Documentation

Server Monitor Docs

Professional reference for commands, routes, admin operations, and API access.

Platform Documentation

Platform Highlights Slash Commands Website Routes Admin Actions API Endpoints

Highlights6

Commands16

Web Routes10

Admin10

API7

Recent Platform Highlights

Most recent additions and operational improvements.

New
Retry-based offline detection to reduce false server flaps
New
One warning per config-issue window with automatic reset once fixed
New
Tier reconciliation and entitlement trimming for upgrades/downgrades
New
Appeal queue workflow with admin moderation actions
New
Global incident banners from manual status or auto API degradation checks
New
Subscription-Manager co-run support with env-based separate bot config

Slash Commands

Command behavior and option requirements.

Command /activate

Activate your Subscription to Server Monitor!

Option	Type	Required	Description
activate-in-this-server	String	Required	Confirm you wish to activate the bot in the Current Server!
cluster	String	Required	Select the Cluster you want to be linked to!
alarm-log	Channel	Required	Channel you want Alarms/Alerts sent to!
rates-log	Channel	Required	Channel you want Rates sent to!
monitor-channel	Channel	Required	Channel you want the Server Monitor to be Shown!

Command /alerts

Manage Alerts on your Server Monitor!

Option	Type	Required	Description
type	String	Required	Set Population Change to Track!
population	String	Optional	How low enemy server population should be, or how much friendly one should increase by!

Command /appeal

Submit a ban appeal for userID/IP/HWID/license bans.

Option	Type	Required	Description
reason	String	Required	Why should your ban be lifted?
contact	String	Optional	Optional contact details for follow-up

Command /bestserver

Show top and bottom population servers by cluster

Option	Type	Required	Description
cluster	String	Optional	Filter by cluster

Command /blacklist

Manage your Blacklisted servers

Option	Type	Required	Description
type	String	Required	Blacklist Option!
server	String	Optional	Enter the Full Server Name!

Command /cluster

Cluster-level official server summaries

Option	Type	Required	Description
status	Subcommand	Optional	Show cluster-level totals
hottest	Subcommand	Optional	Show the hottest servers right now

Command /graph

Generate a graph for the player count of a server

Option	Type	Required	Description
servername	String	Required	Server Name to fetch Graph for.
timeframe	String	Optional	Pick a timeframe!

Command /official

Retrieves Official Server Info

Option	Type	Required	Description
server	String	Required	Enter Server Number

Command /profile

View your profile

No options required.

Command /reminder

List, Create & Delete Reminders for the Server Monitor!

Option	Type	Required	Description
option	String	Required	Select a Reminder Option
name	String	Optional	Name of the Reminder
time	String	Optional	Time: 1d 1h 1m or 1h 10m
mention	User	Optional	User to notify about the Reminder

Command /servers

Manage Servers on your Server Monitor!

Option	Type	Required	Description
type	String	Required	Add/Remove Friendly or Enemy Servers!
server	String	Optional	Enter Server Number!
server-owner	String	Optional	Enter the Tribe/Alliance that owns this server!

Command /settings-alerts

Manage your Server Monitor Alerts Settings!

Option	Type	Required	Description
role	Role	Required	Select the Role you want the bot to mention!
channel	Channel	Required	Channel you want Alerts sent to!

Command /settings-cluster

Change your Cluster for the Server Monitor!

Option	Type	Required	Description
cluster	String	Required	Select the Cluster you want to be linked to!

Command /settings-panel

Manage your Server Monitor Panel Settings!

Option	Type	Required	Description
channel	Channel	Required	Channel you want the Panel sent to!

Command /settings-rates

Manage your Server Monitor Rate Settings!

Option	Type	Required	Description
role	Role	Required	Select the Role you want the bot to mention!
channel	Channel	Required	Channel you want Rates sent to!

Command /settings-reminders

Manage your Server Monitor Reminder Settings!

Option	Type	Required	Description
role	Role	Required	Select the Default Role you want the bot to mention!
channel	Channel	Required	Channel you want Reminder Alarms sent to!

Website Routes

Primary application pages and their purpose.

Route	Description
/	Home page
/auth/discord	Discord OAuth login
/settings	User settings dashboard
/settings/repair-setup	One-click setup repair (POST)
/setup	First-time setup flow
/profile	User profile and backups
/server	Official/unofficial server browser
/rates	Server rates view
/admin	Admin dashboard (owner/admin only)
/docs	This commands and routes documentation page

Admin Actions

Internal admin controls and operational endpoints.

Action	Description
/admin/users/:userID/roles	Update user roles and apply entitlement reconciliation
/admin/users/:userID/license/reset	Reset or remove desktop license key based on tier
/admin/users/:userID/data	Manual JSON save for subscriber data
/admin/users/:userID/ban	Create or update IP/HWID/license/userID bans
/admin/users/bulk/roles	Bulk role + entitlement updates
/admin/users/bulk/reset	Bulk data reset for selected users
/admin/bans/bulk/unban	Bulk unban selected ban entries
/admin/appeals/:appealId/status	Review ban appeals and optionally auto-unban
/admin/incident/set	Set manual global incident banner
/admin/incident/clear	Clear manual global incident banner

API Endpoints

Programmatic access points exposed by Server Monitor.

Endpoint	Description
/healthz	Site health check
/api/db	DB API endpoints (API key protected)
/api/desktop/log	Desktop log ingestion endpoint
/api/validate-user	Desktop user validation endpoint
/api/auth-with-credential	Desktop credential auth endpoint
/api/login	Ascension license login with ban-state checks
/api/sentMessages/*	Alert dedupe sent-message tracking endpoints