MGE Signups

Patron feature

These commands only appear in authorized servers. Run /patreon verify with Manage Server to unlock them, then give Discord a few seconds to register them.

MGE Signups run your alliance’s Mightiest Governor Event recruitment from start to finish. Members apply through a private, multi-language question flow in their DMs, the bot posts each application into a review thread with Accept and Deny buttons, and your coordinators rank accepted applicants into placement spots. The bot follows the in-game MGE calendar and posts a fresh signup before each cycle on its own.

Tier	Patron
Command	/mge
Who can use	Admins, the Bot Admin role, or the MGE Admin role
Also on dashboard	No

How it works

MGE is the Mightiest Governor Event, a recurring Rise of Kingdoms event that rotates troop type (Infantry, Archer, Cavalry, Leadership) every two weeks. The bot tracks that global calendar so it always knows which event is next.

When you run /mge setup, the bot:

• Posts a signup embed with an Apply Here! button in your signup channel.
• Creates three threads in your submissions channel: Applications, Accepted, and Rejected.
• Pins a Download CSV button in the Applications thread and a live Current Rankings panel in the Accepted thread.

The flow for an applicant:

1. A member clicks Apply Here! and picks a language.
2. The bot opens a DM and asks your configured questions one at a time. They have 10 minutes per question, can type back to revisit the previous one, or cancel to stop.
3. They review a summary and type confirm to submit. The finished application is posted into the Applications thread with Accept and Deny buttons.
4. A coordinator clicks Accept and enters a rank number. The applicant lands in that placement spot and moves to the Accepted thread; Deny moves them to Rejected.
5. When the roster is set, a coordinator clicks Publish to lock signups and show the final placements on the signup embed.

The bot posts the next cycle’s signup automatically once the signup window opens, so after the first setup you mostly manage applications, not scheduling.

Applications happen in DMs

The question flow runs entirely in the applicant’s direct messages. If a member has DMs from server members turned off, the bot cannot message them and the application can’t start. Ask them to enable DMs for the server and try again.

The points model

placement_points defines how many rank spots exist and the default score for each, top spot first. You enter a comma or space separated list.

• Numeric tokens are read as millions. 25 displays as 25,000,000 pts. So 25, 22, 20 creates three ranks worth 25M, 22M, and 20M.
• Free-text tokens render verbatim and carry no numeric value. Unlimited, 22, 20 makes the top spot show Unlimited and the next two show 22M and 20M.
• The number of tokens is the number of rank spots. A list of 15 tokens means ranks 1 through 15.

You set this in /mge setup and can change it later from the Edit Points button on the Current Rankings panel, or per-rank with the Edit button (see Managing rankings).

Prerequisites

• The server has run /patreon verify (Patron).
• You have Administrator or Manage Server, or the server’s Bot Admin role.
• The bot can send messages and embed links in the signup channel.
• The bot can Create Public Threads and Send Messages in Threads in the submissions channel.
• You have a .txt file with your MGE rules or info to upload during setup.

Commands

All /mge commands require admin permissions (see Permissions).

/mge setup

Set up or update the MGE signup system. Re-running it updates the existing configuration in place.

Option	Type	Required	Description
signup_channel	channel	Yes	Channel where the signup embed is posted
posted_submissions_channel	channel	Yes	Channel for the admin application threads
placement_points	text	Yes	Points list (for example 25, 22, 20) in millions; free text like Unlimited is allowed
signup_open_day	choice	Yes	Day of the week (the week before the MGE) when signups open
mge_info_file	attachment	Yes	A .txt file with your MGE rules or info
mge_troop_type	choice	No	Force the troop type (Infantry, Archer, Leadership, Cavalry). Leave blank to follow the global calendar
next_mge_date	text	No	Override the next MGE start date as YYYY-MM-DD. Must be a Monday and not in the past. Leave blank to follow the global calendar
ping_role	role	No	Role to ping when signups open
mge_coordinator_role	role	No	Role to tag in the application threads

/mge setup signup_channel:#mge-signups posted_submissions_channel:#mge-review placement_points:Unlimited, 22, 20, 18, 17 signup_open_day:Monday mge_info_file:rules.txt

When the first signup posts

