适应性性能调整 · 我的世界Mod

.detail-panel[hidden] { display: block !important; } .detail-tabs { display: none; } /* These three panels are rendered by the browser. */ [data-versions], [data-changelog-panel], [data-comments] { display: none; }

自适应性能调整 (APTweaks)

自适应性能调整

⚠️ 12.x 是当前统一的发布版本线。 较旧的文档或设置指南可能仍描述旧的 11.x 多模块布局。

💾 更新前请备份你的世界和配置文件。 12.x 仍处于早期发布阶段，某些配置细节可能在版本之间发生变化。

📝 稳定版发布前的已知限制 尚末提供游戏内配置 GUI。12.x 目前采用配置优先的工作流程，较大型服务器通常需要调整出生点参数，超出默认值。

🔄 从 11.x 升级？ 安装 12.x 前，请移除所有旧的 APTweaks 模块 jar。不要将 11.x 和 12.x 文件混放在同一个 mods/ 文件夹中。

自适应性能调整是一款适用于 Forge、Fabric 和 NeoForge 的服务端优化模组。它会监控 Minecraft 服务端的负载，并自动调整选中的系统，以减轻专用服务器、单人世界和局域网开放世界中的卡顿压力。

这意味着 APTweaks 不仅适用于公共或专用服务器。它也能在普通客户端世界中提供帮助，因为单人游戏和局域网会话同样运行着相同的服务端系统来处理生成、游戏刻、游戏规则、物品、经验球和模拟距离。

与要求你自行组装独立模块不同，12.x 将主要功能组整合到一个模组中：

生成控制与生成预设
游戏规则自适应
物品、经验球和箭矢清理
玩家登录与新手保护
自适应模拟距离与移动感知节流
可选的 AI、区块生成和视距高级节流
监控和基准测试工具

🎥 介绍与概述视频

[视频嵌入]

APTweaks 擅长什么 ✨

当性能问题由以下原因引起时，APTweaks 最有效：

生物过多或反复尝试生成
大量掉落物品、经验球或卡住的箭矢
过度探索与区块生成
需要更柔和的自动反应而非永久硬性限制的世界或服务器

APTweaks 特别适用于：

需要在玩家负载变化下提供自适应保护的专用服务器
具有大量实体压力的模组包
建有农场、探索过度或掉落物过多的单人世界
主机硬件难以应对集成服务器负载的局域网世界

它在解决主要源于以下原因的问题时帮助较小：

繁重的红石或机器逻辑
某个特定的损坏模组或实体
世界损坏或存储瓶颈

快速开始 🚀

从 mods/ 中移除所有旧的 11.x APTweaks jar。
通过 CurseForge 或 Modrinth 启动器安装 APTweaks 12.x。手动安装：从上述页面之一下载适用于你加载器的 jar，并将其放入 mods/。
启动游戏、世界或服务器一次。
检查 config/adaptive_performance_tweaks/ 中生成的文件。
在调整任何内容之前，先使用默认设置进行首次测试运行。
如果你运行的是较大型服务器，请尽早检查生成限制。后备的生成默认值针对约 4 名玩家进行了调整。

生成预设从以下位置加载：

config/adaptive_performance_tweaks/spawn_presets/
data/<命名空间>/aptweaks/spawn_presets/

如果你想自定义预设，请从 wiki/SpawnPresets 中的模板和示例开始。

功能概览 🧩

功能	作用
生成	通过负载感知检查、视野区域逻辑和可配置预设来限制生物压力
游戏规则	当服务器负载过高时，调整选定的游戏规则
物品	合并或移除多余的掉落物品
经验球	将经验球聚集以降低实体数量
箭矢	清理卡住的箭矢，不影响活跃的抛射物
玩家保护	在登录期间保护玩家，并帮助新玩家或列表中的玩家
模拟距离	在负载下自动降低模拟距离开销，可在重度探索期间临时进行更强力的节流
视距	可选的高级安全阀，用于重负载服务器
AI 节流	可选的高级节流，用于减缓远处生物 AI 速度
区块生成节流	可选的高级节流，用于减小区块生成工作量
监控	可选的基于日志的负载与实体压力可见性
基准测试	内置的基于情景的基线/活动测量套件，适用于真实世界、服务器和模组包

模拟距离现在仍像以前一样保持负载感知，但在 中等+ 负载下的重度探索期间可以更强力地收紧，然后在玩家停止移动或完成登录后逐步恢复。

命令 🔧

主命令根是 /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 <模块> true

重载说明：

/aptweaks reload 重载 .cfg 文件
更改生成预设 JSON 时，使用原版 /reload 或重启服务器更安全
功能的开/关更改可能仍需重启才能完全生效

了解更多 📚

Wiki 是主要的 12.x 文档：