ktoxktox docs

Vehicle Access Rules

Configure which vehicles are allowed inside each garage using whitelists, blacklists, and type filters.

Vehicle Access Rules

Each garage can restrict which vehicles are allowed inside. Rules are configured per garage through the builder's Access & Restrictions menu.

How Filtering Works

When a player drives into a garage, the vehicle is checked against the garage's access rules in this order:

  1. Model whitelist (if enabled)
  2. Model blacklist
  3. Type whitelist (if enabled)
  4. Type blacklist

If any check fails, the player is blocked with a notification.

Model Whitelist

When enabled, only explicitly listed vehicle models can enter the garage. All other models are rejected.

access = {
    whitelist = {
        enabled = true,
        vehicles = {
            [joaat("adder")] = true,
            [joaat("zentorno")] = true,
        }
    },
}

Warning: When the whitelist is enabled, it takes priority over everything. Only whitelisted models are allowed, regardless of blacklist settings.

Model Blacklist

Listed models are blocked from entering. All other models are allowed (unless a whitelist is also active).

access = {
    blacklist = {
        [joaat("insurgent")] = true,
        [joaat("rhino")] = true,
    },
}

Type Whitelist

When enabled, only listed vehicle type groups can enter. Types reference the vehicleTypeGroups from your config.

access = {
    typeWhitelist = {
        enabled = true,
        types = { "car", "bike" }   -- Only cars and motorcycles
    },
}

Type Blacklist

Listed vehicle type groups are blocked from entering.

access = {
    typeBlacklist = {
        types = { "plane", "heli", "boat" }  -- No aircraft or boats
    },
}

Note: Type whitelist takes priority over type blacklist, just like model whitelist takes priority over model blacklist.

Job Garage Ownership Rules

Job garages have additional rules controlling which vehicles employees can park inside. These are configured in the builder under Access & Restrictions > Job Ownership Rules.

RuleDescription
allowPlayerOwnedEmployees can store their personally owned vehicles
allowOtherOwnedEmployees can store vehicles owned by other players
allowUnownedEmployees can store unowned vehicles (spawned, not in database)

All three default to true. Set any to false to restrict what employees can bring into the job garage.