Configure the MDT: services, jobs and permissions

In short. MDT rights come from the character being played: their job and rank, read from the game database. You put jobs in services, then tick, job by job or rank by rank, what they can do. Nothing is open by default. When you promote an officer in game, their rights follow.

Before you start #

The game database must be connected: see Connect the game database.

1. Create a service and put jobs in it #

1. MDT → Settings: each service is a card that groups its jobs. + New service: a name, a colour and a type (Police, Medical services, Justice, Dealership, Other trade).
2. The type grants no rights: it picks the wording (Citizens, Patients…), the suggested permission templates and, for a dealership, the vehicle catalogue it manages.
3. At the bottom of the card, + Add a job: type to filter the game's jobs, or type its exact name (e.g. sasp). A job belongs to a single service.
4. The card's Manage button lets you rename the service, change its colour or type, tick Map: multi-job (see The live map) or delete it (only with no job, and no report or vehicle stored in it).

For a job to have its own reports, fleet and employees, create a service for it: MDT services. Jobs kept in the "Other" service share everything between them.

Not every job shows up? The catalogue may be "deduced from characters". Connect the panel or SFTP to read jobs.lua (Server → Database), or type the name by hand. The catalogue reloads by itself, every 5 minutes.

2. Set the permissions #

Click a job to open it. Two modes, your choice:

• Same permissions for the whole job: every rank has exactly the same ones.
• Permissions per rank: each rank has its own and also gets those of the ranks below it. The ladder runs from the lowest rank (top) to the highest: set the lowest first, the next ones inherit. Drag ranks to reorder them, then Save order. An inherited permission can be unticked for one specific rank ("removed here").

The other mode's settings are kept: you can switch back without losing anything.

Permissions are grouped in collapsible categories (General, Law enforcement, Health, Justice, Dispatch, Live map, Recruitment, Dealership), with a master box per category. Tick, then Save. An MDT section opens through its "View…" permission: what a service shows follows from the permissions of its jobs and ranks.

A job you add has no permission: tick at least Open the MDT.

Use the MDT outside the game is the most important permission. Without it, the MDT only opens in game (tablet, or browser while playing). This is what stops someone from checking a record from bed. Beware: the master box of the "General" category ticks it too.

Templates and ladders #

Under the services, the collapsed Permission templates and ladders section offers ready-made templates (Police · Recruit to Chief, EMS, DOJ, Dealership, Read-only…) and your own. In a job or a rank, Apply a template copies its boxes: you then adjust them by hand. A ladder spreads templates, from lowest to highest, over a job's ranks.

Discord per service #

At the bottom of the card, Service Discord links the service to a Discord server where the bot is invited: one role per rank (given and removed automatically), channels for the service's notifications, and the Discord membership required option to open the MDT.

3. When the game server stops answering #

With no signal for 90 seconds, Agora can no longer check who is playing what. Under the services, the Server unreachable block offers two choices:

• Keep the browser MDT open (default), with a warning;
• Suspend the browser MDT until the server is back. Administrators keep access.

4. Check with "View as" #

On the MDT home page (MDT), Test access (admin) block: View as. Pick a job and a rank, you see exactly what that player sees, refusals included. The Test mode banner stays at the top, with Leave test mode. ⚠ Actions taken in this mode are real and signed with your name.

Several jobs, several characters #

• A character holding several jobs (player_groups) can reach their services, but permissions are read service by service: never pooled across jobs. Buttons follow the service you are acting in: a button your service would refuse is no longer shown.
• In game, the site follows the loaded character. Off-game, a single character is picked automatically; with several, the member chooses (Switch character link).

Without a game database #

Agora falls back on the forum groups police, doj and ems, with every permission of their department (except HR management). It is a start-up mode, not a way to run your server.