Puzzle Admin | Control Dashboard

Loading images...

Preview	Title	ID	Description	Category	Tags	Size	Popularity	Source	Status	Rating	Created	Updated	Star	Actions

Loading rooms...

Room ID	Image	Dimensions	Progress	Players (Active/Total)	Status	Creator	Completed	Guild	Channel	Deleted	Created	Last Activity	Action

Loading users...

User	User ID	Discord ID	Type	Status	Pieces Solved	Playtime	Created	Completed	Last Active	Registered	Action

Loading catalog...

Categories and tags organize puzzle images for the lobby gallery and search filters. Renaming an item cascades to all associated images automatically.

Categories: Display sections shown in the lobby. Uncategorized and the default preset categories cannot be deleted.
Tags: Lowercase search keywords (letters, numbers, hyphens). Tag suggestions appear when uploading images or running auto-detect.

When	Room	Sender	Message	Actions
No active room chat messages.

Players

Who can open the app, and which lobby controls they see.

Access

Guest play outside Discord, and uploads from the lobby.

Allow web / guest users

Disabled message Shown to web visitors while guest access is off.

Allow lobby URL uploads

Feature flags

Lobby controls a player can see. Room rules and chat live in their own groups.

Show the lobby "Show NSFW images" switch Each player's own "Hide NSFW content" preference applies either way.

Allow unlisted (code-only) rooms Web rooms stay public unless the host opts out. Discord Activity rooms are always unlisted.

Allow passwords on unlisted rooms Passwords are ignored on public rooms. Join checks the password before opening the live room.

Rooms

How rooms open, how many people they hold, and what happens during play.

Room rules

Who may end a room, and whether a public room is kept open.

Allow creators to delete public rooms Off by default. Unlisted web rooms stay deletable by their creator either way.

Allow Activity hosts to delete the channel room On by default. Off, the host returns to the title screen with no delete.

Always keep one public web room active Off by default. When on, a missing public room is opened from the featured catalog at 8×5.

House room preset Grid preset for the maintained house room. Default 8×5.

Default grid preset Initial piece count pre-selected in Create Room. Default 15×8.

Default difficulty mode Initial difficulty pre-selected in Create Room. Default Normal.

Room limits

Max active rooms Minimum 1. Maximum 10000. Default 1000.

Max rooms per user A player who already has this many unfinished rooms cannot create another. Minimum 1. Maximum 100. Default 10.

Max players per room Minimum 1. Maximum 500. Default 50.

During a puzzle

What happens while people are in a room. Each number is used as entered, within its minimum and maximum.

Max multi-select stack size Pieces a player can hold in one multi-select pile. Minimum 1. Maximum 100. Default 10.

Host idle threshold (seconds) Silence from the host before hosting passes to another player, in a room and in an Activity lobby. Minimum 5. Maximum 3600. Default 60.

Min. Disconnect Grace Period Seconds to wait after a dropped socket before announcing leave or handing over hosting. Minimum 0. Maximum 300. Default 3.

Max. Piece Hold Seconds a drag lock may sit idle before the server releases the piece. Minimum 1. Maximum 600. Default 15.

Chat and reports

Room chat, and which reports players are allowed to send.

Chat

Players can still open the drawer when sending is off.

Enable Chat On by default. When off, players can still open chat but cannot send.

Message length limit Characters. Longer messages are dropped. Minimum 1. Maximum 4000. Default 500.

Messages per 10 seconds Per player. Exceeding it replies with a slow-down notice rather than disconnecting. Minimum 1. Maximum 100. Default 5.

Messages kept per room Ring buffer replayed to a joining player. Minimum 1. Maximum 1000. Default 100.

Reports & moderation flags

Toggle reporting capabilities players can raise in the app.

User flags

Image flags

Message flags

User flags

Room flags

Room flags Off by default. When on, a right-click on the room code submits a report.

Images

What the lobby and admin URL import will accept.

Image intake

Applies to lobby URL imports and admin URL uploads. Direct file uploads are bounded by the browser.

Max image size (MB) Download is cancelled past this size. Minimum 1. Maximum 100. Default 20.

Minimum width (px) Minimum 1. Maximum 10000. Default 1200.

Minimum height (px) Minimum 1. Maximum 10000. Default 800.

AI Vision models

Workers AI models used for image captioning, tag generation, and NSFW classification.

Primary vision model Workers AI model id for queries and classification. Default @cf/moondream/moondream3.1-9B-A2B.

Fallback vision model Second model tried when the primary returns no response. Set identical to primary to disable fallback. Default @cf/meta/llama-3.2-11b-vision-instruct.

Retention

