Configuring Activities

Activities are the events and tasks your empire completes that earn players credits. This guide covers how to configure activity settings.

Activity Configuration Command

/activity <subcommand>

Available subcommands:

• config - Configure activity credit values and settings
• cancel - Cancel an activity and deduct credits
• create-extra - Create a one-time bonus activity with custom name
• set-proof - Add or remove proof requirement from an activated activity

Setting Up Activities

To configure an activity:

/activity config <activity>

This opens a modal pre-populated with current values (or sensible defaults for new activities):

Field	Description
Anchor Sunday	Reference date for scheduling (YYYY-MM-DD, must be a Sunday) - shown first since it's most commonly changed
Credit Reward	Credits awarded for claiming (1-1000)
Require Proof	Whether screenshot proof is required (yes/no)

Activity Types

Activities fall into two categories:

Recurring Activities (weekly or biweekly):

• Alliance War
• Rally activities
• Regular donations
• Other scheduled events

One-Time Activities:

• Conquest
• Nebuchadnezzar
• Alexander
• Hannibal
• Joan of Arc
• Other irregular events

Viewing Available Activities

Players can check what activities are available with:

/activities

This shows all upcoming, active, and recently completed activities with their claim status.

Understanding Activity Scheduling

Recurring Activities

Recurring activities use the anchor Sunday to determine when they're scheduled:

• Weekly activities - Available every week, ending on Sunday
• Biweekly activities - Available every other week based on the anchor

The anchor Sunday acts as a reference point. For biweekly activities, it determines which weeks are "on" weeks.

One-Time Activities

One-time activities (like Conquest) are not scheduled automatically. Leaders activate them manually using /activate whenever the in-game event occurs.

Changing the Anchor

To adjust when activities are scheduled:

/activity config "Activity Name"

Update the Anchor Sunday field in the modal. Changes take effect immediately for future activations.

Activating Activities

Activities must be manually activated by leaders before players can claim:

/activate <activity>

When you activate an activity:

1. It's posted to your activity channel with a claim button
2. A thread is created for proof and discussion
3. Players can claim credits by clicking the button
4. Proof requirement uses the setting from /activity config

To change the proof requirement for a specific activated activity, use /activity set-proof.

Recurring vs One-Time Activation

• Recurring activities - Can only be activated during their scheduled period
• One-time activities - Can be activated anytime (if not already active)

Creating Extra-Credit Activities

For ad-hoc bonuses with custom names:

/activity create-extra

This opens a modal where you can enter:

Field	Description
Activity Name	Custom name for this Extra-Credit (e.g., "Stellar Glory 14k points")
Credit Reward	Credits awarded for claiming (1-1000)
Instructions	Message explaining how to claim (e.g., "Post screenshot of 14k points")
End Date	When the activity ends (YYYY-MM-DD format, defaults to tomorrow)
Require Proof	Whether screenshot proof is required (yes/no)

This creates AND activates the activity in one step. Use for:

• Special one-off bonuses
• Temporary challenges
• Custom reward opportunities

Cancelling Activities

If an activity needs to be cancelled after activation:

/activity cancel <activity> <reason>

This:

• Marks the activity as cancelled
• Retroactively deducts credits from all participants
• Does NOT deduct from already-nullified claims
• Creates audit records

How Players Claim Activities

Once activated, players interact with activities via:

1. Click the "Claim Credits" button - Found on activity posts in your activity channel
2. /activities - View available and active activities

For proof-required activities, a thread is created where players post their screenshots — the bot verifies proof when players click Claim Credits.

Activities have a claim window (typically 2 days after the end date) after which they expire.

Multi-Day Activities

For activities spanning multiple days, use the bonus system:

/bonus @player1 @player2 @player3 <amount> <reason>

The bonus command allows you to:

1. Mention up to 20 players at once
2. Award the same credit amount to all mentioned players
3. Provide a reason for the award (e.g., "Week-long campaign participation")

Multi-day credits are awarded directly without requiring player claims.

When to Use Bonuses for Multi-Day Events

Use /bonus for:

• Week-long events
• Special campaigns
• Activities that are hard to claim individually
• Retroactive credit awards
• Events with complex participation tracking

Best Practices

Balanced Values

Set credit values that:

• Reward significant contributions more
• Don't make any single activity dominant
• Are achievable for active players

Communicate Changes

When you adjust credit values:

• Announce the changes to your empire
• Explain the reasoning
• Give notice before reducing values

Regular Review

Periodically review your configuration:

• Are activities being claimed?
• Are credit values still balanced?
• Do players understand the system?

Example Activity Structures

Simple Structure

Activity	Credits
Any Rally	50
Any Donation	25
Special Event	100

Tiered Structure

Activity	Credits
Daily Rally	25
Weekend Rally	50
Major Rally	100
Small Donation	10
Large Donation	50
Special Event	150

Participation-Focused

Activity	Credits
Any Participation	50
Exceptional Performance	Bonus via /bonus

Troubleshooting

Activities Not Appearing

• Verify the anchor Sunday setting
• Check if the activity period has started
• Make sure you've activated the activity with /activate
• For biweekly activities, check if it's an "on" week

Players Can't Find Activities

• Check the activity channel (configured with /empire activity-channel-set)
• Use /activities to see what's available and what needs activation
• Check claim windows haven't expired
• Verify the activity was activated by a leader

Activity Channel Not Configured

Set up an activity channel first:

/empire activity-channel-set #your-activity-channel

Credit Values Need Adjustment

Run /activity config again to update values. Changes apply to new activities, not retroactively.

---

Next: Managing Credits for bonuses and adjustments.