AMXX AJXS HUB

Scripting

The contract, for people who write plugins.

Everything on this page is the real interface, not a summary of it. If you are integrating your own plugin with the licence check, or deciding whether a pack will fit your server, this is the page.

Plugins shipped372
Includes150
Cvars1280
Commands476

The licence check, in full

Every licensed plugin speaks to the same endpoint. There is no SDK to install and no key embedded in the binary: the key is activated once, and after that the plugin asks for a lease and carries the answer.

EndpointMethodWhat it does
/v1/activatePOSTTakes a licence key and returns a signed lease for that server.
/v1/heartbeatPOSTSame exchange, every two minutes. This is how a revoke reaches a running server.
/v1/amxx/leaseGETReturns the canonical string and its signature, for a client that wants to verify locally.
/v1/download-tokenPOSTRetired. Delivery is by SFTP push; no artefact is downloadable.
/v1/download/:tokenGETRetired. Returns 410. Nothing is served from this endpoint.
/v1/healthGETLiveness, no auth.

The lease string

Field order is fixed and it is part of the interface. It is signed with HMAC-SHA256 under a key derived per account, so a leaked binary points at one account and no other.

v1|LIC|<licenceId>|<pack>|<accountId>|<epoch>|<iat>|<exp>|<port>|<flags>

The epoch is the whole enforcement model. Stopping, refunding or revoking a licence increments it. A client that sees a higher epoch than the one it holds stops enforcing immediately, and it does not matter that the plugin is still on disk. That is why nothing has to be deleted from a server to end an arrangement.

What each pack needs beyond the base

A module is loaded from modules.ini. A library is linked into the plugin at compile time, and a missing one fails differently: the plugin loads and then goes quiet. The two are listed separately on purpose.

NameKindPacks that declare it
authemulibrary extras
curlmodule admin-bans
easy_httpmodule network-suite
gripmodule admin-bans
hackdetectorlibrary extras
iphubclientmodule admin-bans
reaimdetectorlibrary extras

4 modules and 3 libraries declared across the library. A pack that declares none runs on the base alone.

Per pack, measured

PackPluginsCoreOptionalExtra requirements
Zombie Plague 5911774 none beyond the base
Extras87483 authemu hackdetector reaimdetector
Network Suite824339 easy_http
Admin and Bans26620 curl grip iphubclient
Server Utilities25619 none beyond the base
CSDM and GunXP23221 none beyond the base
Rank and Stats22418 none beyond the base
VIP and Shop16214 none beyond the base

What the analysis found

Across the whole source corpus, not only the shipped packs: 11251 files, 1997 of them unique content, 435 natives, 476 commands and 1280 cvars declared. Those numbers are what a conflict check has to reason about, and they are the reason two random packs cannot be dropped on one server and expected to agree.

The shipped library is 8 packs, 372 plugins and 150 includes, of which 84 plugins are core. The corpus number is larger because it counts every file the analysis ever saw, including packs that were retired.

Bases and addons covers what to install underneath all of this. Help covers what to do when a plugin will not load.