@rebornteam/reborn-api 2.6.0 → 2.7.0

package/api.ts

@@ -4,7 +4,7 @@
  * Reborn API
  * The Reborn API serves as the central backend for the platform, orchestrating secure communication between game clients and data services. This API supports two authentication methods: - **OAuth 2.0 Client Credentials**: For programmatic API access - **Discord SSO Bearer Token**: For admin endpoints requiring Discord authentication 
  *
- * The version of the OpenAPI document: 2.6.0
+ * The version of the OpenAPI document: 2.7.0
  * 
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -23,6 +23,90 @@ import type { RequestArgs } from './base';
 // @ts-ignore
 import { BASE_PATH, COLLECTION_FORMATS, BaseAPI, RequiredError, operationServerMap } from './base';
 
+/**
+ * Request to apply a punishment to one or more targets
+ */
+export interface AdminApplyPunishmentRequest {
+    /**
+     * List of targets to punish — each must have either a uuid or ipAddress
+     */
+    'targets': Array<AdminPunishmentTarget>;
+    /**
+     * Punishment type
+     */
+    'type': AdminApplyPunishmentRequestTypeEnum;
+    /**
+     * Severity level: 1=Minor, 2=Moderate, 3=Severe, 4=Critical
+     */
+    'severity'?: number;
+    /**
+     * Reason for the punishment
+     */
+    'reason': string;
+    /**
+     * Custom duration in seconds — if omitted the suggested duration for the type and severity is used
+     */
+    'durationSeconds'?: number | null;
+    /**
+     * Force the punishment to be permanent regardless of the target\'s current score
+     */
+    'forcePermanent'?: boolean;
+    /**
+     * Internal notes visible only to administrators — not shown to the punished player
+     */
+    'notes'?: string | null;
+}
+
+export const AdminApplyPunishmentRequestTypeEnum = {
+    Ban: 'BAN',
+    Mute: 'MUTE',
+    Warning: 'WARNING'
+} as const;
+
+export type AdminApplyPunishmentRequestTypeEnum = typeof AdminApplyPunishmentRequestTypeEnum[keyof typeof AdminApplyPunishmentRequestTypeEnum];
+
+/**
+ * Batch punishment apply result — one result per target
+ */
+export interface AdminApplyPunishmentResponse {
+    /**
+     * Ordered list of results, one per target in the request
+     */
+    'results'?: Array<AdminApplyPunishmentResult>;
+}
+/**
+ * Result of applying a punishment to a single target
+ */
+export interface AdminApplyPunishmentResult {
+    /**
+     * The target this result applies to
+     */
+    'target'?: AdminPunishmentTarget;
+    /**
+     * ID of the created punishment record
+     */
+    'punishmentId'?: number;
+    /**
+     * Punishment type applied
+     */
+    'type'?: string;
+    /**
+     * Severity level applied
+     */
+    'severity'?: number;
+    /**
+     * Updated punishment score after applying
+     */
+    'newScore'?: number;
+    /**
+     * Whether the punishment was made permanent
+     */
+    'isPermanent'?: boolean;
+    /**
+     * When the punishment expires — null if permanent or a WARNING
+     */
+    'expiresAt'?: string | null;
+}
 /**
  * Client credential response
  */
@@ -81,6 +165,44 @@ export interface AdminConnectionBypassResponse {
      */
     'createdAt'?: string;
 }