How long rooms, accounts, and collected errors are kept.

Retention

How long each record survives. The daily cron applies these numbers as entered, within each field's minimum and maximum.

Room history (days) How long a joinable room stays listed in its creator's History. Minimum 1. Maximum 365. Default 14.

Room abandonment (hours) Inactivity after which rejoining resets the board. Also bounds which puzzle PuzzleBot resumes. Minimum 1. Maximum 8760. Default 48.

Room soft-expiry (days) Inactivity after which a room stops being joinable. The record itself is kept. Minimum 1. Maximum 365. Default 14.

Empty room expiry (seconds) Rooms with nobody in them, at most one player in total, and no pieces placed. Includes public rooms. Minimum 30. Maximum 86400. Default 300.

Room record retention (days) Days after a room's last move before its record is purged from the database. Minimum 30. Maximum 3650. Default 60.

Guest account retention (days) Inactivity before a non-Discord account is purged. Minimum 1. Maximum 3650. Default 90.

Discord account retention (days) Inactivity before a Discord account is purged. Discord players are kept much longer than guests. Minimum 1. Maximum 3650. Default 365.

User session lifetime (days) How long player authentication sessions remain valid. Minimum 1. Maximum 365. Default 7.

Admin session lifetime (hours) How long admin dashboard sessions remain valid. Minimum 1. Maximum 168. Default 12.

Error collection

Collect client and admin errors When off, submitted errors are acknowledged but not stored, and the Errors page is hidden.

Error log retention (days) How long a collected browser error is kept after its last occurrence. Minimum 1. Maximum 3650. Default 30.

Operations

Request budgets. The short burst ceilings stay in the deploy config.

Rate limiting

Enable HTTP rate limiting

Sensitive writes per 10 min Login, registration, URL import, reports, AI. 0 leaves each route on its own budget. Minimum 0. Maximum 100000. Default 0.

Reads and mutations per 10 min Catalog, stats, room lookups, admin calls. 0 leaves each route on its own budget. Minimum 0. Maximum 100000. Default 0.

Image requests per 10 min Image file and thumbnail streaming. 0 leaves each route on its own budget. Minimum 0. Maximum 100000. Default 0.

PuzzleBot

Hosting in a Discord Activity, and messages players send to PuzzleBot.

PuzzleBot

Enable PuzzleBot hosting When off, PuzzleBot never claims hosting and the Bot page is hidden.

Post messages in the channel

Resume the last puzzle on arrival

Allow NSFW images

Next puzzle delay (seconds) Wait after a puzzle is completed before starting another. Minimum 0. Maximum 3600. Default 30.

Host idle threshold (seconds) Silence from the human host before PuzzleBot may take over. Minimum 1. Maximum 3600. Default 30.

Host pick window (seconds) Time allowed for a host to pick the next puzzle before PuzzleBot starts one automatically. Minimum 10. Maximum 600. Default 60.

Voice channels per server How many channels one server may run PuzzleBot in at once. Minimum 1. Maximum 100. Default 1.

Idle puzzles before standing down Consecutive bot puzzles nobody touches. Minimum 1. Maximum 50. Default 2.

Guild lease lifetime (seconds) How long one Activity instance holds a server's hosting claim before another may take it. Minimum 10. Maximum 86400. Default 120.

Minimum pieces No floor when this is 0. Minimum 0. Maximum 1000. Default 0.

Maximum pieces No ceiling when this is 0. Minimum 0. Maximum 1000. Default 0.

Player messages

Allow players to message PuzzleBot When off, players cannot send new PuzzleBot messages and the Messages page is hidden.

Messages per conversation A full thread stops accepting new player messages. Minimum 1. Maximum 5000. Default 200.

Integrations

A private management API, and the addresses notified when something happens.

Private API

API key Callers send this value in the X-Api-Key header. Leave it empty and every private API call is rejected. 16–256 characters when set.

Endpoints

GET /api/private/images
POST /api/private/images/upload
POST /api/private/images/url-import
POST /api/private/images/generate
POST /api/private/images/analyze
PUT /api/private/images/:id
DELETE /api/private/images/:id
POST /api/private/images/:id/restore
GET /api/private/rooms
DELETE /api/private/rooms/:id
GET /api/private/users
DELETE /api/private/users/:id
GET /api/private/flags
POST /api/private/flags
POST /api/private/flags/:id/dismiss
POST /api/private/flags/:id/resolve
GET /api/private/chat/flagged
DELETE /api/private/chat/messages/:id
POST /api/private/chat/flagged/:id/dismiss
PUT /api/private/catalog/categories/:id
PUT /api/private/catalog/tags/:id

