MGE Event Management

MGE (Mightiest Governor Event) events are the competitive core of AoEM Historian. This guide covers how to manage the slot allocation process.

MGE Command

/mge <subcommand>

Available subcommands:

• activate - Start a new MGE event
• configure-activated - Configure settings on the active MGE (open applications, minimum credits)
• confirm - Preview and finalize event (deduct credits)
• approve - Approve player applications, or reassign an already-approved player to a different slot
• reject - Reject pending applications
• withdraw - Mark a player as voluntarily withdrawn (won't count as bumped)
• slots-override - Force-assign any player to any slot (marks as Override)
• cancel - Cancel an event (before credits are deducted)
• costs - Set tier costs for slots
• status - View MGE schedule configuration
• set-anchor - Set the MGE anchor Sunday

Players can view current event status and slot assignments with /slots.

Understanding the Event Cycle

MGE events follow a biweekly cycle:

┌─────────────┐     ┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   Setup     │ ──▶ │    Open     │ ──▶ │   Review    │ ──▶ │  Finalize   │
│ Set costs   │     │ Applications│     │   Apps      │     │   Slots     │
└─────────────┘     └─────────────┘     └─────────────┘     └─────────────┘

1. Setup - Configure tier costs before the event
2. Open - Applications open for players (/mge activate)
3. Review - Leaders review and approve/reject
4. Finalize - Slots are assigned, credits deducted (/mge confirm)

Setting Tier Costs

Before opening applications, configure the credit costs using a multiplier:

/mge costs

This opens a form where you enter a multiplier. Costs are calculated as medals × multiplier for each slot:

Slot	Medals	Cost (5x)	Cost (3x)	Cost (7x)
1st	100	500	300	700
2nd	80	400	240	560
3rd	60	300	180	420
4th	40	200	120	280
5th	20	100	60	140
6-7	15	75	45	105
8-10	10	50	30	70

Choosing a Multiplier

See Credit System Design for guidance on choosing a multiplier based on your empire's credit economy.

• 5x (default) - ~2 seasons of perfect attendance for 1st place
• 3x-4x - Faster slot turnover, good for smaller/less active empires
• 6x-10x - Slower rotation, rewards long-term commitment

Activating an MGE Event

To open applications for a new event:

/mge activate

Activation Window

Before you can activate an MGE, you must be within the activation window:

• Opens: 5 days before the MGE starts (Wednesday before event week)
• Closes: 2 days after the MGE starts (Wednesday of event week)
• Duration: 7-day window to activate

Check if you're in the activation window:

/mge status

This shows:

• Your configured anchor Sunday
• Next MGE start and end dates
• Activation window dates
• Whether the window is currently open

If there's an unconfirmed MGE, /mge status also shows:

• All slot assignments with player names and credit costs
• Pending applications (up to 5 shown)
• Total credits to be deducted
• Action required (confirm or cancel)

This comprehensive view means you don't need to run /slots separately - everything is in one place.

What Activation Does

When you run /mge activate:

• Creates a new MGE event with status applications_open
• Posts announcement to your MGE channel (if configured)
• Opens applications for players via /apply

Activation Rules

• One event at a time: Cannot activate if an event is already active
• Must be in window: Activation only works during the 7-day window
• Requires anchor: Must set anchor Sunday first via /mge set-anchor

Example

# First, check the schedule
/mge status

# If in activation window, activate the event
/mge activate

# Optionally, open applications to all players (e.g. for new empires)
/mge configure-activated open_applications:true minimum_credits:10

Configuring the Active MGE

After activating an MGE, you can adjust its settings with:

/mge configure-activated [open_applications] [minimum_credits]

Open Applications

By default, players must have enough credits to cover the slot tier they're applying for. Open Applications mode removes this per-slot credit check, allowing anyone to apply for any tier.

/mge configure-activated open_applications:true

This is especially useful for new empires where players haven't accumulated enough credits to afford top slots. Leaders can then review applications manually and approve based on activity participation rather than credit balance.

When open applications is enabled:

• Players can apply for any slot tier regardless of credit balance
• Only the minimum credits threshold is checked (if set)
• Players may go into negative credits after /mge confirm
• Leaders retain full control over who gets approved

Minimum Credits

Set a floor for who can apply:

/mge configure-activated minimum_credits:10

This ensures only players with at least some activity participation can apply. Combine with open applications to let active players apply for any tier:

/mge configure-activated open_applications:true minimum_credits:10

Checking Current Settings

Use /mge status to see the current Open Applications and Minimum Credits values for the active event.

Viewing Applications

Check current event status and applications:

/slots

This shows:

• Event name and status
• Application status (open/closed)
• All applicants with their tier preferences
• Current slot assignments

Approving Applications

To approve a player's application:

/mge approve @Player <slot>

Parameter	Type	Required	Description
@player	User mention	Yes	Player to approve
slot	Number	Yes	Slot number (1-10)

Approval Process

1. Review the player's application tier
2. Verify credits are available
3. Approve the application and assign a slot number
4. Slot is reserved (credits deducted on confirmation)

Bulk Approvals

Approve applications one at a time or in batches based on your review.

Rejecting Applications

To reject a pending application:

/mge reject @Player

When to Reject

• Player doesn't meet requirements
• Too many applications for available slots
• Policy violations

Note: Use /mge withdraw instead if the player is voluntarily giving up their slot — this records a meaningful distinction for the end-of-event summary.

Credit Handling

Credits are only deducted when /mge confirm is run. Rejections before confirmation have no credit impact.

Withdrawing a Player

When a player voluntarily gives up their slot, mark them as withdrawn rather than rejected:

/mge withdraw @Player

This frees their slot and records them as WITHDREW in the confirmation summary — distinct from being bumped. Leaders can use this to track who deserves priority consideration for the next MGE.

Reassigning Approved Slots

To cleanly move an already-approved player to a different slot, use /mge approve again with the new slot number:

/mge approve @Player slot:5

This resets their "originally approved slot" to the new slot, so they won't appear as MOVED in the summary. Use this for intentional admin adjustments.

Overriding Slot Assignments

Force-assign any player to a slot — even without an application. These players are tracked as Override in the summary.

/mge slots-override <slot> @Player

When to Use

• Out-of-process agreements: Player committed via direct message or voice chat
• Non-applicants: Assigning someone who obtained a slot outside the application system
• Force swaps: Moving an approved player when you need /mge slots-override semantics (shows as MOVED in summary)

How It Works

1. Specify the slot number (1-10) and the player
2. If the slot is taken:
   • An approved player is displaced but keeps their approval — they can be reassigned or will appear as BUMPED at confirm
   • An override player is displaced back to pending
3. The assigned player's status is set to Override (or stays Approved if they were already approved via /mge approve)
4. Always run /mge confirm after to review final state

Example Workflow

# Assign PlayerB to slot 3 (displaces PlayerA if present)
/mge slots-override slot:3 @PlayerB
# PlayerB is now "Override" — PlayerA is displaced (still approved, no slot)

# Check the updated state before confirming
/mge confirm

Important Notes

• Works on active/unconfirmed MGEs only
• Cannot override after /mge confirm completes
• Automatically creates an application record for tracking

Confirming the Event

Once slots are assigned and you're ready to finalize the MGE:

/mge confirm

Confirmation Flow

1. Preview Display

   • Shows all 10 slots with player names and credit costs (with [OVERRIDE] / [MOVED from X] tags)
   • Displays total credits that will be deducted
   • Warns about unassigned slots (⚠️ Not assigned)
   • Shows players who will be BUMPED (approved but no slot) and those who Withdrew

2. Review & Adjust

   • If slots need changes, use /mge slots-override or /mge approve to reassign
   • Run /mge confirm again to see updated preview
   • Review carefully — confirmation cannot be undone

3. Confirm or Cancel

   • Click "Cancel" to abort without changes
   • Click "Confirm MGE Slots and Deduct Credits Now" to finalize
   • Hash validation ensures preview matches current state

Post-Confirmation Summary

After confirming, the bot posts a summary with outcome sections:

Section	Who
Slots 1–10	All confirmed placements with credits deducted
⚠️ BUMPED	Approved players who ended up with no slot
WITHDREW	Players who voluntarily gave up their slot — consider for priority next MGE
OVERRIDE	Players placed directly without a normal application

Application statuses are also finalized:

Status	Meaning
Confirmed (approved)	Got the slot they were originally approved for
Moved	Was approved for one slot, confirmed at a different one
Bumped	Was approved but got no slot at confirm time
Override	Placed directly via /mge slots-override
Withdrew	Voluntarily gave up their slot

When to Confirm

Available anytime after /mge activate:

• During applications_open period
• While event is in_progress
• After event ends (awaiting_confirmation)
• No need to wait for the event to end in-game

Safety Features

• Hash validation: If slots change after preview, button becomes invalid
• Cancel option: Safe exit without deducting credits
• Visual warnings: Clear indicators for unassigned slots
• Confirmation preview: See exactly what will happen before committing

Warning: Once you click "Confirm MGE Slots and Deduct Credits Now", credits are permanently deducted and the action cannot be undone.

Canceling Events

If an event needs to be canceled before confirmation:

/mge cancel

Cancellation Rules

• Can cancel at any time before credits are deducted - even after running /mge confirm (which shows a preview), as long as you haven't clicked the "Confirm" button
• Once credits have been deducted via the confirm button, the event cannot be cancelled

When to Cancel

• Event is canceled in-game
• Not enough participants
• Technical issues

Managing Applications Fairly

Review Criteria

Consider establishing criteria:

• Minimum participation requirements
• Credit balance thresholds
• Past event participation
• Activity history

Handling Ties

When multiple players want the same tier:

• First-come-first-served
• Credit balance tiebreaker
• Activity history consideration
• Random selection

Document your tiebreaker policy so players understand.

Communication

Keep players informed:

• When applications open
• Application deadlines
• Approval/rejection notifications
• Final slot assignments

Best Practices

Plan Ahead

Timeline Example:

Wed (5 days before): Activation window opens
                     Set costs and activate event
Thu-Fri:             Players submit applications
Sat-Sun:             Review and approve/reject applications
Mon (event starts):  Make any final slot adjustments with /mge slots-override
                     Run /mge confirm to preview all assignments
                     Click "Confirm" button to finalize
Mon-Sun:             MGE runs in-game
Sun (event ends):    Can still confirm if you haven't yet

Document Decisions

Keep records of:

• Why applications were approved/rejected
• How ties were resolved
• Any special circumstances

Be Transparent

Post event results publicly:

• Who got which slot
• How decisions were made
• Thank participants

Gather Feedback

After events, ask:

• Was the process fair?
• Were costs appropriate?
• What could improve?

Troubleshooting

Player Applied for Wrong Tier

You have several options:

1. Reject and reapply: Reject their application, have them apply again for correct tier
2. Use slots-override: Directly assign them to the correct slot with /mge slots-override
3. Post-confirmation adjustment: Use /bonus to adjust credits after the event (if already confirmed)

Not Enough Applications

• Extend the application period
• Reduce tier costs
• Encourage participation
• Consider allowing multi-tier applications

Too Many Applications

• Stick to tier priorities
• Use tiebreakers consistently
• Consider increasing future event availability
• Encourage lower-tier applications

Player Can't Participate After Approval

1. Cancel their slot (if before confirmation)
2. Consider credit adjustment via /bonus (if after confirmation)
3. Offer slot to next eligible applicant

---

Congratulations! You now have a complete understanding of leader responsibilities. For detailed command syntax, see the Command Reference.