All configuration lives in config.lua, which is the only file you need to edit for day-to-day customisation.
NPC Client Models#
Config.ClientPeds is the list of ped models the script randomly picks from when spawning a client. The file ships with 33 preconfigured models. Add or remove entries as desired — use the correct model name from the RAGE MP Peds list.
Addon peds are supported; just add the model name as a string:
Config.ClientPeds = { "s_f_y_hooker_01", "ig_michelle", "MyCustomAddonPed", -- addon ped example}Blacklisted Ped Models#
Config.BlacklistedPeds contains models that are automatically skipped during ped selection. Models listed here are known to despawn or cause visual issues on OneSync servers. Add any problematic models you discover to this list.
Config.BlacklistedPeds = { "s_f_y_cop_01", "s_m_y_cop_01", -- add others as needed}Idle Animations#
Config.IdleAnimations lists the ambient scenario names played by a waiting client NPC. The script picks one at random each time a client spawns.
Pickup & Drop-off Locations#
Pickup and drop-off spots are defined as vector3 coordinates. See the Locations page for the defaults and guidance on adding your own.
Dialogue#
Config.Dialogue holds all the lines clients speak. Each key maps to a table of strings; the script picks one at random. The available keys are:
| Key | When it plays |
|---|---|
pickup | When the client first gets in the vehicle |
start | When the job begins |
transit | During the drive |
dropoff | On arrival at the destination |
blowjob_offer | When the client makes a special offer |
blowjob_accept | When the player accepts |
blowjob_decline | When the player declines |
blowjob_complete | After the service completes |
sex_offer | When the client makes a premium offer |
sex_accept | When the player accepts |
sex_decline | When the player declines |
sex_complete | After the service completes |
Edit any of the strings freely — the script never hard-codes specific lines.
Offer Chances#
Config.Chances = { enable_offers = true, -- set false to disable all special offers blowjob_offer = 25, -- percentage chance (0-100) sex_offer = 25, -- percentage chance (0-100) table_sex_scene = 0 -- percentage chance for table-prop scene}Set enable_offers = false to turn off all special service offers in one go without touching the individual percentages.
Notifications#
| Option | Default | Description |
|---|---|---|
system | "qb-core" | Notification backend to use |
duration | 5000 | How long notifications stay on screen (ms) |
position | "top-right" | Screen position — applies to ox_lib only |
See the Notifications page for full setup instructions for each system.
Visual & Screen Effects#
The config exposes toggles for screen effects and sound effects that play during special service scenes. Set the relevant options to false to disable effects you do not want on your server.
Photographer NPC System#
A photographer NPC can appear during special services. Related options in config.lua let you control:
- Spawn chance — how often the photographer appears.
- Frequency — how many photos are taken per session.
- Distance — how far away the photographer stands.
- Ped models — which NPC model is used for the photographer.
Set the spawn chance to 0 to disable the photographer system entirely.