CofferCall

Eight checks before you queue.

CofferCall is a YourBot Marketplace plugin for eight-player FINAL FANTASY XIV Savage raid statics. Before the group queues, each configured roster member records whether they are eligible, replaying, or unsure on each enabled floor. The shared board summarizes what the exact lineup should expect from the current weekly reward lockout.

CofferCall deliberately does not inspect the game. Discord self-reports make the tool private, predictable, and usable without a game account link, parser, client plugin, or external service. The in-game duty warning remains authoritative.

Outcomes

For every enabled floor, CofferCall displays one of these states:

• Expected full reward contents — all eight members confirmed eligible.
• Expected reduced reward contents — one to four members confirmed replaying and everyone else confirmed eligible.
• Expected no treasure coffer — at least five members confirmed replaying.
• Unknown - confirmation required — a mark is missing or someone is unsure.
• Setup incomplete — the active roster is not exactly eight unique Discord users.
• Weekly restriction disabled by a manager — the configured tier has been marked as unlocked.

These are preflight estimates based only on saved self-reports. They are never guarantees.

Setup

1. Install CofferCall from YourBot and grant its two explicit capabilities, storage:kv and interaction:respond.
2. Open the plugin dashboard as a server manager.
3. In Tier Setup, set a generic tier name, enable one to four floors, give each enabled floor a label, and confirm whether the weekly restriction is active.
4. In Roster, enter exactly eight unique Discord user IDs. Labels are optional.
5. Ask each roster member to submit a mark for every enabled floor with /coffer-mark or the board buttons.
6. Run /coffer-call, review the shared result, and verify the in-game duty warning before commencing.

Changing ordered roster membership starts a new roster revision. Material floor-slot changes or Start a new tier advance the tier revision so old marks cannot leak into a new lineup or tier. Label-only corrections do not discard current marks.

Commands

• /coffer-call opens the public board for the current reset.
• /coffer-mark floor status privately records eligible, replaying, or unsure, or clears your mark. Only configured roster members can mark.
• /coffer-me privately shows your current marks, their update times, and the next reset.
• /coffer-snapshot publishes and durably saves an immutable preflight snapshot. Only configured roster members can create one.

Board buttons and refresh behavior

The public board contains four status buttons for each floor: Eligible, Replaying, Unsure, and Clear. A disabled floor remains visible, but its buttons are disabled.

Status-button responses are ephemeral. A status change writes only that member's floor record and intentionally does not edit an existing public board. This avoids concurrent clicks overwriting one another and prevents a busy board from changing while the group is reading it.

Use Refresh Board to reread durable state and replace the complete board message. Use Save Snapshot to save the exact matrix and outcome set, then refresh the board with a snapshot confirmation. Buttons on an old reset, tier revision, or roster revision are rejected safely.

Weekly reset

The CofferCall week rolls over every Tuesday at 08:00 UTC, calculated on demand without cron or background jobs. Tuesday at 07:59:59 UTC belongs to the previous week; Tuesday at 08:00:00 UTC begins the new one. Daylight-saving changes do not alter this boundary.

Old records remain isolated under their week, tier, and roster revisions until their configured retention period expires. The default retention is 12 weeks; managers may choose 4–52 weeks.

Dashboard

• Overview is viewer-accessible and shows the reset, confirmation progress, floor outcomes, current roster, recent snapshots, and policy notice.
• Tier Setup is manager-only and controls the tier name, lockout, retention, floor labels, enabled floors, and explicit new-tier action.
• Roster is manager-only and contains eight fixed user-ID and label slots.
• History is viewer-accessible and provides paginated immutable snapshots.

YourBot enforces manager access for configuration saves. CofferCall does not request Discord member-directory access, so IDs are validated by format and uniqueness rather than looked up in the guild. Each manager form includes an edit-version guard. Leave it unchanged; if another manager saves first, CofferCall rejects the stale form and asks you to reload instead of overwriting newer configuration.

Privacy and stored data

CofferCall stores data in YourBot's per-server key-value namespace. One server cannot read another server's CofferCall state. Stored data is limited to:

