截图
介绍
Adaptive Performance Tweaks (APTweaks)

⚠️ 12.x 是当前统一发布版本线。
较旧的文档或安装指南可能仍在描述旧版 11.x 多模块布局。
💾 更新前请备份你的世界和配置文件。
12.x 仍处于早期发布阶段,部分配置细节可能会在不同版本之间发生变化。
📝 稳定版发布前的已知限制
目前还没有游戏内配置 GUI。12.x 当前采用配置优先的工作流程,较大的
服务器通常需要在默认值之外进行一些刷怪调优。
🔄 从 11.x 升级?
安装 12.x 前请移除所有旧的 APTweaks 模块 jar。不要将 11.x 和 12.x 文件混放在
同一个
mods/文件夹中。
Adaptive Performance Tweaks 是一个适用于 **Forge、Fabric 和
NeoForge** 的服务端优化模组。
它会监视 Minecraft 的服务端负载,并自动调整选定的系统,以减轻专用服务器、单人世界和局域网开放世界中的卡顿压力。
这意味着 APTweaks 不仅适用于公共服务器或专用服务器。
它也能帮助普通客户端世界提升性能,因为单人游戏和局域网会话仍会运行相同的
服务端系统,用于生物生成、tick、游戏规则、物品、经验球和模拟距离。
12.x 不再要求你自行组装不同模块,而是将主要功能组整合进一个
模组中:
- 生成控制与生成预设
- 游戏规则调整
- 物品、经验球和箭矢清理
- 玩家登录与新手保护
- 根据移动情况进行限流的自适应模拟距离
- 可选的高级限流功能:AI、区块生成和视距
- 监控与基准测试工具
🎥 介绍与概览视频
APTweaks 的优势 ✨
当性能问题由以下原因造成时,APTweaks 尤其有帮助:
- 生物数量过多或反复尝试生成
- 掉落物、经验球或卡住的箭矢数量过多
- 探索活动频繁,导致区块生成负担过重
- 世界或服务器需要更温和的自动响应,而非永久性的硬性限制
APTweaks 尤其适用于:
- 需要根据玩家负载变化进行自适应保护的专用服务器
- 实体负载较重的整合包
- 有农场、需要探索或掉落战利品过多的单人世界
- 主机因承受集成服务器负载而运行吃力的局域网世界
如果问题主要来自以下原因,APTweaks 的帮助可能较小:
- 复杂的红石电路或机器逻辑
- 某个特定的故障模组或实体
- 世界损坏或存储瓶颈
快速开始 🚀
- 从
mods/中移除所有旧版 11.x APTweaks 模组文件。 - 通过 CurseForge 或 Modrinth 启动器安装 APTweaks 12.x。手动安装:从其中一个页面下载适用于你的加载器的模组文件,并将其放入
mods/。 - 启动一次游戏、世界或服务器。
- 查看在
config/adaptive_performance_tweaks/中生成的文件。 - 首次测试时先保留默认设置,再进行任何调整。
- 如果你运行的是较大型服务器,请尽早检查生物生成上限。备用生成默认值针对约 4 名玩家进行了调整。
生成预设从以下位置加载:
config/adaptive_performance_tweaks/spawn_presets/data/<namespace>/aptweaks/spawn_presets/
如果要自定义预设,请先查看
wiki/SpawnPresets 中的模板和示例。
功能概览 🧩
| 功能 | 作用 |
|———————|————————————————————————————————————–|
| 生物生成 | 通过感知负载的检查、视野范围逻辑和可配置预设,限制生物带来的负载 |
| 游戏规则 | 服务器负载过高时调整选定的游戏规则 |
| 物品 | 合并或移除过量的掉落物品 |
| 经验球 | 聚集经验球以减少实体数量 |
| 箭 | 清理卡住的箭,但不会影响正在飞行的投射物 |
| 玩家保护 | 在玩家登录期间提供保护,并为新玩家或列出的玩家提供帮助 |
| 模拟距离 | 在高负载时自动降低模拟开销,并可在大规模探索期间临时采取更强的限流措施 |
| 视距 | 为高负载服务器提供可选的高级安全阀 |
| AI 限流 | 可选的高级功能,用于降低远处生物 AI 的运行速度 |
| 区块生成限流 | 可选的高级功能,用于降低区块生成的工作负载 |
| 监控 | 可选的基于日志的负载和实体压力监控 |
| 基准测试 | 内置的场景式基准测试套件,可在真实世界、服务器和整合包中进行基线与启用状态测量 |
模拟距离仍会像之前一样根据负载进行调整,但现在在玩家大量探索期间,当负载达到
MEDIUM+ 时还可以进一步降低,并在玩家停止移动或完成登录后逐步恢复。
命令 🔧
主命令根为 /aptweaks。
常用命令包括:
/aptweaks status/aptweaks load/aptweaks stats/aptweaks stats items/aptweaks stats xp_orbs/aptweaks stats arrows/aptweaks stats reset/aptweaks entities overview/aptweaks feature <id> <true|false>/aptweaks playerPositions/aptweaks kill all_dropped_items/aptweaks reload/aptweaks debug/aptweaks benchmark/aptweaks benchmark start/aptweaks benchmark start scenario <general|items|xp|entities|recovery>
如果发现情况异常,请先运行以下四条命令:
/aptweaks status/aptweaks load/aptweaks stats/aptweaks debug <module> true
重新加载说明:
/aptweaks reload会重新加载.cfg文件- 更改生成预设 JSON 后,使用原版
/reload或重启会更稳妥 - 启用或关闭功能后,可能仍需重启才能完全生效
了解更多 📚
Wiki 是 12.x 版本的主要文档:
常见问题
Adaptive Performance Tweaks 支持哪些 Minecraft 版本?
Adaptive Performance Tweaks 支持 Minecraft Java 版 1.16–26.3,共 26 个版本,可用的加载器:Fabric / Forge / NeoForge / Quilt。下载时注意选择和你游戏版本一致的文件。
Adaptive Performance Tweaks 怎么安装?
先用 PCL2 或 HMCL 启动器安装对应版本的 Fabric / Forge / NeoForge / Quilt,再把下载的 .jar 文件放进游戏目录的 mods 文件夹,重新启动游戏即可。开启了版本隔离的,mods 文件夹在 versions/版本名 下面。运行环境:仅服务端。
Kaworru 的其他作品
查看全部 →APTweaks: Core (11.x Classic)
核心是所有自适应性能优化模块的必需前置,提供共享API、监控功能、事件和命令。
APTweaks: Items (11.x Classic)
物品堆叠(掉落方块、经验球等)与垃圾清理。
Easy NPC
在你的世界或模组中轻松创建带有对话功能的 NPC。
Easy Mob Farm
这款简易生物农场模组对服务器很友好,可以捕捉各种动物和生物来收集战利品。模组还提供了多种捕捉道具和生物农场,让过程更有趣。
评论
登录后评论和评分