KyuubiSoft Achievements (Titles, Rewards)

Achievement System for Hytale with Titles and Rewards full customizable. Integrations with MMO Addons and more!
Install via App

File Details
DownloadInstall

KyuubiSoftAchievements-1.6.0.jar

ByKyuubiDDragon
  • R
  • Jan 30, 2026
  • 1011.01 KB
  • 254
  • Early Access

File Name

KyuubiSoftAchievements-1.6.0.jar

Supported Versions

  • Early Access

Version 1.6.0 - External Localization & Auto-Update

Release Date: January 2025

This release introduces an external localization system for easy translation customization, an automatic config update system, and comprehensive reward balancing.

New Features

External Localization System

  • JSON-based Language Files - Translations moved from JAR to external localization/ folder
  • Server-side Customization - Server operators can modify translations without JAR editing
  • Auto-Extraction - Default language files (en-US, de-DE) are automatically extracted on first start
  • Custom Languages - Add new languages by creating {language-code}.json in the localization folder
  • Fallback Chain - Missing translations fall back to en-US, then auto-formatted from key
  • Preserved Customizations - Language files are NOT overwritten on subsequent starts

Config Auto-Update System

  • Version Checking - Achievement configs now include configVersion field
  • Automatic Backup - Outdated configs are backed up as achievements.json.backup-vX
  • Force Update - New default achievements are automatically extracted when version is outdated
  • Seamless Migration - No manual intervention required for config updates
  • MMO Achievements Support - Same version checking applies to mmo_achievements.json

MMO SkillTree Integration

  • Full MMO SkillTree Support - Integration with MMOSkillTree plugin for skill-based achievements
  • Skill Level Tracking - Achievements for reaching skill levels (Mining, Woodcutting, Fishing, etc.)
  • Profession Milestones - Track progress across all MMO professions
  • Separate Config File - mmo_achievements.json for MMO-specific achievements
  • Auto-Detection - MMO achievements only load when MMOSkillTree is installed

Changes

Reward Balancing

Removed End-Game Rewards - All Mithril, Onyxium, and Prisma rewards removed (not available in adventure mode)

Ore Tier Hierarchy - Rewards now follow proper progression:

Copper → Iron → Thorium → Silver → Gold → Cobalt → Adamantite

Adjusted High-Tier Rewards - Replaced with appropriate Cobalt/Adamantite alternatives:

Achievement New Reward Previous Reward
monster_hunter_3 Cobalt Longbow Mithril Longbow
monster_hunter_4 Adamantite Shortbow (none)
monster_hunter_5 (removed) Onyxium Sword
outlander_outcast Cobalt Longbow Mithril Longbow
dragon_slayer_frost Adamantite Shortbow Mithril Shortbow
dragon_slayer_void (removed) Onyxium Ore
dragon_master (removed) Prisma Ore
minotaur_maze Cobalt Longsword Mithril Longsword
broodmother_slayer Adamantite Sword Mithril Sword
pvp_veteran Cobalt Sword Mithril Sword
pvp_legend (removed) Onyxium Sword
miner_4 Adamantite Pickaxe Mithril Pickaxe
void_guardian (removed) Onyxium Ore
perfectionist (removed) Prisma Ore

Removed Circular Rewards - No more "collect X ore" achievements that reward the same ore type:

  • mithril_collector_2: Removed Mithril Ore reward
  • adamantite_collector_2: Removed Adamantite Ore reward
  • prisma_master: Removed Prisma Ore reward

Icon Adjustments - Updated iconItems to match available materials:

Achievement New Icon Previous Icon
weaponsmith_2 Iron Sword Mithril Sword
mithril_knight Adamantite Chestplate Mithril Chestplate
armor_collector Cobalt Helmet Mithril Helmet
ultra_marathon Cobalt Boots Mithril Boots
ore_variety_2 Cobalt Ore Mithril Ore
scarak_genocide Cobalt Dagger Mithril Dagger
yeti_hunter Cobalt Axe Mithril Axe

File Structure Changes

kyuubisoft_achievements/
├── localization/              ← NEW: External translations
│   ├── en-US.json            (auto-extracted on first start)
│   ├── de-DE.json            (auto-extracted on first start)
│   └── [custom].json         (user-added)
├── config.json
├── achievements.json          (now with configVersion: 2)
├── mmo_achievements.json      (now with configVersion: 2)
├── custom_achievements.json   (user customizations - never overwritten)
└── playerdata/

Technical Details

  • PluginI18n.java completely rewritten for external JSON loading
  • AchievementConfig.java now includes version checking logic
  • Config files include "configVersion": 2 field
  • Gson TypeToken used for JSON map parsing
  • Automatic backup creation before config replacement
  • Recursive reload after version update

Dependencies

Required:

  • Hytale Server (latest version)

Optional:

  • LuckPerms (for prefix/suffix integration)
  • MHUD (for multiple HUD support)
  • MMOSkillTree (for skill-based achievements)

Upgrade Notes

Upgrading from 1.5.x

Automatic Migration: The plugin will automatically:

  1. Create a localization/ folder with default language files
  2. Detect outdated achievements.json and create a backup (achievements.json.backup-v1)
  3. Detect outdated mmo_achievements.json and create a backup
  4. Extract new default achievements with updated rewards

Breaking Change: Existing achievements.json and mmo_achievements.json will be replaced if outdated (configVersion < 2). Custom achievements should be in custom_achievements.json to prevent loss.

Important: All Mithril, Onyxium, and Prisma rewards have been removed as these ores are not yet available in adventure mode.

Custom Translations Migration

If you had custom translations in the old .lang format, convert them to JSON:

Old format (.lang):

achievements.name.my_achievement=My Achievement
achievements.desc.my_achievement=Do something cool

New format (.json):

{
  "achievements.name.my_achievement": "My Achievement",
  "achievements.desc.my_achievement": "Do something cool"
}

Fresh Install

  1. Place the JAR in your plugins folder
  2. Start the server
  3. Configure config.json as needed
  4. Add custom achievements to custom_achievements.json
  5. Customize translations in localization/ folder