ktoxktox docs

Garage Builder

Multi-stage visual editor for creating and editing garages in-game.

Garage Builder

The builder is a multi-stage visual editor for creating and editing garages in-game.

Opening the Builder

Type /garages in chat (configurable via builderCommand in config). This opens the tools menu with three options:

  • New Garage - start building a new garage
  • Library - view and edit saved garages
  • Debug - debug tools (only visible when debugMenu = true)

Permissions

Access requires at least one of:

  • ACE permission - grant ktx_garages.builder in server.cfg:
    add_ace group.admin ktx_garages.builder allow
  • Framework group - player's group must be in builder.allowedGroups (default: admin and superadmin)
  • allowEveryone - set to true in config to let all players use the builder

Creating a New Garage

Metadata

First, fill in the garage details:

  • Name - display name shown to players
  • Price - purchase cost
  • Sale Percentage - fraction of price returned when selling (0.2 = 20%)
  • Job Garage - toggle to make this a job-restricted garage
  • Job Name - which job can access it (only when Job Garage is enabled)
  • Friendly Fire - allow player damage inside the garage
  • Garage ID - optional custom identifier (auto-generated if left blank)

Blip Settings

  • Show Blip - toggle map blip visibility
  • Blip Text - label shown on the map
  • Blip Sprite - icon ID (FiveM blip reference)
  • Blip Color - color ID

Stage 1 - World Setup

Place markers and points in the game world.

Main Entry Marker

Where players and vehicles enter the garage. Stand at the desired location and capture. Configure marker appearance:

  • Type - marker shape ID
  • Size - width, depth, height
  • Color - RGB values
  • Distance - render distance
  • Animate Up-Down - bobbing animation
  • Animate Rotate - spinning animation

Main Exit Point

Where players and vehicles appear when leaving the garage. Stand at the exit location and capture.

Showcase Camera

The camera angle shown when players browse garages for purchase. Position yourself where the camera should be and capture.

Invite Zone

The area where invited players must be standing to receive invites. Set the center point, then adjust the radius.

Ped Entry / Exit (Optional)

Separate entry and exit points for players on foot. Not required - if unset, the main entry/exit is used for both vehicles and pedestrians.

Stage 2 - Interior Setup

Select Interior

Choose from 11 built-in interiors across categories: CEO Garages, Warehouses, Apartments, Airports, Casino.

Warning: Changing the interior after placing slots will reset all interior placements.

Apply Template

Pre-configured slot layouts for the selected interior. Select an interior first, then choose a template. Templates save time by placing all vehicle slots automatically.

Preview Vehicle Model

The ghost vehicle shown when manually placing slots. Default: adder. Change this if your garage targets a specific vehicle size.

Interior Spawn Point

Where the player appears when entering the garage interior. Stand at the desired spawn location inside the interior and capture.

Manage Marker

The interaction point inside the garage for managing co-owners, selling, and viewing activity. Place it in an accessible spot inside the interior.

Vehicle Slots

Each slot is a parking position for one vehicle.

To add a slot:

  1. Click "Add Slot" - enters freecam mode with a ghost vehicle
  2. Position the ghost vehicle where you want the slot
  3. Adjust heading and height using the controls:
    • Rotate - change vehicle facing direction
    • Raise / Lower - adjust vertical position
    • Speed Up / Slow Down - change movement speed
  4. Confirm to save the slot

To edit an existing slot:

  • Edit Position - re-enter freecam to reposition
  • Set From Player - use your current position and heading
  • Adjust Heading - enter a specific heading value
  • Delete - remove the slot

Stage 3 - Review and Save

Validate

Runs validation checks on the garage definition. Reports any missing required fields before saving.

Save

Persists the garage to the database. The garage becomes active immediately - no server restart needed.

Editing Existing Garages

Open the Library from the tools menu. Select a garage to load it into the builder. Make changes and save again. The existing definition is updated in place.

Templates

Templates are curated slot layouts for specific interiors. They define vehicle positions and headings that fit naturally within the interior space. After selecting an interior, apply a template to skip manual slot placement. You can still add, remove, or adjust individual slots after applying a template.