邱的优化

邱的优化

此模组优化了Minecraft的各个方面,以提高帧率和实体流畅度。

优化

Qiu's Optimization

轻量级 Minecraft Forge 模组优化器 — 为 1.20.1 服务器降本增效

Forge Minecraft License

📖 简介

Qiu's Optimization 是一款专为 Minecraft Forge 1.20.1 服务器设计的性能优化模组。通过 批处理缓存、AI 节流、动态 TPS 调整 三大核心机制,大幅降低内置服务端的 CPU 负载,让响应时间更流畅。

无需任何依赖,开箱即用,全自动运行。

✨ 特性

  • 🔄 TileEntity 批处理 缓存所有模组方块实体,每秒统一处理一次,取代原版每 tick 遍历,遍历次数减少 20 倍。

  • 🧠 实体 AI 智能节流 距离玩家 32 格以外的实体,AI 更新频率从 0.05 秒/tick 降低到 2 秒/tick,CPU 负载降低 70%。

  • 📉 动态 TPS 降级 服务器 TPS 低于阈值时自动降低处理频率,避免完全卡死。

  • ⚙️ 完全可配置 所有参数均可在 .minecraft/config/qiusoptimization-common.toml 中自由调整。

  • 🪶 轻量 & 无侵入 仅 1 个 Java 文件,不修改原版核心逻辑,兼容绝大多数模组。

📦 安装

  1. 下载最新的 qiusoptimization-{version}.jar
  2. 放入 .minecraft/mods/ 目录
  3. 启动游戏或服务器(Forge 47.4.4+)

⚙️ 配置(1.0.1fix)

配置文件位置:.minecraft/config/qiusoptimization-common.toml

通用设置

[general] # 是否记录泥土方块的注册名 logDirtBlock = true # 魔法数字(示例配置) magicNumber = 42 # 魔法数字介绍文本 magicNumberIntroduction = "The magic number is: " # 示例物品列表 items = ["item1", "item2"]

性能优化设置

[optimization] # TileEntity 缓存重建间隔(Ticks) # 默认:20(1 秒) 范围:5 ~ 200 tileUpdateInterval = 20

# 降级模式的 TPS 阈值,低于该值激活保护
# 默认:16.0  范围:10.0 ~ 20.0
tpsThreshold = 16.0

# 是否启用 TileEntity 批处理优化
enableTileOptimization = true

# 是否启用动态 TPS 降级
enableTPSDowngrade = true

实体优化设置

[entity] # 实体优化模式 # BOOST - 增强模式:为实体分配更多 CPU(推荐) # REDUCE - 精简模式:节省 CPU 以提升 FPS # PRESERVE - 保留模式:不做实体优化,保持原版行为 entityMode = "BOOST"

# 近距离(格),该范围内实体保持原版更新频率
# 默认:16  范围:4 ~ 64
nearDistance = 16

# 中距离(格),该范围内实体轻微节流
# 默认:32  范围:8 ~ 128
midDistance = 32

# 远距离实体 AI 更新间隔(Ticks)
# 默认:10(0.5 秒)  范围:1 ~ 40
farInterval = 10

# 额外实体 tick 间隔(Ticks),0 表示禁用额外 tick
# 默认:4(0.2 秒)  范围:0 ~ 20
extraTickInterval = 4

# 每 tick 最多额外 tick 的实体数量
# 默认:20  范围:1 ~ 100
maxExtraEntityTicks = 20

物品合并设置

[item_merge] # 是否启用物品合并 enableItemMerge = true

# 合并检测半径(格)
# 默认:3  范围:1 ~ 10
itemMergeRadius = 3

# 每个区块最大物品数量,超出部分将被移除(最旧的优先)
# 默认:50  范围:10 ~ 200
maxItemsPerChunk = 50

# 物品合并检测间隔(Ticks)
# 默认:40(2 秒)  范围:10 ~ 100
itemMergeCheckInterval = 40

错峰区块保存设置

[chunk_saving] # 是否启用错峰保存(将保存分散到多个 tick) enableStaggeredSaving = true

# 每批保存的区块数量
# 默认:5  范围:1 ~ 50
chunksPerSave = 5

