promotional bannermobile promotional banner

HyOptimizer

The Ultimate Utility for Console Organization & Memory Efficiency
Install via App

File Details
DownloadInstall

HyOptimizerv3.6.1.jar

ByHytaleLibrary
  • R
  • Feb 8, 2026
  • 29.74 KB
  • 44
  • Early Access

File Name

HyOptimizer.jar

Supported Versions

  • Early Access

HyOptimizer v3.6.1 – The "Build Safety" & "Protected Items" Update 🛡️

Release Date: February 8, 2026

🌟 Vital Fixes & Major Feature Overhaul

This update is a direct response to critical community feedback regarding build safety and administrative control. We’ve prioritized the protection of your world decorations and fixed essential logic in the permission and filtering systems.

🛡️ 1. Fixed Protected Items Logic

The protectedItems system has been completely verified. You can now reliably whitelist specific items to ensure they are never deleted by the auto-cleaner. This is essential for protecting rare loot, custom currency, or modded items.
⚠️ CRITICAL CONFIGURATION RULE: Do NOT include the hytale: prefix in your config. The system uses a loose matching logic for better compatibility.
  • ✅ Correct: "soil_dirt", "another_item"
  • ❌ Incorrect: "hytale:soil_dirt" (The prefix may cause the match to fail).

🏗️ 2. Build Safety & Custom Entity Protection

We heard your reports about decorative entities being removed. To fix this, we have implemented three layers of safety:
  • Disabled by Default: The Item Cleaner is now OFF by default (enabled: false). This ensures that a fresh installation cannot accidentally wipe items until you've configured your settings.
  • Smart Entity Filtering: We’ve added removeCustomEntities: false. When set to false, the plugin will ignore any entity that has a custom name or isn't a standard "dropped item."
  • Builder Disclaimer: We strongly recommend testing the cleaner in a controlled environment before enabling it on a live server with complex builds.

🔒 3. Permission System Overhaul

To ensure server security, we have completely rebuilt the command permission checks.
  • Fixed Exploits: Commands are no longer accessible to regular players by default.
  • Strict Permission Nodes: Every command now requires a specific permission (see the table below).
  • Wildcard Support: You can now use hyoptimizer.* in your permission manager (like LuckPerms) to grant staff access to all features instantly.

📋 Permission Reference Guide

Command Permission Node Description
/ho clean hyoptimizer.clean Trigger the manual item sweep.
/ho gc hyoptimizer.gc Force a manual RAM cleanup cycle.
/ho reload hyoptimizer.reload Reload the config file on the fly.
Full Access hyoptimizer.* Access to every optimization command.
<button class="mdc-button mat-mdc-button-base export-sheets-button-container mat-mdc-button mat-unthemed ng-star-inserted">Export to Sheets</button><button class="mdc-icon-button mat-mdc-icon-button mat-mdc-button-base mat-mdc-tooltip-trigger copy-button mat-unthemed ng-star-inserted" aria-label="Copy table" data-test-id="copy-table-button"></button>
Note: Server Operators (OP) and the Console have full permissions automatically.

⚙️ Configuration Example (hyoptimizer_config.json)

JSON
<button class="mdc-icon-button mat-mdc-icon-button mat-mdc-button-base mat-mdc-tooltip-trigger copy-button ng-tns-c3630790347-53 mat-unthemed ng-star-inserted" aria-label="Copy code"></button>
"protectedItems": [
  "soil_dirt",
  "something else",
  "something else",
  "something else"
],
"enableItemCleaner": false,
"removeCustomEntities": false

⚠️ Important Usage Notes

  • Update Safety: Before updating, please backup your current config. While we support auto-migration, a backup is always the safest route.
  • User Responsibility: Because this plugin interacts directly with world entity data, please verify your protectedItems list to ensure your server's specific needs are met.
Thank you for your incredible patience and for reporting these bugs! Your feedback is what makes HyOptimizer better every single day. Happy optimizing! 🚀