Admin Guide

Department creation

Open /police admin and use the New Department button (the department selector sits at the top of the panel's sidebar). The create form asks for two things:

The rest of the department's settings are edited on their own screens after creation:

• Overview — enable / disable the department and manage the treasury
• Jail Policy — stripping mode (none / locker / wipe) and the keep-item whitelist (see Custody)
• Speed Cameras — the "ignored jobs" list of framework jobs exempt from camera triggers

Departments start with a Config.BankingAccountStartBalance (default $30000) treasury when Config.UseBankingAccount = true.

Grade matrix

For each department, define grades on the Grades screen (with that department selected in the sidebar).

Grades are created entirely through the admin panel — there is no template file to copy from.

Station setup

/police admin → Stations → Create.

After creating, configure the station's points across the panel's screens:

Stations → [station] → Interaction tab:

• Clock-in zone — where officers go on / off duty
• Armory — where officers buy loadouts (loadouts themselves are built on the Loadouts screen)
• Personal locker — where officers put on / take off uniforms
• Boss menu — where bosses open the management panel
• Evidence locker — the case-based evidence access point (the case selected in-app decides which locker opens); access controlled by Config.Evidence.locker.minGrade
• Evidence lab — the evidence processing point

Stations → [station] → Services tab:

• Station bell — desk bell for civilians
• Trash bin — shared bin with slots / weight
• Firearm registration desk — civilian firearm registration point

Detention screens (per station):

• Detention Holding — booking desk, holding cells, jail cell, and release point
• Detention Mugshot — camera position + suspect photo mark

Garages live on the Fleet → Garages screen, where each garage can be attached to a station.

Clock-in, armory, boss menu, evidence locker, evidence lab, and personal locker each support multiple points per station — use the add / remove controls to place more than one. Existing single-point stations keep working unchanged.

Garage and vehicle setup

/police admin → Fleet → Garages, then Fleet → Vehicles.

• Create a garage first (label, type, spawn points), optionally attached to a station.
• Add vehicles here free of charge — the admin panel does not touch the treasury. Bosses buying through their own Fleet screen are charged the vehicle's cost plus any addon surcharges (Config.FleetAddons.radar = 5000, Config.FleetAddons.megaphone = 2500, Config.FleetAddons.gun_rack = 3500), and that total is what a totalled unit costs to replace.
• The model can be anything, not just Config.FleetCatalog — the catalog is the menu bosses shop from, not a restriction on what you can add here.
• Set Type to what the model really is: Car, Bike, Quad, Boat, Helicopter or Plane. Vehicles always spawn as this type, so a motorbike set to Car (or the other way round) spawns broken. Picking a garage sets the type to the garage's kind until you choose one yourself. Editing an entry's type applies from each unit's next spawn; an entry marked Mixed types holds units saved with different types, and saving it gives them all the type shown.
• Toggle has_radar to enable the vehicle radar keybinds (K / J / M).
• Toggle Rack to fit a gun rack. On-duty officers of the department then get Access Gun Rack on those vehicles, a small stash per unit that empties when the unit is returned, towed back or destroyed (unless Config.GunRack.PersistOnReturn is on). Removing a rack does not delete what is in it — the items stay out of reach until a rack is fitted to that vehicle again. See Configuration → Gun racks.
• Set Minimum Grade to gate spawn access. It's a list of the department's own ranks, so it can't be set to a rank nobody holds — a vehicle gated above the top rank would never appear in any garage.
• One entry per vehicle spec. A fleet entry is identified by its model, garage, rank and radar/megaphone/gun rack flags — not by its name. Adding a second entry with the same spec is rejected; use the entry's quantity to add more units of it. Every unit in an entry shares its label, livery, extras, performance upgrades and trunk loadout.
• Set Performance Upgrades (engine, brakes, transmission, armor and turbo) when adding or editing a vehicle. They apply to every unit in the entry, and units you add later inherit them. Upgrades take effect the next time a unit is taken out of the garage; a unit already out on the road keeps its current setup until it comes back. Setting a level back to Stock removes the upgrade. If a vehicle has fewer levels than you chose, it gets its highest one. Entries with upgrades show an Upgraded badge.
• Copy an entry instead of rebuilding it. Press the copy icon on a vehicle row, pick a department and one of its garages, and press Copy — for example to give BCSO the same patrol fleet LSPD has. The copy gets the same number of units, label, model, minimum rank, livery, extras, performance upgrades, radar, megaphone and gun rack, replacement cost and trunk loadout. Every copied unit gets a new plate in the target department's plate format; plates, drivers and vehicle status are never copied. Copying is free, like adding a vehicle here.
  • Only garages of the same type (car, boat or helicopter) are offered.
  • The minimum rank is copied as a number and lowered to the target department's top rank if it has fewer ranks. Check it after copying — rank 3 in one department is not necessarily the same job as rank 3 in another.
  • If the target garage already has an entry with the same model, rank and addons, the copy is refused and names that entry — raise its quantity instead, or copy into another garage.
  • A boss can copy only within the department they run. Copying between two departments needs someone who manages both, which in practice means an admin.
• The trash icon disables the whole entry, it does not delete one unit. Disabled entries stay in this list greyed out with a DISABLED badge and vanish from garages; press the ↺ button to bring them back, or the red trash to delete them permanently. To reduce unit count instead, lower the quantity.
• Give the vehicle a trunk loadout so officers start a shift already equipped. Edit a vehicle and add items under Trunk Loadout, each with a count and a price. The equipment is loaded into the car when the unit is bought and then stays with it — officers take what they need and put things back. The loadout applies to every unit in the group, and units you add later inherit it.
  • Refilling. Press Refill (the box icon) on a vehicle row to restock every unit of that vehicle. The treasury is charged only for what is actually missing, at the prices you set — one used medkit costs one medkit. Vehicles that are already full aren't charged.
  • Because nothing is issued on checkout, officers can't farm equipment by taking a car in and out. A crew that loses its gear costs the department money instead.
  • Saving a loadout also stocks the cars straight away, so vehicles you already own pick it up without a separate step. The treasury is charged the same way as a refill — if it can't cover the equipment the save still succeeds and you're told the cost and the balance.
  • Trunk loadouts need o-link 1.6.7 or newer and an inventory that can write to vehicle trunks — see Configuration → Trunk loadouts.
• Plate formats are set elsewhere — /police settings → Fleet → Fleet plate formats — because they apply per department rather than per vehicle. Only vehicles created after you set one are affected; plates already in service are never rewritten. See Configuration → Plate formats.
• Checked-out vehicles stay in the world until physically returned to a garage bay (they survive clock-out, disconnect, and restarts). When a unit is stranded in the field, use the Tow action on the Fleet screen — it lists each out unit with its plate, holder, and last-seen street so you pick exactly which one to bring back. Each tow charges the treasury Config.FleetRecoveryFee (default 750).

Charges catalog

The charge catalog is managed in the MDT (Catalog tab), not the admin panel.

• The catalog is seeded from Config.DefaultCharges (100 entries) the first time the resource starts.
• Edit / add / archive charges through the MDT's Catalog tab (admins only).
• Editing shared/config/charges.lua after first run does not retroactively modify the database.

Importing a penal code from a spreadsheet

Adding a few hundred charges one at a time is painful, so the Catalog tab has an Import button that takes a CSV.

The columns are code, title, category, description, fine_amount, jail_time. Only code and title are required, and the column order does not matter — the header row is what identifies each column. category must be infraction, misdemeanor, or felony; anything else becomes misdemeanor. A worked example is shown in the import panel.

You can either pick a .csv file or paste the rows straight into the box. Either way you get a preview before anything is saved, showing which rows will be added, which will update a charge that already exists, and which are invalid (flagged and skipped). Nothing is written until you confirm.

Because a row whose code already exists updates that charge rather than duplicating it, you can keep the spreadsheet as your working copy of the penal code and re-import it whenever you make changes. Charges you previously removed come back if their code reappears in the file.

Imports are capped at Config.MDT.limits.maxImportRows (default 500) per file. If a row fails, the rest still import and the failures are listed with their line numbers.

The Export button produces the same format from your current catalog — useful for backups, or for copying a penal code from a test server to a live one. Because the game's browser cannot save files directly, the export appears as selectable text: click it, select all, and copy.

Prison job points

/police admin → Detention → Prisoner Jobs.

• Place rock spawns (mining), trash spawn zones (cleaning), and electrical meter points.
• Each placed point is persisted and tied to one of the three job types.

Prison shop

/police admin → Detention → Prison Shop.

• Set the vendor location (ped spawns at this point with WORLD_HUMAN_CLIPBOARD scenario) in one of two ways:
  • Place Interactively shows a see-through preview of the vendor where you aim. Scroll to turn it, then click to place it. Press Enter to fine-tune: drag the coloured arrows to slide it, scroll to turn it, use the arrow keys to nudge it, and press Enter again to save. ESC cancels at any point and leaves nothing behind.
  • Use My Position saves the spot you are standing on, facing the way you face.
• Define meal windows (for the free prison_food_tray).
• Build the paid catalog (item, label, price, category from Config.PrisonShop.categories).

Prison revive point

/police admin → Detention → Revive Point.

• Sets the global revive point used when an inmate dies during their sentence.
• Stored in the police_prison_revive_point table — without a row, the prison revive cutscene cannot fire and inmates fall through to the framework medical resource.

Speed camera placement

Use /police speedcam create from in-world for placement (see above) — this is faster than placing through the admin panel.