If the signup window is already open when you run setup, the embed posts immediately. Otherwise the bot waits and posts automatically when your chosen signup_open_day arrives, the week before the MGE. The troop type and dates follow the global MGE calendar unless you override them.

/mge questions

Open the question configuration panel. From the dropdown you can toggle any question on or off, add a custom question, remove a custom one, or edit translations. The panel refreshes in place as you change it. See Configuring questions below.

Option	Type	Required	Description
(none)

/mge questions

Editing placements is a button now

The old /mge edit and /mge manual commands have been replaced by a single Edit button. It fills empty ranks, changes filled ones, and adds new ranks all from one form. See Managing rankings.

/mge admin

Set or clear the MGE Admin role: a single Discord role whose holders can run every MGE admin action without needing Administrator or Manage Server. Running it opens a role picker. Choose a role to set it, or use Clear role to remove it.

Option	Type	Required	Description
(none)

/mge admin

Only admins can set the MGE Admin role

/mge admin itself requires Administrator, Manage Server, or the Bot Admin role, so the MGE Admin role can never reassign itself. Once set, its holders can run /mge setup, /mge questions, /mge deactivate, and use the Edit ranking button.

/mge deactivate

Turn off the MGE system. By default this stops automatic scheduling but keeps your data, so a later /mge setup picks up where you left off.

Option	Type	Required	Description
wipe_data	true/false	No	If true, deletes all MGE threads, messages, and database records for this server. Default false

/mge deactivate wipe_data:false

wipe_data deletes everything

Setting wipe_data:true deletes the signup message, the Applications, Accepted, and Rejected threads, the MGE role, and every application, ranking, and question for this server. This cannot be undone. Leave it false to simply pause scheduling.

Configuring questions

The bot ships with a default set of MGE questions, created automatically the first time you set up or open /mge questions. They cover the usual ground:

• In-game name, Governor ID, and VIP level
• The commander being applied for and existing maxed commanders
• Commander skill level, Gold Heads, Crystal Tech spend level, and Zenith skins
• Whether and when they will max the commander, Civilization buffs and special units
• Previous DKP, desired placement
• Equipment and formation screenshots

Several of these are smart: VIP level, Crystal Tech, and Zenith skins offer pick-lists, the screenshot questions accept up to three images each, and Governor ID, Gold Heads, and skill level are format-checked as the member types.

From the /mge questions panel you can:

• Toggle any question on or off. Disabled questions are skipped in the flow.
• Add a custom question. Choose its input type: Text, Image upload, Multiple Choice (single pick), or Checkbox (multiple picks). Choice and checkbox questions take one option per line, 2 to 25 options.
• Remove a custom question. Only questions you added can be removed; the defaults can only be toggled off.
• Edit translations. Add translated wording so applicants who pick another language see your custom questions in their language. The default questions already ship translated into 16 languages.

Auto-translation

When you add a custom question, the bot attempts to translate it into the supported languages automatically, so non-English applicants get a sensible version without extra work. You can refine any wording later from Edit Translations.

Managing rankings

Accepting an application or using the Edit button puts a player into a placement spot. The live roster lives in the pinned Current Rankings message inside the Accepted thread. Its buttons:

Button	What it does
Publish	Locks signups and shows the final placements on the signup embed. Type CONFIRM to confirm
Swap	Swap two ranks. Enter two rank numbers, for example 2, 15
Remove	Clear one or more ranks. Enter the rank numbers, for example 5, 12
Edit Points	Change the whole placement_points list for this MGE
Edit Rank	Open the Edit form for a single spot (fill, change, or add a rank)

The Edit button

The Edit button opens one small form that asks for a rank number, an in-game name, and points. It replaces the old /mge edit and /mge manual commands and covers every case from one place:

• Fill an empty rank with a player who never applied (enter a name; points default to that spot’s value).
• Replace a filled rank by changing the name and/or points. Leave a field blank to keep the current value.
• Create a brand-new rank beyond your configured list by entering a rank number past the last spot.

It appears in two places: as Edit Rank on the Current Rankings panel (any time), and on the public signup embed once rankings are published, so coordinators can fix placements without opening the admin thread. Only admins, the Bot Admin role, or the MGE Admin role can use it. A spot added or changed after publishing appears on the published list immediately.

