Requirements

• Database: MySQL or MariaDB
• Database bridge: oxmysql
• Framework: ESX Legacy, QBCore, or Qbox
• Inventory: ox_inventory, qb-inventory, lj-inventory, qs-inventory, codem-inventory, core_inventory, mf-inventory, smx-inventory, hex_4_inventory, or native ESX inventory
• Voice: PMA-Voice, YACA, or SaltyChat

Installation Steps

1. Copy the nightcore_phone folder into your FiveM resources directory.
2. Keep the resource folder name as nightcore_phone.
3. Start oxmysql, your framework, inventory, and voice resource before NightCore Phone.
4. Review the configuration files:
   • nightcore_phone/config/config.lua
   • nightcore_phone/config/media.lua
5. Add the required inventory items (see Inventory Items section below).
6. Add ensure nightcore_phone to your server.cfg.
7. Restart the server and check the console for warnings.

Example Start Order

ensure oxmysql
ensure es_extended
ensure ox_inventory
ensure pma-voice
ensure nightcore_phone

Replace the example framework, inventory, and voice resources with the ones your server uses.

Database

NightCore Phone creates and upgrades its database tables automatically. A manual SQL import is normally not required. For fresh installs, you can import nightcore_phone/sql/install.sql if needed.

Inventory Items

ox_inventory

Add these items to your ox_inventory items.lua:

["phone"] = {
    label = "iFruit Phone",
    weight = 200,
    stack = false,
    close = true,
    consume = 0,
},

["nightcore_phone_sim_registered"] = {
    label = "Registered SIM",
    weight = 5,
    stack = false,
    close = true,
    consume = 0,
},

["nightcore_phone_sim_anonymous"] = {
    label = "Anonymous SIM",
    weight = 5,
    stack = false,
    close = true,
    consume = 0,
},

QBCore Item Setup

For QBCore-style item tables:

• Set the phone's unique value to match Config.Phone.Unique.
• Set useable = true and shouldClose = true.
• Physical SIM items must always be unique.