+/**
+ * Request to evaluate the impact of a punishment across one or more targets before applying
+ */
+export interface AdminCreatePunishmentDraftRequest {
+    /**
+     * List of targets to evaluate — each must have either a uuid or ipAddress
+     */
+    'targets': Array<AdminPunishmentTarget>;
+    /**
+     * Punishment type
+     */
+    'type': AdminCreatePunishmentDraftRequestTypeEnum;
+    /**
+     * Severity level: 1=Minor, 2=Moderate, 3=Severe, 4=Critical
+     */
+    'severity'?: number;
+    /**
+     * Reason for the punishment (not used in evaluation, required for apply)
+     */
+    'reason': string;
+    /**
+     * Custom duration in seconds — if omitted the suggested duration for the type and severity is used
+     */
+    'durationSeconds'?: number | null;
+    /**
+     * Force the punishment to be permanent regardless of the target\'s current score
+     */
+    'forcePermanent'?: boolean;
+}
+
+export const AdminCreatePunishmentDraftRequestTypeEnum = {
+    Ban: 'BAN',
+    Mute: 'MUTE',
+    Warning: 'WARNING'
+} as const;
+
+export type AdminCreatePunishmentDraftRequestTypeEnum = typeof AdminCreatePunishmentDraftRequestTypeEnum[keyof typeof AdminCreatePunishmentDraftRequestTypeEnum];
+
 export interface AdminDashboardConnectionResponse {
     'id': number;
     'ipAddress': string;
@@ -98,6 +220,19 @@ export interface AdminGetDashboardStats {
     'totalConnections': number;
     'totalClients': number;
 }
+/**
+ * A single IP address match in a punishment search, with all players ever seen on that IP
+ */
+export interface AdminIpSearchResult {
+    /**
+     * IP address
+     */
+    'ipAddress'?: string;
+    /**
+     * Players ever seen on this IP
+     */
+    'players'?: Array<AdminPlayerSearchResult>;
+}
 /**
  * Paginated connection list response
  */
@@ -155,7 +290,7 @@ export interface AdminPagedPunishmentResponse {
     /**
      * Punishments on the current page
      */
-    'data'?: Array<PunishmentGetPunishmentResponse>;
+    'data'?: Array<AdminPunishmentListItem>;
     /**
      * Total number of punishments matching the filters
      */
@@ -214,6 +349,19 @@ export interface AdminPlayerDetailResponse {
      */
     'usernameHistory'?: Array<AdminUsernameHistoryEntry>;
 }
+/**
+ * Lightweight player reference used in search results and punishment evaluations
+ */
+export interface AdminPlayerSearchResult {
+    /**
+     * Player Minecraft UUID
+     */
+    'uuid'?: string;
+    /**
+     * Most recently seen username, null if never recorded
+     */
+    'username'?: string | null;
+}
 /**
  * Summary of a player record, used in list views
  */
@@ -252,79 +400,137 @@ export interface AdminPlayerSummary {
     'punishmentPointsPercent'?: number;
 }
 /**
- * A single entry in a player\'s username history
+ * Batch punishment draft — one evaluation per target
  */
-export interface AdminUsernameHistoryEntry {
-    /**
-     * The username at this point in time
-     */
-    'username'?: string;
+export interface AdminPunishmentDraftResponse {
     /**
-     * When this username was first observed (ISO-8601)
+     * Ordered list of evaluations, one per target in the request
      */
-    'changedAt'?: string;
+    'evaluations'?: Array<AdminPunishmentEvaluation>;
 }
 /**
- * Request to apply a punishment to a player
+ * Evaluation of a punishment\'s impact on a single target
  */
-export interface ApplyPunishmentRequest {
+export interface AdminPunishmentEvaluation {
     /**
-     * Player UUID to punish
+     * The target this evaluation applies to
      */
-    'playerUuid': string;
+    'target'?: AdminPunishmentTarget;
     /**
-     * Reason for the punishment
+     * Players affected — one player for UUID targets, all players on the IP for connection targets
      */
-    'reason': string;
+    'affectedPlayers'?: Array<AdminPlayerSearchResult>;
     /**
-     * Type of punishment
+     * Current punishment score before applying this punishment (0–100+)
      */
-    'type': string;
+    'currentScore'?: number;
     /**
-     * Severity level of the punishment (1-10)
+     * Points this punishment would add to the score
      */
-    'severity': number;
+    'pointsToAdd'?: number;
     /**
-     * Staff member applying the punishment
+     * Projected score after applying this punishment
      */
-    'createdBy': string;
+    'newScore'?: number;
+    /**
+     * Whether this punishment would be permanent based on the current score threshold
+     */
+    'willBePermanent'?: boolean;
     /**
-     * Duration of the punishment in seconds. Null means permanent.
+     * Resolved duration in seconds — null if permanent or a WARNING
      */
     'durationSeconds'?: number | null;
+    /**
+     * Number of existing punishments on this target
+     */
+    'previousPunishmentCount'?: number;
+    /**
+     * True when the target is an IP address (connection punishment) rather than a player UUID
+     */
+    'isConnectionTarget'?: boolean;
+    /**
+     * The effective punishment type that will be applied — may differ from the requested type if escalated to BAN at threshold
+     */
+    'effectiveType'?: string;
+}
+export interface AdminPunishmentListItem {
+    'id': number;
+    'reason': string;
+    'notes'?: string | null;
+    'type': string;
+    'severity': number;
+    'createdBy': string;
+    'expiresAt'?: string | null;
+    'createdAt': string;
+    'targetType': string;
+    'targetUuid'?: string | null;
+    'targetUsername'?: string | null;
+    'targetIp'?: string | null;
 }
 /**
- * Response after applying a punishment
+ * Result of a punishment target search — either a list of matching players or a list of matching IP addresses
  */
-export interface ApplyPunishmentResponse {
+export interface AdminPunishmentSearchResponse {
     /**
-     * ID of the created punishment
+     * Search kind — \'player\' for UUID/username searches, \'ip\' for IP address searches
      */
-    'punishmentId'?: number;
+    'kind'?: AdminPunishmentSearchResponseKindEnum;
     /**
-     * Player UUID punished
+     * Matching players — only populated when kind=\'player\'
      */
-    'playerUuid'?: string;
+    'players'?: Array<AdminPlayerSearchResult>;
     /**
-     * Type of punishment applied
+     * Matching IP addresses with their associated players — only populated when kind=\'ip\'
      */
-    'type'?: string;
+    'ipResults'?: Array<AdminIpSearchResult>;
+}
+
+export const AdminPunishmentSearchResponseKindEnum = {
+    Player: 'player',
+    Ip: 'ip'
+} as const;
+
+export type AdminPunishmentSearchResponseKindEnum = typeof AdminPunishmentSearchResponseKindEnum[keyof typeof AdminPunishmentSearchResponseKindEnum];
+
+/**
+ * A target for a punishment — either a player UUID or an IP address (mutually exclusive)
+ */
+export interface AdminPunishmentTarget {
     /**
-     * Severity level (1-10)
+     * Player Minecraft UUID
      */
-    'severity'?: number;
+    'uuid'?: string | null;
     /**
-     * New total punishment score after applying
+     * IP address — when specified, the punishment is linked to the connection record and all players on that IP are shown as affected
      */
-    'newScore'?: number;
+    'ipAddress'?: string | null;
+}
+/**
+ * A single entry in a player\'s username history
+ */
+export interface AdminUsernameHistoryEntry {
     /**
-     * Whether this punishment is permanent
+     * The username at this point in time
      */
-    'isPermanent'?: boolean;
+    'username'?: string;
     /**
-     * Timestamp when punishment expires (ISO-8601 format, null if permanent)
+     * When this username was first observed (ISO-8601)
      */
-    'expiresAt'?: string;
+    'changedAt'?: string;
+}
+export interface ChatMessageDTO {
+    'id': number;
+    'sentAt': string;
+    'sessionId': string;
+    'playerUuid': string;
+    'message': string;
+    'channel': string;
+}
+export interface ChatMessageRequest {
+    'sessionId': string;
+    'playerUuid': string;
+    'message': string;
+    'channel'?: string | null;
 }
 /**
  * Request to create new client credentials
@@ -390,31 +596,6 @@ export interface CreateBypassRequest {
      */
     'expiresAtEpoch': number;
 }
-/**
- * Request to create a punishment draft for preview before applying
- */
-export interface CreatePunishmentDraftRequest {
-    /**
-     * Player UUID to punish
-     */
-    'playerUuid': string;
-    /**
-     * Reason for the punishment
-     */
-    'reason': string;
-    /**
-     * Type of punishment
-     */
-    'type': string;
-    /**
-     * Severity level of the punishment (1-10)
-     */
-    'severity': number;
-    /**
-     * Duration of the punishment in seconds. Null means permanent.
-     */
-    'durationSeconds'?: number | null;
-}
 /**
  * Player information including join history, tracking data, and punishment scoring
  */
@@ -436,51 +617,6 @@ export interface PlayerGetPlayerInformation {
      */
     'punishmentPointsPercent'?: number;
 }
-/**
- * Response containing punishment draft preview with calculated points and thresholds
- */
-export interface PunishmentDraftResponse {
-    /**
-     * Player UUID this punishment would apply to
-     */
-    'playerUuid'?: string;
-    /**
-     * Reason for the punishment
-     */
-    'reason'?: string;
-    /**
-     * Type of punishment
-     */
-    'type'?: string;
-    /**
-     * Severity level (1-10)
-     */
-    'severity'?: number;
-    /**
-     * Current total punishment score before applying this punishment
-     */
-    'currentScore'?: number;
-    /**
-     * Points this punishment would add
-     */
-    'pointsToAdd'?: number;
-    /**
-     * New total score after applying this punishment
-     */
-    'newScore'?: number;
-    /**
-     * Whether this punishment will be permanent
-     */
-    'willBePermanent'?: boolean;
-    /**
-     * Duration in seconds (null if permanent)
-     */
-    'durationSeconds'?: number;
-    /**
-     * Number of previous punishments for this player
-     */
-    'previousPunishmentCount'?: number;
-}
 /**
  * Punishment information including reason, type, creator, and expiration
  */
@@ -490,15 +626,19 @@ export interface PunishmentGetPunishmentResponse {
      */
     'id'?: number;
     /**
-     * Reason for the punishment
+     * Reason for the punishment, shown to the punished player
      */
     'reason'?: string;
     /**
-     * Type of punishment (e.g., BAN, MUTE, KICK, WARNING)
+     * Internal administrator notes — not shown to the punished player
+     */
+    'notes'?: string | null;
+    /**
+     * Type of punishment (BAN, MUTE, WARNING)
      */
     'type'?: string;
     /**
-     * Severity level of the punishment (1-10, where 10 is most severe)
+     * Severity level (1=Minor, 2=Moderate, 3=Severe, 4=Critical)
      */
     'severity'?: number;
     /**
@@ -549,6 +689,27 @@ export interface PunishmentSeveritiesResponseSeverityInfo {
      */
     'durationSeconds'?: number;
 }
+export interface ServerRegisterRequest {
+    'region': string;
+    'gameType': string;
+    'containerId'?: string | null;
+}
+export interface ServerSessionDTO {
+    'id': string;
+    'region': string;
+    'gameType': string;
+    'instanceName': string;
+    'containerId'?: string | null;
+    'startedAt': string;
+    'lastHeartbeat': string;
+    'endedAt'?: string | null;
+    'online': boolean;
+}
+export interface TokenRequest {
+    'grant_type'?: string | null;
+    'client_id'?: string | null;
+    'client_secret'?: string | null;
+}
 /**
  * Request to update client metadata
  */
@@ -1733,25 +1894,16 @@ export class AdminPlayersApi extends BaseAPI {
 export const AdminPunishmentsApiAxiosParamCreator = function (configuration?: Configuration) {
     return {
         /**
-         * Returns a paginated list of punishments with optional filtering by player UUID, username, IP address, type, and date range.
-         * @summary List punishments
-         * @param {number} page Page number (1-indexed)
-         * @param {number} limit Page size
-         * @param {string | null} [uuid] Filter by player UUID
-         * @param {string | null} [username] Filter by player username (case-insensitive substring match)
-         * @param {string | null} [ipAddress] Filter by IP address
-         * @param {Array<string> | null} [type] Filter by punishment type (BAN, MUTE, KICK, WARNING). Repeatable.
-         * @param {number | null} [issuedAfter] Filter punishments issued after this epoch timestamp (ms)
-         * @param {number | null} [issuedBefore] Filter punishments issued before this epoch timestamp (ms)
+         * Apply a punishment to one or more targets. Player targets are linked via player_punishment; IP targets are linked via connection_punishment. The authenticated user is recorded as the issuer.
+         * @summary Apply punishment
+         * @param {AdminApplyPunishmentRequest} adminApplyPunishmentRequest 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        getPunishments: async (page: number, limit: number, uuid?: string | null, username?: string | null, ipAddress?: string | null, type?: Array<string> | null, issuedAfter?: number | null, issuedBefore?: number | null, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
-            // verify required parameter 'page' is not null or undefined
-            assertParamExists('getPunishments', 'page', page)
-            // verify required parameter 'limit' is not null or undefined
-            assertParamExists('getPunishments', 'limit', limit)
-            const localVarPath = `/admin/punishment`;
+        applyPunishment: async (adminApplyPunishmentRequest: AdminApplyPunishmentRequest, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'adminApplyPunishmentRequest' is not null or undefined
+            assertParamExists('applyPunishment', 'adminApplyPunishmentRequest', adminApplyPunishmentRequest)
+            const localVarPath = `/admin/punishment/apply`;
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
             let baseOptions;
@@ -1759,7 +1911,7 @@ export const AdminPunishmentsApiAxiosParamCreator = function (configuration?: Co
                 baseOptions = configuration.baseOptions;
             }
 
-            const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+            const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options};
             const localVarHeaderParameter = {} as any;
             const localVarQueryParameter = {} as any;
 
@@ -1767,12 +1919,99 @@ export const AdminPunishmentsApiAxiosParamCreator = function (configuration?: Co
             // http bearer authentication required
             await setBearerAuthToObject(localVarHeaderParameter, configuration)
 
-            if (uuid !== undefined) {
-                localVarQueryParameter['uuid'] = uuid;
-            }
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+            localVarHeaderParameter['Accept'] = 'application/json';
 
-            if (username !== undefined) {
-                localVarQueryParameter['username'] = username;
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+            localVarRequestOptions.data = serializeDataIfNeeded(adminApplyPunishmentRequest, localVarRequestOptions, configuration)
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * Preview the impact of a punishment across one or more targets. Returns current score, points to add, projected new score, and affected players per target. No changes are made.
+         * @summary Evaluate punishment impact
+         * @param {AdminCreatePunishmentDraftRequest} adminCreatePunishmentDraftRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        createDraft: async (adminCreatePunishmentDraftRequest: AdminCreatePunishmentDraftRequest, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'adminCreatePunishmentDraftRequest' is not null or undefined
+            assertParamExists('createDraft', 'adminCreatePunishmentDraftRequest', adminCreatePunishmentDraftRequest)
+            const localVarPath = `/admin/punishment/draft`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+            localVarHeaderParameter['Accept'] = 'application/json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+            localVarRequestOptions.data = serializeDataIfNeeded(adminCreatePunishmentDraftRequest, localVarRequestOptions, configuration)
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * Returns a paginated list of punishments with optional filtering by player UUID, username, IP address, type, and date range.
+         * @summary List punishments
+         * @param {number} page Page number (1-indexed)
+         * @param {number} limit Page size
+         * @param {string | null} [uuid] Filter by player UUID
+         * @param {string | null} [username] Filter by player username (case-insensitive substring match)
+         * @param {string | null} [ipAddress] Filter by IP address
+         * @param {Array<string> | null} [type] Filter by punishment type (BAN, MUTE, WARNING). Repeatable.
+         * @param {number | null} [issuedAfter] Filter punishments issued after this epoch timestamp (ms)
+         * @param {number | null} [issuedBefore] Filter punishments issued before this epoch timestamp (ms)
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getPunishments: async (page: number, limit: number, uuid?: string | null, username?: string | null, ipAddress?: string | null, type?: Array<string> | null, issuedAfter?: number | null, issuedBefore?: number | null, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'page' is not null or undefined
+            assertParamExists('getPunishments', 'page', page)
+            // verify required parameter 'limit' is not null or undefined
+            assertParamExists('getPunishments', 'limit', limit)
+            const localVarPath = `/admin/punishment`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            if (uuid !== undefined) {
+                localVarQueryParameter['uuid'] = uuid;
+            }
+
+            if (username !== undefined) {
+                localVarQueryParameter['username'] = username;
             }
 
             if (ipAddress !== undefined) {
@@ -1805,6 +2044,47 @@ export const AdminPunishmentsApiAxiosParamCreator = function (configuration?: Co
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
 
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * Search for players by UUID or username, or look up all players associated with an IP address. Used to populate the target table before issuing a punishment.
+         * @summary Search punishment targets
+         * @param {string} q UUID, username, or partial/full IP address to search for
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        searchTargets: async (q: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'q' is not null or undefined
+            assertParamExists('searchTargets', 'q', q)
+            const localVarPath = `/admin/punishment/search`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            if (q !== undefined) {
+                localVarQueryParameter['q'] = q;
+            }
+
+            localVarHeaderParameter['Accept'] = 'application/json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
             return {
                 url: toPathString(localVarUrlObj),
                 options: localVarRequestOptions,
@@ -1819,6 +2099,32 @@ export const AdminPunishmentsApiAxiosParamCreator = function (configuration?: Co
 export const AdminPunishmentsApiFp = function(configuration?: Configuration) {
     const localVarAxiosParamCreator = AdminPunishmentsApiAxiosParamCreator(configuration)
     return {
+        /**
+         * Apply a punishment to one or more targets. Player targets are linked via player_punishment; IP targets are linked via connection_punishment. The authenticated user is recorded as the issuer.
+         * @summary Apply punishment
+         * @param {AdminApplyPunishmentRequest} adminApplyPunishmentRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async applyPunishment(adminApplyPunishmentRequest: AdminApplyPunishmentRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminApplyPunishmentResponse>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.applyPunishment(adminApplyPunishmentRequest, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['AdminPunishmentsApi.applyPunishment']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * Preview the impact of a punishment across one or more targets. Returns current score, points to add, projected new score, and affected players per target. No changes are made.
+         * @summary Evaluate punishment impact
+         * @param {AdminCreatePunishmentDraftRequest} adminCreatePunishmentDraftRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async createDraft(adminCreatePunishmentDraftRequest: AdminCreatePunishmentDraftRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminPunishmentDraftResponse>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.createDraft(adminCreatePunishmentDraftRequest, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['AdminPunishmentsApi.createDraft']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
         /**
          * Returns a paginated list of punishments with optional filtering by player UUID, username, IP address, type, and date range.
          * @summary List punishments
@@ -1827,7 +2133,7 @@ export const AdminPunishmentsApiFp = function(configuration?: Configuration) {
          * @param {string | null} [uuid] Filter by player UUID
          * @param {string | null} [username] Filter by player username (case-insensitive substring match)
          * @param {string | null} [ipAddress] Filter by IP address
-         * @param {Array<string> | null} [type] Filter by punishment type (BAN, MUTE, KICK, WARNING). Repeatable.
+         * @param {Array<string> | null} [type] Filter by punishment type (BAN, MUTE, WARNING). Repeatable.
          * @param {number | null} [issuedAfter] Filter punishments issued after this epoch timestamp (ms)
          * @param {number | null} [issuedBefore] Filter punishments issued before this epoch timestamp (ms)
          * @param {*} [options] Override http request option.
@@ -1839,6 +2145,19 @@ export const AdminPunishmentsApiFp = function(configuration?: Configuration) {
             const localVarOperationServerBasePath = operationServerMap['AdminPunishmentsApi.getPunishments']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
+        /**
+         * Search for players by UUID or username, or look up all players associated with an IP address. Used to populate the target table before issuing a punishment.
+         * @summary Search punishment targets
+         * @param {string} q UUID, username, or partial/full IP address to search for
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async searchTargets(q: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AdminPunishmentSearchResponse>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.searchTargets(q, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['AdminPunishmentsApi.searchTargets']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
     }
 };
 
@@ -1848,6 +2167,26 @@ export const AdminPunishmentsApiFp = function(configuration?: Configuration) {
 export const AdminPunishmentsApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
     const localVarFp = AdminPunishmentsApiFp(configuration)
     return {
+        /**
+         * Apply a punishment to one or more targets. Player targets are linked via player_punishment; IP targets are linked via connection_punishment. The authenticated user is recorded as the issuer.
+         * @summary Apply punishment
+         * @param {AdminApplyPunishmentRequest} adminApplyPunishmentRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        applyPunishment(adminApplyPunishmentRequest: AdminApplyPunishmentRequest, options?: RawAxiosRequestConfig): AxiosPromise<AdminApplyPunishmentResponse> {
+            return localVarFp.applyPunishment(adminApplyPunishmentRequest, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Preview the impact of a punishment across one or more targets. Returns current score, points to add, projected new score, and affected players per target. No changes are made.
+         * @summary Evaluate punishment impact
+         * @param {AdminCreatePunishmentDraftRequest} adminCreatePunishmentDraftRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        createDraft(adminCreatePunishmentDraftRequest: AdminCreatePunishmentDraftRequest, options?: RawAxiosRequestConfig): AxiosPromise<AdminPunishmentDraftResponse> {
+            return localVarFp.createDraft(adminCreatePunishmentDraftRequest, options).then((request) => request(axios, basePath));
+        },
         /**
          * Returns a paginated list of punishments with optional filtering by player UUID, username, IP address, type, and date range.
          * @summary List punishments
@@ -1856,7 +2195,7 @@ export const AdminPunishmentsApiFactory = function (configuration?: Configuratio
          * @param {string | null} [uuid] Filter by player UUID
          * @param {string | null} [username] Filter by player username (case-insensitive substring match)
          * @param {string | null} [ipAddress] Filter by IP address
-         * @param {Array<string> | null} [type] Filter by punishment type (BAN, MUTE, KICK, WARNING). Repeatable.
+         * @param {Array<string> | null} [type] Filter by punishment type (BAN, MUTE, WARNING). Repeatable.
          * @param {number | null} [issuedAfter] Filter punishments issued after this epoch timestamp (ms)
          * @param {number | null} [issuedBefore] Filter punishments issued before this epoch timestamp (ms)
          * @param {*} [options] Override http request option.
@@ -1865,6 +2204,16 @@ export const AdminPunishmentsApiFactory = function (configuration?: Configuratio
         getPunishments(page: number, limit: number, uuid?: string | null, username?: string | null, ipAddress?: string | null, type?: Array<string> | null, issuedAfter?: number | null, issuedBefore?: number | null, options?: RawAxiosRequestConfig): AxiosPromise<AdminPagedPunishmentResponse> {
             return localVarFp.getPunishments(page, limit, uuid, username, ipAddress, type, issuedAfter, issuedBefore, options).then((request) => request(axios, basePath));
         },
+        /**
+         * Search for players by UUID or username, or look up all players associated with an IP address. Used to populate the target table before issuing a punishment.
+         * @summary Search punishment targets
+         * @param {string} q UUID, username, or partial/full IP address to search for
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        searchTargets(q: string, options?: RawAxiosRequestConfig): AxiosPromise<AdminPunishmentSearchResponse> {
+            return localVarFp.searchTargets(q, options).then((request) => request(axios, basePath));
+        },
     };
 };
 
@@ -1872,6 +2221,28 @@ export const AdminPunishmentsApiFactory = function (configuration?: Configuratio
  * AdminPunishmentsApi - object-oriented interface
  */
 export class AdminPunishmentsApi extends BaseAPI {
+    /**
+     * Apply a punishment to one or more targets. Player targets are linked via player_punishment; IP targets are linked via connection_punishment. The authenticated user is recorded as the issuer.
+     * @summary Apply punishment
+     * @param {AdminApplyPunishmentRequest} adminApplyPunishmentRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public applyPunishment(adminApplyPunishmentRequest: AdminApplyPunishmentRequest, options?: RawAxiosRequestConfig) {
+        return AdminPunishmentsApiFp(this.configuration).applyPunishment(adminApplyPunishmentRequest, options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * Preview the impact of a punishment across one or more targets. Returns current score, points to add, projected new score, and affected players per target. No changes are made.
+     * @summary Evaluate punishment impact
+     * @param {AdminCreatePunishmentDraftRequest} adminCreatePunishmentDraftRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public createDraft(adminCreatePunishmentDraftRequest: AdminCreatePunishmentDraftRequest, options?: RawAxiosRequestConfig) {
+        return AdminPunishmentsApiFp(this.configuration).createDraft(adminCreatePunishmentDraftRequest, options).then((request) => request(this.axios, this.basePath));
+    }
+
     /**
      * Returns a paginated list of punishments with optional filtering by player UUID, username, IP address, type, and date range.
      * @summary List punishments
@@ -1880,7 +2251,7 @@ export class AdminPunishmentsApi extends BaseAPI {
      * @param {string | null} [uuid] Filter by player UUID
      * @param {string | null} [username] Filter by player username (case-insensitive substring match)
      * @param {string | null} [ipAddress] Filter by IP address
-     * @param {Array<string> | null} [type] Filter by punishment type (BAN, MUTE, KICK, WARNING). Repeatable.
+     * @param {Array<string> | null} [type] Filter by punishment type (BAN, MUTE, WARNING). Repeatable.
      * @param {number | null} [issuedAfter] Filter punishments issued after this epoch timestamp (ms)
      * @param {number | null} [issuedBefore] Filter punishments issued before this epoch timestamp (ms)
      * @param {*} [options] Override http request option.
@@ -1889,31 +2260,36 @@ export class AdminPunishmentsApi extends BaseAPI {
     public getPunishments(page: number, limit: number, uuid?: string | null, username?: string | null, ipAddress?: string | null, type?: Array<string> | null, issuedAfter?: number | null, issuedBefore?: number | null, options?: RawAxiosRequestConfig) {
         return AdminPunishmentsApiFp(this.configuration).getPunishments(page, limit, uuid, username, ipAddress, type, issuedAfter, issuedBefore, options).then((request) => request(this.axios, this.basePath));
     }
+
+    /**
+     * Search for players by UUID or username, or look up all players associated with an IP address. Used to populate the target table before issuing a punishment.
+     * @summary Search punishment targets
+     * @param {string} q UUID, username, or partial/full IP address to search for
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public searchTargets(q: string, options?: RawAxiosRequestConfig) {
+        return AdminPunishmentsApiFp(this.configuration).searchTargets(q, options).then((request) => request(this.axios, this.basePath));
+    }
 }
 
 
 
 /**
- * ConnectionApi - axios parameter creator
+ * AuthenticationApi - axios parameter creator
  */
-export const ConnectionApiAxiosParamCreator = function (configuration?: Configuration) {
+export const AuthenticationApiAxiosParamCreator = function (configuration?: Configuration) {
     return {
         /**
-         * Performs comprehensive analysis of an IPv4 address to detect VPN, proxy, or suspicious connections.  **Features:** - Multi-provider VPN/proxy detection with aggregated confidence scoring - Approximate geolocation lookup (city and country) - Connection bypass status and expiration tracking - Optional player UUID association for connection history  **Use Cases:** - Prevent VPN/proxy usage during player authentication - Track player connection history across sessions - Implement temporary bypass systems for false positives - Monitor suspicious connection patterns  **Query Parameters:** - `force_recheck`: Bypass cache and re-run all detection services - `associate_uuid`: Link this IP to a player UUID and return player info  **Caching:** Results are cached unless `force_recheck=true` is specified, reducing API costs and improving response times. 
-         * @summary Check Connection and Detect VPN/Proxy
-         * @param {string} ip IPv4 address to analyze for VPN/proxy detection and geolocation
-         * @param {boolean} forceRecheck When true, bypasses cached results and re-runs all VPN detection services. Use this when you need the most up-to-date analysis or suspect cached data may be stale. Default: false 
-         * @param {string | null} [associateUuid] Minecraft player UUID to associate with this IP address. When provided, the API will: - Link this connection to the player\&#39;s history - Update the player\&#39;s username from Mojang API - Return player information (first join status, first login time) in the response - Track connection history for fraud detection  This operation is asynchronous and won\&#39;t block the response. 
+         * Receives the authorization code from Discord after the user approves the OAuth2 prompt. Exchanges the code for an access token, verifies the user holds an admin guild role, then redirects back to the admin frontend with a signed JWT in the query string (`?token=...`). On failure, redirects with `?error=<reason>` instead. 
+         * @summary Discord - OAuth2 callback
+         * @param {string | null} [code] Authorization code provided by Discord on successful approval
+         * @param {string | null} [error] Error code provided by Discord if the user denied access
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        getConnectionDetails: async (ip: string, forceRecheck: boolean, associateUuid?: string | null, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
-            // verify required parameter 'ip' is not null or undefined
-            assertParamExists('getConnectionDetails', 'ip', ip)
-            // verify required parameter 'forceRecheck' is not null or undefined
-            assertParamExists('getConnectionDetails', 'forceRecheck', forceRecheck)
-            const localVarPath = `/v1/connection/get-connection-details/{ip}`
-                .replace(`{${"ip"}}`, encodeURIComponent(String(ip)));
+        callback: async (code?: string | null, error?: string | null, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            const localVarPath = `/auth/discord/callback`;
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
             let baseOptions;
@@ -1929,15 +2305,14 @@ export const ConnectionApiAxiosParamCreator = function (configuration?: Configur
             // http bearer authentication required
             await setBearerAuthToObject(localVarHeaderParameter, configuration)
 
-            if (forceRecheck !== undefined) {
-                localVarQueryParameter['force_recheck'] = forceRecheck;
+            if (code !== undefined) {
+                localVarQueryParameter['code'] = code;
             }
 
-            if (associateUuid !== undefined) {
-                localVarQueryParameter['associate_uuid'] = associateUuid;
+            if (error !== undefined) {
+                localVarQueryParameter['error'] = error;
             }
 
-            localVarHeaderParameter['Accept'] = 'application/json';
 
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
@@ -1948,88 +2323,14 @@ export const ConnectionApiAxiosParamCreator = function (configuration?: Configur
                 options: localVarRequestOptions,
             };
         },
-    }
-};
-
-/**
- * ConnectionApi - functional programming interface
- */
-export const ConnectionApiFp = function(configuration?: Configuration) {
-    const localVarAxiosParamCreator = ConnectionApiAxiosParamCreator(configuration)
-    return {
-        /**
-         * Performs comprehensive analysis of an IPv4 address to detect VPN, proxy, or suspicious connections.  **Features:** - Multi-provider VPN/proxy detection with aggregated confidence scoring - Approximate geolocation lookup (city and country) - Connection bypass status and expiration tracking - Optional player UUID association for connection history  **Use Cases:** - Prevent VPN/proxy usage during player authentication - Track player connection history across sessions - Implement temporary bypass systems for false positives - Monitor suspicious connection patterns  **Query Parameters:** - `force_recheck`: Bypass cache and re-run all detection services - `associate_uuid`: Link this IP to a player UUID and return player info  **Caching:** Results are cached unless `force_recheck=true` is specified, reducing API costs and improving response times. 
-         * @summary Check Connection and Detect VPN/Proxy
-         * @param {string} ip IPv4 address to analyze for VPN/proxy detection and geolocation
-         * @param {boolean} forceRecheck When true, bypasses cached results and re-runs all VPN detection services. Use this when you need the most up-to-date analysis or suspect cached data may be stale. Default: false 
-         * @param {string | null} [associateUuid] Minecraft player UUID to associate with this IP address. When provided, the API will: - Link this connection to the player\&#39;s history - Update the player\&#39;s username from Mojang API - Return player information (first join status, first login time) in the response - Track connection history for fraud detection  This operation is asynchronous and won\&#39;t block the response. 
-         * @param {*} [options] Override http request option.
-         * @throws {RequiredError}
-         */
-        async getConnectionDetails(ip: string, forceRecheck: boolean, associateUuid?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ConnectionGetConnectionDetailsResponse>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.getConnectionDetails(ip, forceRecheck, associateUuid, options);
-            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
-            const localVarOperationServerBasePath = operationServerMap['ConnectionApi.getConnectionDetails']?.[localVarOperationServerIndex]?.url;
-            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
-        },
-    }
-};
-
-/**
- * ConnectionApi - factory interface
- */
-export const ConnectionApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
-    const localVarFp = ConnectionApiFp(configuration)
-    return {
-        /**
-         * Performs comprehensive analysis of an IPv4 address to detect VPN, proxy, or suspicious connections.  **Features:** - Multi-provider VPN/proxy detection with aggregated confidence scoring - Approximate geolocation lookup (city and country) - Connection bypass status and expiration tracking - Optional player UUID association for connection history  **Use Cases:** - Prevent VPN/proxy usage during player authentication - Track player connection history across sessions - Implement temporary bypass systems for false positives - Monitor suspicious connection patterns  **Query Parameters:** - `force_recheck`: Bypass cache and re-run all detection services - `associate_uuid`: Link this IP to a player UUID and return player info  **Caching:** Results are cached unless `force_recheck=true` is specified, reducing API costs and improving response times. 
-         * @summary Check Connection and Detect VPN/Proxy
-         * @param {string} ip IPv4 address to analyze for VPN/proxy detection and geolocation
-         * @param {boolean} forceRecheck When true, bypasses cached results and re-runs all VPN detection services. Use this when you need the most up-to-date analysis or suspect cached data may be stale. Default: false 
-         * @param {string | null} [associateUuid] Minecraft player UUID to associate with this IP address. When provided, the API will: - Link this connection to the player\&#39;s history - Update the player\&#39;s username from Mojang API - Return player information (first join status, first login time) in the response - Track connection history for fraud detection  This operation is asynchronous and won\&#39;t block the response. 
-         * @param {*} [options] Override http request option.
-         * @throws {RequiredError}
-         */
-        getConnectionDetails(ip: string, forceRecheck: boolean, associateUuid?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<ConnectionGetConnectionDetailsResponse> {
-            return localVarFp.getConnectionDetails(ip, forceRecheck, associateUuid, options).then((request) => request(axios, basePath));
-        },
-    };
-};
-
-/**
- * ConnectionApi - object-oriented interface
- */
-export class ConnectionApi extends BaseAPI {
-    /**
-     * Performs comprehensive analysis of an IPv4 address to detect VPN, proxy, or suspicious connections.  **Features:** - Multi-provider VPN/proxy detection with aggregated confidence scoring - Approximate geolocation lookup (city and country) - Connection bypass status and expiration tracking - Optional player UUID association for connection history  **Use Cases:** - Prevent VPN/proxy usage during player authentication - Track player connection history across sessions - Implement temporary bypass systems for false positives - Monitor suspicious connection patterns  **Query Parameters:** - `force_recheck`: Bypass cache and re-run all detection services - `associate_uuid`: Link this IP to a player UUID and return player info  **Caching:** Results are cached unless `force_recheck=true` is specified, reducing API costs and improving response times. 
-     * @summary Check Connection and Detect VPN/Proxy
-     * @param {string} ip IPv4 address to analyze for VPN/proxy detection and geolocation
-     * @param {boolean} forceRecheck When true, bypasses cached results and re-runs all VPN detection services. Use this when you need the most up-to-date analysis or suspect cached data may be stale. Default: false 
-     * @param {string | null} [associateUuid] Minecraft player UUID to associate with this IP address. When provided, the API will: - Link this connection to the player\&#39;s history - Update the player\&#39;s username from Mojang API - Return player information (first join status, first login time) in the response - Track connection history for fraud detection  This operation is asynchronous and won\&#39;t block the response. 
-     * @param {*} [options] Override http request option.
-     * @throws {RequiredError}
-     */
-    public getConnectionDetails(ip: string, forceRecheck: boolean, associateUuid?: string | null, options?: RawAxiosRequestConfig) {
-        return ConnectionApiFp(this.configuration).getConnectionDetails(ip, forceRecheck, associateUuid, options).then((request) => request(this.axios, this.basePath));
-    }
-}
-
-
-
-/**
- * DefaultApi - axios parameter creator
- */
-export const DefaultApiAxiosParamCreator = function (configuration?: Configuration) {
-    return {
         /**
-         * 
-         * @param {string | null} [code] 
-         * @param {string | null} [error] 
+         * Redirects the browser to Discord\'s OAuth2 authorization page. Not called directly — the admin frontend navigates to this URL to begin the login flow.
+         * @summary Discord - Initiate login
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        callback: async (code?: string | null, error?: string | null, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
-            const localVarPath = `/auth/discord/callback`;
+        initiateLogin: async (options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            const localVarPath = `/auth/discord`;
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
             let baseOptions;
@@ -2045,15 +2346,6 @@ export const DefaultApiAxiosParamCreator = function (configuration?: Configurati
             // http bearer authentication required
             await setBearerAuthToObject(localVarHeaderParameter, configuration)
 
-            if (code !== undefined) {
-                localVarQueryParameter['code'] = code;
-            }
-
-            if (error !== undefined) {
-                localVarQueryParameter['error'] = error;
-            }
-
-            localVarHeaderParameter['Accept'] = 'application/json';
 
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
@@ -2065,12 +2357,16 @@ export const DefaultApiAxiosParamCreator = function (configuration?: Configurati
             };
         },
         /**
-         * 
+         * Exchange service client credentials for a Bearer JWT using the OAuth2 client_credentials grant. Used by game server plugins to authenticate against the API.
+         * @summary Service - Exchange client credentials for token
+         * @param {string | null} [grantType] 
+         * @param {string | null} [clientId] 
+         * @param {string | null} [clientSecret] 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        initiateLogin: async (options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
-            const localVarPath = `/auth/discord`;
+        token: async (grantType?: string | null, clientId?: string | null, clientSecret?: string | null, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            const localVarPath = `/oauth/token`;
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
             let baseOptions;
@@ -2078,19 +2374,34 @@ export const DefaultApiAxiosParamCreator = function (configuration?: Configurati
                 baseOptions = configuration.baseOptions;
             }
 
-            const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+            const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options};
             const localVarHeaderParameter = {} as any;
             const localVarQueryParameter = {} as any;
+            const localVarFormParams = new URLSearchParams();
 
             // authentication DiscordAuth required
             // http bearer authentication required
             await setBearerAuthToObject(localVarHeaderParameter, configuration)
 
+
+            if (grantType !== undefined) { 
+                localVarFormParams.set('grant_type', grantType as any);
+            }
+
+            if (clientId !== undefined) { 
+                localVarFormParams.set('client_id', clientId as any);
+            }
+
+            if (clientSecret !== undefined) { 
+                localVarFormParams.set('client_secret', clientSecret as any);
+            }
+            localVarHeaderParameter['Content-Type'] = 'application/x-www-form-urlencoded';
             localVarHeaderParameter['Accept'] = 'application/json';
 
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+            localVarRequestOptions.data = localVarFormParams.toString();
 
             return {
                 url: toPathString(localVarUrlObj),
@@ -2101,109 +2412,156 @@ export const DefaultApiAxiosParamCreator = function (configuration?: Configurati
 };
 
 /**
- * DefaultApi - functional programming interface
+ * AuthenticationApi - functional programming interface
  */
-export const DefaultApiFp = function(configuration?: Configuration) {
-    const localVarAxiosParamCreator = DefaultApiAxiosParamCreator(configuration)
+export const AuthenticationApiFp = function(configuration?: Configuration) {
+    const localVarAxiosParamCreator = AuthenticationApiAxiosParamCreator(configuration)
     return {
         /**
-         * 
-         * @param {string | null} [code] 
-         * @param {string | null} [error] 
+         * Receives the authorization code from Discord after the user approves the OAuth2 prompt. Exchanges the code for an access token, verifies the user holds an admin guild role, then redirects back to the admin frontend with a signed JWT in the query string (`?token=...`). On failure, redirects with `?error=<reason>` instead. 
+         * @summary Discord - OAuth2 callback
+         * @param {string | null} [code] Authorization code provided by Discord on successful approval
+         * @param {string | null} [error] Error code provided by Discord if the user denied access
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        async callback(code?: string | null, error?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<object>> {
+        async callback(code?: string | null, error?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>> {
             const localVarAxiosArgs = await localVarAxiosParamCreator.callback(code, error, options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
-            const localVarOperationServerBasePath = operationServerMap['DefaultApi.callback']?.[localVarOperationServerIndex]?.url;
+            const localVarOperationServerBasePath = operationServerMap['AuthenticationApi.callback']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * 
+         * Redirects the browser to Discord\'s OAuth2 authorization page. Not called directly — the admin frontend navigates to this URL to begin the login flow.
+         * @summary Discord - Initiate login
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        async initiateLogin(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<object>> {
+        async initiateLogin(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>> {
             const localVarAxiosArgs = await localVarAxiosParamCreator.initiateLogin(options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
-            const localVarOperationServerBasePath = operationServerMap['DefaultApi.initiateLogin']?.[localVarOperationServerIndex]?.url;
+            const localVarOperationServerBasePath = operationServerMap['AuthenticationApi.initiateLogin']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * Exchange service client credentials for a Bearer JWT using the OAuth2 client_credentials grant. Used by game server plugins to authenticate against the API.
+         * @summary Service - Exchange client credentials for token
+         * @param {string | null} [grantType] 
+         * @param {string | null} [clientId] 
+         * @param {string | null} [clientSecret] 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async token(grantType?: string | null, clientId?: string | null, clientSecret?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<object>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.token(grantType, clientId, clientSecret, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['AuthenticationApi.token']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
     }
 };
 
 /**
- * DefaultApi - factory interface
+ * AuthenticationApi - factory interface
  */
-export const DefaultApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
-    const localVarFp = DefaultApiFp(configuration)
+export const AuthenticationApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
+    const localVarFp = AuthenticationApiFp(configuration)
     return {
         /**
-         * 
-         * @param {string | null} [code] 
-         * @param {string | null} [error] 
+         * Receives the authorization code from Discord after the user approves the OAuth2 prompt. Exchanges the code for an access token, verifies the user holds an admin guild role, then redirects back to the admin frontend with a signed JWT in the query string (`?token=...`). On failure, redirects with `?error=<reason>` instead. 
+         * @summary Discord - OAuth2 callback
+         * @param {string | null} [code] Authorization code provided by Discord on successful approval
+         * @param {string | null} [error] Error code provided by Discord if the user denied access
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        callback(code?: string | null, error?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<object> {
+        callback(code?: string | null, error?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<void> {
             return localVarFp.callback(code, error, options).then((request) => request(axios, basePath));
         },
         /**
-         * 
+         * Redirects the browser to Discord\'s OAuth2 authorization page. Not called directly — the admin frontend navigates to this URL to begin the login flow.
+         * @summary Discord - Initiate login
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        initiateLogin(options?: RawAxiosRequestConfig): AxiosPromise<object> {
+        initiateLogin(options?: RawAxiosRequestConfig): AxiosPromise<void> {
             return localVarFp.initiateLogin(options).then((request) => request(axios, basePath));
         },
+        /**
+         * Exchange service client credentials for a Bearer JWT using the OAuth2 client_credentials grant. Used by game server plugins to authenticate against the API.
+         * @summary Service - Exchange client credentials for token
+         * @param {string | null} [grantType] 
+         * @param {string | null} [clientId] 
+         * @param {string | null} [clientSecret] 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        token(grantType?: string | null, clientId?: string | null, clientSecret?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<object> {
+            return localVarFp.token(grantType, clientId, clientSecret, options).then((request) => request(axios, basePath));
+        },
     };
 };
 
 /**
- * DefaultApi - object-oriented interface
+ * AuthenticationApi - object-oriented interface
  */
-export class DefaultApi extends BaseAPI {
+export class AuthenticationApi extends BaseAPI {
     /**
-     * 
-     * @param {string | null} [code] 
-     * @param {string | null} [error] 
+     * Receives the authorization code from Discord after the user approves the OAuth2 prompt. Exchanges the code for an access token, verifies the user holds an admin guild role, then redirects back to the admin frontend with a signed JWT in the query string (`?token=...`). On failure, redirects with `?error=<reason>` instead. 
+     * @summary Discord - OAuth2 callback
+     * @param {string | null} [code] Authorization code provided by Discord on successful approval
+     * @param {string | null} [error] Error code provided by Discord if the user denied access
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
     public callback(code?: string | null, error?: string | null, options?: RawAxiosRequestConfig) {
-        return DefaultApiFp(this.configuration).callback(code, error, options).then((request) => request(this.axios, this.basePath));
+        return AuthenticationApiFp(this.configuration).callback(code, error, options).then((request) => request(this.axios, this.basePath));
     }
 
     /**
-     * 
+     * Redirects the browser to Discord\'s OAuth2 authorization page. Not called directly — the admin frontend navigates to this URL to begin the login flow.
+     * @summary Discord - Initiate login
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
     public initiateLogin(options?: RawAxiosRequestConfig) {
-        return DefaultApiFp(this.configuration).initiateLogin(options).then((request) => request(this.axios, this.basePath));
+        return AuthenticationApiFp(this.configuration).initiateLogin(options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * Exchange service client credentials for a Bearer JWT using the OAuth2 client_credentials grant. Used by game server plugins to authenticate against the API.
+     * @summary Service - Exchange client credentials for token
+     * @param {string | null} [grantType] 
+     * @param {string | null} [clientId] 
+     * @param {string | null} [clientSecret] 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public token(grantType?: string | null, clientId?: string | null, clientSecret?: string | null, options?: RawAxiosRequestConfig) {
+        return AuthenticationApiFp(this.configuration).token(grantType, clientId, clientSecret, options).then((request) => request(this.axios, this.basePath));
     }
 }
 
 
 
 /**
- * PlayerApi - axios parameter creator
+ * ChatApi - axios parameter creator
  */
-export const PlayerApiAxiosParamCreator = function (configuration?: Configuration) {
+export const ChatApiAxiosParamCreator = function (configuration?: Configuration) {
     return {
         /**
-         * Retrieves player information by their Minecraft UUID. Returns whether this is the player\'s first join and their first login timestamp. This endpoint is useful for tracking player join history and implementing first-join rewards or tutorials. 
-         * @summary Get Player Information
-         * @param {string} uuid The Minecraft player UUID (with or without dashes)
+         * Returns up to `limit` chat messages before the given `before` timestamp (keyset pagination). Results are returned in ascending chronological order. Omit `before` to start from the current time. Scroll back through history by passing the `sentAt` of the oldest message received as the next `before` value. 
+         * @summary Get chat history
+         * @param {number} limit Maximum number of messages to return (1–100)
+         * @param {string | null} [sessionId] Filter to a specific server session. Omit for global history.
+         * @param {string | null} [before] ISO-8601 timestamp cursor — return messages sent before this time. Omit to start from now.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        getPlayer1: async (uuid: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
-            // verify required parameter 'uuid' is not null or undefined
-            assertParamExists('getPlayer1', 'uuid', uuid)
-            const localVarPath = `/v1/player/{uuid}`
-                .replace(`{${"uuid"}}`, encodeURIComponent(String(uuid)));
+        history: async (limit: number, sessionId?: string | null, before?: string | null, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'limit' is not null or undefined
+            assertParamExists('history', 'limit', limit)
+            const localVarPath = `/v1/chat`;
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
             let baseOptions;
@@ -2219,11 +2577,62 @@ export const PlayerApiAxiosParamCreator = function (configuration?: Configuratio
             // http bearer authentication required
             await setBearerAuthToObject(localVarHeaderParameter, configuration)
 
+            if (sessionId !== undefined) {
+                localVarQueryParameter['sessionId'] = sessionId;
+            }
+
+            if (before !== undefined) {
+                localVarQueryParameter['before'] = before;
+            }
+
+            if (limit !== undefined) {
+                localVarQueryParameter['limit'] = limit;
+            }
+
+            localVarHeaderParameter['Accept'] = 'application/json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * Stores a chat message from a game server and fans it out to all connected WebSocket clients via PostgreSQL LISTEN/NOTIFY. The session must be currently online. Only the player UUID is stored — usernames are resolved on the web UI from the player database cache. 
+         * @summary Ingest a chat message
+         * @param {ChatMessageRequest} chatMessageRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        ingest: async (chatMessageRequest: ChatMessageRequest, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'chatMessageRequest' is not null or undefined
+            assertParamExists('ingest', 'chatMessageRequest', chatMessageRequest)
+            const localVarPath = `/v1/chat`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json';
 
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+            localVarRequestOptions.data = serializeDataIfNeeded(chatMessageRequest, localVarRequestOptions, configuration)
 
             return {
                 url: toPathString(localVarUrlObj),
@@ -2234,80 +2643,244 @@ export const PlayerApiAxiosParamCreator = function (configuration?: Configuratio
 };
 
 /**
- * PlayerApi - functional programming interface
+ * ChatApi - functional programming interface
  */
-export const PlayerApiFp = function(configuration?: Configuration) {
-    const localVarAxiosParamCreator = PlayerApiAxiosParamCreator(configuration)
+export const ChatApiFp = function(configuration?: Configuration) {
+    const localVarAxiosParamCreator = ChatApiAxiosParamCreator(configuration)
     return {
         /**
-         * Retrieves player information by their Minecraft UUID. Returns whether this is the player\'s first join and their first login timestamp. This endpoint is useful for tracking player join history and implementing first-join rewards or tutorials. 
-         * @summary Get Player Information
-         * @param {string} uuid The Minecraft player UUID (with or without dashes)
+         * Returns up to `limit` chat messages before the given `before` timestamp (keyset pagination). Results are returned in ascending chronological order. Omit `before` to start from the current time. Scroll back through history by passing the `sentAt` of the oldest message received as the next `before` value. 
+         * @summary Get chat history
+         * @param {number} limit Maximum number of messages to return (1–100)
+         * @param {string | null} [sessionId] Filter to a specific server session. Omit for global history.
+         * @param {string | null} [before] ISO-8601 timestamp cursor — return messages sent before this time. Omit to start from now.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        async getPlayer1(uuid: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PlayerGetPlayerInformation>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.getPlayer1(uuid, options);
+        async history(limit: number, sessionId?: string | null, before?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<ChatMessageDTO>>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.history(limit, sessionId, before, options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
-            const localVarOperationServerBasePath = operationServerMap['PlayerApi.getPlayer1']?.[localVarOperationServerIndex]?.url;
+            const localVarOperationServerBasePath = operationServerMap['ChatApi.history']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * Stores a chat message from a game server and fans it out to all connected WebSocket clients via PostgreSQL LISTEN/NOTIFY. The session must be currently online. Only the player UUID is stored — usernames are resolved on the web UI from the player database cache. 
+         * @summary Ingest a chat message
+         * @param {ChatMessageRequest} chatMessageRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async ingest(chatMessageRequest: ChatMessageRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ChatMessageDTO>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.ingest(chatMessageRequest, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['ChatApi.ingest']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
     }
 };
 
 /**
- * PlayerApi - factory interface
+ * ChatApi - factory interface
  */
-export const PlayerApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
-    const localVarFp = PlayerApiFp(configuration)
+export const ChatApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
+    const localVarFp = ChatApiFp(configuration)
     return {
         /**
-         * Retrieves player information by their Minecraft UUID. Returns whether this is the player\'s first join and their first login timestamp. This endpoint is useful for tracking player join history and implementing first-join rewards or tutorials. 
-         * @summary Get Player Information
-         * @param {string} uuid The Minecraft player UUID (with or without dashes)
+         * Returns up to `limit` chat messages before the given `before` timestamp (keyset pagination). Results are returned in ascending chronological order. Omit `before` to start from the current time. Scroll back through history by passing the `sentAt` of the oldest message received as the next `before` value. 
+         * @summary Get chat history
+         * @param {number} limit Maximum number of messages to return (1–100)
+         * @param {string | null} [sessionId] Filter to a specific server session. Omit for global history.
+         * @param {string | null} [before] ISO-8601 timestamp cursor — return messages sent before this time. Omit to start from now.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        getPlayer1(uuid: string, options?: RawAxiosRequestConfig): AxiosPromise<PlayerGetPlayerInformation> {
-            return localVarFp.getPlayer1(uuid, options).then((request) => request(axios, basePath));
+        history(limit: number, sessionId?: string | null, before?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<Array<ChatMessageDTO>> {
+            return localVarFp.history(limit, sessionId, before, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Stores a chat message from a game server and fans it out to all connected WebSocket clients via PostgreSQL LISTEN/NOTIFY. The session must be currently online. Only the player UUID is stored — usernames are resolved on the web UI from the player database cache. 
+         * @summary Ingest a chat message
+         * @param {ChatMessageRequest} chatMessageRequest 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        ingest(chatMessageRequest: ChatMessageRequest, options?: RawAxiosRequestConfig): AxiosPromise<ChatMessageDTO> {
+            return localVarFp.ingest(chatMessageRequest, options).then((request) => request(axios, basePath));
         },
     };
 };
 
 /**
- * PlayerApi - object-oriented interface
+ * ChatApi - object-oriented interface
  */
-export class PlayerApi extends BaseAPI {
+export class ChatApi extends BaseAPI {
     /**
-     * Retrieves player information by their Minecraft UUID. Returns whether this is the player\'s first join and their first login timestamp. This endpoint is useful for tracking player join history and implementing first-join rewards or tutorials. 
-     * @summary Get Player Information
-     * @param {string} uuid The Minecraft player UUID (with or without dashes)
+     * Returns up to `limit` chat messages before the given `before` timestamp (keyset pagination). Results are returned in ascending chronological order. Omit `before` to start from the current time. Scroll back through history by passing the `sentAt` of the oldest message received as the next `before` value. 
+     * @summary Get chat history
+     * @param {number} limit Maximum number of messages to return (1–100)
+     * @param {string | null} [sessionId] Filter to a specific server session. Omit for global history.
+     * @param {string | null} [before] ISO-8601 timestamp cursor — return messages sent before this time. Omit to start from now.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    public getPlayer1(uuid: string, options?: RawAxiosRequestConfig) {
-        return PlayerApiFp(this.configuration).getPlayer1(uuid, options).then((request) => request(this.axios, this.basePath));
+    public history(limit: number, sessionId?: string | null, before?: string | null, options?: RawAxiosRequestConfig) {
+        return ChatApiFp(this.configuration).history(limit, sessionId, before, options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * Stores a chat message from a game server and fans it out to all connected WebSocket clients via PostgreSQL LISTEN/NOTIFY. The session must be currently online. Only the player UUID is stored — usernames are resolved on the web UI from the player database cache. 
+     * @summary Ingest a chat message
+     * @param {ChatMessageRequest} chatMessageRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public ingest(chatMessageRequest: ChatMessageRequest, options?: RawAxiosRequestConfig) {
+        return ChatApiFp(this.configuration).ingest(chatMessageRequest, options).then((request) => request(this.axios, this.basePath));
     }
 }
 
 
 
 /**
- * PunishmentApi - axios parameter creator
+ * ConnectionApi - axios parameter creator
  */
-export const PunishmentApiAxiosParamCreator = function (configuration?: Configuration) {
+export const ConnectionApiAxiosParamCreator = function (configuration?: Configuration) {
+    return {
+        /**
+         * Performs comprehensive analysis of an IPv4 address to detect VPN, proxy, or suspicious connections.  **Features:** - Multi-provider VPN/proxy detection with aggregated confidence scoring - Approximate geolocation lookup (city and country) - Connection bypass status and expiration tracking - Optional player UUID association for connection history  **Use Cases:** - Prevent VPN/proxy usage during player authentication - Track player connection history across sessions - Implement temporary bypass systems for false positives - Monitor suspicious connection patterns  **Query Parameters:** - `force_recheck`: Bypass cache and re-run all detection services - `associate_uuid`: Link this IP to a player UUID and return player info  **Caching:** Results are cached unless `force_recheck=true` is specified, reducing API costs and improving response times. 
+         * @summary Check Connection and Detect VPN/Proxy
+         * @param {string} ip IPv4 address to analyze for VPN/proxy detection and geolocation
+         * @param {boolean} forceRecheck When true, bypasses cached results and re-runs all VPN detection services. Use this when you need the most up-to-date analysis or suspect cached data may be stale. Default: false 
+         * @param {string | null} [associateUuid] Minecraft player UUID to associate with this IP address. When provided, the API will: - Link this connection to the player\&#39;s history - Update the player\&#39;s username from Mojang API - Return player information (first join status, first login time) in the response - Track connection history for fraud detection  This operation is asynchronous and won\&#39;t block the response. 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getConnectionDetails: async (ip: string, forceRecheck: boolean, associateUuid?: string | null, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'ip' is not null or undefined
+            assertParamExists('getConnectionDetails', 'ip', ip)
+            // verify required parameter 'forceRecheck' is not null or undefined
+            assertParamExists('getConnectionDetails', 'forceRecheck', forceRecheck)
+            const localVarPath = `/v1/connection/get-connection-details/{ip}`
+                .replace(`{${"ip"}}`, encodeURIComponent(String(ip)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            if (forceRecheck !== undefined) {
+                localVarQueryParameter['force_recheck'] = forceRecheck;
+            }
+
+            if (associateUuid !== undefined) {
+                localVarQueryParameter['associate_uuid'] = associateUuid;
+            }
+
+            localVarHeaderParameter['Accept'] = 'application/json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+    }
+};
+
+/**
+ * ConnectionApi - functional programming interface
+ */
+export const ConnectionApiFp = function(configuration?: Configuration) {
+    const localVarAxiosParamCreator = ConnectionApiAxiosParamCreator(configuration)
+    return {
+        /**
+         * Performs comprehensive analysis of an IPv4 address to detect VPN, proxy, or suspicious connections.  **Features:** - Multi-provider VPN/proxy detection with aggregated confidence scoring - Approximate geolocation lookup (city and country) - Connection bypass status and expiration tracking - Optional player UUID association for connection history  **Use Cases:** - Prevent VPN/proxy usage during player authentication - Track player connection history across sessions - Implement temporary bypass systems for false positives - Monitor suspicious connection patterns  **Query Parameters:** - `force_recheck`: Bypass cache and re-run all detection services - `associate_uuid`: Link this IP to a player UUID and return player info  **Caching:** Results are cached unless `force_recheck=true` is specified, reducing API costs and improving response times. 
+         * @summary Check Connection and Detect VPN/Proxy
+         * @param {string} ip IPv4 address to analyze for VPN/proxy detection and geolocation
+         * @param {boolean} forceRecheck When true, bypasses cached results and re-runs all VPN detection services. Use this when you need the most up-to-date analysis or suspect cached data may be stale. Default: false 
+         * @param {string | null} [associateUuid] Minecraft player UUID to associate with this IP address. When provided, the API will: - Link this connection to the player\&#39;s history - Update the player\&#39;s username from Mojang API - Return player information (first join status, first login time) in the response - Track connection history for fraud detection  This operation is asynchronous and won\&#39;t block the response. 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async getConnectionDetails(ip: string, forceRecheck: boolean, associateUuid?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ConnectionGetConnectionDetailsResponse>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.getConnectionDetails(ip, forceRecheck, associateUuid, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['ConnectionApi.getConnectionDetails']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+    }
+};
+
+/**
+ * ConnectionApi - factory interface
+ */
+export const ConnectionApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
+    const localVarFp = ConnectionApiFp(configuration)
+    return {
+        /**
+         * Performs comprehensive analysis of an IPv4 address to detect VPN, proxy, or suspicious connections.  **Features:** - Multi-provider VPN/proxy detection with aggregated confidence scoring - Approximate geolocation lookup (city and country) - Connection bypass status and expiration tracking - Optional player UUID association for connection history  **Use Cases:** - Prevent VPN/proxy usage during player authentication - Track player connection history across sessions - Implement temporary bypass systems for false positives - Monitor suspicious connection patterns  **Query Parameters:** - `force_recheck`: Bypass cache and re-run all detection services - `associate_uuid`: Link this IP to a player UUID and return player info  **Caching:** Results are cached unless `force_recheck=true` is specified, reducing API costs and improving response times. 
+         * @summary Check Connection and Detect VPN/Proxy
+         * @param {string} ip IPv4 address to analyze for VPN/proxy detection and geolocation
+         * @param {boolean} forceRecheck When true, bypasses cached results and re-runs all VPN detection services. Use this when you need the most up-to-date analysis or suspect cached data may be stale. Default: false 
+         * @param {string | null} [associateUuid] Minecraft player UUID to associate with this IP address. When provided, the API will: - Link this connection to the player\&#39;s history - Update the player\&#39;s username from Mojang API - Return player information (first join status, first login time) in the response - Track connection history for fraud detection  This operation is asynchronous and won\&#39;t block the response. 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getConnectionDetails(ip: string, forceRecheck: boolean, associateUuid?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<ConnectionGetConnectionDetailsResponse> {
+            return localVarFp.getConnectionDetails(ip, forceRecheck, associateUuid, options).then((request) => request(axios, basePath));
+        },
+    };
+};
+
+/**
+ * ConnectionApi - object-oriented interface
+ */
+export class ConnectionApi extends BaseAPI {
+    /**
+     * Performs comprehensive analysis of an IPv4 address to detect VPN, proxy, or suspicious connections.  **Features:** - Multi-provider VPN/proxy detection with aggregated confidence scoring - Approximate geolocation lookup (city and country) - Connection bypass status and expiration tracking - Optional player UUID association for connection history  **Use Cases:** - Prevent VPN/proxy usage during player authentication - Track player connection history across sessions - Implement temporary bypass systems for false positives - Monitor suspicious connection patterns  **Query Parameters:** - `force_recheck`: Bypass cache and re-run all detection services - `associate_uuid`: Link this IP to a player UUID and return player info  **Caching:** Results are cached unless `force_recheck=true` is specified, reducing API costs and improving response times. 
+     * @summary Check Connection and Detect VPN/Proxy
+     * @param {string} ip IPv4 address to analyze for VPN/proxy detection and geolocation
+     * @param {boolean} forceRecheck When true, bypasses cached results and re-runs all VPN detection services. Use this when you need the most up-to-date analysis or suspect cached data may be stale. Default: false 
+     * @param {string | null} [associateUuid] Minecraft player UUID to associate with this IP address. When provided, the API will: - Link this connection to the player\&#39;s history - Update the player\&#39;s username from Mojang API - Return player information (first join status, first login time) in the response - Track connection history for fraud detection  This operation is asynchronous and won\&#39;t block the response. 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public getConnectionDetails(ip: string, forceRecheck: boolean, associateUuid?: string | null, options?: RawAxiosRequestConfig) {
+        return ConnectionApiFp(this.configuration).getConnectionDetails(ip, forceRecheck, associateUuid, options).then((request) => request(this.axios, this.basePath));
+    }
+}
+
+
+
+/**
+ * PlayerApi - axios parameter creator
+ */
+export const PlayerApiAxiosParamCreator = function (configuration?: Configuration) {
     return {
         /**
-         * Create and apply a punishment to a player. Automatically determines if permanent based on current score threshold (≥100%).
-         * @summary Apply a punishment
-         * @param {ApplyPunishmentRequest} applyPunishmentRequest 
+         * Retrieves player information by their Minecraft UUID. Returns whether this is the player\'s first join and their first login timestamp. This endpoint is useful for tracking player join history and implementing first-join rewards or tutorials. 
+         * @summary Get player information
+         * @param {string} uuid The Minecraft player UUID (with or without dashes)
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        applyPunishment: async (applyPunishmentRequest: ApplyPunishmentRequest, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
-            // verify required parameter 'applyPunishmentRequest' is not null or undefined
-            assertParamExists('applyPunishment', 'applyPunishmentRequest', applyPunishmentRequest)
-            const localVarPath = `/v1/punishment/apply`;
+        getPlayer1: async (uuid: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'uuid' is not null or undefined
+            assertParamExists('getPlayer1', 'uuid', uuid)
+            const localVarPath = `/v1/player/{uuid}`
+                .replace(`{${"uuid"}}`, encodeURIComponent(String(uuid)));
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
             let baseOptions;
@@ -2315,7 +2888,7 @@ export const PunishmentApiAxiosParamCreator = function (configuration?: Configur
                 baseOptions = configuration.baseOptions;
             }
 
-            const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options};
+            const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
             const localVarHeaderParameter = {} as any;
             const localVarQueryParameter = {} as any;
 
@@ -2323,30 +2896,582 @@ export const PunishmentApiAxiosParamCreator = function (configuration?: Configur
             // http bearer authentication required
             await setBearerAuthToObject(localVarHeaderParameter, configuration)
 
-            localVarHeaderParameter['Content-Type'] = 'application/json';
-            localVarHeaderParameter['Accept'] = 'application/json';
+            localVarHeaderParameter['Accept'] = 'application/json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * Accepts a list of player UUIDs and returns a map of `uuid → username` for those that have a recorded username. UUIDs with no username record (e.g. players who have never joined) are omitted from the response. Used by the web UI to display player names in the chat log. 
+         * @summary Batch resolve UUIDs to usernames
+         * @param {Array<string>} uuids List of player UUIDs to resolve (repeatable query param)
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getUsernames: async (uuids: Array<string>, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'uuids' is not null or undefined
+            assertParamExists('getUsernames', 'uuids', uuids)
+            const localVarPath = `/v1/player/usernames`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            if (uuids) {
+                localVarQueryParameter['uuids'] = uuids.join(COLLECTION_FORMATS.csv);
+            }
+
+            localVarHeaderParameter['Accept'] = 'application/json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+    }
+};
+
+/**
+ * PlayerApi - functional programming interface
+ */
+export const PlayerApiFp = function(configuration?: Configuration) {
+    const localVarAxiosParamCreator = PlayerApiAxiosParamCreator(configuration)
+    return {
+        /**
+         * Retrieves player information by their Minecraft UUID. Returns whether this is the player\'s first join and their first login timestamp. This endpoint is useful for tracking player join history and implementing first-join rewards or tutorials. 
+         * @summary Get player information
+         * @param {string} uuid The Minecraft player UUID (with or without dashes)
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async getPlayer1(uuid: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PlayerGetPlayerInformation>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.getPlayer1(uuid, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['PlayerApi.getPlayer1']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * Accepts a list of player UUIDs and returns a map of `uuid → username` for those that have a recorded username. UUIDs with no username record (e.g. players who have never joined) are omitted from the response. Used by the web UI to display player names in the chat log. 
+         * @summary Batch resolve UUIDs to usernames
+         * @param {Array<string>} uuids List of player UUIDs to resolve (repeatable query param)
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async getUsernames(uuids: Array<string>, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.getUsernames(uuids, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['PlayerApi.getUsernames']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+    }
+};
+
+/**
+ * PlayerApi - factory interface
+ */
+export const PlayerApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
+    const localVarFp = PlayerApiFp(configuration)
+    return {
+        /**
+         * Retrieves player information by their Minecraft UUID. Returns whether this is the player\'s first join and their first login timestamp. This endpoint is useful for tracking player join history and implementing first-join rewards or tutorials. 
+         * @summary Get player information
+         * @param {string} uuid The Minecraft player UUID (with or without dashes)
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getPlayer1(uuid: string, options?: RawAxiosRequestConfig): AxiosPromise<PlayerGetPlayerInformation> {
+            return localVarFp.getPlayer1(uuid, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Accepts a list of player UUIDs and returns a map of `uuid → username` for those that have a recorded username. UUIDs with no username record (e.g. players who have never joined) are omitted from the response. Used by the web UI to display player names in the chat log. 
+         * @summary Batch resolve UUIDs to usernames
+         * @param {Array<string>} uuids List of player UUIDs to resolve (repeatable query param)
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getUsernames(uuids: Array<string>, options?: RawAxiosRequestConfig): AxiosPromise<void> {
+            return localVarFp.getUsernames(uuids, options).then((request) => request(axios, basePath));
+        },
+    };
+};
+
+/**
+ * PlayerApi - object-oriented interface
+ */
+export class PlayerApi extends BaseAPI {
+    /**
+     * Retrieves player information by their Minecraft UUID. Returns whether this is the player\'s first join and their first login timestamp. This endpoint is useful for tracking player join history and implementing first-join rewards or tutorials. 
+     * @summary Get player information
+     * @param {string} uuid The Minecraft player UUID (with or without dashes)
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public getPlayer1(uuid: string, options?: RawAxiosRequestConfig) {
+        return PlayerApiFp(this.configuration).getPlayer1(uuid, options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * Accepts a list of player UUIDs and returns a map of `uuid → username` for those that have a recorded username. UUIDs with no username record (e.g. players who have never joined) are omitted from the response. Used by the web UI to display player names in the chat log. 
+     * @summary Batch resolve UUIDs to usernames
+     * @param {Array<string>} uuids List of player UUIDs to resolve (repeatable query param)
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public getUsernames(uuids: Array<string>, options?: RawAxiosRequestConfig) {
+        return PlayerApiFp(this.configuration).getUsernames(uuids, options).then((request) => request(this.axios, this.basePath));
+    }
+}
+
+
+
+/**
+ * PunishmentApi - axios parameter creator
+ */
+export const PunishmentApiAxiosParamCreator = function (configuration?: Configuration) {
+    return {
+        /**
+         * Retrieve duration information for each punishment type and severity level (1-10)
+         * @summary Get punishment severities
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getPunishmentSeverities: async (options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            const localVarPath = `/v1/punishment/severities`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            localVarHeaderParameter['Accept'] = 'application/json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * Retrieve all active punishments for a player by UUID or username, optionally filtered by type and time
+         * @summary Get punishments by player
+         * @param {string | null} [uuid] Player UUID
+         * @param {string | null} [username] Player username
+         * @param {Array<string> | null} [type] Filter by punishment types
+         * @param {number | null} [since] Filter punishments created after this Unix epoch timestamp (milliseconds)
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getPunishments1: async (uuid?: string | null, username?: string | null, type?: Array<string> | null, since?: number | null, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            const localVarPath = `/v1/punishment`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            if (uuid !== undefined) {
+                localVarQueryParameter['uuid'] = uuid;
+            }
+
+            if (username !== undefined) {
+                localVarQueryParameter['username'] = username;
+            }
+
+            if (type) {
+                localVarQueryParameter['type'] = type.join(COLLECTION_FORMATS.csv);
+            }
+
+            if (since !== undefined) {
+                localVarQueryParameter['since'] = since;
+            }
+
+            localVarHeaderParameter['Accept'] = 'application/json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * Retrieve all active punishments associated with an IP address
+         * @summary Get punishments by IP address
+         * @param {string} ip IP address
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getPunishmentsByIp: async (ip: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'ip' is not null or undefined
+            assertParamExists('getPunishmentsByIp', 'ip', ip)
+            const localVarPath = `/v1/punishment/ip`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            if (ip !== undefined) {
+                localVarQueryParameter['ip'] = ip;
+            }
+
+            localVarHeaderParameter['Accept'] = 'application/json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * Returns a paginated list of recent punishments with optional filtering by issue date, expiration date, and type
+         * @summary List recent punishments
+         * @param {number} limit Maximum number of records to return
+         * @param {number} page Page number for pagination
+         * @param {number | null} [issuedAfter] Filter punishments issued after this epoch timestamp (milliseconds)
+         * @param {number | null} [issuedBefore] Filter punishments issued before this epoch timestamp (milliseconds)
+         * @param {number | null} [expiresAfter] Filter punishments expiring after this epoch timestamp (milliseconds)
+         * @param {number | null} [expiresBefore] Filter punishments expiring before this epoch timestamp (milliseconds)
+         * @param {Array<string> | null} [type] Filter by punishment types
+         * @param {string | null} [uuid] Filter by player UUID
+         * @param {string | null} [ipAddress] Filter by IP address
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getRecentPunishments: async (limit: number, page: number, issuedAfter?: number | null, issuedBefore?: number | null, expiresAfter?: number | null, expiresBefore?: number | null, type?: Array<string> | null, uuid?: string | null, ipAddress?: string | null, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'limit' is not null or undefined
+            assertParamExists('getRecentPunishments', 'limit', limit)
+            // verify required parameter 'page' is not null or undefined
+            assertParamExists('getRecentPunishments', 'page', page)
+            const localVarPath = `/v1/punishment/recent`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication DiscordAuth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            if (issuedAfter !== undefined) {
+                localVarQueryParameter['issuedAfter'] = issuedAfter;
+            }
+
+            if (issuedBefore !== undefined) {
+                localVarQueryParameter['issuedBefore'] = issuedBefore;
+            }
+
+            if (expiresAfter !== undefined) {
+                localVarQueryParameter['expiresAfter'] = expiresAfter;
+            }
+
+            if (expiresBefore !== undefined) {
+                localVarQueryParameter['expiresBefore'] = expiresBefore;
+            }
+
+            if (type) {
+                localVarQueryParameter['type'] = type.join(COLLECTION_FORMATS.csv);
+            }
+
+            if (uuid !== undefined) {
+                localVarQueryParameter['uuid'] = uuid;
+            }
+
+            if (ipAddress !== undefined) {
+                localVarQueryParameter['ipAddress'] = ipAddress;
+            }
+
+            if (limit !== undefined) {
+                localVarQueryParameter['limit'] = limit;
+            }
+
+            if (page !== undefined) {
+                localVarQueryParameter['page'] = page;
+            }
+
+            localVarHeaderParameter['Accept'] = 'application/json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+    }
+};
+
+/**
+ * PunishmentApi - functional programming interface
+ */
+export const PunishmentApiFp = function(configuration?: Configuration) {
+    const localVarAxiosParamCreator = PunishmentApiAxiosParamCreator(configuration)
+    return {
+        /**
+         * Retrieve duration information for each punishment type and severity level (1-10)
+         * @summary Get punishment severities
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async getPunishmentSeverities(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PunishmentSeveritiesResponse>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.getPunishmentSeverities(options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['PunishmentApi.getPunishmentSeverities']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * Retrieve all active punishments for a player by UUID or username, optionally filtered by type and time
+         * @summary Get punishments by player
+         * @param {string | null} [uuid] Player UUID
+         * @param {string | null} [username] Player username
+         * @param {Array<string> | null} [type] Filter by punishment types
+         * @param {number | null} [since] Filter punishments created after this Unix epoch timestamp (milliseconds)
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async getPunishments1(uuid?: string | null, username?: string | null, type?: Array<string> | null, since?: number | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<PunishmentGetPunishmentResponse>>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.getPunishments1(uuid, username, type, since, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['PunishmentApi.getPunishments1']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * Retrieve all active punishments associated with an IP address
+         * @summary Get punishments by IP address
+         * @param {string} ip IP address
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async getPunishmentsByIp(ip: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<PunishmentGetPunishmentResponse>>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.getPunishmentsByIp(ip, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['PunishmentApi.getPunishmentsByIp']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+        /**
+         * Returns a paginated list of recent punishments with optional filtering by issue date, expiration date, and type
+         * @summary List recent punishments
+         * @param {number} limit Maximum number of records to return
+         * @param {number} page Page number for pagination
+         * @param {number | null} [issuedAfter] Filter punishments issued after this epoch timestamp (milliseconds)
+         * @param {number | null} [issuedBefore] Filter punishments issued before this epoch timestamp (milliseconds)
+         * @param {number | null} [expiresAfter] Filter punishments expiring after this epoch timestamp (milliseconds)
+         * @param {number | null} [expiresBefore] Filter punishments expiring before this epoch timestamp (milliseconds)
+         * @param {Array<string> | null} [type] Filter by punishment types
+         * @param {string | null} [uuid] Filter by player UUID
+         * @param {string | null} [ipAddress] Filter by IP address
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async getRecentPunishments(limit: number, page: number, issuedAfter?: number | null, issuedBefore?: number | null, expiresAfter?: number | null, expiresBefore?: number | null, type?: Array<string> | null, uuid?: string | null, ipAddress?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<PunishmentGetPunishmentResponse>>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.getRecentPunishments(limit, page, issuedAfter, issuedBefore, expiresAfter, expiresBefore, type, uuid, ipAddress, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['PunishmentApi.getRecentPunishments']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
+    }
+};
+
+/**
+ * PunishmentApi - factory interface
+ */
+export const PunishmentApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
+    const localVarFp = PunishmentApiFp(configuration)
+    return {
+        /**
+         * Retrieve duration information for each punishment type and severity level (1-10)
+         * @summary Get punishment severities
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getPunishmentSeverities(options?: RawAxiosRequestConfig): AxiosPromise<PunishmentSeveritiesResponse> {
+            return localVarFp.getPunishmentSeverities(options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Retrieve all active punishments for a player by UUID or username, optionally filtered by type and time
+         * @summary Get punishments by player
+         * @param {string | null} [uuid] Player UUID
+         * @param {string | null} [username] Player username
+         * @param {Array<string> | null} [type] Filter by punishment types
+         * @param {number | null} [since] Filter punishments created after this Unix epoch timestamp (milliseconds)
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getPunishments1(uuid?: string | null, username?: string | null, type?: Array<string> | null, since?: number | null, options?: RawAxiosRequestConfig): AxiosPromise<Array<PunishmentGetPunishmentResponse>> {
+            return localVarFp.getPunishments1(uuid, username, type, since, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Retrieve all active punishments associated with an IP address
+         * @summary Get punishments by IP address
+         * @param {string} ip IP address
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getPunishmentsByIp(ip: string, options?: RawAxiosRequestConfig): AxiosPromise<Array<PunishmentGetPunishmentResponse>> {
+            return localVarFp.getPunishmentsByIp(ip, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Returns a paginated list of recent punishments with optional filtering by issue date, expiration date, and type
+         * @summary List recent punishments
+         * @param {number} limit Maximum number of records to return
+         * @param {number} page Page number for pagination
+         * @param {number | null} [issuedAfter] Filter punishments issued after this epoch timestamp (milliseconds)
+         * @param {number | null} [issuedBefore] Filter punishments issued before this epoch timestamp (milliseconds)
+         * @param {number | null} [expiresAfter] Filter punishments expiring after this epoch timestamp (milliseconds)
+         * @param {number | null} [expiresBefore] Filter punishments expiring before this epoch timestamp (milliseconds)
+         * @param {Array<string> | null} [type] Filter by punishment types
+         * @param {string | null} [uuid] Filter by player UUID
+         * @param {string | null} [ipAddress] Filter by IP address
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getRecentPunishments(limit: number, page: number, issuedAfter?: number | null, issuedBefore?: number | null, expiresAfter?: number | null, expiresBefore?: number | null, type?: Array<string> | null, uuid?: string | null, ipAddress?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<Array<PunishmentGetPunishmentResponse>> {
+            return localVarFp.getRecentPunishments(limit, page, issuedAfter, issuedBefore, expiresAfter, expiresBefore, type, uuid, ipAddress, options).then((request) => request(axios, basePath));
+        },
+    };
+};
+
+/**
+ * PunishmentApi - object-oriented interface
+ */
+export class PunishmentApi extends BaseAPI {
+    /**
+     * Retrieve duration information for each punishment type and severity level (1-10)
+     * @summary Get punishment severities
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public getPunishmentSeverities(options?: RawAxiosRequestConfig) {
+        return PunishmentApiFp(this.configuration).getPunishmentSeverities(options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * Retrieve all active punishments for a player by UUID or username, optionally filtered by type and time
+     * @summary Get punishments by player
+     * @param {string | null} [uuid] Player UUID
+     * @param {string | null} [username] Player username
+     * @param {Array<string> | null} [type] Filter by punishment types
+     * @param {number | null} [since] Filter punishments created after this Unix epoch timestamp (milliseconds)
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public getPunishments1(uuid?: string | null, username?: string | null, type?: Array<string> | null, since?: number | null, options?: RawAxiosRequestConfig) {
+        return PunishmentApiFp(this.configuration).getPunishments1(uuid, username, type, since, options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * Retrieve all active punishments associated with an IP address
+     * @summary Get punishments by IP address
+     * @param {string} ip IP address
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public getPunishmentsByIp(ip: string, options?: RawAxiosRequestConfig) {
+        return PunishmentApiFp(this.configuration).getPunishmentsByIp(ip, options).then((request) => request(this.axios, this.basePath));
+    }
+
+    /**
+     * Returns a paginated list of recent punishments with optional filtering by issue date, expiration date, and type
+     * @summary List recent punishments
+     * @param {number} limit Maximum number of records to return
+     * @param {number} page Page number for pagination
+     * @param {number | null} [issuedAfter] Filter punishments issued after this epoch timestamp (milliseconds)
+     * @param {number | null} [issuedBefore] Filter punishments issued before this epoch timestamp (milliseconds)
+     * @param {number | null} [expiresAfter] Filter punishments expiring after this epoch timestamp (milliseconds)
+     * @param {number | null} [expiresBefore] Filter punishments expiring before this epoch timestamp (milliseconds)
+     * @param {Array<string> | null} [type] Filter by punishment types
+     * @param {string | null} [uuid] Filter by player UUID
+     * @param {string | null} [ipAddress] Filter by IP address
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public getRecentPunishments(limit: number, page: number, issuedAfter?: number | null, issuedBefore?: number | null, expiresAfter?: number | null, expiresBefore?: number | null, type?: Array<string> | null, uuid?: string | null, ipAddress?: string | null, options?: RawAxiosRequestConfig) {
+        return PunishmentApiFp(this.configuration).getRecentPunishments(limit, page, issuedAfter, issuedBefore, expiresAfter, expiresBefore, type, uuid, ipAddress, options).then((request) => request(this.axios, this.basePath));
+    }
+}
+
 
-            setSearchParams(localVarUrlObj, localVarQueryParameter);
-            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
-            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
-            localVarRequestOptions.data = serializeDataIfNeeded(applyPunishmentRequest, localVarRequestOptions, configuration)
 
-            return {
-                url: toPathString(localVarUrlObj),
-                options: localVarRequestOptions,
-            };
-        },
+/**
+ * ServerSessionsApi - axios parameter creator
+ */
+export const ServerSessionsApiAxiosParamCreator = function (configuration?: Configuration) {
+    return {
         /**
-         * Preview punishment impact before applying. Returns calculated points, current/new thresholds, and whether it will be permanent.
-         * @summary Create a punishment draft
-         * @param {CreatePunishmentDraftRequest} createPunishmentDraftRequest 
+         * Updates the `last_heartbeat` timestamp for the given session, keeping it marked as online. Sessions that miss heartbeats for more than 2 minutes are automatically tombstoned by the scheduler. Call this every 30 seconds from the game server. 
+         * @summary Send a heartbeat
+         * @param {string} id Session UUID returned from the registration call
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        createPunishmentDraft: async (createPunishmentDraftRequest: CreatePunishmentDraftRequest, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
-            // verify required parameter 'createPunishmentDraftRequest' is not null or undefined
-            assertParamExists('createPunishmentDraft', 'createPunishmentDraftRequest', createPunishmentDraftRequest)
-            const localVarPath = `/v1/punishment/draft`;
+        heartbeat: async (id: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'id' is not null or undefined
+            assertParamExists('heartbeat', 'id', id)
+            const localVarPath = `/v1/servers/{id}/heartbeat`
+                .replace(`{${"id"}}`, encodeURIComponent(String(id)));
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
             let baseOptions;
@@ -2354,7 +3479,7 @@ export const PunishmentApiAxiosParamCreator = function (configuration?: Configur
                 baseOptions = configuration.baseOptions;
             }
 
-            const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options};
+            const localVarRequestOptions = { method: 'PUT', ...baseOptions, ...options};
             const localVarHeaderParameter = {} as any;
             const localVarQueryParameter = {} as any;
 
@@ -2362,13 +3487,10 @@ export const PunishmentApiAxiosParamCreator = function (configuration?: Configur
             // http bearer authentication required
             await setBearerAuthToObject(localVarHeaderParameter, configuration)
 
-            localVarHeaderParameter['Content-Type'] = 'application/json';
-            localVarHeaderParameter['Accept'] = 'application/json';
 
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
-            localVarRequestOptions.data = serializeDataIfNeeded(createPunishmentDraftRequest, localVarRequestOptions, configuration)
 
             return {
                 url: toPathString(localVarUrlObj),
@@ -2376,13 +3498,13 @@ export const PunishmentApiAxiosParamCreator = function (configuration?: Configur
             };
         },
         /**
-         * Retrieve duration information for each punishment type and severity level (1-10)
-         * @summary Get punishment severities
+         * Returns all server sessions — both online and historical — ordered by start time descending. Used by the web UI to populate the session filter dropdown.
+         * @summary List all server sessions
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        getPunishmentSeverities: async (options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
-            const localVarPath = `/v1/punishment/severities`;
+        listAll: async (options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            const localVarPath = `/v1/servers/history`;
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
             let baseOptions;
@@ -2410,17 +3532,13 @@ export const PunishmentApiAxiosParamCreator = function (configuration?: Configur
             };
         },
         /**
-         * Retrieve all active punishments for a player by UUID or username, optionally filtered by type and time
-         * @summary Get punishments by player
-         * @param {string | null} [uuid] Player UUID
-         * @param {string | null} [username] Player username
-         * @param {Array<string> | null} [type] Filter by punishment types
-         * @param {number | null} [since] Filter punishments created after this Unix epoch timestamp (milliseconds)
+         * Returns all currently online server sessions, ordered by start time descending.
+         * @summary List online server sessions
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        getPunishments1: async (uuid?: string | null, username?: string | null, type?: Array<string> | null, since?: number | null, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
-            const localVarPath = `/v1/punishment`;
+        listOnline: async (options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            const localVarPath = `/v1/servers`;
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
             let baseOptions;
@@ -2436,22 +3554,6 @@ export const PunishmentApiAxiosParamCreator = function (configuration?: Configur
             // http bearer authentication required
             await setBearerAuthToObject(localVarHeaderParameter, configuration)
 
-            if (uuid !== undefined) {
-                localVarQueryParameter['uuid'] = uuid;
-            }
-
-            if (username !== undefined) {
-                localVarQueryParameter['username'] = username;
-            }
-
-            if (type) {
-                localVarQueryParameter['type'] = type.join(COLLECTION_FORMATS.csv);
-            }
-
-            if (since !== undefined) {
-                localVarQueryParameter['since'] = since;
-            }
-
             localVarHeaderParameter['Accept'] = 'application/json';
 
             setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -2464,16 +3566,17 @@ export const PunishmentApiAxiosParamCreator = function (configuration?: Configur
             };
         },
         /**
-         * Retrieve all active punishments associated with an IP address
-         * @summary Get punishments by IP address
-         * @param {string} ip IP address
+         * Marks the session as offline with the current timestamp as `endedAt`. Call this from the game server\'s shutdown hook for a clean shutdown signal. Sessions that crash without calling this endpoint will be tombstoned automatically by the 2-minute heartbeat scheduler. 
+         * @summary Mark a session offline
+         * @param {string} id Session UUID returned from the registration call
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        getPunishmentsByIp: async (ip: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
-            // verify required parameter 'ip' is not null or undefined
-            assertParamExists('getPunishmentsByIp', 'ip', ip)
-            const localVarPath = `/v1/punishment/ip`;
+        markOffline: async (id: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'id' is not null or undefined
+            assertParamExists('markOffline', 'id', id)
+            const localVarPath = `/v1/servers/{id}/offline`
+                .replace(`{${"id"}}`, encodeURIComponent(String(id)));
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
             let baseOptions;
@@ -2481,7 +3584,7 @@ export const PunishmentApiAxiosParamCreator = function (configuration?: Configur
                 baseOptions = configuration.baseOptions;
             }
 
-            const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+            const localVarRequestOptions = { method: 'PUT', ...baseOptions, ...options};
             const localVarHeaderParameter = {} as any;
             const localVarQueryParameter = {} as any;
 
@@ -2489,11 +3592,6 @@ export const PunishmentApiAxiosParamCreator = function (configuration?: Configur
             // http bearer authentication required
             await setBearerAuthToObject(localVarHeaderParameter, configuration)
 
-            if (ip !== undefined) {
-                localVarQueryParameter['ip'] = ip;
-            }
-
-            localVarHeaderParameter['Accept'] = 'application/json';
 
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
@@ -2505,26 +3603,16 @@ export const PunishmentApiAxiosParamCreator = function (configuration?: Configur
             };
         },
         /**
-         * Returns a paginated list of recent punishments with optional filtering by issue date, expiration date, and type
-         * @summary List recent punishments
-         * @param {number} limit Maximum number of records to return
-         * @param {number} page Page number for pagination
-         * @param {number | null} [issuedAfter] Filter punishments issued after this epoch timestamp (milliseconds)
-         * @param {number | null} [issuedBefore] Filter punishments issued before this epoch timestamp (milliseconds)
-         * @param {number | null} [expiresAfter] Filter punishments expiring after this epoch timestamp (milliseconds)
-         * @param {number | null} [expiresBefore] Filter punishments expiring before this epoch timestamp (milliseconds)
-         * @param {Array<string> | null} [type] Filter by punishment types
-         * @param {string | null} [uuid] Filter by player UUID
-         * @param {string | null} [ipAddress] Filter by IP address
+         * Registers a game server instance and returns a session ID used for subsequent heartbeats and chat ingestion. If a `containerId` is provided and an online session already exists for that container (e.g. after a Velocity restart), the existing session is returned unchanged. Otherwise a fresh session is created with an auto-generated instance name. 
+         * @summary Register a server session
+         * @param {ServerRegisterRequest} serverRegisterRequest 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        getRecentPunishments: async (limit: number, page: number, issuedAfter?: number | null, issuedBefore?: number | null, expiresAfter?: number | null, expiresBefore?: number | null, type?: Array<string> | null, uuid?: string | null, ipAddress?: string | null, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
-            // verify required parameter 'limit' is not null or undefined
-            assertParamExists('getRecentPunishments', 'limit', limit)
-            // verify required parameter 'page' is not null or undefined
-            assertParamExists('getRecentPunishments', 'page', page)
-            const localVarPath = `/v1/punishment/recent`;
+        register: async (serverRegisterRequest: ServerRegisterRequest, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'serverRegisterRequest' is not null or undefined
+            assertParamExists('register', 'serverRegisterRequest', serverRegisterRequest)
+            const localVarPath = `/v1/servers`;
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
             const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
             let baseOptions;
@@ -2532,7 +3620,7 @@ export const PunishmentApiAxiosParamCreator = function (configuration?: Configur
                 baseOptions = configuration.baseOptions;
             }
 
-            const localVarRequestOptions = { method: 'GET', ...baseOptions, ...options};
+            const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options};
             const localVarHeaderParameter = {} as any;
             const localVarQueryParameter = {} as any;
 
@@ -2540,47 +3628,13 @@ export const PunishmentApiAxiosParamCreator = function (configuration?: Configur
             // http bearer authentication required
             await setBearerAuthToObject(localVarHeaderParameter, configuration)
 
-            if (issuedAfter !== undefined) {
-                localVarQueryParameter['issuedAfter'] = issuedAfter;
-            }
-
-            if (issuedBefore !== undefined) {
-                localVarQueryParameter['issuedBefore'] = issuedBefore;
-            }
-
-            if (expiresAfter !== undefined) {
-                localVarQueryParameter['expiresAfter'] = expiresAfter;
-            }
-
-            if (expiresBefore !== undefined) {
-                localVarQueryParameter['expiresBefore'] = expiresBefore;
-            }
-
-            if (type) {
-                localVarQueryParameter['type'] = type.join(COLLECTION_FORMATS.csv);
-            }
-
-            if (uuid !== undefined) {
-                localVarQueryParameter['uuid'] = uuid;
-            }
-
-            if (ipAddress !== undefined) {
-                localVarQueryParameter['ipAddress'] = ipAddress;
-            }
-
-            if (limit !== undefined) {
-                localVarQueryParameter['limit'] = limit;
-            }
-
-            if (page !== undefined) {
-                localVarQueryParameter['page'] = page;
-            }
-
+            localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json';
 
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+            localVarRequestOptions.data = serializeDataIfNeeded(serverRegisterRequest, localVarRequestOptions, configuration)
 
             return {
                 url: toPathString(localVarUrlObj),
@@ -2591,259 +3645,189 @@ export const PunishmentApiAxiosParamCreator = function (configuration?: Configur
 };
 
 /**
- * PunishmentApi - functional programming interface
+ * ServerSessionsApi - functional programming interface
  */
-export const PunishmentApiFp = function(configuration?: Configuration) {
-    const localVarAxiosParamCreator = PunishmentApiAxiosParamCreator(configuration)
+export const ServerSessionsApiFp = function(configuration?: Configuration) {
+    const localVarAxiosParamCreator = ServerSessionsApiAxiosParamCreator(configuration)
     return {
         /**
-         * Create and apply a punishment to a player. Automatically determines if permanent based on current score threshold (≥100%).
-         * @summary Apply a punishment
-         * @param {ApplyPunishmentRequest} applyPunishmentRequest 
-         * @param {*} [options] Override http request option.
-         * @throws {RequiredError}
-         */
-        async applyPunishment(applyPunishmentRequest: ApplyPunishmentRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ApplyPunishmentResponse>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.applyPunishment(applyPunishmentRequest, options);
-            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
-            const localVarOperationServerBasePath = operationServerMap['PunishmentApi.applyPunishment']?.[localVarOperationServerIndex]?.url;
-            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
-        },
-        /**
-         * Preview punishment impact before applying. Returns calculated points, current/new thresholds, and whether it will be permanent.
-         * @summary Create a punishment draft
-         * @param {CreatePunishmentDraftRequest} createPunishmentDraftRequest 
+         * Updates the `last_heartbeat` timestamp for the given session, keeping it marked as online. Sessions that miss heartbeats for more than 2 minutes are automatically tombstoned by the scheduler. Call this every 30 seconds from the game server. 
+         * @summary Send a heartbeat
+         * @param {string} id Session UUID returned from the registration call
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        async createPunishmentDraft(createPunishmentDraftRequest: CreatePunishmentDraftRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PunishmentDraftResponse>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.createPunishmentDraft(createPunishmentDraftRequest, options);
+        async heartbeat(id: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.heartbeat(id, options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
-            const localVarOperationServerBasePath = operationServerMap['PunishmentApi.createPunishmentDraft']?.[localVarOperationServerIndex]?.url;
+            const localVarOperationServerBasePath = operationServerMap['ServerSessionsApi.heartbeat']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * Retrieve duration information for each punishment type and severity level (1-10)
-         * @summary Get punishment severities
+         * Returns all server sessions — both online and historical — ordered by start time descending. Used by the web UI to populate the session filter dropdown.
+         * @summary List all server sessions
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        async getPunishmentSeverities(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PunishmentSeveritiesResponse>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.getPunishmentSeverities(options);
+        async listAll(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<ServerSessionDTO>>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.listAll(options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
-            const localVarOperationServerBasePath = operationServerMap['PunishmentApi.getPunishmentSeverities']?.[localVarOperationServerIndex]?.url;
+            const localVarOperationServerBasePath = operationServerMap['ServerSessionsApi.listAll']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * Retrieve all active punishments for a player by UUID or username, optionally filtered by type and time
-         * @summary Get punishments by player
-         * @param {string | null} [uuid] Player UUID
-         * @param {string | null} [username] Player username
-         * @param {Array<string> | null} [type] Filter by punishment types
-         * @param {number | null} [since] Filter punishments created after this Unix epoch timestamp (milliseconds)
+         * Returns all currently online server sessions, ordered by start time descending.
+         * @summary List online server sessions
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        async getPunishments1(uuid?: string | null, username?: string | null, type?: Array<string> | null, since?: number | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<PunishmentGetPunishmentResponse>>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.getPunishments1(uuid, username, type, since, options);
+        async listOnline(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<ServerSessionDTO>>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.listOnline(options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
-            const localVarOperationServerBasePath = operationServerMap['PunishmentApi.getPunishments1']?.[localVarOperationServerIndex]?.url;
+            const localVarOperationServerBasePath = operationServerMap['ServerSessionsApi.listOnline']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * Retrieve all active punishments associated with an IP address
-         * @summary Get punishments by IP address
-         * @param {string} ip IP address
+         * Marks the session as offline with the current timestamp as `endedAt`. Call this from the game server\'s shutdown hook for a clean shutdown signal. Sessions that crash without calling this endpoint will be tombstoned automatically by the 2-minute heartbeat scheduler. 
+         * @summary Mark a session offline
+         * @param {string} id Session UUID returned from the registration call
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        async getPunishmentsByIp(ip: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<PunishmentGetPunishmentResponse>>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.getPunishmentsByIp(ip, options);
+        async markOffline(id: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.markOffline(id, options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
-            const localVarOperationServerBasePath = operationServerMap['PunishmentApi.getPunishmentsByIp']?.[localVarOperationServerIndex]?.url;
+            const localVarOperationServerBasePath = operationServerMap['ServerSessionsApi.markOffline']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * Returns a paginated list of recent punishments with optional filtering by issue date, expiration date, and type
-         * @summary List recent punishments
-         * @param {number} limit Maximum number of records to return
-         * @param {number} page Page number for pagination
-         * @param {number | null} [issuedAfter] Filter punishments issued after this epoch timestamp (milliseconds)
-         * @param {number | null} [issuedBefore] Filter punishments issued before this epoch timestamp (milliseconds)
-         * @param {number | null} [expiresAfter] Filter punishments expiring after this epoch timestamp (milliseconds)
-         * @param {number | null} [expiresBefore] Filter punishments expiring before this epoch timestamp (milliseconds)
-         * @param {Array<string> | null} [type] Filter by punishment types
-         * @param {string | null} [uuid] Filter by player UUID
-         * @param {string | null} [ipAddress] Filter by IP address
+         * Registers a game server instance and returns a session ID used for subsequent heartbeats and chat ingestion. If a `containerId` is provided and an online session already exists for that container (e.g. after a Velocity restart), the existing session is returned unchanged. Otherwise a fresh session is created with an auto-generated instance name. 
+         * @summary Register a server session
+         * @param {ServerRegisterRequest} serverRegisterRequest 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        async getRecentPunishments(limit: number, page: number, issuedAfter?: number | null, issuedBefore?: number | null, expiresAfter?: number | null, expiresBefore?: number | null, type?: Array<string> | null, uuid?: string | null, ipAddress?: string | null, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<PunishmentGetPunishmentResponse>>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.getRecentPunishments(limit, page, issuedAfter, issuedBefore, expiresAfter, expiresBefore, type, uuid, ipAddress, options);
+        async register(serverRegisterRequest: ServerRegisterRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ServerSessionDTO>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.register(serverRegisterRequest, options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
-            const localVarOperationServerBasePath = operationServerMap['PunishmentApi.getRecentPunishments']?.[localVarOperationServerIndex]?.url;
+            const localVarOperationServerBasePath = operationServerMap['ServerSessionsApi.register']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
     }
 };
 
 /**
- * PunishmentApi - factory interface
+ * ServerSessionsApi - factory interface
  */
-export const PunishmentApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
-    const localVarFp = PunishmentApiFp(configuration)
+export const ServerSessionsApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
+    const localVarFp = ServerSessionsApiFp(configuration)
     return {
         /**
-         * Create and apply a punishment to a player. Automatically determines if permanent based on current score threshold (≥100%).
-         * @summary Apply a punishment
-         * @param {ApplyPunishmentRequest} applyPunishmentRequest 
-         * @param {*} [options] Override http request option.
-         * @throws {RequiredError}
-         */
-        applyPunishment(applyPunishmentRequest: ApplyPunishmentRequest, options?: RawAxiosRequestConfig): AxiosPromise<ApplyPunishmentResponse> {
-            return localVarFp.applyPunishment(applyPunishmentRequest, options).then((request) => request(axios, basePath));
-        },
-        /**
-         * Preview punishment impact before applying. Returns calculated points, current/new thresholds, and whether it will be permanent.
-         * @summary Create a punishment draft
-         * @param {CreatePunishmentDraftRequest} createPunishmentDraftRequest 
+         * Updates the `last_heartbeat` timestamp for the given session, keeping it marked as online. Sessions that miss heartbeats for more than 2 minutes are automatically tombstoned by the scheduler. Call this every 30 seconds from the game server. 
+         * @summary Send a heartbeat
+         * @param {string} id Session UUID returned from the registration call
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        createPunishmentDraft(createPunishmentDraftRequest: CreatePunishmentDraftRequest, options?: RawAxiosRequestConfig): AxiosPromise<PunishmentDraftResponse> {
-            return localVarFp.createPunishmentDraft(createPunishmentDraftRequest, options).then((request) => request(axios, basePath));
+        heartbeat(id: string, options?: RawAxiosRequestConfig): AxiosPromise<void> {
+            return localVarFp.heartbeat(id, options).then((request) => request(axios, basePath));
         },
         /**
-         * Retrieve duration information for each punishment type and severity level (1-10)
-         * @summary Get punishment severities
+         * Returns all server sessions — both online and historical — ordered by start time descending. Used by the web UI to populate the session filter dropdown.
+         * @summary List all server sessions
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        getPunishmentSeverities(options?: RawAxiosRequestConfig): AxiosPromise<PunishmentSeveritiesResponse> {
-            return localVarFp.getPunishmentSeverities(options).then((request) => request(axios, basePath));
+        listAll(options?: RawAxiosRequestConfig): AxiosPromise<Array<ServerSessionDTO>> {
+            return localVarFp.listAll(options).then((request) => request(axios, basePath));
         },
         /**
-         * Retrieve all active punishments for a player by UUID or username, optionally filtered by type and time
-         * @summary Get punishments by player
-         * @param {string | null} [uuid] Player UUID
-         * @param {string | null} [username] Player username
-         * @param {Array<string> | null} [type] Filter by punishment types
-         * @param {number | null} [since] Filter punishments created after this Unix epoch timestamp (milliseconds)
+         * Returns all currently online server sessions, ordered by start time descending.
+         * @summary List online server sessions
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        getPunishments1(uuid?: string | null, username?: string | null, type?: Array<string> | null, since?: number | null, options?: RawAxiosRequestConfig): AxiosPromise<Array<PunishmentGetPunishmentResponse>> {
-            return localVarFp.getPunishments1(uuid, username, type, since, options).then((request) => request(axios, basePath));
+        listOnline(options?: RawAxiosRequestConfig): AxiosPromise<Array<ServerSessionDTO>> {
+            return localVarFp.listOnline(options).then((request) => request(axios, basePath));
         },
         /**
-         * Retrieve all active punishments associated with an IP address
-         * @summary Get punishments by IP address
-         * @param {string} ip IP address
+         * Marks the session as offline with the current timestamp as `endedAt`. Call this from the game server\'s shutdown hook for a clean shutdown signal. Sessions that crash without calling this endpoint will be tombstoned automatically by the 2-minute heartbeat scheduler. 
+         * @summary Mark a session offline
+         * @param {string} id Session UUID returned from the registration call
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        getPunishmentsByIp(ip: string, options?: RawAxiosRequestConfig): AxiosPromise<Array<PunishmentGetPunishmentResponse>> {
-            return localVarFp.getPunishmentsByIp(ip, options).then((request) => request(axios, basePath));
+        markOffline(id: string, options?: RawAxiosRequestConfig): AxiosPromise<void> {
+            return localVarFp.markOffline(id, options).then((request) => request(axios, basePath));
         },
         /**
-         * Returns a paginated list of recent punishments with optional filtering by issue date, expiration date, and type
-         * @summary List recent punishments
-         * @param {number} limit Maximum number of records to return
-         * @param {number} page Page number for pagination
-         * @param {number | null} [issuedAfter] Filter punishments issued after this epoch timestamp (milliseconds)
-         * @param {number | null} [issuedBefore] Filter punishments issued before this epoch timestamp (milliseconds)
-         * @param {number | null} [expiresAfter] Filter punishments expiring after this epoch timestamp (milliseconds)
-         * @param {number | null} [expiresBefore] Filter punishments expiring before this epoch timestamp (milliseconds)
-         * @param {Array<string> | null} [type] Filter by punishment types
-         * @param {string | null} [uuid] Filter by player UUID
-         * @param {string | null} [ipAddress] Filter by IP address
+         * Registers a game server instance and returns a session ID used for subsequent heartbeats and chat ingestion. If a `containerId` is provided and an online session already exists for that container (e.g. after a Velocity restart), the existing session is returned unchanged. Otherwise a fresh session is created with an auto-generated instance name. 
+         * @summary Register a server session
+         * @param {ServerRegisterRequest} serverRegisterRequest 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        getRecentPunishments(limit: number, page: number, issuedAfter?: number | null, issuedBefore?: number | null, expiresAfter?: number | null, expiresBefore?: number | null, type?: Array<string> | null, uuid?: string | null, ipAddress?: string | null, options?: RawAxiosRequestConfig): AxiosPromise<Array<PunishmentGetPunishmentResponse>> {
-            return localVarFp.getRecentPunishments(limit, page, issuedAfter, issuedBefore, expiresAfter, expiresBefore, type, uuid, ipAddress, options).then((request) => request(axios, basePath));
+        register(serverRegisterRequest: ServerRegisterRequest, options?: RawAxiosRequestConfig): AxiosPromise<ServerSessionDTO> {
+            return localVarFp.register(serverRegisterRequest, options).then((request) => request(axios, basePath));
         },
     };
 };
 
 /**
- * PunishmentApi - object-oriented interface
+ * ServerSessionsApi - object-oriented interface
  */
-export class PunishmentApi extends BaseAPI {
-    /**
-     * Create and apply a punishment to a player. Automatically determines if permanent based on current score threshold (≥100%).
-     * @summary Apply a punishment
-     * @param {ApplyPunishmentRequest} applyPunishmentRequest 
-     * @param {*} [options] Override http request option.
-     * @throws {RequiredError}
-     */
-    public applyPunishment(applyPunishmentRequest: ApplyPunishmentRequest, options?: RawAxiosRequestConfig) {
-        return PunishmentApiFp(this.configuration).applyPunishment(applyPunishmentRequest, options).then((request) => request(this.axios, this.basePath));
-    }
-
+export class ServerSessionsApi extends BaseAPI {
     /**
-     * Preview punishment impact before applying. Returns calculated points, current/new thresholds, and whether it will be permanent.
-     * @summary Create a punishment draft
-     * @param {CreatePunishmentDraftRequest} createPunishmentDraftRequest 
+     * Updates the `last_heartbeat` timestamp for the given session, keeping it marked as online. Sessions that miss heartbeats for more than 2 minutes are automatically tombstoned by the scheduler. Call this every 30 seconds from the game server. 
+     * @summary Send a heartbeat
+     * @param {string} id Session UUID returned from the registration call
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    public createPunishmentDraft(createPunishmentDraftRequest: CreatePunishmentDraftRequest, options?: RawAxiosRequestConfig) {
-        return PunishmentApiFp(this.configuration).createPunishmentDraft(createPunishmentDraftRequest, options).then((request) => request(this.axios, this.basePath));
+    public heartbeat(id: string, options?: RawAxiosRequestConfig) {
+        return ServerSessionsApiFp(this.configuration).heartbeat(id, options).then((request) => request(this.axios, this.basePath));
     }
 
     /**
-     * Retrieve duration information for each punishment type and severity level (1-10)
-     * @summary Get punishment severities
+     * Returns all server sessions — both online and historical — ordered by start time descending. Used by the web UI to populate the session filter dropdown.
+     * @summary List all server sessions
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    public getPunishmentSeverities(options?: RawAxiosRequestConfig) {
-        return PunishmentApiFp(this.configuration).getPunishmentSeverities(options).then((request) => request(this.axios, this.basePath));
+    public listAll(options?: RawAxiosRequestConfig) {
+        return ServerSessionsApiFp(this.configuration).listAll(options).then((request) => request(this.axios, this.basePath));
     }
 
     /**
-     * Retrieve all active punishments for a player by UUID or username, optionally filtered by type and time
-     * @summary Get punishments by player
-     * @param {string | null} [uuid] Player UUID
-     * @param {string | null} [username] Player username
-     * @param {Array<string> | null} [type] Filter by punishment types
-     * @param {number | null} [since] Filter punishments created after this Unix epoch timestamp (milliseconds)
+     * Returns all currently online server sessions, ordered by start time descending.
+     * @summary List online server sessions
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    public getPunishments1(uuid?: string | null, username?: string | null, type?: Array<string> | null, since?: number | null, options?: RawAxiosRequestConfig) {
-        return PunishmentApiFp(this.configuration).getPunishments1(uuid, username, type, since, options).then((request) => request(this.axios, this.basePath));
+    public listOnline(options?: RawAxiosRequestConfig) {
+        return ServerSessionsApiFp(this.configuration).listOnline(options).then((request) => request(this.axios, this.basePath));
     }
 
     /**
-     * Retrieve all active punishments associated with an IP address
-     * @summary Get punishments by IP address
-     * @param {string} ip IP address
+     * Marks the session as offline with the current timestamp as `endedAt`. Call this from the game server\'s shutdown hook for a clean shutdown signal. Sessions that crash without calling this endpoint will be tombstoned automatically by the 2-minute heartbeat scheduler. 
+     * @summary Mark a session offline
+     * @param {string} id Session UUID returned from the registration call
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    public getPunishmentsByIp(ip: string, options?: RawAxiosRequestConfig) {
-        return PunishmentApiFp(this.configuration).getPunishmentsByIp(ip, options).then((request) => request(this.axios, this.basePath));
+    public markOffline(id: string, options?: RawAxiosRequestConfig) {
+        return ServerSessionsApiFp(this.configuration).markOffline(id, options).then((request) => request(this.axios, this.basePath));
     }
 
     /**
-     * Returns a paginated list of recent punishments with optional filtering by issue date, expiration date, and type
-     * @summary List recent punishments
-     * @param {number} limit Maximum number of records to return
-     * @param {number} page Page number for pagination
-     * @param {number | null} [issuedAfter] Filter punishments issued after this epoch timestamp (milliseconds)
-     * @param {number | null} [issuedBefore] Filter punishments issued before this epoch timestamp (milliseconds)
-     * @param {number | null} [expiresAfter] Filter punishments expiring after this epoch timestamp (milliseconds)
-     * @param {number | null} [expiresBefore] Filter punishments expiring before this epoch timestamp (milliseconds)
-     * @param {Array<string> | null} [type] Filter by punishment types
-     * @param {string | null} [uuid] Filter by player UUID
-     * @param {string | null} [ipAddress] Filter by IP address
+     * Registers a game server instance and returns a session ID used for subsequent heartbeats and chat ingestion. If a `containerId` is provided and an online session already exists for that container (e.g. after a Velocity restart), the existing session is returned unchanged. Otherwise a fresh session is created with an auto-generated instance name. 
+     * @summary Register a server session
+     * @param {ServerRegisterRequest} serverRegisterRequest 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    public getRecentPunishments(limit: number, page: number, issuedAfter?: number | null, issuedBefore?: number | null, expiresAfter?: number | null, expiresBefore?: number | null, type?: Array<string> | null, uuid?: string | null, ipAddress?: string | null, options?: RawAxiosRequestConfig) {
-        return PunishmentApiFp(this.configuration).getRecentPunishments(limit, page, issuedAfter, issuedBefore, expiresAfter, expiresBefore, type, uuid, ipAddress, options).then((request) => request(this.axios, this.basePath));
+    public register(serverRegisterRequest: ServerRegisterRequest, options?: RawAxiosRequestConfig) {
+        return ServerSessionsApiFp(this.configuration).register(serverRegisterRequest, options).then((request) => request(this.axios, this.basePath));
     }
 }