Skip to main content

Installation and Setup

Third-Party Resource Dependencies

warning

Failure to adhere to these dependencies will result in NPWD not working correctly. You MUST use the screenshot basic version linked below.

If you wish for NPWD to have full functionality. The following resources are required to be installed and started before NPWD.

  1. screenshot-basic - Make sure to use the exact version, as linked.
  2. pma-voice
note

NPWD has standardized pma-voice as our default voice system for the phone. We encourage everyone to do such. We will not provide support or configuration, for any other VOIP's should issues arise.

Downloading Release

  1. Navigate to the releases page.
    • The latest release is shown at the top of the page and will have an image to the right stating as such.
  2. Left click on the hyperlink containing npwd.zip.
    tip

    The mentioned zip contains a pre-built version of the phone so no building is required.

  3. Save and unzip the npwd folder into your resources folder. An example directory would be: A:\xd-rp-server\server-data\resources

Initial Setup

Database Integration

To setup the database schema, you must run the import.sql file found within the root of your npwd folder.

If you already use mysql-async, ghmattimysql, or oxmysql. NPWD will automatically configure itself to use the mysql_connection_string from your server.cfg file.

If you do not already use one of these libraries, you must add an entry to your server.cfg file for mysql_connection_string, matching one of the following connection configuration formats:

# You do NOT need both. Only one.
set mysql_connection_string "mysql://root:[email protected]/es_extended?charset=utf8mb4"
set mysql_connection_string "user=root;database=es_extended;password=12345;charset=utf8mb4"

Basic Configuration

caution

Standalone installation requires a users table of some sort that stores player identifiers. If you are a menu based server and don't use popular frameworks, you will need to use pe-core so you can use this resource. It's a very basic "framework" and wlll have no impact on your server.

NPWD uses a config.json file that contains important information required for the resource to work correctly. This file is location within the root of your npwd folder. See here.

Databse Configuration

"database": {
"useIdentifierPrefix": false,
"playerTable": "users",
"identifierColumn": "identifier",
"identifierType": "license",
"profileQueries": true,
"phoneNumberColumn": "phone_number"
},

Above is the default database configuration that comes with NPWD. The information needs to be altered to match your database.

  • "useIdentifierPrefix"

    • The prefix is refering to the text before the colon when obntaining identifiers.
    • If your database uses license:XXXXXXXXXXXXXXXXXXXXXXXXXXX set this to true. Otherwise, set it to false.
    • This is only used when "useResourceIntegration" is set to false.
  • "playerTable"

    • The table in which your user information is stored.
    • At a minimum, it needs to contain player's identifier and a phone number column.
  • "identifierColumn"

    • Found within your playerTable that is specified within the config.json.
  • "identifierType"

    • Ranges from the following: steam, license, xbl, ip, discord and live.
  • "profileQueries"

    • Provides useful debug information about the time it took to get data from the database.
  • "phoneNumberColumn"

    • The column where phone numbers are stored.

    • As of v1.03, you need to create this yourself. See the sql file for an example query.

      note

      We are working to improve this so the number column is added when you run the SQL file.

General Configuration

"general": {
"useResourceIntegration": false,
"toggleKey": "f1",
"toggleCommand": "phone",
},
  • "useResourceIntegration"
    • This is only used for framework integration.
      info

      Setting this to true is what exposes the newPlayer export. The export won't work without this set to true.

  • "toggleKey"
    • The key used to open the phone. Please see here for a list of available keys.
  • "toggleCommand"
    • The command used to open the phone. This is executed on the key press of the configured toggleKey.

Framework Integration

If you are using a popular framework such as ESX or QBCore, you can easily integrate NPWD using the corresponding premade compatbility resource(s), these should automatically configure NPWD to work with your framework.

Follow the written documentation for ESX and QB-Core for the altered installation.

If you have basic development knowledge and wish to integrate NPWD with any arbitrary framework, see the following documentation page for more information.

tip

Have you made a wrapper for a framework not listed above? If so, please reach out to us so we may improve our documentation. You can do so by contacting us on the Project-Error Discord here.

Below is information pertaining to functionalty to enable specific features of the phone such as image uploading for the camera or report logging for discord.

Setting up Camera Functionality

caution

Some have reported issues with uploading images. While this is most likely related to using a different version of screenshot-basic, imgur may also be blocked in your country. We are currently working on alternatives.

NPWD allows for players to access a camera app and take in-game photos. The link to the photo is saved within the database of NPWD so these photos are required to be uploaded somewhere. One solution is to setup NPWD to upload the photos to Imgur.

Steps

  1. Setup an imgur application here.
  2. After you have created an account or logged in, create an application here.
  3. Type in a Application name. This can be something like npwd-imgur-[servername].
  4. Choose the Authorization type called OAuth 2 authorization without a callback URL. Example.
  5. Fill in the rest of the form.
  6. Copy the client ID and add setr SCREENSHOT_BASIC_TOKEN <your_client_id> to your server.cfg file before starting NPWD.

If you can't find your application you just created, check your settings pages here.

Setting up Discord Log Integration

NPWD can integrate with Discord to log certain actions. As of release v1.0.3, the only use case is to log reported tweets and marketplace listings. This requires a webhook to be setup and the following convar set in your server.cfg file:

# You need to wrap the webhook in quotation marks.
# Do NOT use setr in place of set as this shares this webhook with the client.
set NPWD_DISCORD_TOKEN "my_discord_webhook"

Finishing Up

Example Final Config

Your server.cfg should somewhat resemble the following (in terms of order):

set mysql_connection_string "mysql://root:[email protected]/es_extended?charset=utf8mb4"
setr SCREENSHOT_BASIC_TOKEN XXXXXXXXXXXXXXX
set NPWD_DISCORD_TOKEN "my_discord_webhook" # Quotations required

ensure screenshot-basic
ensure pma-voice

ensure my_framework_here # Your framework resource. Ignore if you're not using one.
ensure esx-npwd # Any compatibility resources like esx-npwd or qb-npwd. Ignore if you're not using one.

ensure npwd
caution

If you're using es_extended from overextended, esx-npwd is not necessary as it's built into their resource. See their README for more information.

Important Information

  • By installing npwd, you agree to the use of the following diagnostic package:
    • Sentry, (in use within the React portion of NPWD) Automatically uploads relevant sesssion details and stack traces whenever an exception is thrown. We use these metrics to further improve the quality of the phone.
    • To explicitly disable this, we urge you not to as its incredibly useful metrics for us, please change the SentryErrorMetrics setting to false in phone/config/default.json and rebuild the phone.
  • Encountered an issue? Please open an issue here following the provided template.
  • If you seek additional support, feel free to join the Project-Error Discord.