Mekanism Optimizer

⚡ Mekanism Optimizer

摘要（英文）：
面向 Mekanism 的高性能优化模组：消除物流管道与线缆卡顿，加速高 tick 工厂吞吐量，突破 2.14B 传输上限，并以零 tick 开销优化发电机。

📖 英文描述

Mekanism Optimizer 是一款新一代高性能优化模组，专为 Minecraft 1.20.1 Forge 上的 Mekanism 及其丰富的附属生态（Astral Mekanism、Mekanism Extras、Mekanism Generators 等）打造。

它大幅降低服务器 tick 耗时，消除 GC 内存压力，并移除由物流运输器、通用线缆、多方块计算和高频 tick 环境造成的瓶颈。

🚀 主要特性

• ⚡ 物流运输器与管道缓存（$O(1)$ 查找）：消除每 tick 繁重的接收方能力检查与重复寻路查找。在密集的大型工厂中，将物品与流体管道的 tick 卡顿降低最多 80% – 90%。
• ⚡ 通用线缆自适应退避：当目标机器或能量立方已充满时，智能暂停冗余的能量传输计算。
• ☀️ 发电机与太阳能激活器天光绕过：在夜间或缓冲区已满时，为太阳能发电机和太阳能中子激活器绕过昂贵的世界射线检测与天光检查。
• 🚀 突破 2.14B 自动弹出上限与多重爆发模式：可选配置可突破 Forge 每 tick Integer.MAX_VALUE（21.4 亿）的吞吐瓶颈。在单 tick 内无缝传输数万亿 RF/FE、mB 级流体/化学品以及数万物品（默认：安全 false）。
• 🪵 专用异步文件日志器：自动将实时性能统计、优化指标和健康报告记录到 .minecraft/logs/mekanism_optimizer.log，且零 tick 开销（非阻塞异步写入器）。
• 🌐 完整本地化与游戏内配置：包含完整的英文和日文（ja_jp）提示，可通过 Configured 或 mekanism_optimizer-common.toml 进行游戏内配置。
• 🛡️ 100% GUI 兼容性：确保所有机器和界面的 100% 稳定性与可访问性，包括温室和多方块结构。

💡 灵感与参考

Mekanism Optimizer 的灵感来自 Minecraft 生态中领先性能模组的卓越架构与优化范式：

• ModernFix（作者 embeddedt）：在字节码注入、惰性能力解析和结构化内存优化方面的出色设计。
• FerriteCore（作者 malte0811）：内存分配削减技术与快速数据缓存结构。
• Lithium / Canary（作者 CaffeineMC 与 AbdElAziz308）：世界 tick、方块实体节流和 $O(1)$ 空间追踪原理。
• Mekanism（作者 aidancbrady 与 Mekanism 团队）：向核心团队致以最深的敬意，感谢他们创造了 Minecraft 历史上最不可思议的科技模组体验之一。

📦 需求与兼容性

• Minecraft：1.20.1
• 模组加载器：Forge 47.3.0+（推荐 47.4.21+）
• Java：17+
• 必需依赖：Mekanism（10.4.x）
• 附属兼容性：完全兼容 Astral Mekanism (AME)、Mekanism Extras、Mekanism Generators、Mekanism Tools 以及主流存储模组（Applied Energistics 2、Refined Storage）。

🛠️ 配置

可通过 Configured 在游戏内配置设置，或编辑 .minecraft/config/mekanism_optimizer-common.toml：

[general]
# Output optimization statistics to logs/mekanism_optimizer.log
enableDedicatedLogFile = true

# Bypass 2.14B per-tick eject limits (Default: false)
enableUnlimitedAutoEject = false
maxItemBurstPerTick = 64

📜 许可证与开源

Mekanism Optimizer 基于 MIT 许可证开源。
源代码与问题追踪：GitHub 仓库

🇯🇵 日语说明（Japanese Description）

概要（Summary 日语翻译）：
专为 Mekanism 打造的新一代高性能优化模组。将管道与电网的搜索负载最多降低 90%，解决天体倍速与超巨型工厂的 Tick 尖峰，突破 21 亿限制并实现爆发式自动输出，同时减轻发电机的负载。

Mekanism Optimizer 是适用于 Minecraft 1.20.1 Forge 环境下 Mekanism 及其附属模组群（Astral Mekanism、Mekanism Extras、Mekanism Generators 等）的新一代高性能优化模组。

从根本上解决大型工业工厂、错综复杂的管线、天体倍速与加速环境下产生的 Tick 尖峰、GC（内存回收）负载，以及输电与管道搜索的开销。

🚀 主要功能与特点（日语）

• ⚡ 物流管道与传送器搜索的大幅轻量化（$O(1)$ 缓存）：将每 Tick 执行的输入目标机器 Capability 查询与路径搜索以 $O(1)$ 高速缓存化。在超巨型工厂中将管道的 Tick 负载最多降低 80% 〜 90%。
• ⚡ 输电电缆自适应退避：当连接目标机器或储电设备已满电时，智能暂停无用的输电模拟计算，从而降低服务器负载。
• ☀️ 发电机与太阳能激活装置的天空光照计算绕过：在太阳能发电机与太阳能中子激活装置中，于夜间或缓冲区满时以 $O(1)$ 完全绕过开销高昂的直射日光判定（射线检测）。
• 🚀 突破 21 亿（2.14B）输出限制与多重爆发式自动输出：搭载突破 Forge 标准 Integer.MAX_VALUE（21.4 亿）每 Tick 输出上限的选项。可在 1 Tick 内一次性输出数十亿至数万亿以上的能量、液体、气体，以及数万个物品（初始值：安全的 OFF）。
• 🪵 专用异步日志系统（logs/mekanism_optimizer.log）：不会被其他模组的大量日志淹没，将 Mekanism Optimizer 单独的优化统计与运行指标异步（Tick 负载完全为零）自动记录到 .minecraft/logs/mekanism_optimizer.log。
• 🌐 完全日语化的配置与工具提示支持：在游戏内配置模组（Configured 等）中鼠标悬停时，会显示所有项目通俗易懂的日语说明工具提示。
• 🛡️ 100% GUI 兼容性：保证包括温室（Greenhouse）在内所有机器的稳定运行。

💡 参考与致敬的模组（Inspirations）

本模组的架构与优化设计，受以下引领 Minecraft 社区的优秀优化模组启发而开发：

• ModernFix（by embeddedt）：精炼的字节码注入、延迟 Capability 解析、结构化内存优化设计。
• FerriteCore（by malte0811）：内存分配削减技术与高速数据缓存结构。
• Lithium / Canary（by CaffeineMC & AbdElAziz308）：世界 Tick 处理、方块实体节流，以及 $O(1)$ 空间追踪范式。
• Mekanism（by aidancbrady & the Mekanism Team）：衷心感谢为本作打造出 Minecraft 史上最出色工业体验的本家开发团队各位。

📦 运行环境与兼容性

• Minecraft：1.20.1
• 模组加载器：Forge 47.3.0+（推荐 47.4.21 / 47.4.22）
• Java：17+
• 必需前置模组：Mekanism（10.4.x）
• 附属模组兼容性：与 Astral Mekanism (AME)、Mekanism Extras、Mekanism Generators、Mekanism Tools，以及主要存储模组（AE2、Refined Storage）100% 兼容。

📜 许可证

Mekanism Optimizer 基于 MIT 许可证作为开源项目发布。
源代码与 Bug 报告：GitHub 仓库