Rarx PedMenu

Overview#

RARX PedMenu is a standalone PED management system for FiveM. Admins assign custom PEDs to players; each player can then browse and apply their assigned PEDs from a dedicated menu. Includes a full admin panel for bulk management, 9 translated languages, a custom NUI (no dependencies on qb-menu / qb-input / ox_lib), and Discord webhook logging.

Features#

Requirements#

Installation#

1. Download & Extract

   Extract the resource into your server's resources/ folder.

2. Import Database

   Run rarx_pedmenu.sql to create the rarx_pedmenu table.

   SQLCopy

   CREATE TABLE IF NOT EXISTS `rarx_pedmenu` (
     `id` INT(11) NOT NULL AUTO_INCREMENT,
     `citizen_id` VARCHAR(50) NOT NULL,
     `ped_name` VARCHAR(100) NOT NULL,
     `ped_model` VARCHAR(100) NOT NULL,
     `assigned_by` VARCHAR(100) NOT NULL,
     `assigned_at` INT(11) NOT NULL,
     PRIMARY KEY (`id`),
     INDEX `idx_citizen_id` (`citizen_id`),
     INDEX `idx_ped_model` (`ped_model`)
   );

3. Add to server.cfg

   server.cfgCopy

   ensure rarx_pedmenu

   Ensure oxmysql and your framework start before this resource.

4. Configure

   Edit shared/config.lua to set your language, commands, admin groups, and webhook URLs.

Configuration#

General#

Config = {
    Language  = 'es',     -- 'es', 'en', 'fr', 'de', 'it', 'pt', 'ru', 'ja', 'zh'
    Framework = 'auto',   -- 'auto', 'qbcore', 'qbox', 'esx'
}

Commands#

Config.Commands = {
    playerPeds = 'peds',          -- Open the player's own PED selector
    pedMenu    = 'rarxpedmenu',   -- Open the admin PED management panel
}

Permissions#

Config.AdminGroups     = { 'admin', 'superadmin', 'god' }
Config.ModeratorGroups = { 'moderator', 'mod' }
Config.AceEnabled      = true   -- Also accept ACE permissions (e.g. command.rarxpedmenu)

Discord Webhooks#

Config.Webhooks = {
    enabled   = false,
    selectPed = { url = '', color = 0x00ff00, enabled = true },
    addPed    = { url = '', color = 0x00ff00, enabled = true },
    removePed = { url = '', color = 0xff0000, enabled = true },
    editPed   = { url = '', color = 0xffaa00, enabled = true },
}

Debug#

Config.Debug = {
    enabled    = false,
    categories = {
        framework = true,  -- Framework detection
        database  = true,  -- DB queries
        player    = true,  -- Player actions (connect, select, assign)
        system    = true,  -- Resource lifecycle
    },
}

When Config.Debug.enabled = false, no debug messages are printed — only critical errors.

Commands#

Both command names are configurable via Config.Commands.

Debug-only commands#

Using the Player Menu#

1. Player runs /peds
2. The NUI opens and lists every PED an admin has assigned to them
3. The player clicks a PED to apply it — the model is swapped on the player and the appearance (if any) is re-applied via rarx_clothing when available
4. If the player has only one PED assigned, /peds applies it directly without opening the menu

Using the Admin Panel#

1. Admin runs /rarxpedmenu
2. The panel opens with three tabs:
   • My PEDs — the admin's own assigned PEDs
   • All PEDs — every player on the server with at least one PED assigned
   • Management — assign / edit / remove PEDs

Assigning a PED#

1. Pick a player

   Choose from online players, or look up any citizen_id with previously-assigned PEDs.

2. Enter PED details

   Provide a friendly Name and the GTA model hash (e.g. a_m_m_business_01).

3. Confirm

   The PED is stored in the rarx_pedmenu table and the target player sees it on their next /peds.

Editing a PED#

Select any existing PED in the Management tab to rename it or swap the model. The table key is (citizen_id, ped_model) — editing the model updates the row in place.

Removing a PED#

Admins can remove any PED from any player. Confirmation is required before the row is deleted.

Localization#

Language is set via Config.Language in shared/config.lua. The language cannot be changed in-game — you must restart the resource after editing the config.

Adding a new language#

1. Duplicate en.json

   Copy locales/en.json to locales/<code>.json (e.g. nl.json).

2. Translate

   Translate every string value. Leave keys untouched.

3. Apply

   Set Config.Language = 'nl' and restart the resource.

Events API#

Server → Client#

Client → Server#

Database#

Single table: rarx_pedmenu

Indexes: citizen_id, ped_model.

Troubleshooting#