Skip to content

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).

Season Pass admin panel on the Tiers section The admin panel on the Tiers section: grouped navigation with counts on the left, the tier list of the edited season on the right.

WayRequirement
/spadmin panelks.seasonpass.admin (see Permissions)
Tile Season Pass Admin in KyuubiSoft Core’s /ksadmin hubCore’s ks.admin
A Core citizen with the ID showcase_seasonpassonly 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.

  • 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:
GroupSections
ConfigurationGeneral, Season, Currency, Premium, XP sources (13), Prestige (number of prestige levels)
ManagementPlayers (players online), Events (1 while an XP event runs)
ContentTiers (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).


Server-wide settings in config.json.

FieldSaved toNotes
Server languagelanguage9 languages; reloads the language files when changed
Debug outputdebugDetailed Season Pass logging
Progress HUDtrackerHudEnabledOff hides the progress card for every player; the toasts stay
Auto-save interval (seconds)autoSaveIntervalSeconds10 - 86400, takes effect after a restart
Give the itemitem.enabled
Item IDitem.itemIdRequired
Hotbar slot (0 - 8)item.hotbarSlot
On first join / On every joinitem.giveOnFirstJoin / item.giveOnEveryJoinBoth give the item on a join when the player has none
Delay (seconds)item.giveDelaySeconds0 - 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.


  • 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.


Saved to the edited season, then the currency is set up again at once.

FieldSeason keyNotes
TypecurrencyModeInternal, Item, Economy
Display namecurrencyNameRequired
Symbol itemcurrencyIconItem
Currency item (for type Item)currencyItemIdRequired for Item and must exist in the game
Economy provider (for type Economy)economyProviderOptional
Tokens per XP (“XP give 1 token”)seasonTokenXpRatio1 - 1,000,000
Keep leftover XPtokenXpCarryOver”Off: small XP gains (blocks, mobs) give no tokens. On: leftover XP is collected per player.”
Bonus XP / Bonus tokensfirstLoginBonusXp / firstLoginBonusTokensOn the first join of the season

FieldSeason keyRange
Premium pass activepremiumEnabled
Only granted by adminspremiumCommandOnly
Hint textpremiumHintText”Shown when buying is disabled, e.g. a Discord hint”
PricepremiumCost0 - 1,000,000,000
CurrencypremiumCurrencyIdRequired; a KyuubiSoft Core currency ID such as economy, item:Ingredient_Bar_Gold or season_tokens
XP bonuspremiumXpBoost1.0 - 10.0 (x XP)
Daily challenges / Weekly challengesdailyChallengeSlots / weeklyChallengeSlots1 - 5
Premium daily / Premium weeklypremiumDailyChallengeSlots / premiumWeeklyChallengeSlots1 - 3
Shop offers / Premium offersdailyShopSlots / premiumDailyShopSlots1 - 8

The slot counts live here, under “Slots per player”. See Seasons for the currency IDs.


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.


  • 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.

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.

ActionRangeWhat it does
Give XP1 - 10,000,000Normal XP with boosts and caps, may raise the tier
Set tier0 - number of tiersSets the tier; the XP in the tier stays unchanged
Give tokens1 - 10,000,000Internal season tokens
Set prestige0 - 1000Sets the level, no rewards
Give XP boostermultiplier 1.0 - 10.0, 1 - 10,080 minutesReplaces a running booster
Grant premium / Revoke premiumToggles the pass
Reset progressSecond 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.


  • 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.

  • Filters: Daily · 16, Weekly · 12, Premium · 8 (the premiumOnly challenges 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. descriptionKey can 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.


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.”).

ColumnMeaning
TypeItem, Tokens, Lootbag, Command, Booster, None
Item / ID / command / multiplierItem: item ID. Lootbag: lootbag ID. Command: the command (a leading / is removed). Booster: the multiplier (1.0 - 10.0). Tokens: empty
AmountItem: amount. Tokens: number of tokens. Booster: minutes (1 - 10,080)
IconIcon item (optional)
Display namedescription
RarityCommon 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.