航空学/Sable优化器

!在添加到现有世界之前请备份世界!

想要真正的性能提升，请编辑配置文件

此项目的部分内容使用了 AI 辅助生成

---

Sable 优化器

这是一个服务端 NeoForge 模组，通过检测非活跃的子层级（船只）并降低其计算工作量，来减少 Sable 物理引擎的 CPU 占用。

命令

命令	描述
/sableoptimizer status @e[type=sable:sub_level]	显示目标子层级的活跃状态和速度
/sableoptimizer reset @e[type=sable:sub_level]	强制将目标子层级唤醒至完全活跃状态

需要操作等级 2 或以上。

配置预设

编辑服务器配置文件（config/sable_optimizer-server.toml）以手动应用这些值：

质量（温和）

平滑的船只移动，与原版视觉差异极小。

设置	值
inactivityThresholdTicks	200
activeHeatmapTickInterval	4
inactiveHeatmapTickInterval	40
inactivePosesSubstepInterval	5
inactiveActorTickInterval	4

均衡（推荐）

折中方案 —— 适用于大多数服务器。

设置	值
inactivityThresholdTicks	400
activeHeatmapTickInterval	4
inactiveHeatmapTickInterval	10
inactivePosesSubstepInterval	5
inactiveActorTickInterval	4

性能（激进）

最大 CPU 节省 —— 非活跃船只的视觉保真度可能会降低。

设置	值
inactivityThresholdTicks	200
activeHeatmapTickInterval	8
inactiveHeatmapTickInterval	70
inactivePosesSubstepInterval	8
inactiveActorTickInterval	8

可选：Create Aeronautics

如果安装了 Create Aeronautics，Sable 优化器会自动对 Aeronautics 的螺旋桨、气球和其他方块实体执行器应用相同的优化。无需额外配置。

可选：机械动力（Create）

如果安装了 Create，Sable 优化器会应用以下服务端优化：

• 动力方块实体（KineticBlockEntity）跳tick — 空闲的动力方块实体（无速度更新、无网络脏标记、无待验证状态）将跳过整个 tick，为拥有数千个空闲轴/齿轮的大型网络节省 CPU。
• 装置（Contraption）跳tick — 静止的装置（零位移）将跳过实体碰撞检查、执行器 tick 及相关逐 tick 工作。
• 动力网络同步节流 — 网络应力/容量同步数据包将节流至每 4 tick 发送一次，而非每 tick，将大型动力网络的网络数据包流量减少 75%。

这些由 enableCreateOptimizations 配置选项控制（默认：true）。即使未安装机械动力，保持启用也完全安全。

可选：Flywheel

Flywheel 是纯客户端模组 —— 它没有服务端代码。Sable 优化器不会修改 Flywheel。

完整配置选项

选项	默认值	描述
enableOptimization	true	总开关
inactivityThresholdTicks	400	停止的子层级被判定为非活跃前的 tick 数
velocityThreshold	0.01	子层级被视为静止的速度阈值（米/秒）
activeHeatmapTickInterval	4	活跃子层级的热图频率
inactiveHeatmapTickInterval	10	非活跃子层级的热图频率
inactivePosesSubstepInterval	5	非活跃子层级姿态/力学更新的物理子步长间隔
inactiveActorTickInterval	4	非活跃子层级的方块实体执行器 tick 间隔
enableCreateOptimizations	true	启用针对机械动力的专属服务端优化