HyOptimizer

HyOptimizer 🚀

控制台清晰度、内存管理与服务器指标的终极工具箱

版本： 3.6.2（最新版本 - 2026年2月）

---

⚠️ 重要提示：建筑安全与配置

更新前请阅读： 为防止意外移除装饰性实体（如盔甲架或自定义装饰道具），物品清理器现默认禁用（enableItemCleaner: false）。

在启用前，请：

1. 检查您的配置： 设置 removeCustomEntities: false 以保护已命名/自定义生物。

2. 更新受保护物品： 将任何特定物品添加到 protectedItems 列表中（不要使用 hytale: 前缀）。

3. 测试： 先在安全区域运行手动清理 /ho clean。

💖 支持项目

HyOptimizer 和 HyDamageEditor 的开发需要大量的时间和精力。虽然这些工具将始终对社区免费，但非常感谢您的捐赠，这有助于推动未来的更新、新功能和专属支持！

如果这些工具让您的服务器运行更流畅，或让您作为管理员的工作更轻松，请考虑请我喝杯咖啡：

👉 通过 PayPal 捐赠

感谢您支持独立的 Hytale 开发！🚀

---

📖 概述

HyOptimizer 是一款专门的高性能实用工具，旨在消除 Hytale 服务器流畅运行的四大障碍：控制台噪音、内存泄漏、实体卡顿和缺乏实时指标。

通过结合精准的日志过滤、激进的内存回收、线程安全的实体清理系统以及全新的性能监视器，HyOptimizer 确保您的服务器保持高效，日志保持清晰可读。3.6.2 版本引入了关键的建筑安全协议、严格的权限系统和多语言支持。

---

✨ 主要特性

1. 📊 实时性能监视器

通过专业、颜色编码的聊天界面，获取服务器运行状况的全面快照。

• 基于聊天的显示： 一种稳定、跨客户端兼容的替代方案，避免了问题百出的 HUD。
• 动态颜色编码：
  • 🔵 青色： 标题和分类标签。
  • 💛 金色/黄色： 内存统计和运行时间跟踪。
  • ⚪ 白色： 高对比度数据值。
  • 🎨 状态指示器： 绿色（健康）→ 黄色（中等）→ 红色（严重）。
• 便捷访问： 使用 /ho 获取即时性能概览。

2. 🛡️ 建筑安全物品清理器（更新于 v3.6.2）

通过清理掉落物品维持高 TPS，同时避免服务器不稳定或破坏建筑。

• 安全第一： 默认禁用，防止意外发生。
• 自定义实体保护： 新设置 removeCustomEntities: false 确保已命名生物和特殊实体被忽略。
• 智能白名单： 通过 protectedItems 列表保护有价值的资源（例如 "ores"、"sword"）。
• 故障安全架构： 如果世界线程过载，自动跳过清理周期。

3. 🧹 高级反垃圾与日志过滤

通过抑制引擎级警告的持续泛滥，清理您的控制台。

• 26个有效过滤器： 原生支持 InteractionChain、Missing interaction、NPC 过量和 FileSystemException 错误。
• 可读日志： 拦截“垃圾”协议哈希，确保所有日志为纯文本、可读格式。
• 正则灵活性： 在 config.json 中添加自定义模式以屏蔽特定字符串。

4. 🔒 严格权限系统（新增）

安全至关重要。3.6.2 版本为每个命令实现了严格的权限节点，兼容 Hytale 的原生权限系统。

• 精细控制： 分配特定权限，如 hyoptimizer.* 和 hyoptimizer.clean。
• 清单注册： 节点已正确注册，以便更好地与外部管理器兼容。

5. 🌍 多语言支持

• 内置语言： 在配置中即时切换英语（"en"）和西班牙语（"es"）。
• 可扩展： 通过 Messages 系统轻松添加更多语言。

---

🎮 命令中心与权限

命令	操作	权限节点
/ho	打开性能监视器（默认）	hyoptimizer.monitor
/ho gc	手动触发内存优化周期	hyoptimizer.gc
/ho clean	立即移除未受保护的地面物品	hyoptimizer.clean
/ho reload	热重载配置和过滤器	hyoptimizer.reload

注意：服务器管理员（OP）默认拥有所有命令的完整访问权限。

---

⚙️ 配置预览（config.json）

注意： 在 v3.6.2 中，不要为受保护物品使用 hytale: 前缀。

{
  "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!"
  ]
}

---

📥 安装指南

1. 停止您的 Hytale 服务器。
2. 全新安装： 删除任何旧的 HyOptimizer.jar 和 mods/HyOptimizer 文件夹，以确保干净的 v3.6.2 环境。
3. 部署： 将新的 HyOptimizer-3.6.2.jar 放入您的 mods 文件夹。
4. 启动： 重新启动您的服务器。

---

🆕 v3.6.2 更新内容

• 🛡️ 建筑安全： 物品清理器默认禁用；新增 removeCustomEntities 开关。
• 🐛 修复： protectedItems 现在能正确工作（移除了前缀要求）。
• 🔒 权限： 新增严格权限节点（hyoptimizer.*）和清单注册。
• 🌍 语言： 新增原生西班牙语支持（"language": "es"）。
• ☕ 兼容性： 修复了 Java 21 的 UnsupportedClassVersionError 问题。

---

❓ 为什么选择 HyOptimizer？

Hytale 抢先体验环境天生“嘈杂”——它会记录每一个微小的细节并激进地消耗内存。这使得识别真正的破坏性错误变得困难。HyOptimizer 会静默噪音并管理膨胀，让您专注于社区，而我们在后台处理引擎的“混乱”。

---

📝 版本历史

• v3.6.2（2026年2月）：建筑安全协议、权限系统重写、语言支持。
• v3.5.0：聊天监视器、品牌自定义、26+ 过滤器。
• v3.0.0：聊天颜色支持、线程安全清理。
• v1.0.0：初始版本。