> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dietrich-development.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Spawn, direct, and orchestrate NPCs and animals in seconds - no code, just config

DD Gamemaster is your control room for live events and storytelling. Open the UI, pick from hundreds of NPCs and animals, and then right-click the world to give clear, game-native orders: move here, stand there, attack that, mount this horse, play an animation, and more.

You set everything up using only the `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.

<Info>
  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.
</Info>

## 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-9` to select a favorite.
* **Quick-assign**: Press `1-9` while 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**: `W` `A` `S` `D`
* **Up / down**: `Space` / `C`
* **Sprint**: `Shift`
* **Zoom**: Mouse wheel
* **Rotate camera**: Middle mouse button + move
* **Yaw**: `Q` `E` or left/right arrow keys
* **Pitch**: `R` `F` or 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

<Columns cols={2}>
  <Card title="Setup" icon="screwdriver-wrench" href="/scripts/gamemaster/setup">
    Permissions, core settings, catalog data, images, and localization.
  </Card>

  <Card title="Developer reference" icon="code" href="/scripts/gamemaster/developers">
    Extend the context menu with your own actions and providers.
  </Card>
</Columns>