🚀Install & Setup Guide

Step 1: Download the Latest Releases

  1. Download pp-bridge: Get the latest release of pp-bridge from our GitHub repository.

  2. Download pp-mdt: Download pp-mdt from CFX Keymaster

  3. Place both pp-bridge and pp-mdt folders into the resources directory inside your server files.

Step 1: Check Compatibility

First, confirm if the scripts, frameworks, inventory systems, etc., you’re using are compatible with our setup. Take a look at this list: Compatibility List. If everything you're using is on this list, you’re good to go to the next step! 🎉

If your scripts are NOT listed there, don’t worry:

  • Open the file @pp-mdt/config/config_s.lua

  • Update the script functions in this file to match the ones you’re using by following the template provided for other scripts.

You’ll also need to configure the pp-bridge resource:

  • Locate init.lua in the pp-bridge.

  • Add new files/resources to the appropriate folders based on your setup.

Step 2: Set Up database

  1. Find the file sql.sql file in the pp-mdt folder, which you downloaded from Keymaster.

  2. Run this SQL file in your database to create the required tables and columns.

  3. Get SQL file prepared for your Framework from here and run it inside your database

Step 3: Enable the Script in server.cfg

  1. Open your server.cfg file.

  2. Add the following lines:

    # ensure inventory, ensure framework, ensure targets, etc.
    ensure pp-bridge
    ensure pp-mdt-prop
    ensure pp-mdt
  3. Save the changes, and restart your server to make sure everything loads correctly. 🚀

Step 4: Configure Locales 🌍

Before proceeding, check each file in the config folder to ensure that the "locales" setting matches your preferred language. If the correct locale isn’t listed:

  1. Open the locales folder.

  2. Use an existing locale file as a template to create your own custom translation file.

  3. Update the "locales" setting in each config file to point to your new locale.

Step 5: Open the MDT

To open the MDT:

  • Use the client export openMDT

  • or press the default keybind \| to bring up the MDT.

But before you do, make sure:

  1. Your job has access to the MDT. Open config/config_s.lua and check if your job is listed in the jobsWithAccess table.

  2. You’re on duty if your server uses qbcore or qbox for duty states.

Final Step: Enjoy Your New MDT! 🎉📱

Once everything is set up, hop on the server, open the MDT, and start exploring its features! 🎈

Extra Step: Optimizing Locales for Better Performance

If you’re experiencing any lag or performance issues with the NUI, the problem could be related to the locales settings. Here’s how to fix this by removing unnecessary locale files:

  1. Go to the folder @pp-mdt/web/build/assets.

  2. Locate the .js files that contain prefixes for each language. These files will have names formatted like en_US and en, or pl_PL and pl for Polish, etc. You can find more information about locale codes here.

    • Example files:

  3. Delete all files except the ones that match your preferred language and the core files:

    • Keep only the files with your locale prefix (e.g., pl_PL.js for Polish or en_US.js for English).

    • Leave the main index-<...>.css and index-<...>.js files untouched.

  4. Save these changes and restart the resource.

Removing unused locale files will help the NUI load only the necessary language settings, which should reduce lag and improve the performance of the MDT.


Need Help? 💬

If you run into any issues or have questions, please open a ticket on our Discord https://discord.gg/pixelprecision or reach out by email at support@pixelprecision.dev.

Last updated