Skip to main content

Season Pass

kyuubisoft

A full battle pass system for Hytale servers with tiered progression, daily and weekly challenges, a season shop, prestige system, XP boosters, and premium track support.

Features​

Tiered Progression​

  • 30 Standard Tiers with increasing XP requirements
  • 10 Bonus Tiers for dedicated players after completing the main track
  • XP-based progression with configurable scaling per tier
  • Tier-up toast notifications with queue system

Free + Premium Track​

  • Free Track available to all players with rewards at every tier
  • Premium Track with exclusive rewards, unlockable via server currency or admin command
  • Retroactive premium unlock grants all previously earned premium rewards
  • Premium info page prevents accidental purchases
  • premiumEnabled config flag to completely hide the premium track if desired
  • premiumCommandOnly mode to restrict premium purchases to admin commands only

XP Sources​

Earn XP from 14+ gameplay activities:

  • Block breaking and placing
  • Mob kills and boss kills
  • Crafting items
  • Zone discovery and exploration
  • Playtime milestones
  • Quest completions
  • Achievement completions
  • Daily login bonus
  • Challenge completions
  • And more via configurable source weights

Daily / Weekly Challenges​

  • 3 daily and 3 weekly challenges from weighted random rotation
  • Premium players get extra challenge slots (2 daily + 1 weekly, configurable)
  • Challenge type deduplication ensures variety within each category
  • Challenges award both XP and Season Tokens
  • premiumOnly flag for premium-exclusive challenges

Season Tokens​

  • Secondary currency earned proportionally to XP gains
  • Used to purchase items in the Season Shop
  • Displayed in challenge rewards (e.g., "+25 XP | +5 T")

Season Shop​

  • 4 daily rotating shop slots with token-based purchases
  • Premium players get extra shop slots (2 slots, configurable)
  • "SOLD" badge on purchased items with visual tint
  • Header shows token balance and countdown to next rotation
  • Shop purchases display chat feedback messages

HUD Tracker​

  • Compact on-screen display showing current tier, XP progress, and active challenges
  • MHUD-compatible with configurable position
  • Auto-hides when the map is open
  • Toggleable via player settings

Prestige System​

  • Repeatable prestige after reaching max tier
  • Permanent XP boost per prestige level (up to 10 levels)
  • Prestige badge displayed in the Tiers tab
  • Admin management via /spadmin setprestige

XP Boosters​

  • Personal XP boosters with configurable multiplier and duration
  • Grantable via admin command or as tier/shop rewards
  • New booster reward type for tier and shop configurations
  • Double XP Events — Server-wide XP multiplier via /spadmin doublexp

Season Pass Book​

  • Physical in-game item (Spellbook model, Rare quality) that opens the Season Pass UI on right-click
  • Configurable auto-give on first join or every join
  • Customizable hotbar slot and give delay
  • Duplicate protection via inventory check
  • Only given when a season is active

Season Pass UI​

4 tabs accessible via the book or command:

TabDescription
TiersVisual tier progression with free/premium rewards and claim buttons
ChallengesActive daily and weekly challenges with progress bars
ShopToken shop with rotating inventory
HistoryPast season summaries and statistics

Player Settings​

  • HUD tracker toggle
  • XP notification toggle
  • Tier-up notification toggle
  • Challenge completion notification toggle

Daily XP Cap​

  • Configurable soft cap (warning) and hard cap (stop earning)
  • Prevents excessive XP farming while keeping the game fair
  • Login streak tracking with first login bonus

Commands​

CommandAliasDescription
/ksseasonpasssp, seasonpass, battlepassOpen the Season Pass UI
/ksseasonpassadminspadminAdmin commands (grant, reset, manage seasons)

Admin Subcommands​

  • spadmin grantbooster <player> <multiplier> <minutes> — Give a personal XP booster
  • spadmin doublexp <minutes> — Start a server-wide double XP event
  • spadmin stopdoublexp — End the current double XP event
  • spadmin setprestige <player> <level> — Set a player's prestige level

Requirements​

  • Hytale Server with plugin support
  • KyuubiSoft Core (for TrackingService, RewardGrantHelper, CurrencyProvider, ShopService, ModMenuRegistry)

Configuration​

  • config.json — Season settings (duration, XP scaling, caps, premium options)
  • seasons/ — Season definitions with tier rewards
  • challenges/ — Challenge pool definitions (daily and weekly)
  • shop/ — Season shop item configurations
  • Localization: en-US and de-DE fully supported