@rebornteam/reborn-api 3.2.1 → 4.5.0

package/docs/AdminPlayersApi.md

@@ -4,13 +4,868 @@ All URIs are relative to *https://api.smsh.sh*
 
 |Method | HTTP request | Description|
 |------------- | ------------- | -------------|
+|[**addAltExemption**](#addaltexemption) | **POST** /admin/player/{uuid}/alt-exemption | Add an alt exemption|
+|[**backfillUsernames**](#backfillusernames) | **POST** /admin/player/backfill-usernames | Start a username backfill job|
+|[**bulkRevokePropagated**](#bulkrevokepropagated) | **POST** /admin/player/player-punishment/bulk-revoke | Bulk-revoke PROPAGATED links by source|
+|[**createPlayerNote**](#createplayernote) | **POST** /admin/player/{uuid}/note | Create a staff note on a player|
+|[**deletePlayerNote**](#deleteplayernote) | **DELETE** /admin/player/{uuid}/note/{noteId} | Soft-delete a staff note|
+|[**getAltGraph**](#getaltgraph) | **GET** /admin/player/{uuid}/alt-graph | Alt-graph traversal rooted at a player|
 |[**getPlayer**](#getplayer) | **GET** /admin/player/{uuid} | Get player detail|
+|[**getPlayerAlts**](#getplayeralts) | **GET** /admin/player/{uuid}/alts | List a player\'s alt accounts|
+|[**getPlayerConnections**](#getplayerconnections) | **GET** /admin/player/{uuid}/connections | List a player\'s connection history|
+|[**getPlayerPunishments**](#getplayerpunishments) | **GET** /admin/player/{uuid}/player-punishments | List a player\'s full punishment history|
+|[**getSessionStats**](#getsessionstats) | **GET** /admin/player/{uuid}/session-stats | Get a player\'s aggregate session stats|
+|[**listAltExemptions**](#listaltexemptions) | **GET** /admin/player/{uuid}/alt-exemption | List a player\'s alt exemptions|
+|[**listPlayerNotes**](#listplayernotes) | **GET** /admin/player/{uuid}/notes | List staff notes on a player|
 |[**listPlayers**](#listplayers) | **GET** /admin/player | List players|
+|[**listSessions**](#listsessions) | **GET** /admin/player/{uuid}/sessions | List a player\'s session history|
+|[**removeAltExemption**](#removealtexemption) | **DELETE** /admin/player/{uuid}/alt-exemption/{altPlayerUuid} | Remove an alt exemption|
+|[**revokePropagatedLink**](#revokepropagatedlink) | **DELETE** /admin/player/{uuid}/player-punishment/{playerPunishmentId} | Revoke a propagated punishment link|
+|[**setAggressiveModeImmunity**](#setaggressivemodeimmunity) | **PATCH** /admin/player/{uuid}/aggressive-mode-immunity | Toggle aggressive-mode immunity|
+|[**trustFactorBreakdown**](#trustfactorbreakdown) | **GET** /admin/player/{uuid}/trust-factor-breakdown | Trust factor breakdown for a player|
+|[**trustFactorHistory**](#trustfactorhistory) | **GET** /admin/player/{uuid}/trust-factor-history | Trust factor history for a player|
+
+# **addAltExemption**
+> addAltExemption(adminCreateAltExemptionRequest)
+
+Mark another player as a known-legitimate associate (e.g. roommate). The relationship is stored symmetrically: subsequent aggressive-mode propagation skips this pair as an alt source in either direction. Finer-grained than the per-player aggressive_mode_immunity flag.
+
+### Example
+
+```typescript
+import {
+    AdminPlayersApi,
+    Configuration,
+    AdminCreateAltExemptionRequest
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminPlayersApi(configuration);
+
+let uuid: string; //Player Minecraft UUID (default to undefined)
+let adminCreateAltExemptionRequest: AdminCreateAltExemptionRequest; //
+
+const { status, data } = await apiInstance.addAltExemption(
+    uuid,
+    adminCreateAltExemptionRequest
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **adminCreateAltExemptionRequest** | **AdminCreateAltExemptionRequest**|  | |
+| **uuid** | [**string**] | Player Minecraft UUID | defaults to undefined|
+
+
+### Return type
+
+void (empty response body)
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: Not defined
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**201** | Exemption created (or already existed; idempotent) |  -  |
+|**400** | Cannot exempt a player from themselves |  -  |
+|**404** | Either UUID does not match a known player |  -  |
+|**401** | Unauthorized |  -  |
+|**403** | Forbidden - Moderator role required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **backfillUsernames**
+> AdminAsyncJobStartResponse backfillUsernames()
+
+Submits an async job that walks every player row whose username is NULL and calls the Mojang profile API to resolve it. The job upserts both the player.username column and a player_username_history row. Returns immediately with a job id — poll GET /admin/job/{id} for progress and DELETE /admin/job/{id} to cancel. The final Admin_BackfillUsernamesResponse (processed/succeeded/failed counts) lands in the job\'s result_payload on COMPLETED. Mojang rate-limits at ~1 req/sec; a backfill of many rows can run for a while — cancel is honoured between rows.
+
+### Example
+
+```typescript
+import {
+    AdminPlayersApi,
+    Configuration
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminPlayersApi(configuration);
+
+const { status, data } = await apiInstance.backfillUsernames();
+```
+
+### Parameters
+This endpoint does not have any parameters.
+
+
+### Return type
+
+**AdminAsyncJobStartResponse**
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**202** | Job accepted; poll /admin/job/{id} for progress |  -  |
+|**401** | Unauthorized |  -  |
+|**403** | Forbidden - Moderator role required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **bulkRevokePropagated**
+> AdminBulkRevokeResponse bulkRevokePropagated(adminBulkRevokeRequest)
+
+Soft-revokes every currently active PROPAGATED player_punishment row whose source matches the supplied id. Exactly one of sourcePlayerId / sourceConnectionId must be set. Useful when staff identify a single source as a false positive (e.g. shared NAT, legitimate roommate) and want to undo every link it caused in one operation.
+
+### Example
+
+```typescript
+import {
+    AdminPlayersApi,
+    Configuration,
+    AdminBulkRevokeRequest
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminPlayersApi(configuration);
+
+let adminBulkRevokeRequest: AdminBulkRevokeRequest; //
+
+const { status, data } = await apiInstance.bulkRevokePropagated(
+    adminBulkRevokeRequest
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **adminBulkRevokeRequest** | **AdminBulkRevokeRequest**|  | |
+
+
+### Return type
+
+**AdminBulkRevokeResponse**
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Bulk revoke complete; response carries the number of rows updated |  -  |
+|**400** | Both or neither source field supplied |  -  |
+|**401** | Unauthorized |  -  |
+|**403** | Forbidden - Moderator role required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **createPlayerNote**
+> AdminPlayerNote createPlayerNote(adminCreatePlayerNoteRequest)
+
+Appends a free-form note (1–4000 chars). Notes are not editable — to revise, post a new one and soft-delete the old.
+
+### Example
+
+```typescript
+import {
+    AdminPlayersApi,
+    Configuration,
+    AdminCreatePlayerNoteRequest
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminPlayersApi(configuration);
+
+let uuid: string; //Player Minecraft UUID (default to undefined)
+let adminCreatePlayerNoteRequest: AdminCreatePlayerNoteRequest; //
+
+const { status, data } = await apiInstance.createPlayerNote(
+    uuid,
+    adminCreatePlayerNoteRequest
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **adminCreatePlayerNoteRequest** | **AdminCreatePlayerNoteRequest**|  | |
+| **uuid** | [**string**] | Player Minecraft UUID | defaults to undefined|
+
+
+### Return type
+
+**AdminPlayerNote**
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**201** | Note created |  -  |
+|**404** | Player not found |  -  |
+|**401** | Unauthorized |  -  |
+|**403** | Forbidden - Moderator role required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **deletePlayerNote**
+> deletePlayerNote()
+
+Marks the note as deleted but keeps the row for audit. Idempotent — 404 if already deleted or unknown id.
+
+### Example
+
+```typescript
+import {
+    AdminPlayersApi,
+    Configuration
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminPlayersApi(configuration);
+
+let uuid: string; //Player Minecraft UUID (routing only) (default to undefined)
+let noteId: number; //Note id (default to undefined)
+
+const { status, data } = await apiInstance.deletePlayerNote(
+    uuid,
+    noteId
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **uuid** | [**string**] | Player Minecraft UUID (routing only) | defaults to undefined|
+| **noteId** | [**number**] | Note id | defaults to undefined|
+
+
+### Return type
+
+void (empty response body)
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: Not defined
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**204** | Note deleted |  -  |
+|**404** | Note not found or already deleted |  -  |
+|**401** | Unauthorized |  -  |
+|**403** | Forbidden - Moderator role required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **getAltGraph**
+> AdminAltGraph getAltGraph()
+
+Returns the connection-shared player graph reachable from this player within {depth} hops. Mirrors the propagation walk used by ALT_PROPAGATION_SWEEP — promiscuous (likely shared-NAT) connections are pruned, alt-exemption rows cut the graph at exempted players. Depth is clamped server-side at 5. Used by the admin Graph tab to render an interactive explorer.
+
+### Example
+
+```typescript
+import {
+    AdminPlayersApi,
+    Configuration
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminPlayersApi(configuration);
+
+let uuid: string; //Player Minecraft UUID (default to undefined)
+let depth: number; //Hop depth to walk. 1=direct alts only; 5=full sticky-trap radius. Default 2. (optional) (default to 2)
+
+const { status, data } = await apiInstance.getAltGraph(
+    uuid,
+    depth
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **uuid** | [**string**] | Player Minecraft UUID | defaults to undefined|
+| **depth** | [**number**] | Hop depth to walk. 1=direct alts only; 5=full sticky-trap radius. Default 2. | (optional) defaults to 2|
+
+
+### Return type
+
+**AdminAltGraph**
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Graph traversal complete |  -  |
+|**401** | Unauthorized |  -  |
+|**403** | Forbidden - Moderator role required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
 # **getPlayer**
 > AdminPlayerDetailResponse getPlayer()
 
-Returns full detail for a single player including all known usernames and punishment scoring.
+Returns full detail for a single player including all known usernames and punishment scoring.
+
+### Example
+
+```typescript
+import {
+    AdminPlayersApi,
+    Configuration
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminPlayersApi(configuration);
+
+let uuid: string; //Player Minecraft UUID (default to undefined)
+
+const { status, data } = await apiInstance.getPlayer(
+    uuid
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **uuid** | [**string**] | Player Minecraft UUID | defaults to undefined|
+
+
+### Return type
+
+**AdminPlayerDetailResponse**
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Player detail retrieved successfully |  -  |
+|**404** | Player not found |  -  |
+|**401** | Unauthorized |  -  |
+|**403** | Forbidden - Moderator role required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **getPlayerAlts**
+> PageAdminAltAccount getPlayerAlts()
+
+Other players who have been seen on at least one of this player\'s historical connections. Sorted by shared-connection count desc, then last seen desc.
+
+### Example
+
+```typescript
+import {
+    AdminPlayersApi,
+    Configuration,
+    Pageable
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminPlayersApi(configuration);
+
+let uuid: string; //Player Minecraft UUID (default to undefined)
+let pageable: Pageable; // (default to undefined)
+
+const { status, data } = await apiInstance.getPlayerAlts(
+    uuid,
+    pageable
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **uuid** | [**string**] | Player Minecraft UUID | defaults to undefined|
+| **pageable** | **Pageable** |  | defaults to undefined|
+
+
+### Return type
+
+**PageAdminAltAccount**
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Alt list retrieved successfully |  -  |
+|**401** | Unauthorized |  -  |
+|**403** | Forbidden - Moderator role required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **getPlayerConnections**
+> PageAdminDashboardConnectionResponse getPlayerConnections()
+
+Paginated list of every connection this player has used (latest first). Same shape as the dashboard connection list, suitable for an infinite-scroll panel inside the player detail modal.
+
+### Example
+
+```typescript
+import {
+    AdminPlayersApi,
+    Configuration,
+    Pageable
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminPlayersApi(configuration);
+
+let uuid: string; //Player Minecraft UUID (default to undefined)
+let pageable: Pageable; // (default to undefined)
+
+const { status, data } = await apiInstance.getPlayerConnections(
+    uuid,
+    pageable
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **uuid** | [**string**] | Player Minecraft UUID | defaults to undefined|
+| **pageable** | **Pageable** |  | defaults to undefined|
+
+
+### Return type
+
+**PageAdminDashboardConnectionResponse**
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Connection history retrieved successfully |  -  |
+|**401** | Unauthorized |  -  |
+|**403** | Forbidden - Moderator role required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **getPlayerPunishments**
+> PageAdminPlayerPunishmentResponse getPlayerPunishments()
+
+Paginated list of every player_punishment row for this player — DIRECT and PROPAGATED, active and revoked. Includes the transfer_note explaining why each propagated link was inserted and the revocation audit trail. The admin UI uses this to render a punishment-history section inside the player detail modal.
+
+### Example
+
+```typescript
+import {
+    AdminPlayersApi,
+    Configuration,
+    Pageable
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminPlayersApi(configuration);
+
+let uuid: string; //Player Minecraft UUID (default to undefined)
+let pageable: Pageable; // (default to undefined)
+
+const { status, data } = await apiInstance.getPlayerPunishments(
+    uuid,
+    pageable
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **uuid** | [**string**] | Player Minecraft UUID | defaults to undefined|
+| **pageable** | **Pageable** |  | defaults to undefined|
+
+
+### Return type
+
+**PageAdminPlayerPunishmentResponse**
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Punishment history retrieved |  -  |
+|**401** | Unauthorized |  -  |
+|**403** | Forbidden - Moderator role required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **getSessionStats**
+> AdminPlayerSessionStats getSessionStats()
+
+Single-row summary: total seconds played, session count, distinct days active, most recent session start, and whether the player is currently online. Computed on demand from player_session. Feeds the trust factor system.
+
+### Example
+
+```typescript
+import {
+    AdminPlayersApi,
+    Configuration
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminPlayersApi(configuration);
+
+let uuid: string; //Player Minecraft UUID (default to undefined)
+
+const { status, data } = await apiInstance.getSessionStats(
+    uuid
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **uuid** | [**string**] | Player Minecraft UUID | defaults to undefined|
+
+
+### Return type
+
+**AdminPlayerSessionStats**
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Stats retrieved |  -  |
+|**401** | Unauthorized |  -  |
+|**403** | Forbidden - Moderator role required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **listAltExemptions**
+> PageAdminAltExemption listAltExemptions()
+
+Paginated list of the player\'s known-legitimate-associate exemptions. The list reflects rows where this player is the source side (player_id = this); since exemptions are stored symmetrically the reciprocal rows exist too.
+
+### Example
+
+```typescript
+import {
+    AdminPlayersApi,
+    Configuration,
+    Pageable
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminPlayersApi(configuration);
+
+let uuid: string; //Player Minecraft UUID (default to undefined)
+let pageable: Pageable; // (default to undefined)
+
+const { status, data } = await apiInstance.listAltExemptions(
+    uuid,
+    pageable
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **uuid** | [**string**] | Player Minecraft UUID | defaults to undefined|
+| **pageable** | **Pageable** |  | defaults to undefined|
+
+
+### Return type
+
+**PageAdminAltExemption**
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Exemption list retrieved |  -  |
+|**401** | Unauthorized |  -  |
+|**403** | Forbidden - Moderator role required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **listPlayerNotes**
+> PageAdminPlayerNote listPlayerNotes()
+
+Paginated, newest first. Soft-deleted notes are included; the UI styles them as struck-through.
+
+### Example
+
+```typescript
+import {
+    AdminPlayersApi,
+    Configuration,
+    Pageable
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminPlayersApi(configuration);
+
+let uuid: string; //Player Minecraft UUID (default to undefined)
+let pageable: Pageable; // (default to undefined)
+
+const { status, data } = await apiInstance.listPlayerNotes(
+    uuid,
+    pageable
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **uuid** | [**string**] | Player Minecraft UUID | defaults to undefined|
+| **pageable** | **Pageable** |  | defaults to undefined|
+
+
+### Return type
+
+**PageAdminPlayerNote**
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Notes retrieved |  -  |
+|**401** | Unauthorized |  -  |
+|**403** | Forbidden - Moderator role required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **listPlayers**
+> PageAdminPlayerSummary listPlayers()
+
+Returns up to 500 players ordered by most recently seen. Optionally filter by UUID or username substring.
+
+### Example
+
+```typescript
+import {
+    AdminPlayersApi,
+    Configuration,
+    Pageable
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminPlayersApi(configuration);
+
+let pageable: Pageable; // (default to undefined)
+let search: string; //Optional search string matched against UUID or username (case-insensitive substring) (optional) (default to undefined)
+
+const { status, data } = await apiInstance.listPlayers(
+    pageable,
+    search
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **pageable** | **Pageable** |  | defaults to undefined|
+| **search** | [**string**] | Optional search string matched against UUID or username (case-insensitive substring) | (optional) defaults to undefined|
+
+
+### Return type
+
+**PageAdminPlayerSummary**
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Player list retrieved successfully |  -  |
+|**401** | Unauthorized |  -  |
+|**403** | Forbidden - Moderator role required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **listSessions**
+> PageAdminPlayerSession listSessions()
+
+Paginated history of player_session rows (active + closed), newest first. Each row records one visit by this player to one game server. Used by the admin player detail view and as the underlying data for the session-stats aggregate.
+
+### Example
+
+```typescript
+import {
+    AdminPlayersApi,
+    Configuration,
+    Pageable
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminPlayersApi(configuration);
+
+let uuid: string; //Player Minecraft UUID (default to undefined)
+let pageable: Pageable; // (default to undefined)
+
+const { status, data } = await apiInstance.listSessions(
+    uuid,
+    pageable
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **uuid** | [**string**] | Player Minecraft UUID | defaults to undefined|
+| **pageable** | **Pageable** |  | defaults to undefined|
+
+
+### Return type
+
+**PageAdminPlayerSession**
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Session history retrieved |  -  |
+|**401** | Unauthorized |  -  |
+|**403** | Forbidden - Moderator role required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **removeAltExemption**
+> removeAltExemption()
+
+Delete the symmetric exemption pair between two players. Both directions are removed.
 
 ### Example
 
@@ -24,9 +879,126 @@ const configuration = new Configuration();
 const apiInstance = new AdminPlayersApi(configuration);
 
 let uuid: string; //Player Minecraft UUID (default to undefined)
+let altPlayerUuid: string; //UUID of the alt to remove from exemption (default to undefined)
 
-const { status, data } = await apiInstance.getPlayer(
-    uuid
+const { status, data } = await apiInstance.removeAltExemption(
+    uuid,
+    altPlayerUuid
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **uuid** | [**string**] | Player Minecraft UUID | defaults to undefined|
+| **altPlayerUuid** | [**string**] | UUID of the alt to remove from exemption | defaults to undefined|
+
+
+### Return type
+
+void (empty response body)
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: Not defined
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**204** | Exemption(s) deleted; or no rows existed |  -  |
+|**404** | Either UUID does not match a known player |  -  |
+|**401** | Unauthorized |  -  |
+|**403** | Forbidden - Moderator role required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **revokePropagatedLink**
+> revokePropagatedLink()
+
+Soft-deletes a single player_punishment row that was inserted by aggressive-mode propagation. The source punishment record is untouched — only the link between this player and that punishment is removed from enforcement. Rejected with 404 if the row is DIRECT (the original punishment record) or already revoked.
+
+### Example
+
+```typescript
+import {
+    AdminPlayersApi,
+    Configuration
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminPlayersApi(configuration);
+
+let uuid: string; //Player Minecraft UUID (for routing/audit context; the link id is the source of truth) (default to undefined)
+let playerPunishmentId: number; //player_punishment row id (default to undefined)
+
+const { status, data } = await apiInstance.revokePropagatedLink(
+    uuid,
+    playerPunishmentId
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **uuid** | [**string**] | Player Minecraft UUID (for routing/audit context; the link id is the source of truth) | defaults to undefined|
+| **playerPunishmentId** | [**number**] | player_punishment row id | defaults to undefined|
+
+
+### Return type
+
+void (empty response body)
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: Not defined
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**204** | Link revoked |  -  |
+|**404** | Link not found, already revoked, or DIRECT (cannot revoke a non-propagated link via this endpoint) |  -  |
+|**401** | Unauthorized |  -  |
+|**403** | Forbidden - Moderator role required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **setAggressiveModeImmunity**
+> AdminPlayerDetailResponse setAggressiveModeImmunity(adminSetAggressiveModeImmunityRequest)
+
+Sets whether a player is exempt from aggressive-mode propagation. Flipping the flag ON also bulk-revokes every currently active PROPAGATED link for the player in the same transaction, so the player\'s enforcement state immediately reflects the cleared status. Flipping back to OFF re-enables propagation but does NOT un-revoke previously-revoked links.
+
+### Example
+
+```typescript
+import {
+    AdminPlayersApi,
+    Configuration,
+    AdminSetAggressiveModeImmunityRequest
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminPlayersApi(configuration);
+
+let uuid: string; //Player Minecraft UUID (default to undefined)
+let adminSetAggressiveModeImmunityRequest: AdminSetAggressiveModeImmunityRequest; //
+
+const { status, data } = await apiInstance.setAggressiveModeImmunity(
+    uuid,
+    adminSetAggressiveModeImmunityRequest
 );
 ```
 
@@ -34,6 +1006,7 @@ const { status, data } = await apiInstance.getPlayer(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
+| **adminSetAggressiveModeImmunityRequest** | **AdminSetAggressiveModeImmunityRequest**|  | |
 | **uuid** | [**string**] | Player Minecraft UUID | defaults to undefined|
 
 
@@ -45,6 +1018,60 @@ const { status, data } = await apiInstance.getPlayer(
 
 [DiscordAuth](../README.md#DiscordAuth)
 
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Immunity flag updated; returns the refreshed player detail |  -  |
+|**404** | Player not found |  -  |
+|**401** | Unauthorized |  -  |
+|**403** | Forbidden - Moderator role required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **trustFactorBreakdown**
+> AdminTrustFactorBreakdown trustFactorBreakdown()
+
+Returns every subtotal (bonuses / penalties) and the underlying signal counts that fed compute_trust_factor for this player. The {@code finalScore} matches what GET /admin/player/{uuid} returns; this endpoint adds the per-component detail. Used by the admin UI \"why is this score what it is?\" tooltip. Informational only — trust factor never auto-escalates punishments.
+
+### Example
+
+```typescript
+import {
+    AdminPlayersApi,
+    Configuration
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminPlayersApi(configuration);
+
+let uuid: string; //Player Minecraft UUID (default to undefined)
+
+const { status, data } = await apiInstance.trustFactorBreakdown(
+    uuid
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **uuid** | [**string**] | Player Minecraft UUID | defaults to undefined|
+
+
+### Return type
+
+**AdminTrustFactorBreakdown**
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
 ### HTTP request headers
 
  - **Content-Type**: Not defined
@@ -54,17 +1081,17 @@ const { status, data } = await apiInstance.getPlayer(
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** | Player detail retrieved successfully |  -  |
+|**200** | Breakdown computed |  -  |
 |**404** | Player not found |  -  |
 |**401** | Unauthorized |  -  |
 |**403** | Forbidden - Moderator role required |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
-# **listPlayers**
-> AdminPagedPlayerResponse listPlayers()
+# **trustFactorHistory**
+> AdminTrustFactorHistoryEntry trustFactorHistory()
 
-Returns up to 500 players ordered by most recently seen. Optionally filter by UUID or username substring.
+Returns one snapshot per day (oldest first) over the requested window. Useful for trend visualization. The daily snapshot job runs at 03:00 UTC; days with no row indicate the snapshot job didn\'t run that day (e.g., outage).
 
 ### Example
 
@@ -77,14 +1104,12 @@ import {
 const configuration = new Configuration();
 const apiInstance = new AdminPlayersApi(configuration);
 
-let page: number; //Page number (1-indexed) (default to 1)
-let limit: number; //Page size (default to 50)
-let search: string; //Optional search string matched against UUID or username (case-insensitive substring) (optional) (default to undefined)
+let uuid: string; //Player Minecraft UUID (default to undefined)
+let days: number; //Window in days (default 30, max 365) (optional) (default to 30)
 
-const { status, data } = await apiInstance.listPlayers(
-    page,
-    limit,
-    search
+const { status, data } = await apiInstance.trustFactorHistory(
+    uuid,
+    days
 );
 ```
 
@@ -92,14 +1117,13 @@ const { status, data } = await apiInstance.listPlayers(
 
 |Name | Type | Description  | Notes|
 |------------- | ------------- | ------------- | -------------|
-| **page** | [**number**] | Page number (1-indexed) | defaults to 1|
-| **limit** | [**number**] | Page size | defaults to 50|
-| **search** | [**string**] | Optional search string matched against UUID or username (case-insensitive substring) | (optional) defaults to undefined|
+| **uuid** | [**string**] | Player Minecraft UUID | defaults to undefined|
+| **days** | [**number**] | Window in days (default 30, max 365) | (optional) defaults to 30|
 
 
 ### Return type
 
-**AdminPagedPlayerResponse**
+**AdminTrustFactorHistoryEntry**
 
 ### Authorization
 
@@ -114,7 +1138,7 @@ const { status, data } = await apiInstance.listPlayers(
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-|**200** | Player list retrieved successfully |  -  |
+|**200** | History retrieved |  -  |
 |**401** | Unauthorized |  -  |
 |**403** | Forbidden - Moderator role required |  -  |