Configuring Activities

Activities are the in-game events your players participate in to earn credits. Configuration is now season-scoped: a leader opens a season, picks the primary activity for each week, picks the weekly small activities, and sets the credit reward per activity. Activities flow naturally from there.

The Season Model

A season is typically 5 weeks. Each week has:

• One primary activity — chosen from the catalog (Golden Expedition, KvK, Primordial Conflict, Desolate Desert). The same primary may repeat across weeks (e.g. KvK in weeks 2 and 4).
• Weekly small activities — run every week of the season (Starfall Vein, Wonder / Battle of Dawn). You pick which weeklies are in play for the whole season.

Sundays remain the week-end anchor. Each activity has a claim-opens day-of-week (default Wednesday): players can claim from that day through Sunday end + a 2-day grace window.

Opening a Season

/season open

Provide:

Field	Description
week1_end_sunday	The Sunday (YYYY-MM-DD) that ends week 1
total_weeks	Number of weeks (default 5)
current_week	Which week the season starts on (1 unless you're catching up mid-season)
primaries	Comma-separated primary names per week, e.g. Golden Expedition, KvK, Primordial Conflict, KvK, Desolate Desert
weeklies	Comma-separated weekly activity names
primary_credits	Default credit reward for primaries
weekly_credits	Default credit reward for weeklies
claim_opens_dow	Day-of-week claims open: 0=Sun..6=Sat (default 3 = Wed)
require_proof	Whether screenshot proof is required by default

The bot validates that the number of primaries equals total_weeks and that each named activity exists in the catalog. Only one season can be active at a time.

Adjusting a Season

/season status              # show current week, this week's activities, claim windows
/season set-current-week 3  # advance the pointer
/season set-credits         # tune credit reward for a specific activity
/season close               # mark the season completed

set-current-week lets a leader move the active week forward (or back) without reopening the season — useful when a week's events shift in-game.

set-credits updates the credit reward for one activity within the current season. Changes apply to future activations; already-activated instances keep their snapshotted reward.

Activating Activities

/activate <activity>

Activation reads the active season's configs:

• The autocomplete only suggests this week's primary plus all weekly activities.
• Activation is allowed when the current date is within the claim window (claim-opens day-of-week through Sunday end + 2 days), and the activity belongs to the current week or earlier.
• Each /activate posts the embed with a claim button, creates a proof thread if required, and snapshots the credit reward onto the instance.

Extra-Credit (Ad-Hoc Bonuses)

For one-off bonuses outside the season schedule:

/activity create-extra

Modal fields: name, credit reward, instructions, end date, require proof. This creates and activates a custom activity in one step — independent of the season.

Cancelling and Bonuses

/activity cancel <activity> <reason>
/bonus @player1 @player2 ... <amount> <reason>

cancel retroactively deducts credits from claimants. bonus awards credits directly to up to 20 players — useful for week-long campaigns or anything that doesn't fit a single claim.

The Activity Catalog

The catalog is seeded with the four primaries, three weeklies, and Extra-Credit. Leaders can rename or add custom types from the Activity catalog page in the web dashboard. Custom types can be selected as primaries or weeklies when opening a season.

Troubleshooting

/activate doesn't list the activity I want.

• Only the current week's primary and the season's weeklies are activatable. Use /season set-current-week if the active week is wrong.

Players can't claim yet.

• Claims open on the season's claim_opens_dow. Check /season status for the current week's claim window.

No active season.

• /activate requires an active season. Run /season open first, or /activity create-extra for an ad-hoc bonus.

---

Next: Managing Credits for bonuses and adjustments.