How to run weekly or monthly Discord XP seasons

Before you start

• A running bot with Leveling enabled and already earning message or voice XP, unlocked by Pro. XP Seasons has no XP of its own: it only counts what Leveling awards while both modules are enabled for that server.
• Manage Server access, or whichever role you use for dashboard settings, to turn on XP Seasons and pick Weekly or Monthly for the server.
• Patience for the first real test: a season boundary is only checked the next time someone earns XP or runs a /season command, not on a background timer, so do not expect an instant rollover at the exact UTC second.

1. Understand what XP Seasons actually counts

   XP Seasons does not add a new way to earn XP. It reads the same message and voice XP that Leveling already awards while both modules are enabled for the server, and keeps a separate seasonal score alongside Leveling’s own lifetime total. Lifetime XP, levels and level roles are completely unaffected: XP Seasons never grants, removes or resets any of them, and it has no reset command of its own.

   It is off by default for every server, even one where Leveling is already running. It adds no new privileged Discord intent and needs no third-party API key, because it only reads XP values the bot already has. XP earned while XP Seasons is off for a server is not added retroactively once you turn it on; only Leveling’s lifetime total already counted that time.

2. Turn on XP Seasons and choose a cadence

   On your bot’s page, open XP Seasons under Modules, click its gear button titled Settings, and pick the intended server from the Server selector, the same way you would for Leveling. Switch on Seasonal XP, then choose Weekly or Monthly under Season length; Monthly is the default. Click Save Settings and wait for the Saved confirmation, restarting the bot from its page if the dialog reports that live sync to the bot runtime failed.

   XP Seasons only has an effect where Leveling is also enabled for that exact server: it hooks into Leveling’s own award path rather than tracking anything independently. Enable Leveling first if you have not already, and keep it enabled for XP Seasons to keep counting.

3. Know when a season actually ends

   Weekly seasons end at 00:00 UTC on Monday; monthly seasons end at 00:00 UTC on the first of the month. There is no background timer: the boundary is only checked, and a finished season only saved, the next time someone earns XP or runs a /season command in that server. A quiet server simply carries the previous season a little longer past the boundary, with no XP lost.

   Changing the cadence takes effect only after the current season ends. Switching from Weekly to Monthly, or back, mid-season does not shorten, extend, split or merge the season already in progress.

4. Check standings with /season commands

   Run /season status to see the current season’s ID and its start and end, which Discord shows in your own time zone. Run /season leaderboard for a private top-ten reply that only you can see; it never pings anyone and shows "No XP earned in this season yet" for a season with no scores. Add a saved season id to view a past leaderboard instead of the current one, for example /season leaderboard season:weekly-2026-09-28.

   Run /season history to list the IDs and end dates of the last twelve completed seasons in this server. Asking for a season ID that /season history does not list, because it is too old or was never saved, returns a not-found reply rather than inventing a result.

5. Test it with a real award

   Save your settings, then send a message or spend a minute together in voice exactly as you would to test Leveling itself. Run /season status to confirm a season is active, then /season leaderboard to confirm the XP you just earned shows up. If nothing changed, re-check that both Leveling and XP Seasons are switched on for this exact server, since a toggle left off on either module means nothing is recorded.

6. Plans and what happens on Free

   XP Seasons needs Pro, the same as Leveling. If the account moves from Pro to Free, Pro modules including Leveling and XP Seasons are switched off on that bot, so no new seasonal XP is counted. They are restored when you upgrade to Pro.