Electus LogoElectus Documentation

Installation

Install Electus Trap Phone, its database tables and inventory item.

Installation steps

Please follow these steps carefully. If you need installation help, join our Discord.

Download the package

Download electus_trap_phone from Cfx.re Portal and place it in your server resources folder.

Install the required dependencies

Install and start:

  • Your supported framework and inventory
  • oxmysql
  • ox_lib

Calls are enabled by default and use pma-voice. Install it before continuing, or set Config.Calls.Enabled = false.

lb-phone and electus_gangs are optional. Start either resource before electus_trap_phone when its integration is enabled.

Add the trap phone item

The default item name is trap_phone. When Config.UniquePhone.Enabled is true, configure the item as unique or non-stackable so every physical phone can retain its own number and data.

The package does not include a trap_phone.png inventory icon. Add your own icon if your inventory requires one.

Run the SQL file

install.sql

Import sql/install.sql. It creates:

  • electus_trap_phone_players
  • electus_trap_phone_offers
  • electus_trap_phone_messages
  • electus_trap_phone_calls
  • electus_trap_phone_item_metadata
  • electus_trap_phone_buyers

Configure the resource

Review config/config.lua, config/buyers.lua, config/messages.lua and config/locales/en.lua.

At minimum, verify:

  • Config.Framework, Config.Inventory and Config.Target
  • Config.Phone.Item
  • Config.DrugItems
  • Config.Calls
  • Config.Gangs

Add the resource to server.cfg

Start dependencies before the trap phone:

ensure oxmysql
ensure ox_lib
ensure pma-voice
ensure electus_trap_phone

Your framework and inventory must also start first. Place lb-phone and electus_gangs before electus_trap_phone when enabled.

Configure admin access

The buyer manager command defaults to:

/trapphoneadmin

ESX superadmin and QB/Qbox admin users are accepted. The bridge also accepts the command.admin ACE:

add_ace group.admin command.admin allow

Verify player access

Give yourself a trap_phone item. Use the item, press F4, or run:

/trapphone

The key and command still require the player to own the configured item.