Skip to main content

Changelog

Version 1.5.0 - LuckPerms & MHUD Release​

Release Date: January 2025

This is a major release consolidating all 1.4.x improvements into a stable version.

New Features​

LuckPerms Integration​

  • Automatic Prefix Retrieval - LuckPerms prefixes are fetched automatically from the API
  • Full Color Support - Rainbow, gradients, legacy codes (&a, &b), hex colors
  • Trailing Style Support - Active styles at the end of prefix apply to username (color, bold, italic, underlined, strikethrough)
  • Separate Prefix/Suffix Styling - Prefix styles → Username, Suffix styles → Message color
  • Combined Chat Format - [LuckPerms-Prefix] [Achievement-Title] Username: message
  • Lazy Initialization - Works regardless of plugin load order

MHUD Integration​

  • Multiple HUD Support - Full integration with MHUD plugin
  • Conflict Prevention - No more crashes when multiple plugins use Custom HUDs
  • Graceful Fallback - Works with or without MHUD installed
  • Smart Detection - Automatically detects and uses MHUD when available

Technical​

  • Adventure MiniMessage library for color parsing (same as LuckPerms uses)
  • AdventureConverter utility class for MiniMessage → Hytale Message conversion
  • MHUDIntegration class for MHUD communication via reflection
  • Shadow JAR includes relocated Adventure libraries

Bug Fixes​

  • Fixed color inheritance for complex LuckPerms prefixes
  • Fixed LuckPerms load order issues with lazy initialization
  • Fixed "Failed to apply CustomUI HUD commands" crash with MHUD
  • Fixed crash when multiple plugins use Custom HUD without MHUD
  • Removed debug logging (now uses FINE level)

Dependencies​

Optional:

  • LuckPerms (for prefix/suffix integration)
  • MHUD (for multiple HUD support)

Version 1.3.0 - Display Options & Localization​

New Features​

Achievement Toast Banner​

  • Display Mode Config - Choose how achievement unlocks are displayed:
    • chat - Classic chat message (default)
    • banner - Toast notification in the top-right corner
    • both - Both chat and banner
  • Toast Features:
    • Shows achievement name, title reward, item rewards
    • Achievement icon on the left
    • Auto-hides after configurable duration
    • New toast cancels previous one (no stacking)
    • Fixed width (300px), dynamic height

Default Achievements Toggle​

  • loadDefaultAchievements config option
  • Set to false to use only custom achievements
  • Perfect for servers with fully custom achievement sets

Localization Improvements​

  • Chat messages now localized ("Achievement Unlocked", "Title Unlocked")
  • All notification messages support DE/EN

Version 1.2.0 - Complete Overhaul​

Custom Achievements System​

  • Custom Achievements File - Server operators can define custom achievements in custom_achievements.json
  • Custom achievements can override default achievements (same ID)
  • Automatically merged with default achievements on load
  • Template file custom_achievements.json.example is auto-generated

New Field: additionalInfo

  • Displays additional information below the reward line in the gallery
  • Ideal for event hints, special conditions, etc.
  • Configurable with text and color

Session-Based Playtime Tracking​

Before (Scheduler-based)

  • Playtime was incremented every minute via scheduler
  • On server crash: Loss of entire session since last save

Now (Session-based)

  • Session start time is saved on player connect
  • Playtime is calculated on player disconnect
  • 15-minute checkpoints: Automatic intermediate saves
  • Live calculation: UI always shows current playtime in real-time
  • Maximum data loss: 15 minutes instead of entire session
  • Search Field - Search achievements by name, description, ID, and category
  • "Completed" Filter Tab - New filter shows all unlocked achievements
  • Smart Chain Display - For achievement chains, only the next incomplete achievement is shown
  • Chain Progress Counter - Shows progress like [2/5] for chains
  • Progress with Units - Progress now shows units (e.g., "162 / 300 Minutes")
  • Live Playtime - Playtime achievements always show current session time
  • AdditionalInfo Display - Shows extra info for custom achievements
  • Hover Effects - All filter buttons and pagination buttons

Title Selection Improvements​

  • Full Localization (DE/EN) - Title, current label, no title, clear button
  • Pagination - Prev, Next, Page indicators
  • Statistics - "Titles: X/Y unlocked"
  • Origin Display - "From: {Achievement}"

Bug Fixes​

  • Fixed double-colon in reward display
  • Fixed chain counter going down instead of up
  • Fixed various German translation issues

Version 1.1.0 - Initial Release​

Features​

  • 487 built-in achievements across 6 categories
  • Achievement Gallery UI
  • Title Selection UI
  • Player commands (/achievements, /titles)
  • Admin commands (/achievementadmin)
  • Progress tracking for all trigger types
  • Item and command rewards
  • Multi-language support (EN, DE)
  • Statistics export

Categories​

  • Combat (49 achievements)
  • Progression (102 achievements)
  • Exploration (32 achievements)
  • Social (20 achievements)
  • Husbandry (29 achievements)
  • Secret (37 achievements)

Upgrade Notes​

Upgrading to 1.5.0​

No breaking changes. The plugin is fully backwards compatible.

Optional: Install MHUD for better HUD compatibility with other plugins.

Upgrading to 1.2.0​

Recommendation: When updating from 1.1.x, we recommend deleting the existing achievements.json file and restarting the server. The plugin will automatically generate a new default file. Custom achievements should be moved to the custom_achievements.json file so they are not overwritten by future updates.

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