SwemCull — SWEM Horse Performance Fix

大规模 SWEM 马群，流畅 FPS。
SwemCull 能大幅降低 SWEM 马匹对游戏性能的影响。
马匹看起来完全一样，游戏却不再卡顿。

Minecraft 1.21.1（NeoForge）和 1.20.1（Forge & NeoForge）· 仅在你的客户端运行，适用于任何服务器 · 需要安装 SWEM 或 SWEM Lite

功能介绍

• 🐴 大群马匹也流畅 — 站在32匹全套装备的马群中，FPS几乎能提升到原来的三倍。
• 🌄 远处的马几乎不占性能 — 远处的马保留所有装备并继续活动，但几乎不会影响游戏性能。（1.21.1）
• 🧱 看不见的马不会造成卡顿 — 马匹在马厩里、墙后或你身后时不会被渲染，因此不会拖慢游戏。栅栏、门和玻璃不会遮挡马匹。
• 💩 马粪不会造成卡顿 — SWEM 会一直渲染每一堆马粪，而且它们不会自行消失。SwemCull 只渲染你看得见的马粪，速度也快得多。
• 🎽 装备不再闪烁 — 马鞍、毯子和护腿在远处不再闪烁。
• 🔍 缩放照常生效 — 使用望远镜或缩放模组观察时，马匹仍会保持细节。
• 💛 你的马始终安全 — 你骑乘、牵引或正在观察的马始终保持完整细节。
• 🎯 设置一次，轻松畅玩 — 默认启用平衡预设。想要更高 FPS？用一条命令切换其他预设。
• 🛡️ 兼容 SWEM 更新 — 如果 SWEM 更新导致某项功能发生变化，SwemCull 只会关闭受影响的部分，并在聊天栏通知你。你的马匹仍可正常使用。

性能提升幅度

Minecraft 1.21.1，1080p，平衡预设，使用 /swemcull advanced benchmark 测得。
即使马匹在远处或墙后，你仍能看到它们及其所有装备——只是不会再消耗你的 FPS。1.20.1 在远处的性能提升较小。

预设

使用 /swemcull preset <name> 选择预设。数字的单位为格。

在 1.21.1 中，远处站立或行走的马匹仍会保留所有马具。

命令

• /swemcull — 查看当前启用的功能以及马匹状态。
• /swemcull preset — 选择预设。
• /swemcull adaptive 60 — 自动将帧率维持在 60 FPS。输入 /swemcull adaptive off 可停止。
• /swemcull overlay — 显示一个小窗口，查看帧率以及马匹的显示情况。
• /swemcull toggle — 立即启用或停用 SwemCull，方便你对比效果。
• /swemcull advanced — 查看其他设置，可逐项调整功能。

在 NeoForge 1.21.1 中，也可以在模组菜单中找到所有设置。配置文件位于 config/swemcull-client.toml。

兼容模组

• 🐴 SWEM、SWEM Lite、SWEM Addendum 和 Addendum Plus — 也兼容所有 Addendum 品种。
• 🌈 Iris 和 Oculus 光影 — 马匹仍会保留阴影。
• ⚡ Sodium、Embeddium、ImmediatelyFast、ModernFix、FerriteCore — 可与 SwemCull 配合使用。
• 🧊 EntityCulling — 可与本模组同时使用。它本身不会隐藏 SWEM 马匹；SwemCull 会。
• 🔍 Zoomify、Ok Zoomer 和其他缩放模组 — 放大查看时，马匹仍会保持细节。
• 🗺️ Xaero’s Minimap 和 World Map — 马粪不再布满地图。输入 /swemcull advanced minimappoop on 可重新显示。
• 🌍 任何服务器 — 仅在你的客户端生效。服务器无需安装，可安全添加到现有世界。

还需要： SWEM 或 SWEM Lite、GeckoLib，以及 Player Animation Library（SWEM 需要它，但没有注明）。在 NeoForge 1.20.1 上，请使用 Player Animation Library 的 Forge 版本——目前没有 NeoForge 版本，但 Forge 版本可以正常使用。

常见问题

为什么 SWEM 会这么卡？
SWEM 的马匹模型非常精细，而且每件马具都有自己的纹理。一群装备齐全的马匹会给游戏带来比大多数完整建筑还重的负担。SWEM 还会渲染处于你身后或墙后的马匹。

怎样提高 SWEM 的帧率？
安装 SwemCull 就可以了。默认预设能让马匹装备齐全的马群中帧率接近提升至原来的三倍，而远处的马匹几乎不占用性能。还想进一步提升？试试 /swemcull preset aggressive。

我的马匹外观会变吗？
近距离不会。在 1.21.1 中，远处的马仍会保留所有马具。骑乘中的马、幼马、长有翅膀的马，以及 1.20.1 中的所有马，在远处会逐渐隐藏细小的马具，接着是鬃毛和尾巴——毕竟远到肉眼都看不清了。它们会渐隐，而不是突然消失。用望远镜放大后，一切都会恢复。

服务器也需要安装吗？
不需要。SwemCull 只需安装在你的客户端上，并且适用于任何服务器。

我走动时，马匹会突然出现或消失。
使用 /swemcull advanced cull 92，让它们在画面中保留更久；也可以使用 /swemcull preset light。

我绕过拐角时，马匹会很晚才出现。
使用 /swemcull advanced occlusion off，关闭墙体遮挡隐藏功能。其他功能仍会正常运行。

我身后的马匹仍会影响 FPS。
它们并没有被绘制。剩下的开销来自游戏中马匹的移动（单人游戏中，游戏自己的服务器也会运行它们的 AI）。SwemCull 只会改变绘制方式，这是有意为之。使用 /swemcull toggle 可以确认：如果 FPS 没有变化，问题就不在绘制上。

我的 Addendum 马匹全是纯黑色。
这是因为缺少材质包。Addendum 的马种不自带毛色纹理——你需要从 Addendum 页面链接的社区资源包中获取。使用 /swemcull toggle 可以确认：如果关闭 SwemCull 后它们仍是黑色，问题就不在 SwemCull。

聊天栏提示 SwemCull 为我的 SWEM 关闭了某项功能。
你的 SWEM 版本发生了变化，导致某项功能不再兼容，因此该功能已关闭，你的马匹会按 SWEM 原本的方式显示。输入 /swemcull 可查看具体是哪项功能以及原因。通常更新 SwemCull 后，该功能就会恢复。

可以在我的整合包中使用吗？
可以！SwemCull 使用 LGPL-3.0 许可证，欢迎将其加入整合包。

由 ItzAdoman 制作 · adoman.eu · LGPL-3.0
与 SWEM 或 GeckoLib 无关联，且不包含它们的任何代码。