Usage
Opening the Menu
Type /events in chat. The staff event panel opens if you have been granted access (or are an admin).
Managing Scenes
Creating a Scene
- Open the menu with
/events. - Click Create Scene and enter a name.
- The scene is created empty and immediately appears in the scene list.
Adding Objects
- Select a scene from the list and click Add Object.
- Choose an object type: Prop, Ped or Teleport.
- A freecam mode activates - navigate to the placement location.
- Use the gizmo to position and rotate the object precisely.
- Confirm placement. The object appears in-world for all players instantly.
Object Types
| Type | Description |
|---|---|
| Prop | A static frozen world object (furniture, barriers, decorations, etc.) |
| Ped | An NPC placed at the location, configurable animation and optional weapon |
| Teleport | An invisible trigger zone that warps any player who enters it to a configured destination |
Editing Objects
- Select any object in the scene panel to reposition it (freecam + gizmo), change its settings, or toggle it on/off.
- Use Copy Object to duplicate an existing object within the same scene.
Enabling / Disabling
- Scenes and individual objects can be toggled without deleting them.
- A disabled scene removes all its objects from the world, re-enabling restores them.
Event Stashes
Event stashes are virtual inventories (50 slots) that players can open by interacting with the object they are attached to.
Attaching a Stash
- Select an object in the scene panel.
- Click Add Stash (requires
add_stash_to_objectpermission). - Configure the stash name, items and whether it is per-player or shared.
| Mode | Behaviour |
|---|---|
| Per-player | Each player gets their own copy of the inventory |
Shared (stashCommon) | All players share a single inventory pool |
Refilling a Stash
Select the stash in the panel and click Refill (requires refill_stash permission). The stash items are reset to the configured default contents.
Permissions
Admins always have full access. Non-admin staff must be granted individual permissions.
| Permission | Description |
|---|---|
add_stash | Create new event stashes |
remove_stash | Delete event stashes |
refill_stash | Refill stash contents back to default |
edit_stash_items | Change the items defined in a stash |
add_stash_to_object | Attach a stash to a scene object |
remove_scene | Delete an entire scene and all its objects |
disable_scene | Enable or disable a scene |
edit_scene | Add, move, edit or remove objects within a scene |
all | Grants all of the above permissions |
Granting Access
Admins have full access by default. To grant a non-admin staff member access, open the /events menu as an admin and assign the desired permissions to that player directly from the UI.
Configuration
| File | Option | Default | Description |
|---|---|---|---|
editable/sv_config.lua | LogWebhookUrl | "" | Discord webhook URL for event activity logs |
editable/props.json | - | Built-in list | Prop categories and models available in the prop picker, each category has a label and an items array of { object, label } entries |
editable/animations.json | - | Built-in list | Animations selectable for event peds |
editable/minigames.json | - | Built-in list | Minigames triggerable from event objects |
editable/weapons.json | - | Built-in list | Weapons assignable to event peds |
UI Icons
Preview thumbnails shown in the prop and ped pickers are loaded from the compiled NUI assets. To add or replace an icon, place a .webp file in the correct folder inside ui/dist/icons/ using the model name as the filename.
| Folder | Naming | Used for |
|---|---|---|
ui/dist/icons/props/ | <object_model>.webp | Prop thumbnails, name must match the object field in editable/props.json |
ui/dist/icons/peds/ | <ped_model>.webp | Ped thumbnails, name must match the ped model name |
ui/dist/icons/category-icons/ | <category_key>.png and <category_key>_active.png | Category icons in the prop picker, name must match the category key in editable/props.json |
ui/dist/icons/noitem.webp | - | Fallback shown when no matching icon file is found |
Stash item icons
Icons for items inside event stashes are loaded from your inventory resource's NUI assets. The URL base and file extension are auto-detected in editable/cl_ui.lua based on the active inventory set in prp-bridge:
| Inventory | Base URL | Extension |
|---|---|---|
ox_inventory | https://cfx-nui-ox_inventory/web/images/ | png |
tgiann-inventory | https://cfx-nui-inventory_images/images/ | webp |
origen_inventory | https://cfx-nui-origen_inventory/html/images/ | png |
If you use a different inventory or a custom image path, update iconUrl and iconExt in editable/cl_ui.lua.