ACPlayerPed

A complete server-controlled ped customization framework. Admins grant any GTA ped (or custom addon ped) to specific players via a categorised browser with image previews. Players manage their personal collection through /myped — apply, set as default (auto-applies on every login + respawn), or reset back to their character creator outfit.

Built with a fully self-contained custom NUI — zero dependency on qb-menu, ox_lib menus, or any other UI library. Will never break when those libraries get updated.

Includes a categorised admin browser (Custom · Male · Female · Animal · Special · Browse-All — 250+ vanilla peds with image previews), a hover-following preview panel, custom-ped support for server-specific addon models, per-character (citizenid) collections, and a Manage-Granted view so admins can revoke peds at any time. Includes a built-in RP-rules disclaimer banner that warns players against ped-changing during active scenes (combat log abuse). Blocks ped changes while in vehicle, dead, cuffed, or on-duty as police/EMS/sheriff/SWAT.

What's in the box

• Custom NUI — HTML + CSS + vanilla JS, zero ox_lib / qb-menu dependency
• Categorised admin browser — Custom · Male · Female · Animal · Special · Browse-All, 250+ peds with previews
• Custom peds support — register server-specific addon ped models via config
• Hover-following preview panel — 280×280 image, origin tag, category, granted-by + granted-at metadata
• Per-character collections — tied to citizenid, multi-character safe
• Set as Default — auto-applies on every login + respawn
• Reset to Original Outfit — via illenium-appearance / qb-clothing reload (configurable)
• Manage-Granted view — admins can revoke peds at any time, see granted-by + granted-at
• RP-rules disclaimer banner — anti combat-log abuse, warns players against scene-time ped changes
• Smart blocking — blocks ped changes while in vehicle, dead, cuffed, or on-duty police/EMS/sheriff/SWAT
• Search bar — quick filter across browse views
• Database persisted — ac_player_peds table survives restarts
• Per-ped image override — bundle your own previews or use docs.fivem.net defaults

Compatibility

Game build: 2189+ Dependencies: qb-core, ox_lib, oxmysql, a skin script with reload event (illenium-appearance / qb-clothing / fivem-appearance)

Quick install

1. Drop into resources/[standalone]/ACPlayerPed/
2. Add ensure ACPlayerPed to server.cfg
3. Schema (ac_player_peds table) auto-installs on first start, or run install/ac_player_peds.sql manually
4. Edit config.lua: AdminPermission, ResetSkinEvent, Categories.custom (your addon peds), LockedJobs
5. Restart the server