ATG Commands

What the mod does

ATG Commands adds a single chat command, /atg, and lets the other ATG mods put their controls underneath it. Instead of learning a different command per mod, an administrator learns one word.

On its own it does very little — it answers /atg and two small built-in commands. Its value is that everything else lives in one place: install it alongside other ATG mods and their commands appear automatically under /atg.

Installing it

Load ATG Commands before any ATG mod that uses it. Mods find it by load order rather than by declaring it as a dependency, so a mod ordered ahead of ATG Commands will silently come up with no chat commands at all.

If you run a server with ATG Scenario, the order in your mod list should read ATG Commands, then ATG Scenario.

Nothing else is required, and there is nothing to configure.

Using it

Type /atg on its own to list every command available on that server, including ones added by other mods. The list is generated from what is actually loaded, so it is always accurate for that server.

Everything else comes from other mods. With ATG Scenario loaded you also get op and combat, for switching the server between rolling objectives and an authored operation — see Narrative ops — and zone, for marking out where objectives may be placed from inside the running game — see Objective placement.

/atg status

Each mod contributes its own labelled lines, printed separately so they stay readable as more mods are added:

ATG: mode - combat ops, tier may rise, op in 12 minutes
ATG: score - 1240, tier 3, +85 since the last switch
ATG: narrative - 4 root(s)

A mod with nothing to report stays quiet rather than printing an empty line. If nothing at all is registered, /atg status says so.

/atg whoami

Prints which roles the server thinks you hold. This is the first thing to reach for when a command refuses somebody it shouldn’t — it distinguishes “you don’t have the role” from “the command is broken”.

Who can run what

Every command declares how much authority it needs, and a higher role satisfies a lower requirement — an administrator can run everything without also being flagged as a Game Master.

• Game Master — any server role at all. Used for commands that only read state, such as status.
• Session administrator — used for commands that change what the whole server is doing.
• Administrator — the highest level.

A player without the required role is told which role the command wants, rather than being ignored, because the usual cause is holding a role one rung below.

Dev documentation. This mod is on a development branch. Command names and behaviour may change before release, and the role checks in particular have been confirmed only against an account holding all three roles at once — /atg whoami is how you verify what your own server reports.

Extending it

Other ATG mods register their own commands and status lines automatically when loaded in the right order; nothing needs wiring up by hand. If you are building a mod of your own and want it to appear under /atg, get in touch — the registration interface is small, but it is not documented here.