config/ folder and the frameworkBridge. No code changes are required. Within minutes, you can tailor the tool to your server style and let staff stage scenes smoothly.
What you’ll do most of the time: choose who to spawn, select them, right-click somewhere, and pick an action. The UI translates your choice into in-game orders for the selected entities.
How it works at a glance
- Selection: Click or drag to select one or more peds or vehicles.
- Context menu: Right-click ground, a ped, or a vehicle to see relevant actions.
- Orders: Actions like go to, attack, dismount, give weapon, play animation. The script handles pathing, hostility, safety checks, and timing.
- Your configuration: Control the catalog, languages, permissions, and menu content entirely from
config/.
Using the UI
Spawning items
- Select and spawn: Left-click an item in the grid to select it, then click in the world to spawn it.
- Item options and variants: Right-click an item to see options or choose among variants (when available).
- Find items fast: Use the search bar and filters to narrow results.
Favorites
- Assign by drag: Drag items from the grid onto the numbered 1-9 slots.
- Select favorite: Press a digit key
1-9to select a favorite. - Quick-assign: Press
1-9while hovering an item to assign it to that slot.
Categories and filters
- Switch categories to browse different item types.
- Use filters to refine results by tags and properties.
- Reset clears all filters and the current search query.
Keyboard shortcuts
Camera controls
- Move:
WASD - Up / down:
Space/C - Sprint:
Shift - Zoom: Mouse wheel
- Rotate camera: Middle mouse button + move
- Yaw:
QEor left/right arrow keys - Pitch:
RFor up/down arrow keys
Selection and actions
- Select entity under cursor: Left mouse button
- Box-select (drag): Left mouse button + drag
- Open context menu: Right mouse button
- Move order (with selection): Right mouse button + drag
- Return to select mode:
Esc - Cancel spawn mode: Right mouse button
- Highlight all peds:
Tab - Copy selection:
Ctrl + C - Paste at cursor:
Ctrl + V - Cut selection:
Ctrl + X - Delete selection:
Delete/Backspace
Favorites
- Select favorite:
1-9 - Assign favorite (while hovering an item):
1-9
Advanced features
Smart search
Search is debounced and covers item names and tags. Examples:"sheriff"- finds Sheriff NPCs"lawman"- finds law enforcement NPCs"combat"- finds combat-related presets
Activity log
The log drawer records your actions, supports filtering, and can be exported. Useful for debugging or reviewing a session.Marquee selection
Drag the left mouse in empty world space to box-select multiple entities quickly.Ped info panel
When exactly one ped is selected, a compact panel shows model, HP, weapon, relationship, and ownership.Next steps
Setup
Permissions, core settings, catalog data, images, and localization.
Developer reference
Extend the context menu with your own actions and providers.