KyuubiSoft Achievement System - Changelog

New Features

Achievement HUD Tracker

• Track up to 3 achievements on your screen with real-time progress
• Shows achievement name, progress count, and percentage (e.g. "15/50 — 30%")
• Difficulty color indicators: Normal (brown), Hard (gold), Epic (purple)
• Auto-untrack when an achievement is unlocked
• Chain support — tracking follows to the next tier automatically
• 6 position presets + custom X/Y positioning with live preview
• Per-player settings saved persistently

Achievement Points as Currency

• Earn points for every achievement: Normal (10), Hard (25), Epic (50)
• Spend points in the Core shop system as a real currency
• Points can be queried and modified by other mods via the API

Achievement Book Item

• Physical in-game item that opens the Achievement Gallery on right-click
• Configurable: enable/disable, hotbar slot, give on first join or every join
• Duplicate check prevents giving the item twice

Full Admin Panel

• 7-tab in-game configuration panel: General, Display, Notifications, Tracking, Admin, Prefixes, Achievements
• Full CRUD for custom achievements with visual item picker
• Multi-language editing (EN, DE, FR) for names, descriptions, and titles
• Up to 10 rewards per achievement with dynamic slot management
• Working copy system — changes are held until you click Save
• LuckPerms group prefix import
• Browse panel with category/source filters and pagination

Custom Icons

• Pixel-art icons for all UI buttons: settings, titles, rewards, pagination, collect all, clear, apply, reset
• HUD tracker header icon
• Quick-access buttons in the gallery for Titles and Rewards pages

NPC Integration

• Track NPC interactions and dialog completions for achievement progress
• Dialog conditions based on achievement status (unlocked, count)

AchievementAPI Extensions

• Achievement points management: get, add, spend
• Title management: set active title, get display name
• Event listeners for programmatic integration

Vertical Navigation Sidebar

• Admin panel navigation redesigned with vertical sidebar (InfoHub style)
• 4 color-coded sections: Settings (gold), Features (cyan), Management (green), Content (orange)

Localization Improvements

• Auto-discovery of all language files in the localization folder
• French (fr-FR) translation added alongside English and German
• All tooltips, HUD text, and admin labels fully localized

Improvements

• Migrated to Core's centralized TrackingService — removed 5 duplicate ECS systems
• Migrated to Core's shared utilities (ItemUtils, CommandUtils, RewardGrantHelper, GameDataProvider)
• Reward system uses Core's RewardType enum for consistency
• Lootbag management moved to Core's Lootbag Admin Panel
• "Collect All" now also collects lootbags (opens them and grants items directly)
• Unlock dates shown in the gallery for completed achievements
• Rewards page and Title Selection redesigned with icon buttons and pagination
• Settings page with Apply/Reset buttons and live preview
• HUD element IDs prefixed with "Ach" to avoid collisions with Quest Tracker
• All command messages localized (14 new keys)
• Browse panel migrated to Core's BrowsePanelHelper for consistency
• Dynamic slots: achievement rewards and lootbag items now support up to 10 entries (was 4)

Bug Fixes

• Fixed: Achievement and Quest HUD trackers interfering with each other due to identical element IDs
• Fixed: Chat crash caused by missing Adventure libraries at runtime
• Fixed: Browse panel items not showing on first open
• Fixed: Dropdown staying on "Loading..." when selecting the same value again
• Fixed: Fast typing in text fields losing characters
• Fixed: Admin panel localization version mismatch causing endless re-extraction
• Fixed: Over 150 incorrect item and entity IDs in default achievements
• Fixed: 6 ore achievements using wrong trigger type (blocks_mined for non-mineable ores)
• Fixed: Weekend Warrior achievement not unlocking properly
• Fixed: Chat broadcasts firing for all achievements instead of only title-granting ones