Admin Panel
Version: 2.0.7 · Opened with: /spadmin panel
The admin panel “Season Pass Admin” edits everything of the Season Pass in game: the server settings, every season file, the players online and the server-wide XP event. It was rebuilt in 2.0.0 in the KyuubiSoft Goldfiligran look. Its texts follow the admin’s language (all 9 bundled languages).

Opening the Panel
Section titled “Opening the Panel”| Way | Requirement |
|---|---|
/spadmin panel | ks.seasonpass.admin (see Permissions) |
Tile Season Pass Admin in KyuubiSoft Core’s /ksadmin hub | Core’s ks.admin |
A Core citizen with the ID showcase_seasonpass | only while KyuubiSoft Core runs in showcase mode; on any other server the citizen does not open the panel (since 2.0.7) |
The panel opens on General. On a Core showcase server every change is refused with “Blocked in showcase mode.”; looking around works. For showcase visitors the Players section shows “Player data is hidden” and its search does not answer.
Layout
Section titled “Layout”- Header: the title, a subtitle such as “Editing: Season 1: Explorer · Active: Season 1: Explorer (running)”, a status line for the result of the last action (green or red), Reload and the close button.
- Navigation (left) in three groups, with a count next to some entries:
| Group | Sections |
|---|---|
| Configuration | General, Season, Currency, Premium, XP sources (13), Prestige (number of prestige levels) |
| Management | Players (players online), Events (1 while an XP event runs) |
| Content | Tiers (number of tiers), Challenges (pool size), Shop (pool size) |
- Reload reloads
config.json, all season files and the languages and sets up the currency again, like/spadmin reload(see Configuration). Open editors are closed.
How saving works: every section has its own Save button and only saves its own fields; the season sections write the edited season file at once. On/off switches only take effect with that Save. Invalid input is not saved and the status line says why (""abc” must be between 1 and 8.”). Whole numbers in the section fields may be typed with thousands separators (“1.000” or “1,000”, not in the reward editor), decimals with a dot or a comma. Deleting, ending a season and resetting a player need a second click (“Sure?”).
Edited season: everything except General, Players and Events works on the season selected in the Season section, which does not have to be the running one. The panel starts with the running season (or the first one).
General
Section titled “General”Server-wide settings in config.json.
| Field | Saved to | Notes |
|---|---|---|
| Server language | language | 9 languages; reloads the language files when changed |
| Debug output | debug | Detailed Season Pass logging |
| Progress HUD | trackerHudEnabled | Off hides the progress card for every player; the toasts stay |
| Auto-save interval (seconds) | autoSaveIntervalSeconds | 10 - 86400, takes effect after a restart |
| Give the item | item.enabled | |
| Item ID | item.itemId | Required |
| Hotbar slot (0 - 8) | item.hotbarSlot | |
| On first join / On every join | item.giveOnFirstJoin / item.giveOnEveryJoin | Both give the item on a join when the player has none |
| Delay (seconds) | item.giveDelaySeconds | 0 - 300 |
enabled and timezone have no field in the panel; change them in config.json and press Reload. While enabled is false the header shows the season as paused. See Configuration.
See Configuration.
Season
Section titled “Season”- Edited season: dropdown of all loaded seasons. The line next to it says “Running”, “Running · paused” or “Not running”.
- Stats of the running season, counted over the players online: Players online, Avg. tier, With premium, Highest tier.
- Data: Name (required), Description, Start, End (
YYYY-MM-DD, may be empty), Icon item, Accent colour (#rrggbb). - XP curve: XP for tier 1 (1 - 10,000,000), Growth per tier (1.0 - 3.0), Daily limit, Full XP up to (soft cap), Afterwards (factor 0 - 1), Duration (days, 1 - 3650). The heading shows the total, e.g. “XP curve · 259.055 XP up to tier 40”.
- Buttons: Save, Start season (when the edited season is not running; also sets up its currency), New season, End season (while a season runs; needs a second click: “Click again to end the running season – online players get their open rewards.”). See Seasons for the payout.
New season creates season_<n>.json with the name Season <n> (e.g. season_2.json, “Season 2”), no tiers, challenges or offers, and selects it. The End field is the date on which the season ends by itself; Start and Duration are only stored. See Seasons.
Currency
Section titled “Currency”Saved to the edited season, then the currency is set up again at once.
| Field | Season key | Notes |
|---|---|---|
| Type | currencyMode | Internal, Item, Economy |
| Display name | currencyName | Required |
| Symbol item | currencyIconItem | |
| Currency item (for type Item) | currencyItemId | Required for Item and must exist in the game |
| Economy provider (for type Economy) | economyProvider | Optional |
| Tokens per XP (“XP give 1 token”) | seasonTokenXpRatio | 1 - 1,000,000 |
| Keep leftover XP | tokenXpCarryOver | ”Off: small XP gains (blocks, mobs) give no tokens. On: leftover XP is collected per player.” |
| Bonus XP / Bonus tokens | firstLoginBonusXp / firstLoginBonusTokens | On the first join of the season |
Premium
Section titled “Premium”| Field | Season key | Range |
|---|---|---|
| Premium pass active | premiumEnabled | |
| Only granted by admins | premiumCommandOnly | |
| Hint text | premiumHintText | ”Shown when buying is disabled, e.g. a Discord hint” |
| Price | premiumCost | 0 - 1,000,000,000 |
| Currency | premiumCurrencyId | Required; a KyuubiSoft Core currency ID such as economy, item:Ingredient_Bar_Gold or season_tokens |
| XP bonus | premiumXpBoost | 1.0 - 10.0 (x XP) |
| Daily challenges / Weekly challenges | dailyChallengeSlots / weeklyChallengeSlots | 1 - 5 |
| Premium daily / Premium weekly | premiumDailyChallengeSlots / premiumWeeklyChallengeSlots | 1 - 3 |
| Shop offers / Premium offers | dailyShopSlots / premiumDailyShopSlots | 1 - 8 |
The slot counts live here, under “Slots per player”. See Seasons for the currency IDs.
XP sources
Section titled “XP sources”The 13 XP values of the edited season (0 - 1,000,000 each, 0 turns a source off): Block mined, Block placed, Monster defeated, Player defeated, Playtime per minute, Zone discovered, Plant harvested, Flower picked, Quest completed, Achievement unlocked, Daily login, Login streak per day, Streak counts up to (days). See Seasons.
Prestige
Section titled “Prestige”- Settings: Prestige active, Highest level (0 - 1000, 0 = no limit), XP bonus per level (0 - 100 %; 0 counts as 5 %). Save stores these three.
- Rewards per level: a list “Prestige 1”, “Prestige 2”, … with a summary of each level’s rewards and Edit / Delete. + Level adds the next level and opens it.
- Editing a level opens the reward editor (“Rewards of prestige 2”); Save stores it, Cancel goes back.
Players
Section titled “Players”Looks up an online player by name (button Search or Enter). Offline players cannot be edited here. Showcase visitors on a Core showcase server see “Player data is hidden” instead.
Player card: tier badge, name, “Online · Season 1: Explorer”, Premium and prestige badges, and Tier, XP in this tier, Total XP, Season tokens, Unclaimed rewards and Daily challenges done.
| Action | Range | What it does |
|---|---|---|
| Give XP | 1 - 10,000,000 | Normal XP with boosts and caps, may raise the tier |
| Set tier | 0 - number of tiers | Sets the tier; the XP in the tier stays unchanged |
| Give tokens | 1 - 10,000,000 | Internal season tokens |
| Set prestige | 0 - 1000 | Sets the level, no rewards |
| Give XP booster | multiplier 1.0 - 10.0, 1 - 10,080 minutes | Replaces a running booster |
| Grant premium / Revoke premium | Toggles the pass | |
| Reset progress | Second click needed; moves the season to the player’s history and resets everything, like /spadmin resetplayer |
The player’s HUD updates right away. The “Unclaimed rewards” count includes tiers with an empty track.
Events
Section titled “Events”- Double XP: the state (“Running: 2x XP · 42:10 left” or “No XP event running.”), Multiplier (1.1 - 10.0) and Duration (1 - 10,080 minutes), Start (Restart while one runs; replaces it) and End event. Same as
/spadmin doublexp/stopdoublexp. - Season status: “Season 1: Explorer is running” or ”… is paused – no XP until resumed”, with Pause season / Resume season.
- Maintenance: “New challenges reach online players within a minute.”
- New daily challenges / New weekly challenges: re-roll the lists of all online players at the next 60-second check. Players usually get the same challenges again with progress back at 0, see Challenges.
- Save player data: saves the data of every online player now.
- List: “Season 1: Explorer · 30 tiers + 10 bonus tiers · each track can hold several rewards”. Eight rows per page, each “Tier 5” or “Bonus 31” with its icon and “Free: Explorer Lootbag · Premium: Emote: Victory Dance”, and Edit / Delete.
- Warnings: chips above the list name tiers with item IDs that do not exist in the game; such rows say “Item missing”.
- + Tier appends a standard tier (before the bonus tiers), + Bonus tier appends a bonus tier; both open the new tier.
- Delete removes the tier; every later tier gets a number one lower (tier numbers are list positions). + Tier in turn gives every bonus tier a number one higher.
- Players’ claims follow both changes, so a claimed tier stays claimed under its new number (online players at once, others on their next join); the claim of a deleted tier is dropped. Only changes made here are tracked, not edits in the web editor or in the file. See Seasons.
- Editing a tier (“Edit Tier 5”): Tier icon (item ID, optional) and a reward editor each for Free and Premium.
Challenges
Section titled “Challenges”- Filters: Daily · 16, Weekly · 12, Premium · 8 (the
premiumOnlychallenges of both pools). - List: eight rows per page with name, icon, “Mob Kill · 10 · +150 XP, +8 Tokens”, the weight, and Edit / Delete. Rows of challenges whose type is never counted are flagged “Never counted”, unknown icons “Item missing”; chips above the list sum these up (“Type “items_collected” is never counted – 1 challenge(s) can never be completed.”).
- + Challenge adds “New Challenge” (Break Block, 50, +100 XP, +5 tokens) to the daily or weekly pool of the current filter (Premium adds a daily premium challenge) and opens it.
- Editor: ID (unique across both pools), Name, Description, Type (dropdown; types that are never counted are marked ”(!)”), Target (default
any), Count, XP, Tokens, Weight, Icon item, Premium only. The pool cannot be changed in the editor.descriptionKeycan only be set in the file.
See Challenges.
- Filters: Daily offer and Premium offer, with the number of offers. The hint names how many offers each player sees (“each player sees 4 daily and 2 premium offers”).
- List: eight rows per page with name, icon, contents summary, rarity, weight, price, and Edit / Delete.
- + Offer adds “New Offer” (50, 10 Gold Ingots) to the current filter and opens it.
- Editor: ID, Name, Description, Icon item, Price (1 - 10,000,000), Weight (1 - 10,000), Rarity, Premium only, and the contents as a reward editor. An offer needs at least one reward.
See Token Shop.
Reward editor
Section titled “Reward editor”Used for both tracks of a tier, shop offers and prestige levels. It shows up to four rewards; rewards beyond the fourth are kept unchanged (“2 more reward(s) beyond the four shown are kept unchanged.”).
| Column | Meaning |
|---|---|
| Type | Item, Tokens, Lootbag, Command, Booster, None |
| Item / ID / command / multiplier | Item: item ID. Lootbag: lootbag ID. Command: the command (a leading / is removed). Booster: the multiplier (1.0 - 10.0). Tokens: empty |
| Amount | Item: amount. Tokens: number of tokens. Booster: minutes (1 - 10,080) |
| Icon | Icon item (optional) |
| Display name | description |
| Rarity | Common to Legendary |
+ Reward adds a row (an item reward with 1 Gold Ingot), the button at the end of a row removes it, and type None removes a row when saving.