跳到正文

AnimationBudget

作者:JeremyXu

为 Distant Horizons 提供自适应的客户端性能调整,并可选择限制方块实体动画。

收藏

介绍

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

AnimationBudget

AnimationBudget 是一款适用于 Minecraft 1.21.1 的客户端性能模组,会在帧率下降时降低 Distant Horizons 的负载,并在性能恢复后逐步恢复画质。

功能

  • 根据 10 秒帧时间窗口、平均 FPS 和尾帧性能,自适应调整 Distant Horizons 的渲染距离与画质。
  • FPS 持续偏低时快速分阶段降低设置;性能稳定一段时间后缓慢恢复;调整之间设有重建冷却时间。
  • 通过 Distant Horizons API 覆盖设置,不会改写用户的 DistantHorizons.toml 文件。
  • 忽略菜单、暂停或加载画面、非活动窗口、非玩家视角,以及异常长帧。
  • 可选的客户端方块实体动画节流功能,使用精确的注册表 ID 允许列表。
  • 观察模式会报告符合条件的方块实体动画,但不会跳过这些动画。

方块实体动画策略

此功能默认关闭,且默认允许列表为空。除非你主动启用该功能并配置完整注册表 ID,否则不会跳过任何方块实体动画。

启用并添加到允许列表后:

  • 32 格以内:动画以完整速度播放。
  • 32 至 64 格:每四个游戏刻更新一次,并错开更新时机。
  • 超过 64 格:暂停动画更新。

服务器端的刻时逻辑始终正常运行。AnimationBudget 不会冻结服务器机器、Create 装置、网络通信、世界存档或任意模组。

运行需求

  • Minecraft 1.21.1
  • NeoForge 21.1.248 或更新版本
  • Java 21
  • Distant Horizons 3.3.3 或更新版本为可选依赖,但自适应远景地形控制需要安装它

配置

客户端配置文件位于 config/animationbudget-client.toml。

  • distantHorizons.adaptiveEnabled:启用 Distant Horizons 自适应控制。
  • distantHorizons.targetFps:目标帧率,默认为 60。
  • blockEntityAnimation.enabled:启用动画节流,默认为 false。
  • blockEntityAnimation.observationMode:启用候选项统计,默认为 true。
  • blockEntityAnimation.targets:方块实体注册表 ID 精确允许列表,默认为空。

允许列表示例:minecraft:chest。

许可证

LGPL-3.0。

常见问题

AnimationBudget 支持哪些 Minecraft 版本?

AnimationBudget 支持 Minecraft Java 版 1.21.1,可用的加载器:NeoForge。下载时注意选择和你游戏版本一致的文件。

AnimationBudget 怎么安装?

先用 PCL2 或 HMCL 启动器安装对应版本的 NeoForge,再把下载的 .jar 文件放进游戏目录的 mods 文件夹,重新启动游戏即可。开启了版本隔离的,mods 文件夹在 versions/版本名 下面。

评论

登录后评论和评分