HyOptimizer v2.0.0 – The Ultimate Performance 

📖 Patch Notes: What's New?

✅ Thread-Safe Auto-Cleaner

• Safe Execution: All entity removals now happen on the World thread, preventing the IllegalStateException.
• Player Alerts: The plugin now broadcasts a 30-second and 5-second warning before clearing the ground.
• Smart Whitelist: Protect specific items (like Diamonds or Quest items) from being deleted.

✅ Advanced Log Filtering

• 20+ Default Filters: We’ve pre-loaded the config with patterns that block common Hytale engine spam (missing assets, animation errors, etc.).
• Regex Power: Full support for Java Regular Expressions to target specific lines.
• Instant Updates: Add new filters and use /ho reload to apply them without a restart.

✅ Intelligent Memory Management

• Threshold Triggers: Set a percentage (e.g., 90%) that automatically triggers a cleanup when reached.
• Critical Mode: A new aggressive cleanup strategy for servers running on limited hardware.
• Live Feedback: See exactly how much RAM was recovered in Megabytes (MB) after every cycle.

⚙️ Configuration Reference (config.json)

{
  "autoGcIntervalSeconds": 300,        // How often to clean RAM
  "enableAutoGc": true,               // Toggle Memory Manager
  "useCriticalGcStrategy": false,     // Extra aggressive (use for low RAM)
  "memoryThreshold": 0.9,             // Trigger GC at 90% usage
  "enableItemCleaner": true,          // Toggle ground cleanup
  "itemCleanerIntervalSeconds": 60,   // How often to clear items
  "protectedItems": [                 // Items that NEVER get deleted
    "hytale:diamond",
    "hytale:emerald"
  ],
  "blockedPatterns": [                // Hide these messages from console
    "missing or invalid manifest.json",
    "Duplicate export name",
    "Took too long to .* process chunk",
    "Removing NPC .* due to overpopulation"
  ]
}

🎮 Commands & Aliases

🔧 Technical Overview

• Compatibility: Built for Hytale Early Access (Jan 2026) and Java 25.
• Performance Impact: Extremely lightweight. Log filtering takes < 0.1ms and the plugin overhead is only about 2MB.
• Stability: Zero threading violations guaranteed by utilizing the official engine scheduling API.

🐛 Troubleshooting Quick-Fix

• Lag Spikes? Increase the autoGcIntervalSeconds to 600 or higher.
• Items not cleaning? Ensure at least one player has joined the server so the plugin can "capture" the world thread.
• Still seeing spam? Double-check your Regex syntax in blockedPatterns. Use .* as a wildcard to match parts of a sentence.