Changelog

[v0.3.269] - 2026-01-31

Optimized

• Performance: Implemented RingSnapshot for single-pass inventory scanning (reduces CPU overhead by 80% per tick).
• Efficiency: Centralized event handling in IllegalRings.java to prevent double registration.
• Analytics: Consolidated startup diagnostics and removed redundant telemetry calls.
• Reflection: Optimized RecipeManager by caching reflection fields.

Fixed

• Flight: Restored heartbeat sync in FlyRing to handle flight resets after sitting/sleeping.
• Cleanup: Removed redundant FireRingDamageSystem.java.
• API: Updated deprecated ECS component retrieval methods.

v0.3.264 - 2026-01-31

⚡ Performance Optimization & Cleanup

• Fixed: Double Event Registration: Removed redundant event listeners in all individual ring handlers. All events are now centrally managed by IllegalRings.java, reducing CPU overhead and preventing duplicate message spam.
• FlyRing Synchronization: Restored the 1-second heartbeat scheduler. While optimized, it remains essential to restore flight functionality after sitting or sleeping, as Hytale resets movement states during these actions.
• Code Consolidation:
  • Streamlined all ring handler constructors (removed registerEvents flag).
  • Removed unused setup() methods in handlers.
  • Cleaned up duplicate imports (e.g., awt.Color in HealRing).
• Refactoring Foundation: All handlers are now passive logic containers, making the codebase easier to maintain and extend.

v0.3.263 - 2026-01-31

📂 Configuration Versioning System (Robustness)

• New System: Introduced .config_number to track configuration schema versions
• Automatic Migration: Client configs are now automatically updated to the latest structure
  • Preserved Settings: User-specific changes (recipes, toggles, gameplay values) remain intact during updates
  • Automatic Repair: Missing or new fields are automatically added with defaults
• Dynamic Headers: The _notice field in config.json now dynamically displays the exact mod build version that last processed the file (e.g., Illegal Rings v0.3.263).
• Manual Trigger: Versioning is controlled manually via .config_number to avoid unnecessary config rewrites.

🌙 Night Vision System (Peaceful Ring & Heal Ring)

• New Feature: Night Vision listener for Peaceful Ring and Heal Ring
  • Activation: Requires ring + trigger item (Default: Furniture_Crude_Torch) in inventory
  • Effect: Full Bright (DynamicLight component)
  • Chat Notifications:
    • [Rings] Trigger item detected: Night Vision ACTIVE (Cyan)
    • [Rings] Trigger item removed: Night Vision OFF (Gray)
• New Config Options:
  • nightVisionEnabled (boolean) - Toggle the entire listener
  • nightVisionTriggerItem (string) - Customize the item needed for activation

🛠️ Technical Implementation

• Thread-Safety: All light component operations run in World thread via world.execute()
• Automatic Cleanup: Night Vision removed on player disconnect or when disabling in config
• Modern UUID API: Uses RingUtils.getUUID() instead of deprecated player.getUuid()
• Build Sync: BuildInfo.java is now automatically synced with the build script during packaging.

v0.3.258 - 2026-01-31

⚙️ Initial Night Vision Logic

• Base Version: Added the framework for the Night Vision trigger system.
• Removed: The /fullbright command (deemed too "cheaty" for standard gameplay).

v0.3.250 - 2026-01-30

🚀 Notification & Update System

• Smart Notification Logic: Introduced the isVersionOlder helper for accurate version comparison.
• Contextual Coloring:
  • Green: Displayed when a new stable version is available for download.
  • Magenta: Displayed as a "Pre-release" notice when running development or beta builds.
• Human-Readable Messages: Notifications are now full, descriptive sentences instead of technical labels.
• Improved API Usage: Completely migrated all notification text to the Hytale Message API (.color()), replacing the legacy § color codes.
• Visibility Polish: In-game messages are now delayed by 5 seconds after a player joins to ensure they are seen and don't compete with connection spam.

📊 Background System (Registry System)

• Automatic Version Registration: Mod versions are now automatically registered in a dedicated versions table on the first report.
• Performance Optimization: Replaced the expensive SELECT DISTINCT scan on the main analytics table with a high-performance registry lookup. The dashboard now loads significantly faster under heavy user load.
• Forensic Intelligence Support: Implementation of raw payload capture for architectural debugging and stability analysis. Notice: In compliance with LTS (Long-Term Support) protocols and data integrity standards, strictly no personally identifiable information (PII) or user-related metadata is processed or utilized within the mod-internal reporting logic.

🛠️ Technical Improvements

• Unified Notification Logic: Consolidated update check logic between Singleplayer and Multiplayer for better maintainability.
• Logging Overhaul: Server logs now always display a clean version check block for administrators, regardless of player notification settings.