Once rankings are published, the Apply button is disabled and members can no longer submit applications for that cycle.

Set up step by step

1. Run /patreon verify (with Manage Server) so the /mge commands appear, and wait a few seconds for Discord to register them.
2. Pick two channels: one for the public signup embed, one for the admin review threads. Confirm the bot can post and embed in the first, and create and post in threads in the second.
3. Write your placement list, top spot first, for example Unlimited, 22, 20, 18, 17. Numeric values are millions; free text renders as-is.
4. Save your MGE rules or info as a .txt file to upload.
5. Decide which day of the week (the week before the MGE) signups should open.
6. Run /mge setup with the two channels, placement_points, signup_open_day, and mge_info_file. Add a ping role, coordinator role, or a date or troop-type override if you need them.
7. Run /mge questions to toggle, add, or translate questions to fit your alliance.
8. When applications arrive, review them in the Applications thread with Accept and Deny, then arrange placements from the Current Rankings panel and click Publish when the roster is final.

Permissions

The MGE commands and the ranking buttons (Accept, Deny, Publish, Swap, Remove, Edit Points, and Edit) require the server to be Patron and the user to be able to manage MGE, meaning any of:

• Server Administrator
• Manage Server
• The server’s Bot Admin role
• The server’s MGE Admin role (set with /mge admin)

The MGE Admin role grants MGE actions only, not the wider bot config surface. Setting it with /mge admin requires Administrator, Manage Server, or the Bot Admin role, so it can never grant or reassign itself.

There is no dashboard surface for MGE; it is managed entirely in Discord.

Limits and behavior

• One MGE configuration per server. It tracks a single active cycle at a time.
• Up to 3 images per screenshot question. Uploaded images are compressed before being attached to the posted application.
• Applications survive restarts. An interrupted application is resumed automatically when the bot comes back, and the signup embed and review buttons re-attach on startup.
• A deleted signup channel pauses MGE. If your signup channel is deleted, the bot stops posting there and pauses automatic scheduling for the server, the same as /mge deactivate. Run /mge setup again with a channel that still exists to switch it back on; your data is kept.
• The flow times out per question. Applicants have 10 minutes to answer each question; an abandoned application is cleaned up.
• Duplicate applications are allowed with a confirmation. If a member already has an application for the current MGE, the bot asks whether they really want to submit another before continuing.
• Publishing closes signups. After Publish, the Apply button is disabled for that cycle.
• The CSV export (the Download CSV button pinned in the Applications thread) gives coordinators the full application data outside Discord.

Troubleshooting

The /mge commands don’t show up. Run /patreon verify with Manage Server, then wait up to a minute for Discord to register the commands. Patron commands only appear in authorized servers.

Setup fails with a permission error. The bot needs to send messages and embed links in the signup channel, and to Create Public Threads and Send Messages in Threads in the submissions channel. Fix those and run /mge setup again.

Setup rejects my MGE info file. mge_info_file must be a .txt file. Save your rules as plain text and re-upload.

The Apply button says signups aren’t open. Signups open on your configured signup_open_day the week before the MGE and close when the MGE starts. If rankings have been published, signups are closed for that cycle by design.

Signups stopped posting on their own. The usual cause is the signup channel being deleted. When that happens the bot pauses MGE scheduling for your server rather than retrying a channel that no longer exists. Re-run /mge setup and point it at a channel that still exists to resume; your questions, applications, and settings are kept. If the bot simply lost permission to see the channel, restore its access and posting picks back up on its own.

A member says the bot never messaged them. The application runs in DMs. If they have direct messages from server members disabled, the bot can’t reach them. Ask them to enable DMs for the server and click Apply Here! again.

I need to fix or add a placement after publishing. Use the Edit button. After rankings are published it appears on the public signup embed (and on the Current Rankings panel as Edit Rank). It can fill an empty rank, change a filled one, or add a new rank, and the published list updates right away.

next_mge_date was rejected. The override must be a Monday (MGE cycles start on Monday) in YYYY-MM-DD format and cannot be in the past. Leave it blank to follow the global calendar.