wtclaude
e0d13e73db
PLAN_REDESIGNS section 1. - Every sync reads the store (perm.inventory), reconciles it against the site's record and its ledger, and pushes. A change made in the game is settled by the server's policy (D161): auto-adopt (default), adopt, or revoke. The first read of a server imports everything (D198). - Groups belong to one server unless an admin shares them (D189), in new id-keyed tables; the old ones are copied once at boot and left unread. Holders may be a Steam account nobody linked (D188). - An in-game change affects that server only (D190): a grant that reaches further gains an exception, a shared group is split. - Never judged: a permission the server does not register right now (an unloaded plugin is not a revocation), and a pair an event lease holds. - A new admin API (server view, grant/revoke with everywhere-or-here, groups by id, share/split, members, drift answers) and a screen on PermissionsManager's flow with a state on every toggle (D162, D163, U-1). - The announcement voice names a group by id; old name settings still read. Walked on both rigs against the walk core: import on an existing install, auto-adopt of a grant and a revoke, a fleet grant's exception, Kits unloaded without loss, a shared group split, adopt and revoke policies. Server 420/420, client 58/58, swagger, imports and route manifest current. Refs #21 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01E14m6SuuY6i1vASFeGDBeY
1087 lines
52 KiB
JavaScript
1087 lines
52 KiB
JavaScript
// ── The OpenAPI fragment: the shared half ─────────────────────────────────
|
||
//
|
||
// The tags and component schemas the `#swagger.*` annotations refer to.
|
||
// `scripts/swaggerFragment.js` feeds this to swagger-autogen; the per-endpoint
|
||
// detail lives beside each route, exactly as it does in core.
|
||
//
|
||
// **Two rules about names, and both belong to the MERGED document rather than to
|
||
// this file** (MODULE_API.md §6.1a). Core merges every started module's fragment
|
||
// over its own committed spec and serves the result at `/api/docs.json`, and core
|
||
// wins any key collision:
|
||
//
|
||
// • **Namespace what you DEFINE.** `RustServerList`, not `ServerList`. A second
|
||
// game's module describing the same idea under the same bare name would
|
||
// silently clobber this one or be clobbered by it.
|
||
// • **Reference what CORE defines by core's name.** `#/components/schemas/Error`
|
||
// and `ValidationError` are core's; point at them and do not redefine them.
|
||
//
|
||
// **swagger-autogen renders `components.schemas` from an EXAMPLE object, not from
|
||
// raw OpenAPI.** `{ type: 'object' }` comes back as a meta-description of itself.
|
||
// That is uniform across core's committed spec and is the house shape.
|
||
|
||
module.exports = {
|
||
tags: [
|
||
{
|
||
name: 'Public · Rust',
|
||
description: 'The Rust servers this site follows, as each one last reported itself',
|
||
},
|
||
{
|
||
name: 'Player · Rust',
|
||
description: 'The Rust surface for a signed-in player',
|
||
},
|
||
{
|
||
name: 'Admin · Rust',
|
||
description: 'Configuring the Rust servers and their sidecars',
|
||
},
|
||
],
|
||
components: {
|
||
schemas: {
|
||
RustServerList: {
|
||
type: 'object',
|
||
description: 'Every Rust server this site follows (GET /public/rust/servers).',
|
||
properties: {
|
||
servers: {
|
||
type: 'array',
|
||
items: { $ref: '#/components/schemas/RustServer' },
|
||
},
|
||
},
|
||
},
|
||
RustServer: {
|
||
type: 'object',
|
||
description: 'One Rust server, as it last reported itself.',
|
||
properties: {
|
||
id: { type: 'string', example: 'main' },
|
||
name: { type: 'string', example: 'Main · Vanilla' },
|
||
online: { type: 'boolean', example: true },
|
||
players: { type: 'integer', example: 42 },
|
||
maxPlayers: { type: 'integer', example: 100 },
|
||
hostname: { type: 'string', nullable: true, example: 'Runic Gateway · Main' },
|
||
level: { type: 'string', nullable: true, example: 'Procedural Map' },
|
||
worldSize: { type: 'integer', nullable: true, example: 4000 },
|
||
seed: { type: 'integer', nullable: true, example: 1234 },
|
||
updatedAt: { type: 'string', format: 'date-time', nullable: true },
|
||
stale: {
|
||
type: 'boolean',
|
||
description: 'Has nothing reported in longer than the freshness window? A stale row is reported offline.',
|
||
example: false,
|
||
},
|
||
nextWipe: { $ref: '#/components/schemas/RustNextWipe' },
|
||
},
|
||
},
|
||
RustNextWipe: {
|
||
type: 'object',
|
||
nullable: true,
|
||
description: 'When the server wipes next, computed from the operator’s schedule on every read, or null when no schedule is set. `source` is `forced` (Facepunch’s monthly forced wipe, first Thursday 19:00 UK time), `rule` (the server’s own weekly or biweekly day) or `once` (a one-off date the operator set, which replaces any computed wipe before it). Absent from a module older than phase 16.',
|
||
properties: {
|
||
at: { type: 'string', format: 'date-time', example: '2026-10-01T18:00:00.000Z' },
|
||
source: { type: 'string', enum: ['forced', 'rule', 'once'], example: 'forced' },
|
||
},
|
||
},
|
||
RustWipeSchedule: {
|
||
type: 'object',
|
||
description: 'A server’s wipe schedule as the operator stored it — what they typed, not what it computes to. A past `onceAt` is still returned so the form can show it as past.',
|
||
properties: {
|
||
rule: { type: 'string', enum: ['none', 'forced', 'weekly', 'biweekly'], example: 'weekly' },
|
||
day: { type: 'integer', nullable: true, description: '0 = Sunday … 6 = Saturday', example: 4 },
|
||
time: { type: 'string', nullable: true, example: '14:00' },
|
||
tz: { type: 'string', nullable: true, example: 'America/Chicago' },
|
||
anchor: { type: 'string', format: 'date', nullable: true, example: null },
|
||
onceAt: { type: 'string', format: 'date-time', nullable: true, example: null },
|
||
},
|
||
},
|
||
RustServerSave: {
|
||
type: 'object',
|
||
description: 'The body of PUT /admin/rust/servers/{id}. The wipe fields are written only when `wipeRule` is present.',
|
||
properties: {
|
||
name: { type: 'string', example: 'Main · Vanilla' },
|
||
sidecarBaseUrl: { type: 'string', example: 'http://10.0.0.5:8090' },
|
||
sidecarToken: { type: 'string', description: 'Write-only. Omit or send empty to keep the stored one.', example: '' },
|
||
protocol: { type: 'integer', example: 11 },
|
||
enabled: { type: 'boolean', example: true },
|
||
sortOrder: { type: 'integer', example: 0 },
|
||
wipeRule: { type: 'string', enum: ['none', 'forced', 'weekly', 'biweekly'], example: 'weekly' },
|
||
wipeDay: { type: 'integer', nullable: true, example: 4 },
|
||
wipeTime: { type: 'string', nullable: true, example: '14:00' },
|
||
wipeTz: { type: 'string', nullable: true, example: 'America/Chicago' },
|
||
wipeAnchor: { type: 'string', format: 'date', nullable: true, example: null },
|
||
wipeOnceAt: { type: 'string', format: 'date-time', nullable: true, example: null },
|
||
},
|
||
},
|
||
RustAdminServerList: {
|
||
type: 'object',
|
||
description: 'The configured servers, with their sidecar settings (GET /admin/rust/servers).',
|
||
properties: {
|
||
servers: {
|
||
type: 'array',
|
||
items: { $ref: '#/components/schemas/RustAdminServer' },
|
||
},
|
||
},
|
||
},
|
||
RustAdminServer: {
|
||
type: 'object',
|
||
description: 'One configured server. The sidecar token is never included — `hasToken` reports only whether one is stored.',
|
||
properties: {
|
||
id: { type: 'string', example: 'main' },
|
||
name: { type: 'string', example: 'Main · Vanilla' },
|
||
sidecarBaseUrl: { type: 'string', example: 'http://10.0.0.5:8090' },
|
||
hasToken: { type: 'boolean', example: true },
|
||
protocol: { type: 'integer', example: 1 },
|
||
enabled: { type: 'boolean', example: true },
|
||
sortOrder: { type: 'integer', example: 0 },
|
||
reachable: {
|
||
type: 'boolean',
|
||
description: 'Did the sidecar answer on the last poll? Separate from `online`, which is about the game rather than the bridge.',
|
||
example: true,
|
||
},
|
||
bootId: { type: 'string', nullable: true, example: 'boot-20260915T194502Z' },
|
||
sidecarProtocol: { type: 'integer', nullable: true, example: 1 },
|
||
zoneHelper: {
|
||
type: 'object',
|
||
nullable: true,
|
||
description: 'The ZoneManager helper the game reported at hello (protocol 13, PLAN_FIXES D182). `patched` means ZoneManager counts a player already standing in a zone when it is created or restored. `missing`, `unsupported` or `no-zonemanager` mean it does not: the bridge scores its zones by position instead, and the flags ZoneManager applies miss that player. Null when the plugin reported none.',
|
||
properties: {
|
||
state: { type: 'string', enum: ['patched', 'unsupported', 'missing', 'no-zonemanager'], example: 'patched' },
|
||
version: { type: 'string', example: '0.1.0' },
|
||
reason: { type: 'string', example: 'this ZoneManager (3.2.0) has no Zone.InitializeZone' },
|
||
},
|
||
},
|
||
online: { type: 'boolean', example: true },
|
||
players: { type: 'integer', example: 42 },
|
||
stale: { type: 'boolean', example: false },
|
||
nextWipe: { $ref: '#/components/schemas/RustNextWipe' },
|
||
schedule: { $ref: '#/components/schemas/RustWipeSchedule' },
|
||
titles: { $ref: '#/components/schemas/RustTitleSettings' },
|
||
titlePush: {
|
||
type: 'object',
|
||
nullable: true,
|
||
description: 'What the last push of titles to this server found, since this site last started: how many players hold one and whether BetterChat was there to show them. Null before the first push.',
|
||
properties: {
|
||
count: { type: 'integer', example: 4 },
|
||
betterChat: { type: 'boolean', example: true },
|
||
at: { type: 'string', format: 'date-time' },
|
||
},
|
||
},
|
||
},
|
||
},
|
||
RustTitleSettings: {
|
||
type: 'object',
|
||
description: 'One server’s chat titles (phase 17, D135–D136): rules that rank the current wipe, in precedence order, and how many titles a player shows.',
|
||
properties: {
|
||
mode: {
|
||
type: 'string',
|
||
enum: ['first', 'all', 'upto'],
|
||
description: '`first` shows the first rule a player meets, `all` every one, `upto` at most `max`.',
|
||
example: 'first',
|
||
},
|
||
max: { type: 'integer', minimum: 1, maximum: 5, example: 2 },
|
||
rules: {
|
||
type: 'array',
|
||
maxItems: 10,
|
||
items: {
|
||
type: 'object',
|
||
properties: {
|
||
stat: { type: 'string', enum: ['kills', 'npckills', 'playtime'], example: 'kills' },
|
||
topN: { type: 'integer', minimum: 1, maximum: 10, example: 1 },
|
||
text: {
|
||
type: 'string',
|
||
maxLength: 24,
|
||
description: 'The title. `[`, `]`, `<`, `>`, `{` and `}` are taken out on save, so a title carries no markup of its own.',
|
||
example: 'Top Killer',
|
||
},
|
||
color: { type: 'string', example: '#ff8800' },
|
||
},
|
||
},
|
||
},
|
||
},
|
||
},
|
||
RustIntegrations: {
|
||
type: 'object',
|
||
description: 'Which optional mods a server has loaded right now (GET /admin/rust/servers/{id}/integrations), read live from the game.',
|
||
properties: {
|
||
ok: { type: 'boolean', example: true },
|
||
status: { type: 'string', description: 'The sidecar client’s one-word status when the game could not be asked.', example: 'ok' },
|
||
integrations: {
|
||
type: 'object',
|
||
nullable: true,
|
||
description: 'Null when the game could not be asked, or its plugin is older than protocol 12.',
|
||
properties: {
|
||
betterChat: {
|
||
type: 'object',
|
||
properties: { loaded: { type: 'boolean', example: true }, version: { type: 'string', example: '5.2.15' } },
|
||
},
|
||
popupNotifications: {
|
||
type: 'object',
|
||
properties: { loaded: { type: 'boolean', example: false } },
|
||
},
|
||
},
|
||
},
|
||
},
|
||
},
|
||
RustVoice: {
|
||
type: 'object',
|
||
description: 'The voice news and `rust.announce` lines are said in (D140): a styled permission group, or none for plain chat.',
|
||
properties: {
|
||
voice: { type: 'string', description: 'A group name, or empty for plain chat.', example: 'staff' },
|
||
options: {
|
||
type: 'array',
|
||
description: 'Every group that has a chat style — the only groups that can be a voice.',
|
||
items: {
|
||
type: 'object',
|
||
properties: {
|
||
group: { type: 'string', example: 'staff' },
|
||
title: { type: 'string', example: '[Staff]' },
|
||
format: { type: 'string', description: 'The line the voice makes, with `{message}` where the words go.', example: '[#55aaff][+15][Staff][/+][/#] [#ffffff][+15]{message}[/+][/#]' },
|
||
},
|
||
},
|
||
},
|
||
},
|
||
},
|
||
RustLink: {
|
||
type: 'object',
|
||
description: 'One Steam account linked to a website user. Never carries a code.',
|
||
properties: {
|
||
steamId: { type: 'string', example: '76561198000000000' },
|
||
name: {
|
||
type: 'string',
|
||
nullable: true,
|
||
description: 'What the player was called in game when they linked. A display name only — a Rust name changes on a whim and nothing identifies anybody by it.',
|
||
example: 'Wanderer',
|
||
},
|
||
serverId: {
|
||
type: 'string',
|
||
nullable: true,
|
||
description: 'Which server minted the code. Not part of the identity — a link is fleet-wide — but it is where a support conversation starts.',
|
||
example: 'main',
|
||
},
|
||
linkedAt: { type: 'string', format: 'date-time' },
|
||
},
|
||
},
|
||
RustLinkList: {
|
||
type: 'object',
|
||
description: 'The Steam accounts one website user holds (GET /player/rust/links).',
|
||
properties: {
|
||
links: { type: 'array', items: { $ref: '#/components/schemas/RustLink' } },
|
||
},
|
||
},
|
||
RustPlayerReach: {
|
||
type: 'object',
|
||
description: 'One server an entitlement’s scope reaches, and whether it is there yet.',
|
||
properties: {
|
||
id: { type: 'string', example: 'main' },
|
||
name: { type: 'string', example: 'Main · Vanilla+' },
|
||
live: {
|
||
type: 'boolean',
|
||
description: 'True only when a sync confirmed this into that server’s own store. False covers every way it has not arrived — the server is offline, no loaded plugin registered the name, or its store has never seen the account — and the difference between those is an operator’s diagnosis, not a player’s.',
|
||
example: true,
|
||
},
|
||
},
|
||
},
|
||
RustPlayerPermissions: {
|
||
type: 'object',
|
||
description: 'What the site has given the signed-in player in game (GET /player/rust/permissions).',
|
||
properties: {
|
||
accounts: {
|
||
type: 'integer',
|
||
description: 'How many Steam accounts the caller has linked. Zero is why an entitlement can be authored and reach nobody.',
|
||
example: 1,
|
||
},
|
||
groups: {
|
||
type: 'array',
|
||
items: {
|
||
type: 'object',
|
||
properties: {
|
||
name: { type: 'string', example: 'vip' },
|
||
title: { type: 'string', example: 'VIP' },
|
||
scope: { type: 'string', description: 'A server id, or `*` for the whole fleet.', example: '*' },
|
||
since: { type: 'string', format: 'date-time' },
|
||
permissions: { type: 'array', items: { type: 'string' }, example: ['kits.vip'] },
|
||
reach: { type: 'array', items: { $ref: '#/components/schemas/RustPlayerReach' } },
|
||
},
|
||
},
|
||
},
|
||
grants: {
|
||
type: 'array',
|
||
items: {
|
||
type: 'object',
|
||
properties: {
|
||
permission: { type: 'string', example: 'kits.vip' },
|
||
scope: { type: 'string', example: '*' },
|
||
source: { type: 'string', description: 'Who authored it — `admin` now, an event action later.', example: 'admin' },
|
||
note: { type: 'string', nullable: true },
|
||
since: { type: 'string', format: 'date-time' },
|
||
reach: { type: 'array', items: { $ref: '#/components/schemas/RustPlayerReach' } },
|
||
},
|
||
},
|
||
},
|
||
},
|
||
},
|
||
RustLinkRequest: {
|
||
type: 'object',
|
||
required: ['code'],
|
||
properties: {
|
||
code: {
|
||
type: 'string',
|
||
description: 'The six-character code /link handed the player in game. Good for five minutes, and it works once.',
|
||
example: 'K7M2PQ',
|
||
},
|
||
},
|
||
},
|
||
RustLinkResult: {
|
||
type: 'object',
|
||
description: 'The result of redeeming a code.',
|
||
properties: {
|
||
linked: { type: 'boolean', example: true },
|
||
link: { $ref: '#/components/schemas/RustLink' },
|
||
already: {
|
||
type: 'boolean',
|
||
description: 'True when this Steam id was already linked to the caller — a second press of the button, not an error.',
|
||
example: false,
|
||
},
|
||
},
|
||
},
|
||
RustAdminLinkList: {
|
||
type: 'object',
|
||
description: 'One user’s Rust identity, for the admin.users.detail panel (GET /admin/users/{id}/rust/links).',
|
||
properties: {
|
||
links: {
|
||
type: 'array',
|
||
items: {
|
||
type: 'object',
|
||
properties: {
|
||
steamId: { type: 'string', example: '76561198000000000' },
|
||
name: {
|
||
type: 'string',
|
||
nullable: true,
|
||
description: 'What the game last saw this player called, falling back to the name recorded at link time.',
|
||
example: 'Wanderer',
|
||
},
|
||
linkedName: { type: 'string', nullable: true, example: 'Wanderer' },
|
||
serverId: { type: 'string', nullable: true, example: 'main' },
|
||
linkedAt: { type: 'string', format: 'date-time' },
|
||
firstSeen: { type: 'string', format: 'date-time', nullable: true },
|
||
lastSeen: { type: 'string', format: 'date-time', nullable: true },
|
||
servers: {
|
||
type: 'array',
|
||
description: 'All-time totals per server, summed across every wipe.',
|
||
items: {
|
||
type: 'object',
|
||
properties: {
|
||
serverId: { type: 'string', example: 'main' },
|
||
serverName: { type: 'string', example: 'Main · Vanilla' },
|
||
kills: { type: 'integer', example: 41 },
|
||
deaths: { type: 'integer', example: 37 },
|
||
npcKills: { type: 'integer', example: 120 },
|
||
structures: { type: 'integer', example: 64 },
|
||
playtimeSec: { type: 'integer', example: 43200 },
|
||
wipes: { type: 'integer', example: 2 },
|
||
lastSeen: { type: 'string', format: 'date-time', nullable: true },
|
||
},
|
||
},
|
||
},
|
||
},
|
||
},
|
||
},
|
||
},
|
||
},
|
||
RustPermissionOverview: {
|
||
type: 'object',
|
||
description:
|
||
'The permission manager’s front page (GET /admin/rust/permissions): every server with its policy and sync state, and every change made in a game that waits for a person (PLAN_REDESIGNS §1).',
|
||
properties: {
|
||
servers: {
|
||
type: 'array',
|
||
items: {
|
||
type: 'object',
|
||
properties: {
|
||
id: { type: 'string', example: 'rust-oxide' },
|
||
name: { type: 'string', example: 'Oxide rig' },
|
||
policy: {
|
||
type: 'string',
|
||
enum: ['auto-adopt', 'adopt', 'revoke'],
|
||
description: 'What a change made in the game becomes (D161): the site’s own, a question for a person, or undone.',
|
||
example: 'auto-adopt',
|
||
},
|
||
sync: { $ref: '#/components/schemas/RustPermissionSyncState' },
|
||
},
|
||
},
|
||
},
|
||
drift: { type: 'array', items: { $ref: '#/components/schemas/RustPermissionDrift' } },
|
||
policies: { type: 'array', items: { type: 'string' }, example: ['auto-adopt', 'adopt', 'revoke'] },
|
||
chatFields: {
|
||
type: 'array',
|
||
description: 'The twelve BetterChat group fields a style carries, with each one’s type and BetterChat’s default, for the style editor.',
|
||
items: {
|
||
type: 'object',
|
||
properties: {
|
||
name: { type: 'string', example: 'TitleColor' },
|
||
type: { type: 'string', enum: ['int', 'title', 'color', 'size', 'bool', 'format'], example: 'color' },
|
||
default: { type: 'string', nullable: true, example: '#55aaff' },
|
||
},
|
||
},
|
||
},
|
||
},
|
||
},
|
||
RustPermissionDrift: {
|
||
type: 'object',
|
||
description: 'A change made in a game that waits for a person: every change under the `adopt` policy, an event’s grant removed in the game, a hand-edited style field, or a notice that a shared group was split (D190).',
|
||
properties: {
|
||
id: { type: 'integer', example: 3 },
|
||
serverId: { type: 'string', example: 'rust-oxide' },
|
||
kind: { type: 'string', description: '`grant`, `member`, `group-permission`, `group`, or `chat-field`.', example: 'grant' },
|
||
direction: { type: 'string', enum: ['added', 'removed', 'changed', 'split'], example: 'added' },
|
||
subject: { type: 'string', description: 'A Steam id, or a group name.', example: '76561198000000000' },
|
||
object: { type: 'string', description: 'A permission or group name, a style field, or empty.', example: 'kits.vip' },
|
||
detail: { type: 'string', nullable: true, description: 'What the game holds now (a style value, a group’s title, rank and parent), or a notice’s sentence.', example: null },
|
||
username: { type: 'string', nullable: true, example: 'wanderer' },
|
||
playerName: { type: 'string', nullable: true, example: 'Wanderer' },
|
||
firstSeen: { type: 'string', format: 'date-time' },
|
||
},
|
||
},
|
||
RustPermissionServer: {
|
||
type: 'object',
|
||
description:
|
||
'One server as the permission screen shows it (GET /admin/rust/permissions/servers/{serverId}), following uMod PermissionsManager’s flow (D162): plugins grouped by the plugin that registered each permission, the groups on the server (D189), every player holding anything there named by account and in-game name (D163), and the facts each toggle’s state is read from.',
|
||
properties: {
|
||
server: { type: 'object', properties: { id: { type: 'string' }, name: { type: 'string' } } },
|
||
servers: { type: 'array', items: { type: 'object', properties: { id: { type: 'string' }, name: { type: 'string' } } } },
|
||
policy: { type: 'string', example: 'auto-adopt' },
|
||
sync: { $ref: '#/components/schemas/RustPermissionSyncState' },
|
||
plugins: {
|
||
type: 'array',
|
||
items: {
|
||
type: 'object',
|
||
properties: {
|
||
key: { type: 'string', example: 'plugin:ZoneManager' },
|
||
label: { type: 'string', example: 'ZoneManager' },
|
||
registered: { type: 'boolean', description: 'False for a name no plugin owns (Carbon’s built-in modules), grouped by its prefix.', example: true },
|
||
permissions: { type: 'array', items: { type: 'string', example: 'zonemanager.ignoreflag.nokits' } },
|
||
},
|
||
},
|
||
},
|
||
groups: {
|
||
type: 'array',
|
||
items: {
|
||
type: 'object',
|
||
properties: {
|
||
id: { type: 'integer', example: 12 },
|
||
name: { type: 'string', example: 'vip' },
|
||
title: { type: 'string', example: 'VIP' },
|
||
rank: { type: 'integer', example: 10 },
|
||
parent: { type: 'string', example: 'default' },
|
||
source: { type: 'string', example: 'imported' },
|
||
builtin: { type: 'boolean', example: false },
|
||
allServers: { type: 'boolean', example: false },
|
||
shared: { type: 'boolean', description: 'On more than one server; a change to it asks whether to change it everywhere or split this server off.', example: false },
|
||
servers: { type: 'array', items: { type: 'string', example: 'rust-oxide' } },
|
||
permissions: { type: 'array', items: { type: 'string', example: 'kits.vip' } },
|
||
members: { type: 'array', items: { type: 'object', properties: { userId: { type: 'integer' }, username: { type: 'string' }, steamIds: { type: 'array', items: { type: 'string' } } } } },
|
||
steamMembers: { type: 'array', items: { type: 'string', example: '76561198000000000' } },
|
||
chat: { type: 'object', nullable: true, additionalProperties: { type: 'string' } },
|
||
},
|
||
},
|
||
},
|
||
players: {
|
||
type: 'array',
|
||
items: {
|
||
type: 'object',
|
||
properties: {
|
||
steamId: { type: 'string', example: '76561198000000000' },
|
||
name: { type: 'string', nullable: true, example: 'Wanderer' },
|
||
account: { type: 'object', nullable: true, properties: { userId: { type: 'integer' }, username: { type: 'string' } } },
|
||
grants: {
|
||
type: 'array',
|
||
items: {
|
||
type: 'object',
|
||
properties: {
|
||
permission: { type: 'string', example: 'kits.vip' },
|
||
sources: { type: 'array', description: 'What puts it there: `userGrant`, `steamGrant` or `runGrant`, with its id and scope.', items: { type: 'object' } },
|
||
},
|
||
},
|
||
},
|
||
groups: { type: 'array', items: { type: 'string', example: 'vip' } },
|
||
},
|
||
},
|
||
},
|
||
excepted: { type: 'array', description: 'Grants that reach every server but this one (D190).', items: { type: 'object' } },
|
||
landed: { type: 'array', description: 'What has landed on this server: `grant <steamId> <permission>` and `member <steamId> <group>`.', items: { type: 'string' } },
|
||
report: {
|
||
type: 'object',
|
||
nullable: true,
|
||
properties: {
|
||
unresolved: { type: 'array', items: { type: 'string' } },
|
||
pending: { type: 'array', items: { type: 'string' } },
|
||
notLanded: { type: 'array', items: { type: 'string' } },
|
||
},
|
||
},
|
||
drift: { type: 'array', items: { $ref: '#/components/schemas/RustPermissionDrift' } },
|
||
},
|
||
},
|
||
RustPermissionSyncState: {
|
||
type: 'object',
|
||
description: 'Whether one server’s store matches what the site authors, and what its last report said.',
|
||
properties: {
|
||
serverId: { type: 'string', example: 'main' },
|
||
state: {
|
||
type: 'string',
|
||
description: 'One of `pending`, `ok`, `failed`.',
|
||
example: 'ok',
|
||
},
|
||
inSync: {
|
||
type: 'boolean',
|
||
description: 'True when the last successful push carried the set the site currently authors.',
|
||
example: true,
|
||
},
|
||
dirty: { type: 'boolean', example: false },
|
||
lastAttemptAt: { type: 'string', format: 'date-time', nullable: true },
|
||
lastOkAt: { type: 'string', format: 'date-time', nullable: true },
|
||
importedAt: { type: 'string', format: 'date-time', nullable: true, description: 'When this server’s store was first imported (D198). Null until then; until then every sync imports.' },
|
||
error: {
|
||
type: 'string',
|
||
nullable: true,
|
||
description: 'Why the last attempt failed — a transport word (`timeout`, `no-token`, `protocol-mismatch`) or the game’s own refusal.',
|
||
example: null,
|
||
},
|
||
report: {
|
||
type: 'object',
|
||
nullable: true,
|
||
description: 'The plugin’s report from the last successful sync.',
|
||
properties: {
|
||
applied: {
|
||
type: 'object',
|
||
properties: {
|
||
grants: { type: 'integer', example: 2 },
|
||
revokes: { type: 'integer', example: 0 },
|
||
groupsCreated: { type: 'integer', example: 1 },
|
||
members: { type: 'integer', example: 3 },
|
||
},
|
||
},
|
||
alreadyCorrect: { type: 'integer', example: 14 },
|
||
unresolved: {
|
||
type: 'array',
|
||
description: 'Permission names no loaded plugin on that server has registered. A grant naming one lands nowhere and is not recorded as pushed.',
|
||
items: { type: 'string', example: 'kits.gold' },
|
||
},
|
||
pending: {
|
||
type: 'array',
|
||
description: 'Memberships waiting on a first connection: the store has no user record to put in a group yet.',
|
||
items: { type: 'string', example: '76561198000000000:vip' },
|
||
},
|
||
},
|
||
},
|
||
},
|
||
},
|
||
RustPermissionCatalogue: {
|
||
type: 'object',
|
||
description: 'Every permission name the configured servers have registered (GET /admin/rust/permissions/catalogue).',
|
||
properties: {
|
||
permissions: {
|
||
type: 'array',
|
||
items: { $ref: '#/components/schemas/RustPermissionCatalogueEntry' },
|
||
},
|
||
},
|
||
},
|
||
RustPermissionCatalogueEntry: {
|
||
type: 'object',
|
||
description: 'One registered permission name, and which servers know it.',
|
||
properties: {
|
||
permission: { type: 'string', example: 'kits.vip' },
|
||
servers: { type: 'array', items: { type: 'string', example: 'main' } },
|
||
owner: { type: 'string', nullable: true, description: 'The plugin that registered it, from the inventory (PLAN_REDESIGNS §0.1).', example: 'Kits' },
|
||
},
|
||
},
|
||
RustPermissionSyncResult: {
|
||
type: 'object',
|
||
description: 'What a forced sync produced (POST /admin/rust/permissions/sync).',
|
||
properties: {
|
||
servers: { type: 'array', items: { $ref: '#/components/schemas/RustPermissionSyncState' } },
|
||
drift: { type: 'array', items: { $ref: '#/components/schemas/RustPermissionDrift' } },
|
||
},
|
||
},
|
||
RustUserPermissions: {
|
||
type: 'object',
|
||
description: 'One person’s Rust privileges, for the admin.users.detail panel (GET /admin/users/{id}/rust/permissions).',
|
||
properties: {
|
||
groups: {
|
||
type: 'array',
|
||
items: {
|
||
type: 'object',
|
||
properties: {
|
||
name: { type: 'string', example: 'vip' },
|
||
title: { type: 'string', example: 'VIP' },
|
||
scope: { type: 'string', example: '*' },
|
||
permissions: { type: 'array', items: { type: 'string', example: 'kits.vip' } },
|
||
},
|
||
},
|
||
},
|
||
grants: {
|
||
type: 'array',
|
||
items: {
|
||
type: 'object',
|
||
properties: {
|
||
id: { type: 'integer', example: 7 },
|
||
permission: { type: 'string', example: 'kits.gold' },
|
||
scope: { type: 'string', example: 'main' },
|
||
source: { type: 'string', example: 'admin' },
|
||
grantedAt: { type: 'string', format: 'date-time' },
|
||
},
|
||
},
|
||
},
|
||
reaches: {
|
||
type: 'array',
|
||
description: 'The Steam accounts these privileges reach. Empty means this person has linked nothing and holds them on paper only.',
|
||
items: { type: 'string', example: '76561198000000000' },
|
||
},
|
||
},
|
||
},
|
||
RustOnline: {
|
||
type: 'object',
|
||
description: 'Who is on one server (GET /public/rust/servers/{id}/online). Below the operator’s presence audience the names are withheld and only the count is answered — nothing names who is online by default.',
|
||
properties: {
|
||
players: {
|
||
type: 'array',
|
||
description: 'Empty whenever `hidden` is true.',
|
||
items: {
|
||
type: 'object',
|
||
properties: {
|
||
steamId: { type: 'string', example: '76561198000000000' },
|
||
name: { type: 'string', nullable: true, example: 'Wanderer' },
|
||
sleeping: { type: 'boolean', example: false },
|
||
connectedAt: { type: 'string', nullable: true },
|
||
},
|
||
},
|
||
},
|
||
hidden: { type: 'boolean', description: 'Were the names withheld from this viewer?', example: true },
|
||
count: { type: 'integer', description: 'How many are online. Public at every audience.', example: 12 },
|
||
audience: { $ref: '#/components/schemas/RustAudience' },
|
||
},
|
||
},
|
||
RustAudience: {
|
||
type: 'string',
|
||
enum: ['staff', 'signed_in', 'public'],
|
||
description: 'Who may see something: admins and moderators, any signed-in account, or anybody. Ordered — each includes the ones before it.',
|
||
example: 'staff',
|
||
},
|
||
RustVisibility: {
|
||
type: 'object',
|
||
description: 'Who may see who is online: the fleet default and each server’s optional override (GET /admin/rust/visibility).',
|
||
properties: {
|
||
audiences: { type: 'array', items: { $ref: '#/components/schemas/RustAudience' } },
|
||
presence: {
|
||
type: 'object',
|
||
properties: {
|
||
fleet: { $ref: '#/components/schemas/RustAudience' },
|
||
servers: {
|
||
type: 'array',
|
||
items: {
|
||
type: 'object',
|
||
properties: {
|
||
id: { type: 'string', example: 'main' },
|
||
name: { type: 'string', example: 'Main · Vanilla' },
|
||
enabled: { type: 'boolean', example: true },
|
||
override: {
|
||
type: 'string',
|
||
nullable: true,
|
||
enum: ['staff', 'signed_in', 'public', null],
|
||
description: 'This server’s own choice, or null to follow the fleet default.',
|
||
},
|
||
effective: { $ref: '#/components/schemas/RustAudience' },
|
||
},
|
||
},
|
||
},
|
||
},
|
||
},
|
||
clans: {
|
||
type: 'object',
|
||
description: 'Who may see a clan roster, and each server’s clan board.',
|
||
properties: {
|
||
audiences: { type: 'array', items: { $ref: '#/components/schemas/RustClanAudience' } },
|
||
roster: { $ref: '#/components/schemas/RustClanAudience' },
|
||
servers: {
|
||
type: 'array',
|
||
items: {
|
||
type: 'object',
|
||
properties: {
|
||
id: { type: 'string', example: 'main' },
|
||
name: { type: 'string', example: 'Main · Vanilla' },
|
||
supported: { type: 'boolean', example: true },
|
||
enabled: { type: 'boolean', example: true },
|
||
fresh: { type: 'boolean', example: true },
|
||
truncated: { type: 'boolean', example: false },
|
||
reason: { type: 'string', nullable: true },
|
||
clans: { type: 'integer', example: 14 },
|
||
umodClans: { type: 'boolean', description: 'Is the uMod Clans plugin loaded? Its clans are a separate system and are not Teams.', example: false },
|
||
},
|
||
},
|
||
},
|
||
},
|
||
},
|
||
map: {
|
||
type: 'object',
|
||
description: 'The live map’s switches and each server’s picture (phase 14).',
|
||
properties: {
|
||
layers: { type: 'array', items: { type: 'string' }, example: ['world', 'events', 'players', 'bases'] },
|
||
fleet: {
|
||
type: 'object',
|
||
properties: {
|
||
world: { $ref: '#/components/schemas/RustAudience' },
|
||
events: { $ref: '#/components/schemas/RustAudience' },
|
||
players: { $ref: '#/components/schemas/RustAudience' },
|
||
bases: { $ref: '#/components/schemas/RustAudience' },
|
||
mates: { type: 'boolean', example: true },
|
||
},
|
||
},
|
||
servers: {
|
||
type: 'array',
|
||
items: {
|
||
type: 'object',
|
||
properties: {
|
||
id: { type: 'string', example: 'main' },
|
||
name: { type: 'string', example: 'Main · Vanilla' },
|
||
overrides: { type: 'object', description: 'Each layer and `mates`, or null to follow the fleet.' },
|
||
effective: { type: 'object' },
|
||
picture: {
|
||
type: 'object',
|
||
nullable: true,
|
||
properties: {
|
||
source: { type: 'string', enum: ['companion', 'rendered', 'none'] },
|
||
mapKey: { type: 'string' },
|
||
hasPicture: { type: 'boolean' },
|
||
bytes: { type: 'integer' },
|
||
worldSize: { type: 'integer' },
|
||
fetchedAt: { type: 'string', format: 'date-time', nullable: true },
|
||
},
|
||
},
|
||
renderStallSeconds: { type: 'integer', description: 'About how long Render now would stall this server.', example: 9 },
|
||
fetching: { type: 'boolean' },
|
||
rendering: { type: 'boolean' },
|
||
lastError: { type: 'string', nullable: true },
|
||
},
|
||
},
|
||
},
|
||
},
|
||
},
|
||
news: {
|
||
type: 'object',
|
||
description: 'Whether a published news post is also said in each server’s in-game chat. Off by default (D104).',
|
||
properties: {
|
||
servers: {
|
||
type: 'array',
|
||
items: {
|
||
type: 'object',
|
||
properties: {
|
||
id: { type: 'string', example: 'main' },
|
||
name: { type: 'string', example: 'Main · Vanilla' },
|
||
enabled: { type: 'boolean', example: true },
|
||
on: { type: 'boolean', example: false },
|
||
delivery: {
|
||
type: 'string',
|
||
enum: ['chat', 'popup'],
|
||
description: 'Where the post goes when `on`: chat, or a popup — which needs PopupNotifications on that server (D142).',
|
||
example: 'chat',
|
||
},
|
||
},
|
||
},
|
||
},
|
||
},
|
||
},
|
||
},
|
||
},
|
||
RustMapLayer: {
|
||
type: 'object',
|
||
description: 'Whether this viewer gets one map layer, and which audience does. A hidden layer never says what it holds.',
|
||
properties: {
|
||
visible: { type: 'boolean', example: false },
|
||
audience: { $ref: '#/components/schemas/RustAudience' },
|
||
cappedByPresence: {
|
||
type: 'boolean',
|
||
description: 'Players layer only: narrower than its own switch because who may see who is online is narrower (D113).',
|
||
example: true,
|
||
},
|
||
},
|
||
},
|
||
RustMap: {
|
||
type: 'object',
|
||
description: 'One server’s map, as this viewer may see it (GET /public/rust/servers/{id}/map).',
|
||
properties: {
|
||
serverId: { type: 'string', example: 'main' },
|
||
mapKey: { type: 'string', nullable: true, example: '3000.1234.1' },
|
||
picture: {
|
||
type: 'object',
|
||
nullable: true,
|
||
description: 'Null when the game has no picture of its map.',
|
||
properties: {
|
||
path: { type: 'string', description: 'Relative to /api/v1, with the picture’s hash in it.', example: '/public/rust/servers/main/map/image?v=28da6e8a' },
|
||
source: { type: 'string', enum: ['companion', 'rendered'], example: 'companion' },
|
||
fetchedAt: { type: 'string', format: 'date-time', nullable: true },
|
||
},
|
||
},
|
||
geometry: {
|
||
type: 'object',
|
||
nullable: true,
|
||
description: 'How world coordinates reach a pixel: s = (width − 2 × oceanMargin) / worldSize, px = (x + worldSize/2) × s + oceanMargin, and z the same way up from the bottom edge.',
|
||
properties: {
|
||
worldSize: { type: 'integer', example: 3000 },
|
||
oceanMargin: { type: 'integer', description: 'In pixels, unscaled.', example: 500 },
|
||
width: { type: 'integer', example: 2500 },
|
||
height: { type: 'integer', example: 2500 },
|
||
gridCells: { type: 'integer', description: 'Cells per side, from the game’s own grid.', example: 20 },
|
||
gridCellSize: { type: 'number', description: 'Metres.', example: 150 },
|
||
background: { type: 'string', nullable: true, example: '#0B3B4A' },
|
||
},
|
||
},
|
||
monuments: {
|
||
type: 'array',
|
||
description: 'Present only when the viewer may see the world layer.',
|
||
items: {
|
||
type: 'object',
|
||
properties: {
|
||
value: { type: 'string', example: 'harbor_1#2' },
|
||
kind: { type: 'string', example: 'harbor_1' },
|
||
label: { type: 'string', example: 'Harbor' },
|
||
grid: { type: 'string', nullable: true, example: 'O3' },
|
||
x: { type: 'number', example: 678.1 },
|
||
z: { type: 'number', example: 1005.7 },
|
||
},
|
||
},
|
||
},
|
||
layers: {
|
||
type: 'object',
|
||
properties: {
|
||
world: { $ref: '#/components/schemas/RustMapLayer' },
|
||
events: { $ref: '#/components/schemas/RustMapLayer' },
|
||
players: { $ref: '#/components/schemas/RustMapLayer' },
|
||
bases: { $ref: '#/components/schemas/RustMapLayer' },
|
||
},
|
||
},
|
||
mates: {
|
||
type: 'object',
|
||
description: 'Whether this viewer gets their own position and their online clan mates’ (D115).',
|
||
properties: {
|
||
visible: { type: 'boolean', example: true },
|
||
on: { type: 'boolean', description: 'Is the switch on for this server?', example: true },
|
||
linked: { type: 'boolean', description: 'Has this viewer linked a Steam account?', example: true },
|
||
signedIn: { type: 'boolean', description: 'Is this viewer signed in at all?', example: true },
|
||
},
|
||
},
|
||
pollMs: { type: 'integer', example: 10000 },
|
||
},
|
||
},
|
||
RustMapLive: {
|
||
type: 'object',
|
||
description: 'What moves on one server’s map, cut down to this viewer (GET /public/rust/servers/{id}/map/live). A layer the viewer may not see is ABSENT, not empty.',
|
||
properties: {
|
||
live: { type: 'boolean', description: 'False when the game did not answer; `reason` says why.', example: true },
|
||
reason: { type: 'string', nullable: true },
|
||
mapKey: { type: 'string', nullable: true, example: '3000.1234.1' },
|
||
world: {
|
||
type: 'array',
|
||
items: {
|
||
type: 'object',
|
||
properties: {
|
||
kind: { type: 'string', enum: ['cargo', 'heli', 'chinook', 'bradley', 'supply', 'crate'], example: 'cargo' },
|
||
x: { type: 'number', example: 812.4 },
|
||
z: { type: 'number', example: -1320.6 },
|
||
hackLeftSec: { type: 'integer', description: 'A locked crate being hacked: seconds left.', example: 540 },
|
||
hacked: { type: 'boolean', example: false },
|
||
},
|
||
},
|
||
},
|
||
events: {
|
||
type: 'array',
|
||
items: {
|
||
type: 'object',
|
||
properties: {
|
||
kind: { type: 'string', enum: ['zone', 'crate', 'npc'], example: 'zone' },
|
||
runId: { type: 'string', example: '41' },
|
||
x: { type: 'number' },
|
||
z: { type: 'number' },
|
||
radius: { type: 'number', description: 'A zone’s.', example: 60 },
|
||
name: { type: 'string', description: 'A zone’s.', example: 'Harbor brawl' },
|
||
prefab: { type: 'string', description: 'A crate’s or NPC’s allowlist key.', example: 'crate.elite' },
|
||
},
|
||
},
|
||
},
|
||
players: {
|
||
type: 'array',
|
||
items: {
|
||
type: 'object',
|
||
properties: {
|
||
steamId: { type: 'string', example: '76561198000000000' },
|
||
name: { type: 'string', example: 'Wanderer' },
|
||
x: { type: 'number' },
|
||
z: { type: 'number' },
|
||
sleeping: { type: 'boolean', example: false },
|
||
online: { type: 'boolean', example: true },
|
||
},
|
||
},
|
||
},
|
||
playersTruncated: { type: 'boolean', description: 'More sleepers than the plugin’s MapMaxSleepers.' },
|
||
bases: {
|
||
type: 'array',
|
||
description: 'Positions only: no owner, no authorised list, no shop name.',
|
||
items: {
|
||
type: 'object',
|
||
properties: {
|
||
kind: { type: 'string', enum: ['tc', 'vending'], example: 'tc' },
|
||
x: { type: 'number' },
|
||
z: { type: 'number' },
|
||
},
|
||
},
|
||
},
|
||
basesTruncated: { type: 'boolean', description: 'More than the plugin’s MapMaxBases.' },
|
||
mates: {
|
||
type: 'array',
|
||
description: 'The viewer’s own positions (their sleeper too) and their online first-party clan mates on this server.',
|
||
items: {
|
||
type: 'object',
|
||
properties: {
|
||
steamId: { type: 'string' },
|
||
name: { type: 'string' },
|
||
x: { type: 'number' },
|
||
z: { type: 'number' },
|
||
sleeping: { type: 'boolean' },
|
||
online: { type: 'boolean' },
|
||
self: { type: 'boolean', description: 'One of the viewer’s own accounts.' },
|
||
},
|
||
},
|
||
},
|
||
},
|
||
},
|
||
RustClanAudience: {
|
||
type: 'string',
|
||
enum: ['members', 'signed_in', 'public'],
|
||
description: 'Who may see a clan’s roster: the clan’s own members (a website account linked to one of them) and staff, any signed-in account, or anybody. Widening it also shows which members are online to that audience.',
|
||
example: 'members',
|
||
},
|
||
RustClanBoard: {
|
||
type: 'object',
|
||
description: 'Whether a server’s clan list can be trusted right now.',
|
||
properties: {
|
||
supported: { type: 'boolean', description: 'Could the bridge read this server’s clans at all?', example: true },
|
||
enabled: { type: 'boolean', description: 'Is the game’s clan system switched on?', example: true },
|
||
fresh: { type: 'boolean', description: 'Has the board been re-sent within the last three minutes?', example: true },
|
||
truncated: { type: 'boolean', description: 'At the game’s 100-clan ceiling, or too large for one line: there may be clans the list does not show.', example: false },
|
||
reason: { type: 'string', nullable: true, description: 'Why the clans cannot be read, when they cannot.' },
|
||
},
|
||
},
|
||
RustClanList: {
|
||
type: 'object',
|
||
description: 'One server’s clans (GET /public/rust/servers/{id}/clans). Public: nothing here names a player.',
|
||
properties: {
|
||
clans: {
|
||
type: 'array',
|
||
items: {
|
||
type: 'object',
|
||
properties: {
|
||
externalId: { type: 'string', example: 'main:12:1790142840535' },
|
||
name: { type: 'string', example: 'Northwatch' },
|
||
color: { type: 'string', nullable: true, example: '#3fa9f5' },
|
||
score: { type: 'integer', example: 140 },
|
||
memberCount: { type: 'integer', example: 6 },
|
||
maxMembers: { type: 'integer', nullable: true, example: 100 },
|
||
},
|
||
},
|
||
},
|
||
board: { $ref: '#/components/schemas/RustClanBoard' },
|
||
},
|
||
},
|
||
RustClan: {
|
||
type: 'object',
|
||
description: 'One clan (GET /public/rust/clans/{externalId}) and, inside the roster audience, its roster.',
|
||
properties: {
|
||
clan: {
|
||
type: 'object',
|
||
properties: {
|
||
externalId: { type: 'string', example: 'main:12:1790142840535' },
|
||
name: { type: 'string', example: 'Northwatch' },
|
||
color: { type: 'string', nullable: true, example: '#3fa9f5' },
|
||
score: { type: 'integer', example: 140 },
|
||
memberCount: { type: 'integer', example: 6 },
|
||
maxMembers: { type: 'integer', nullable: true, example: 100 },
|
||
serverId: { type: 'string', example: 'main' },
|
||
serverName: { type: 'string', example: 'Main · Vanilla' },
|
||
founded: { type: 'integer', nullable: true, description: 'When the clan was founded, epoch milliseconds.' },
|
||
gone: { type: 'boolean', description: 'The clan has been disbanded, or has left its server’s board.', example: false },
|
||
},
|
||
},
|
||
roster: {
|
||
type: 'object',
|
||
properties: {
|
||
visible: { type: 'boolean', description: 'Is this viewer inside the roster audience? When false, `members` is empty.', example: false },
|
||
audience: { $ref: '#/components/schemas/RustClanAudience' },
|
||
members: {
|
||
type: 'array',
|
||
items: {
|
||
type: 'object',
|
||
properties: {
|
||
name: { type: 'string', nullable: true, example: 'Wanderer' },
|
||
role: { type: 'string', nullable: true, example: 'Leader' },
|
||
leader: { type: 'boolean', example: true },
|
||
online: { type: 'boolean', example: false },
|
||
joined: { type: 'integer', nullable: true, description: 'Epoch milliseconds.' },
|
||
},
|
||
},
|
||
},
|
||
},
|
||
},
|
||
},
|
||
},
|
||
RustVisibilityUpdate: {
|
||
type: 'object',
|
||
description: 'A change to who may see who is online. Either part may be omitted; a server set to null follows the fleet default again.',
|
||
properties: {
|
||
fleet: { $ref: '#/components/schemas/RustAudience' },
|
||
servers: {
|
||
type: 'object',
|
||
additionalProperties: { type: 'string', nullable: true, enum: ['staff', 'signed_in', 'public', null] },
|
||
example: { main: 'public', pvp: null },
|
||
},
|
||
clanRoster: { $ref: '#/components/schemas/RustClanAudience' },
|
||
news: {
|
||
type: 'object',
|
||
description: 'A server id to whether a published news post is said in its in-game chat.',
|
||
additionalProperties: { type: 'boolean' },
|
||
example: { main: true },
|
||
},
|
||
newsDelivery: {
|
||
type: 'object',
|
||
description: 'A server id to where a news post goes on it: `chat` or `popup` (D142).',
|
||
additionalProperties: { type: 'string', enum: ['chat', 'popup'] },
|
||
example: { main: 'popup' },
|
||
},
|
||
map: {
|
||
type: 'object',
|
||
description: 'The live map’s switches. `fleet` maps a layer to an audience and `mates` to true or false; `servers` maps a server id to the same shape, where null follows the fleet.',
|
||
example: { fleet: { players: 'signed_in', mates: true }, servers: { pve: { players: 'public' }, pvp: { players: null } } },
|
||
},
|
||
},
|
||
},
|
||
RustSidecarProbe: {
|
||
type: 'object',
|
||
description: 'What a sidecar said when probed (POST /admin/rust/servers/{id}/test).',
|
||
properties: {
|
||
ok: { type: 'boolean', example: true },
|
||
status: {
|
||
type: 'string',
|
||
description: 'What happened, in one word — this is what tells a wrong URL from a wrong token from a mismatched protocol. One of `ok`, `no-token`, `unauthorized`, `protocol-mismatch`, `timeout`, `transport-error`, or `http-<code>`.',
|
||
example: 'ok',
|
||
},
|
||
sidecar: {
|
||
type: 'object',
|
||
nullable: true,
|
||
description: 'The sidecar’s own health document, or the mismatch detail on a protocol disagreement.',
|
||
properties: {
|
||
status: { type: 'string', example: 'ok' },
|
||
protocol: { type: 'integer', example: 1 },
|
||
plugin_connected: { type: 'boolean', example: true },
|
||
database: { type: 'string', example: 'ok' },
|
||
uptime: { type: 'string', example: '3h 2m' },
|
||
last_event: { type: 'string', format: 'date-time', nullable: true },
|
||
},
|
||
},
|
||
},
|
||
},
|
||
},
|
||
},
|
||
}
|