跳到正文

Adaptive Performance Tweaks

作者:Kaworru

Adaptive Performance Tweaks 模组会自动调整服务器上的特定设置,以提升 TPS/FPS 表现。

收藏

截图

介绍

介绍由机器翻译自 Modrinth 原页面,仅供参考。

Adaptive Performance Tweaks (APTweaks)

APTweaks: Bundle Versions

Download on CurseForge
CurseForge Downloads

Download on Modrinth
Modrinth Downloads

Report an Issue
Open Issues
Closed Issues

Adaptive Performance Tweaks

⚠️ 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 的帮助可能较小:

  • 复杂的红石电路或机器逻辑
  • 某个特定的故障模组或实体
  • 世界损坏或存储瓶颈

快速开始 🚀

  1. 从 mods/ 中移除所有旧版 11.x APTweaks 模组文件。
  2. 通过 CurseForge 或 Modrinth 启动器安装 APTweaks 12.x。手动安装:从其中一个页面下载适用于你的加载器的模组文件,并将其放入 mods/。
  3. 启动一次游戏、世界或服务器。
  4. 查看在 config/adaptive_performance_tweaks/ 中生成的文件。
  5. 首次测试时先保留默认设置,再进行任何调整。
  6. 如果你运行的是较大型服务器,请尽早检查生物生成上限。备用生成默认值针对约 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 的其他作品

查看全部 →