> For the complete documentation index, see [llms.txt](https://docs.menanak47.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.menanak47.com/multi-framework/ak47_garage/commands.md).

# Commands

### Admin Permissions Setup

All management commands require admin permissions as configured in [`config.lua`](file:///f:/Fivem%20Work/%5BAsset-Link%5D/%5Bmulti-framework%5D/ak47_garage/config.lua):

```lua
-- Ace Permission (e.g. add_ace group.admin command.creategarage allow)
Admin = {}
Admin.WithAce = true

-- Or License
Admin.WithLicense = {
    ['license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'] = true,
}

-- Or Framework Identifier
Admin.WithIdentifier = {
    ['char1:xxxxxxxx'] = true,
}

-- Or Framework User Group (ESX / QBCore / Qbox)
Admin.WithGroup = {
    ['superadmin'] = true,
    ['god'] = true,
    ['admin'] = true,
}
```

***

### `/creategarage`

Launches the interactive 3D Garage Creation Wizard with free-cam controls and a live setup checklist.

* **Default Command**: `/creategarage`
* **Configuration Key**: `Config.Commands.creategarage`
* **Permission Required**: Admin

#### Setup Steps:

1. **Initial Information Dialog**:
   * **Garage Name**: Unique name for the garage.
   * **Garage Type**: `Car Garage`, `Boat Garage`, `Heli Garage`, or `Plane Garage`.
   * **Is Impound**: Checkbox to designate as an impound lot.
   * **Impound Fee**: Default retrieval fee (if impound).
2. **Garage Configuration Dialog**:
   * **Enable Blip**: Toggle map blip.
   * **Real Parking**: Enable physical visual parked vehicle dummies.
   * **Enable Parking Fee**: Enable hourly parking charges.
   * **Hourly Fee**: Dollar amount charged per hour parked.
   * **Max Garage Fee**: Maximum cap on accumulated parking fees (`-1` for unlimited).
   * **Enable Parking Limit**: Enforce maximum capacity limit.
   * **Max Vehicle**: Total vehicle capacity.
   * **Transfer Fee**: Fee charged when players transfer vehicles into this garage.
3. **Step-by-Step 3D Creation Checklist**:
   * **1. Zone Boundary**: Fly around using `W/A/S/D/Q/E` and click `Mouse 1` to define the polygon perimeter points around the garage.
   * **2. Vehicle Spawn Spots**: Position preview vehicle ghosts, rotate with mouse wheel, and click `Mouse 1` to add spawn locations.
   * **3. Trailer Spot Setup (Car Garages)**: Position the dedicated truck & trailer ghost spot (or press `X` to skip).
   * **4. Respawn Spot (Boat Garages)**: Set the pedestrian exit point when parking boats.

***

### `/garagesetting`

Opens an interactive configuration modal to modify settings for the garage zone the player is currently standing inside.

* **Default Command**: `/garagesetting`
* **Configuration Key**: `Config.Commands.garagesetting`
* **Permission Required**: Admin

#### Editable Settings:

* Toggle Map Blip
* Toggle Real Parking (Physical Dummies)
* Enable / Disable Hourly Parking Fees
* Set Hourly Parking Fee rate ($)
* Set Max Parking Fee Cap ($)
* Enable / Disable Parking Capacity Limits
* Set Maximum Vehicle Limit
* Set Garage Transfer Fee ($)

***

### `/deletegarage`

Permanently deletes the garage the player is currently standing inside from the database and despawns all associated RealParking visual dummies across the server.

* **Default Command**: `/deletegarage`
* **Configuration Key**: `Config.Commands.deletegarage`
* **Permission Required**: Admin

#### Usage:

1. Walk into the target garage PolyZone boundary.
2. Type `/deletegarage` in chat or F8 console.
3. Confirm the alert prompt in the UI to permanently delete the garage.

***

### `/photodebug`

Launches the interactive in-game Photo Studio & Camera Preset Debugger. Spawns the vehicle model in the dedicated photo room, activates a free-flying scripted camera with collision, displays a live dimension and ranking HUD, and prints copy-pasteable configuration code to the F8 console.

* **Default Command**: `/photodebug [model_name]`
* **Configuration Key**: `Config.PhotoDebugCommand`
* **Permission Required**: Admin

#### Syntax

```
/photodebug adder
/photodebug t20
/photodebug marquis
/photodebug frogger2
```

#### In-Game Controls & Features:

| Control             | Action                                                        |
| ------------------- | ------------------------------------------------------------- |
| **Mouse Look**      | Rotate and angle camera pitch and yaw.                        |
| **W / A / S / D**   | Fly camera forward, strafe left, move backward, strafe right. |
| **Q / E**           | Move camera elevation down / up.                              |
| **Mouse Scroll**    | Zoom camera Field of View (FOV) in and out.                   |
| **Arrow Keys**      | Fine-tune camera angle in 0.2° increments.                    |
| **ENTER**           | Print formatted Lua code to the **F8 Console**.               |
| **BACKSPACE / ESC** | Exit the debugger and clean up entities.                      |

#### F8 Console Output Example:

Pressing `ENTER` generates a drop-in table snippet for `PhotoAPI.ModelOverrides` in [`config.lua`](file:///f:/Fivem%20Work/%5BAsset-Link%5D/%5Bmulti-framework%5D/ak47_garage/config.lua):

```lua
-- Model Override configuration for PhotoAPI.ModelOverrides:
[`adder`] = {
    name = 'adder',
    CamCoords = vector3(-273.00, 164.95, -49.96),
    CamRotation = vector3(-12.60, 0.00, 19.40),
    Fov = 50.0,
},
```
