Skip to main content

Season Pass Changelog

A summary of all notable changes, organized by version.

v1.4.0 — 2026-03-15​

New Features​

  • Per-Player Language — Players can set their preferred language via /kslang; all Season Pass UI, notifications, and challenge descriptions respect the player's language setting
  • LevelingCore Integration — XP rewards and level-based unlock conditions now use the unified LevelingCore API
  • ShowcaseCompat — Season Pass pages can be opened via the Showcase NPC system for server lobbies and info displays

v1.3.0 — 2026-02-24​

New Features​

  • Premium Challenges — Extra daily/weekly challenge slots for premium pass holders (2 daily + 1 weekly, configurable)
  • Premium Shop — Extra shop slots for premium pass holders (2 slots, configurable)
  • Prestige System — Repeatable prestige after max tier with permanent XP boost per level (up to 10 levels)
  • XP Boosters — Personal XP boosters via admin command or tier rewards
  • Double XP Events — Server-wide XP multiplier events via /spadmin doublexp
  • Claim All Button — One-click claim for all available tier rewards
  • Booster Reward Type — New reward type booster for tier and shop rewards (multiplier + duration)
  • premiumCommandOnly Mode — Disable /sp buy, premium only via admin command
  • premiumHintText Config — Custom hint text for non-premium lock boxes

Improvements​

  • Challenge Type Deduplication — Max 1 challenge per type within each category (daily/weekly)
  • premiumOnly Flag — Challenges and shop items can be marked as premium-exclusive
  • Non-premium players see lock boxes with configurable hint text instead of premium content
  • New admin commands: grantbooster, doublexp, stopdoublexp, setprestige
  • Prestige badge displayed in Tiers tab

v1.2.0 — 2026-02-24​

New Features​

  • Season Pass Book Item — 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
    • Only given when a season is active
    • Duplicate protection via inventory check
  • Command Reward Examples — Season 1 premium tiers include command reward examples (emotes, titles, effects)
  • Premium Info Page — Premium button opens an info modal instead of directly purchasing (prevents accidental purchases)
  • Claim-in-Badge — Tier number badge turns green with "Claim now" text when rewards are claimable (cleaner layout)

Bugfixes​

  • Premium button gave premium for free — Now opens info page; purchase only via /sp buy
  • Daily login XP granted on every login — New dailyLoginXpGranted flag prevents multiple grants per day

Improvements​

  • Premium button hidden when player already has premium (badge remains visible)
  • Challenge token rewards displayed in UI (e.g., "+25 XP | +5 T")
  • Shop purchases show chat feedback (success/error message)
  • Premium info page shows dynamic ownership status
  • New premiumEnabled config flag — set to false to completely hide premium track
  • Localization version bumped to v3

v1.1.0 — 2026-02-22​

New Features​

  • MySQL Support — Player data via Core's PlayerDataStorage abstraction (MySQL or file-based)
  • Automatic legacy file migration when switching to MySQL

Improvements​

  • Shop Tab Redesign — 4 equal-size cards in a row (instead of 2x3 grid)
  • "SOLD" corner badge on purchased shop items with dark card tint
  • Shop header with token balance and countdown to next rotation
  • All data.save() calls replaced with service.savePlayerData() for storage abstraction

v1.0.0 — 2026-02-21​

Initial Release​

  • Season Pass system with time-limited seasons
  • 30 standard tiers + 10 bonus tiers
  • Free Track + Premium Track with retroactive premium unlock
  • XP-based progression from 14+ gameplay sources (blocks, kills, playtime, zones, quests, achievements)
  • Daily/Weekly challenge system with weighted random rotation (3 each)
  • Season Tokens currency with XP-proportional earning
  • Daily rotating Season Shop (4 slots) with token purchases
  • HUD Tracker (MHUD-compatible, map-hide, configurable position)
  • Tier-Up toast notifications with queue system
  • Season Pass Book Page (4 tabs: Tiers, Challenges, Shop, History)
  • Player Settings Page (HUD toggle, XP notifications, tier-up/challenge notifications)
  • Premium Pass via server currency + admin command + ShopService integration
  • Auto-claim unclaimed rewards at season end
  • Login streak tracking + first login bonus
  • Daily XP cap (configurable soft/hard cap)
  • Full i18n support (en-US + de-DE)
  • Core API integration: TrackingService, RewardGrantHelper, CurrencyProvider, ShopService, ModMenuRegistry

Commands​

  • /ksseasonpass (aliases: sp, seasonpass, battlepass) — Player command
  • /ksseasonpassadmin (alias: spadmin) — Admin command