Summary
Connects a server to the ATG API for account linking and moderation.
Description
ATG Link connects an Arma Reforger server to the ATG API - the service behind ATG's
Discord integration. Three things rest on that connection.
IDENTITY
The API establishes that the server at a given address really is the one its owner
enrolled. It sends a challenge, the server answers from a secret only the two of them
hold, and the secret never crosses the connection. Nothing else works until this
succeeds.
THE GATE
A server can require that players have linked their game account before they are allowed
to deploy, or merely tell them how. Three modes: off, nag and block. The gate applies at
the spawn rather than at the connection, so a player who is turned away can still join and
look around. It is subtractive - whatever the base game or another mod already refuses
stays refused.
By default a player is admitted when the check itself cannot be completed. A server that
locks its whole membership out because a web service blinked is worse off than one that
briefly admits somebody unregistered.
MODERATION
A ban issued from Discord reaches the server, and the server hands it to Bohemia's ban
service.
The mod ships inert. With nothing configured it registers its commands, reports that it is
not configured, and does nothing else. It never contacts anything on its own - the API
opens the connection, over RCON, and this mod only answers.
LOAD ORDER
Load ATG Core and ATG Commands BEFORE this mod. Both are found by load order rather than declared as dependencies, so a server that orders this mod ahead of either comes up with no commands at all - and with no commands, nothing can reach it.
ATG UI is optional and also found by load order. Loaded before this mod, the gate and the nag appear on screen as a card as well as in chat, which matters because a player sitting on the deploy screen does not read chat. Loaded after, or not at all, the mod says the same things in chat alone and nothing else changes.
The order should read: ATG Core, ATG Commands, ATG UI, ATG Link.
Documentation: https://atg-milsim.org/wiki/dev/atg-link
License
Arma Public License No Derivatives (APL-ND)