v0.6.0 Patch Notes

Command Rewards v2.0 - Schema Redesign

Major overhaul of the command rewards system with a unified schema and override-based config.

New Schema

• Unified rewards list - All rewards are now commands (items given via /give commands)
• Override-based config - Config stores only customizations, defaults preserved across updates
• Per-command customization:
•     localizationKey - Preferred way to set display name (supports all languages)
•     displayName - Fallback literal display name
•     color - Hex color for UI display (e.g., #ffaa00)
•     runAs - CONSOLE (default) or PLAYER
• Display logic - Rewards without display info are executed but hidden from UI

New Config Format

{
  "schemaVersion": 1,
  "enabled": true,
  "overrides": {
    "MINING": {
      "10": [
        {
          "command": "/give {player} Ingredient_Bar_Iron --quantity=25",
          "localizationKey": "reward.item.iron_bars",
          "color": "#ffaa00"
        }
      ]
    }
  }
}

Override Semantics

• Missing levels use defaults automatically
• Set level to empty array [] to disable rewards at that level
• New defaults propagate without losing your customizations
• Schema version only changes for structural changes

Migration

• Automatic V4 migration - Existing configs are converted and backed up
• Claimed rewards preserved - Level-based tracking maintained across upgrade

Global Skill Rewards

• New reward category: GLOBAL_SKILL - Bonus rewards given to ALL skills at milestone levels
•     Tracked per-skill: Mining 50 and Swords 50 each independently trigger level 50 global rewards
•     Configurable via GLOBAL_SKILL key in command-rewards.json overrides
•     Visible in the player Rewards UI as "Lv X Bonus" rows alongside per-skill rewards
•     Default: 1.25x Global XP Boost (15 min) at Level 100 for every skill mastered

XP Boost Token Rewards

• Boost tokens as milestone rewards - Level-up milestones now include XP boost tokens
•     Personal skill boosts at Lv 50 (1.5x 15min) and Lv 100 (2x 30min) for each skill
•     Personal all-skills boosts at Total Lv 100 (1.5x 30min) and Total Lv 350 (2x 45min)
•     Global server boosts at Total Lv 500 (1.5x 30min), 750 (2x 30min), 1000 (2x 60min)
•     Global boosts broadcast to all online players via /say when activated

Admin Command Rewards UI

• New CommandRewardsPage - Visual editor for command rewards, accessible from /mmoadmin
•     Category tabs: Gathering, Combat, Crafting, Misc, Total Level, All Skills (Global)
•     Skill selector for per-skill categories, hidden for Total Level and All Skills
•     Level selector showing all configured milestone levels
•     Reward table with columns: Command, Display Name, Loc Key, Color, Status
•     Add/Edit section with fields for Command, Display Name, Loc Key, Color
•     Inline Disable button on each default reward to create override without that reward
•     Remove button on overridden rewards to delete individual entries
•     Disable Level to set empty override (no rewards at that level)
•     Reset to Default to remove override and restore defaults

Auto-Derived Display Info

• Item rewards auto-derive display names from item IDs (e.g., Ingredient_Bar_Iron → "Iron Bars")
• Item rewards auto-derive tier colors from item ID patterns:
•     Common materials (Iron, Copper): #c8c8c8
•     Uncommon (Cobalt, Thorium): #4aff7f
•     Rare (Adamantite, Mithril): #4a9eff
•     Epic (Onyxium): #c84aff
•     Legendary (Prisma, Voidstone): #ffaa4a
•     Gems, essences, and tools each have appropriate colors
• Rewards without explicit display info now visible in admin UI with auto-derived names

Bug Fixes

• Fixed incorrect ore XP rates - Removed explicit low-XP entries for special terrain ores (Ore_Cobalt_Slate, Ore_Adamantite_Magma, Ore_Iron_Basalt) that overrode wildcard patterns with incorrect values (4-6 XP instead of proper ore rates)
• Fixed tier label missing in player Rewards UI - localization fallback returned empty string for undefined keys, causing blank tier headers
• Fixed Visible boolean type error - Hytale CustomUI requires boolean values for Visible property, not string representations
• Fixed display name override in tier headers - Auto-derived item names no longer replace "Level X" tier labels