HyOptimizer 🚀

The Ultimate Toolkit for Console Clarity, Memory Management & Server Metrics

Version: 3.6.2 (Latest Release - Feb 2026)

⚠️ IMPORTANT: BUILD SAFETY & CONFIGURATION

PLEASE READ BEFORE UPDATING: To prevent accidental removal of decorative entities (like Armor Stands or Custom Props), the Item Cleaner is now DISABLED by default (enableItemCleaner: false).

Before enabling it, please:

Check your config: Set removeCustomEntities: false to protect named/custom mobs.
Update Protected Items: Add any specific items to the protectedItems list (do NOT use the hytale: prefix).
Test: Run a manual cleanup /ho clean in a safe area first.

💖 Support the Project

Development of HyOptimizer and HyDamageEditor takes a significant amount of time and effort. While these tools will always remain free for the community, donations are greatly appreciated and help fuel future updates, new features, and dedicated support!

If these tools have helped your server run smoother or made your life as an admin easier, consider buying me a coffee:

👉 Donate via PayPal

Thank you for supporting independent Hytale development! 🚀

📖 Overview

HyOptimizer is a specialized, high-performance utility designed to eliminate the four primary obstacles to a smooth Hytale server: Console Noise, Memory Leaks, Entity Lag, and Lack of Real-Time Metrics.

By merging surgical log filtration, aggressive RAM recovery, a thread-safe entity cleanup system, and an all-new performance monitor, HyOptimizer ensures your server remains efficient and your logs stay readable. Version 3.6.2 introduces critical safety protocols for builds, a strict permission system, and multi-language support.

✨ Key Features

1. 📊 Real-Time Performance Monitor

Get a comprehensive snapshot of your server’s health with a professional, color-coded chat interface.

Chat-Based Display: A stable and cross-client compatible alternative to problematic HUDs.
Dynamic Color Coding:
- 🔵 Cyan: Headers and category labels.
- 💛 Gold/Yellow: Memory stats and uptime tracking.
- ⚪ White: High-contrast data values.
- 🎨 Status Indicators: Green (Healthy) → Yellow (Moderate) → Red (Critical).
Streamlined Access: Use /ho for an immediate performance overview.

2. 🛡️ Build-Safe Item Cleaner (Updated v3.6.2)

Maintain high TPS by wiping dropped items without risking server instability or ruining builds.

Safety First: Disabled by default to prevent accidents.
Custom Entity Protection: New setting removeCustomEntities: false ensures named mobs and special entities are ignored.
Smart Whitelist: Protect valuable resources (e.g., "ores", "sword") via the protectedItems list.
Fail-Safe Architecture: Automatically skips cleanup cycles if the world thread is overloaded.

3. 🧹 Advanced Anti-Spam & Log Filtering

Clean up your console by suppressing the relentless flood of engine-level warnings.

26 Active Filters: Native coverage for InteractionChain, Missing interaction, NPC overpopulation, and FileSystemException errors.
Readable Logs: Intercepts "garbage" protocol hashes and ensures all logs are plain, readable text.
Regex Flexibility: Add your own custom patterns to config.json to block specific strings.

4. 🔒 Strict Permission System (New)

Security is paramount. Version 3.6.2 implements strict permission nodes for every command, compatible with Hytale's native permission system.

Granular Control: Assign specific rights like hyoptimizer.* and hyoptimizer.clean
Manifest Registered: Nodes are properly registered for better compatibility with external managers.

5. 🌍 Multi-Language Support

Built-in Languages: Switch between English ("en") and Spanish ("es") instantly in the config.
Extensible: Easy to add more languages via the Messages system.

🎮 Command Center & Permissions

Command	Action	Permission Node
`/ho`	Opens the performance monitor (Default)	`hyoptimizer.monitor`
`/ho gc`	Manually triggers a RAM optimization cycle	`hyoptimizer.gc`
`/ho clean`	Instantly removes non-protected ground items	`hyoptimizer.clean`
`/ho reload`	Hot-reloads configuration and filters	`hyoptimizer.reload`

Note: Server Operators (OP) have full access to all commands by default.

⚙️ Configuration Preview (`config.json`)

Note: In v3.6.2, do NOT use the hytale: prefix for protected items.

JSON

{
  "configVersion": 6,
  "language": "en",
  "prefix": "&e[HyOptimizer]",
  "primaryColor": "&a",
  "secondaryColor": "&b",
  "warningColor": "&c",
  "infoColor": "&7",
  
  "enableAutoGc": true,
  "autoGcIntervalSeconds": 30,
  "useCriticalGcStrategy": false,
  "memoryThreshold": 0.0,
  
  "enableItemCleaner": false,
  "removeCustomEntities": false,
  "itemCleanerIntervalSeconds": 300,
  "warningIntervals": [ 60, 30, 5 ],
  
  "protectedItems": [
    "soil_dirt",
    "diamond",
    "emerald"
  ],
  
  "blockedPatterns": [
    "missing or invalid manifest.json",
    "Took too long to .* process chunk",
    "InteractionChain",
    "Removing NPC .* due to overpopulation",
    "FileSystemException.*The process cannot access the file",
    "...and 20+ more!"
  ]
}

📥 Installation Guide

Stop your Hytale Server.
Clean Install: Delete any old HyOptimizer.jar and the mods/HyOptimizer folder to ensure a clean v3.6.2 environment.
Deploy: Place the new HyOptimizer-3.6.2.jar into your mods folder.
Launch: Restart your server.

🆕 New in v3.6.2

🛡️ Build Safety: Item cleaner disabled by default; added removeCustomEntities toggle.
🐛 Fix: protectedItems now works correctly (removed requirement for prefixes).
🔒 Permissions: Added strict permission nodes (hyoptimizer.*) and manifest registration.
🌍 Languages: Added native Spanish support ("language": "es").
☕ Compatibility: Fixed Java 21 UnsupportedClassVersionError issues.

❓ Why Choose HyOptimizer?

The Hytale Early Access environment is naturally "loud"—it logs every minor detail and consumes RAM aggressively. This makes it hard to identify actual game-breaking errors. HyOptimizer silences the noise and manages the bloat, letting you focus on your community while we handle the engine's "mess" in the background.

📝 Version History

v3.6.2 (Feb 2026): Build safety protocols, Permission system overhaul, Language support.
v3.5.0: Chat monitor, branding customization, 26+ filters.
v3.0.0: Chat color support, thread-safe cleaning.
v1.0.0: Initial release.