Plugin Protocol

These endpoints power staff activity tracking and the Server Manager command queue. They are the protocol the Roblox integration and the standalone Technified Admin speak. You only need them if you are building a custom in-game admin system. If you use the official plugin, it handles all of this for you.

Unlike the moderation endpoints, these routes use camelCase field names (guildId, robloxId). Match the examples exactly.

Staff permissions

Resolve a Roblox user’s staff permission level so your admin system can grant the right access in-game.

GET /guilds/:guildId/staff/roblox/:robloxId/permissions

string

required

number

required

Game registration

Register the running game with Technified on startup. This is what makes the game appear under connected games in the dashboard.

POST /roblox/games/register

Body

{
  "guildId": "123456789012345678",
  "placeId": "987654321",
  "universeId": "111222333",
  "gameName": "My Game",
  "creatorId": "1",
  "metadata": {
    "source": "adonis-plugin",
    "pluginVersion": "2.0.0",
    "jobId": "abc123-..."
  }
}

metadata.source identifies which client registered the game. The official integration sends adonis-plugin or guardsman-plugin. Pick your own identifier if you are building a custom admin system.

Session tracking

Report when a staff member starts and stops playing, so their hours show up in Staff Activity.

Start
End
Heartbeat

POST /staff/roblox/session/start

Body

{
  "guildId": "123456789012345678",
  "robloxId": "261",
  "robloxUsername": "Shedletsky",
  "placeId": "987654321",
  "universeId": "111222333",
  "gameName": "My Game"
}

POST /staff/roblox/session/end

Body

{
  "guildId": "123456789012345678",
  "robloxId": "261"
}

POST /staff/roblox/heartbeat

Keeps an open session alive. Send periodically while the staff member is in-game.

Action logging

Log a moderation or admin command so it appears in the audit logs and counts toward performance scoring.

POST /staff/roblox/action

Body

{
  "guildId": "123456789012345678",
  "actorRobloxId": "261",
  "actorUsername": "Shedletsky",
  "actionType": "ban",
  "actionCategory": "moderation",
  "targetRobloxId": "156",
  "targetUsername": "Telamon",
  "placeId": "987654321",
  "universeId": "111222333",
  "details": {
    "reason": "Exploiting",
    "rawCommand": ":ban Telamon Exploiting",
    "source": "adonis"
  }
}

actionCategory is moderation or admin. See the Roblox integration features for the full command list.

Server Manager queue

The live server control endpoints (heartbeat, poll commands, acknowledge) are also part of this protocol and use the same guild API key. They have their own page.

Server Manager

Heartbeat a server, poll for queued commands, and acknowledge results.

Developer API

Endpoints

Playground

Reference

Staff permissions

Game registration

Session tracking

Action logging

Server Manager queue

Server Manager

​Staff permissions

​Game registration

​Session tracking

​Action logging

​Server Manager queue

Server Manager

Staff permissions

Game registration

Session tracking

Action logging

Server Manager queue