# 保存间隔(Ticks)
# 默认:200(10 秒)  范围:20 ~ 400
saveInterval = 200

配置速查表

配置项 默认值 说明
tileUpdateInterval 20 TileEntity 缓存重建间隔,越高 CPU 占用越低
tpsThreshold 16.0 降级模式的 TPS 阈值
enableTileOptimization true 禁用后恢复原版 TileEntity 行为
enableTPSDowngrade true 禁用后移除 TPS 降级保护
entityMode BOOST 实体模式:BOOST/REDUCE/PRESERVE
nearDistance 16 该范围内实体保持原版更新
midDistance 32 该范围内实体轻微节流
farInterval 10 远距离实体 AI 更新间隔(Ticks)
extraTickInterval 4 额外实体 tick 间隔,0 = 禁用
maxExtraEntityTicks 20 每 tick 最多额外 tick 的实体数量
enableItemMerge true 禁用后停止物品合并
itemMergeRadius 3 合并检测半径,越高效率越高
maxItemsPerChunk 50 每区块物品上限
itemMergeCheckInterval 40 物品合并检测间隔
enableStaggeredSaving true 禁用后恢复原版保存
chunksPerSave 5 每批保存的区块数量
saveInterval 200 保存间隔(Ticks)

三种实体模式

模式 说明 推荐用于
BOOST 增强模式:将节省的 CPU 分配给实体,实体更流畅 高端设备(推荐)
REDUCE 精简模式:降低远距离实体更新频率,节省 CPU 低端设备,FPS 优先
PRESERVE 保留模式:不做实体优化,保持原版行为 测试/基准对比

更改配置后

必须重启服务器,配置更改才会生效。

性能调优建议

高端设备(实体流畅度优先):

  • entityMode = "BOOST"
  • extraTickInterval = 2
  • maxExtraEntityTicks = 30

低端设备(FPS 优先):

  • entityMode = "REDUCE"
  • farInterval = 15
  • tileUpdateInterval = 30

均衡配置(推荐):

  • entityMode = "BOOST"
  • extraTickInterval = 4
  • maxExtraEntityTicks = 20
  • tileUpdateInterval = 20

🔧 技术细节

优化项 原版机制 优化后
TileEntity 遍历 每 Tick 全量扫描 缓存 + 每 20 Ticks 批处理
实体 AI 更新 所有实体每 Tick 近:10 Tick/更新,远:40 Tick/更新
TPS 保护 无 低于阈值自动节流至 5 Ticks

🚀 性能测试结果(参考)

在 50+ 模组的整合包中测试(Alex's Mobs、Biomes O' Plenty、Spore 等):

指标 优化前 优化后 提升
平均 TPS 17.2 19.8 +15%
实体 Tick 耗时 3.2ms 0.9ms -72%
区块加载耗时 4.1ms 2.3ms -44%

🤝 兼容性

兼容:

  • Forge 47.4.4+(1.20.1)
  • 绝大多数 Forge 模组

不兼容 / 需谨慎:

  • OptiFine:新版 OptiFine 与 Forge 的 Mixin 系统冲突。建议改用 Rubidium + Oculus 替代。
  • ModernFix:部分优化与 OptiFine 冲突。若同时使用,请禁用 release_protochunks 及相关 Mixin。

📝 命令

无游戏内命令。优化自动运行。可通过游戏日志查看启动状态:

[QiusOptimization] Optimization engine activated! (Tile batch processing + AI throttling) [QiusOptimization] Current config: Tile interval=20t, AI interval=40t, TPS threshold=18.0

🛠️ 开发与构建

# 克隆仓库
git clone https://github.com/qym1421/qiusoptimization.git

# 构建
./gradlew build

# 输出位于 build/libs/

📄 许可证

本项目采用 MIT 许可证 — 可自由使用、修改和分发。

🙏 致谢

📬 反馈与建议

⚠️ 免责声明

本模组通过缓存和节流来优化性能,不会影响核心玩法机制。部分实体行为(如 AI 响应速度)在远距离时可能略有延迟——这是正常的优化效果。

由 QiuYM 用 ❤️ 制作