• generic tier and floor configuration;
• the eight Discord user IDs and optional manager-provided labels;
• self-reported per-floor status, update timestamp, and interaction identifier;
• tier, roster, and state revision numbers;
• a non-personal configuration edit-version counter; and
• immutable snapshots containing the roster, configuration, status matrix, outcomes, creator ID, and timestamp.

Status and snapshot records expire according to the configured retention period. CofferCall does not store FFXIV credentials, character data, account links, messages, server tokens, secrets, or game telemetry. It does not read Discord messages or the guild member directory.

Capabilities and policy boundary

The manifest explicitly requests two capabilities:

storage:kv
interaction:respond

interaction:respond is the safe capability that lets CofferCall reply to its own slash commands and board buttons. It must be declared explicitly: yourbot validate does not infer it from the declared slash commands, so a plugin that responds to interactions but omits it fails validation. CofferCall declares no proxy domains or scheduled jobs and does not request message sending/editing, Discord reads, message content, SQL, secrets, HTTP, WebSockets, or role-management capabilities.

CofferCall is an independent Discord coordination utility. It does not connect to, read, modify, automate, or interact with the FINAL FANTASY XIV game client or game servers. All statuses are self-reported. FINAL FANTASY XIV and related marks are property of Square Enix. CofferCall is not affiliated with, endorsed by, or sponsored by Square Enix.

See DISCLAIMER.md for the standalone policy notice.

Troubleshooting

The board says setup is incomplete

Open Tier Setup and Roster as a manager. At least one floor must be enabled, and the roster must contain exactly eight unique 17–20 digit Discord user IDs.

My mark was saved, but the public board did not change

This is intentional. Status buttons never mutate a public board. Press Refresh Board to render the latest durable state.

A button says the board is stale

Open a fresh board with /coffer-call. The old message belongs to a previous reset, tier revision, roster revision, or component schema.

A member cannot submit a mark

Confirm that their Discord user ID appears in the active roster and that the selected floor is enabled. If configuration changed, open a fresh board.

The result says the weekly restriction is disabled

A manager turned off the lockout in Tier Setup. CofferCall will not predict reward contents while that switch is off.

A command reports a rate limit or duplicate interaction

Wait for the indicated window and try again. Interaction deduplication and per-user limits protect state from duplicate Discord delivery and accidental rapid clicks.

Marketplace listing copy

Tagline: Eight checks before you queue.

Short description: CofferCall gives eight-player raid statics a shared, self-reported weekly Savage reward preflight. Each member confirms every floor, and the board shows whether the exact lineup should expect full, reduced, no, or unknown coffer contents.

Features:

• One-click per-floor member check-in.
• Full, reduced, no, or unknown reward evaluation.
• Exact Tuesday 08:00 UTC weekly rollover.
• Immutable preflight snapshots.
• A manager-configured eight-person roster.
• No game account, API, scraping, or client integration.
• Two minimal explicit capabilities: storage:kv and the safe interaction:respond.

Marketplace disclaimer: CofferCall is an independent Discord coordination utility. It does not connect to, read, modify, automate, or interact with the FINAL FANTASY XIV game client or game servers. All statuses are self-reported. FINAL FANTASY XIV and related marks are property of Square Enix. CofferCall is not affiliated with, endorsed by, or sponsored by Square Enix.

Development

Requirements:

• Python 3.11 or newer;
• yourbot-sdk>=0.8.3,<0.9; and
• pytest 8.x for development.

Create an environment and install dependencies:

python -m venv .venv
. .venv/bin/activate
python -m pip install -r requirements-dev.txt

Run the complete release checks in order:

python -m pytest
python -m compileall .
yourbot doctor
yourbot validate
python scripts/build_zip.py

The final command creates dist/coffer_call.zip. Its archive root contains manifest.json, dashboard_manifest.json, and __main__.py, alongside the production package, dependency declaration, and project documentation. Tests, caches, virtual environments, Git metadata, build scripts, and dist itself are excluded.

License

CofferCall is copyright © 2026 CubCadet. Its source code is available under the MIT License.