Changelog

Season Pass Changelog

A summary of all notable changes, organized by version.

v1.7.0 — 2026-04-09

Localization Expansion

9 bundled languages: en-US, de-DE, fr-FR, es-ES, pt-BR, ru-RU, pl-PL, tr-TR, it-IT
Localization version bumped to v9
Settings page static labels fully localized

Improvements

Web editor config provider integration (SeasonPassConfigProvider)
Core ModMenuRegistry reload handler support
Per-mod language selection via LanguageSettingsHelper

v1.6.0 — 2026-03-22

Admin Page — Full In-Game Config Editor

Brand new admin panel with 11 tabs (/spadmin panel)
CONFIG: General, Season, Currency, Premium, XP Sources, Prestige — all settings editable inline
CONTENT: Tiers, Challenges, Shop — create, edit, and delete season content entirely in-game
MANAGEMENT: Player management + Events (Double XP, season lifecycle)
Create new seasons, start/end seasons directly from the panel

Configurable Currency System

3 currency modes: internal (default tokens), item (inventory items), economy (VaultUnlocked)
Dynamic currency name and icon everywhere (header, shop, challenges, rewards)
Currency changes take effect immediately

Visual Design Overhaul

Native Hytale card textures with decorative borders for reward and shop cards
Strong rarity color tinting on cards
Smoother XP bar with percent overlay
Tier highlights and challenge progress colors

Rarity System

Rewards have rarity tiers: Common, Uncommon, Rare, Epic, Legendary
Visible color differences on all reward cards

Bug Fixes

Fixed shop purchase messages on Sold Out / Not Enough
Fixed currency mode dropdown resetting

v1.5.0 — 2026-03-22

Rarity System

Rarity tiers for rewards and shop items
Color-coded labels and background tinting

UI Improvements

Smoother XP progress bar (5% steps with percent overlay)
Current tier glow, challenge progress percentage, time urgency colors

Configurable Currency

3 modes: internal, item, economy
Full CurrencyAdapter system

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