Webhooks

Room created POST when a room is first created. Leave empty to skip.

Sample payload

{
  "event": "room.created",
  "occurredAt": 1710000000000,
  "data": {
    "roomId": "ABCD",
    "creatorId": "guest_1",
    "imageId": "img_ocean",
    "visibility": "public",
    "cols": 20,
    "rows": 10
  }
}

Room completed POST when every piece is locked. Leave empty to skip.

Sample payload

{
  "event": "room.completed",
  "occurredAt": 1710000000000,
  "data": {
    "roomId": "ABCD",
    "imageId": "img_ocean",
    "completedAt": 1710000000000,
    "elapsedMs": 754000,
    "players": [
      { "id": "guest_1", "username": "Ada", "count": 120 }
    ]
  }
}

Room idle expiry POST when empty or inactive rooms expire. reason is empty or inactive. Leave empty to skip.

Sample payload

{
  "event": "room.idle_expired",
  "occurredAt": 1710000000000,
  "data": {
    "reason": "empty",
    "rooms": [{ "roomId": "ABCD" }]
  }
}

Room deleted POST when a room is removed. reason is admin, owner, or moderation. A retention purge sends data.rooms instead of data.roomId. Leave empty to skip.

Sample payload

{
  "event": "room.deleted",
  "occurredAt": 1710000000000,
  "data": {
    "reason": "owner",
    "roomId": "ABCD"
  }
}

User created POST when a guest or Discord account is first stored. Leave empty to skip.

Sample payload

{
  "event": "user.created",
  "occurredAt": 1710000000000,
  "data": {
    "userId": "guest_1",
    "username": "Ada",
    "isDiscordUser": false
  }
}

Discord account linked POST when a guest account is linked to Discord. Leave empty to skip.

Sample payload

{
  "event": "user.discord_linked",
  "occurredAt": 1710000000000,
  "data": {
    "userId": "123456789012345678",
    "discordUserId": "123456789012345678",
    "username": "Ada"
  }
}

User image uploaded POST when a player imports an image. Leave empty to skip.

Sample payload

{
  "event": "user.image_uploaded",
  "occurredAt": 1710000000000,
  "data": {
    "imageId": "usr_ocean",
    "title": "Coral reef",
    "width": 1920,
    "height": 1080
  }
}

PuzzleBot activity POST when PuzzleBot starts, finishes, or drops a puzzle. action is started, completed, or deleted. Leave empty to skip.

Sample payload

{
  "event": "puzzlebot.activity",
  "occurredAt": 1710000000000,
  "data": {
    "action": "started",
    "roomId": "ABCD",
    "instanceId": "i-1",
    "guildId": "123456789012345678",
    "channelId": "234567890123456789",
    "imageId": "img_ocean"
  }
}

Item flagged POST when a report is first stored. Leave empty to skip.

Sample payload

{
  "event": "item.flagged",
  "occurredAt": 1710000000000,
  "data": {
    "flagId": "flag_1",
    "entityType": "image",
    "entityId": "img_ocean",
    "roomId": null,
    "reason": "user_report"
  }
}

Captured error POST when a client or admin error is captured. Leave empty to skip.

Sample payload

{
  "event": "error.captured",
  "occurredAt": 1710000000000,
  "data": {
    "id": "ce_1710000000000_abcde",
    "fingerprint": "a1b2c3d4e5f6",
    "source": "client",
    "kind": "error",
    "message": "Uncaught TypeError: Cannot read properties of undefined",
    "stack": "TypeError: Cannot read properties of undefined\n    at render...",
    "pageUrl": "https://puzzles.samliew.net/room/ABCD",
    "userAgent": "Mozilla/5.0...",
    "appVersion": "1.0.0",
    "userId": "guest_1",
    "roomId": "ABCD",
    "repeat": false
  }
}

Support message created POST when a player sends a message to PuzzleBot. Leave empty to skip.

Sample payload

{
  "event": "support.message_created",
  "occurredAt": 1710000000000,
  "data": {
    "conversationId": "sc_guest_1",
    "messageId": "sm_1710000000000_abcde",
    "userId": "guest_1",
    "username": "Player",
    "content": "Need help with a puzzle"
  }
}

Categories

Tags

Players

Access

Feature flags

Rooms

Room rules

Room limits

During a puzzle

Chat and reports

Chat

Reports & moderation flags

User flags

Room flags

Images

Image intake

AI Vision models

Retention

Retention

Error collection

Operations

Rate limiting

PuzzleBot

PuzzleBot

Player messages

Integrations

Private API

Endpoints

Webhooks

Edit Image