RedstoneOptimizer
RedstoneOptimizer 是一款针对红石电路系统的性能优化插件。
其核心目标是减少红石电路重复计算带来的 Tick 开销，通过缓存机制与结构优化手段，提高复杂电路环境下的运算效率。
插件基于运行时 Hook 技术实现，对红石组件评估流程进行优化处理。
核心优化机制
ConsumerComponent 评估结果缓存
插件对 ConsumerComponent::$evaluate 进行拦截，并建立缓存机制：
- 为每个 ConsumerComponent 计算输入状态哈希值
- 若当前输入状态与上次一致，则直接使用缓存结果
- 跳过重复的电路计算流程
缓存内容包括：
- 输入哈希值
- 上次输出信号强度
当输入未发生变化时，不再重复执行完整 evaluate 流程。
输入状态哈希计算
在执行缓存判断前，插件会遍历当前组件的输入源，并计算以下信息：
- 来源组件信号强度
- 衰减值
- 是否直接供电
- 方向信息
- 附加数据
通过组合计算生成唯一哈希值，用于判断输入是否发生变化。
扁平缓存结构
插件使用基于 unordered_map 的扁平缓存结构：
- Key：ConsumerComponent 指针
- Value：缓存条目（输入哈希 + 输出强度）
当缓存数量达到上限时：
- 采用批量清理方式
- 清空缓存后重新建立
该方式避免了维护 LRU 链表带来的额外开销。
递归深度保护
为避免复杂红石电路导致的深层递归问题，插件加入递归深度限制：
- 使用 thread_local 计数器记录 evaluate 深度
- 超过设定上限时跳过缓存逻辑
- 保证系统稳定性
组件有序插入优化
在 CircuitSceneGraph::add 中：
- 替代全量排序
- 对新增组件执行局部插入排序
- 仅对末尾元素进行位置调整
该优化降低了组件列表排序的整体开销。
组件移除时缓存清理
当组件被移除时：
- 同步删除对应缓存条目
- 避免无效缓存残留
通过 Hook：
- CircuitSceneGraph::removeComponent
实现缓存一致性维护。
调试统计功能
支持周期性输出缓存运行状态，包括：
- 缓存命中次数
- 缓存未命中次数
- 因递归保护跳过次数
- 当前缓存大小
- 命中率
统计输出可通过配置开关控制。
技术实现结构
插件主要拦截以下核心函数：
- CircuitSceneGraph::add
- ConsumerComponent::$evaluate
- CircuitSceneGraph::removeComponent
通过缓存复用与结构优化，减少重复电路计算与排序开销。
配置项说明
支持以下主要配置参数：
- 是否启用优化
- 是否启用调试输出
- 最大缓存容量
配置文件位于插件目录下的 config.json。
适用环境
适用于：
- 大规模红石电路服务器
- 高频信号传递结构
- 复杂逻辑电路场景
- 自动化装置密集区域
- 红石运算压力较高的环境
RedstoneOptimizer 通过缓存机制与结构优化，降低红石系统重复计算成本，在复杂电路环境中改善服务器运行表现。
点击链接加入群聊【PHE 插件交流群】：https://qm.qq.com/q/DOYQMxgWVW
