1.21.1 Fabric Mou 整合包完整使用指南#

当前版：Mou v1.0.0（推荐）#

下载 Mou 1.0.0（69-Mod mrpack）

• 发布页：mou-modpack-v1.0.0
• Minecraft：1.21.1
• Fabric Loader：0.19.3
• Java：21
• 包格式：Modrinth mrpack（modrinth.index.json + overrides/）
• 文件大小：62,303,517 字节，约 59.42 MiB
• SHA-256：9aebbb285b46e2c19e80538a2dd648762fac7109fab38893eb3a243fa87b2b8f
• 内容构成：索引下载模组 67 个（安装时从 CDN 拉取，约 318 MB）+ 捆绑模组 2 个（Quick Shulker、Litematica Printer）+ 预置配置
• 顶层 Mod 合计 69，与本文正文一致

导入方式

1. 推荐：用 PCL / HMCL / Prism / Modrinth App 等支持 mrpack 的启动器直接导入压缩包。
2. 备选：把 Mou.1.0.0.zip 扩展名改成 .mrpack，再导入支持 Modrinth 整合包的启动器。
3. 首次启动前确认启动器使用 Java 21。
4. 安装阶段会联网下载索引里的 67 个模组，请保持网络畅通；捆绑的 2 个 jar 已在包内，无需再下。

NOTE

v1.0.0 就是本文 2026-09-22 的 69-Mod 快照公开版，教程正文可以直接照着用。

旧版：Mou 0.1.0（已过时）#

下载旧版 Mou 0.1.0（50-JAR GitHub Release）

• Minecraft：1.21.1
• Fabric Loader：0.19.3
• 文件大小：81,477,184 字节，约 77.70 MiB
• SHA-256：FB40234D00399464458EE7683A1B184517D714A33F2662226F89E0B068BDC8CD

WARNING

0.1.0 是 2026 年 8 月 12 日发布的旧版 50-JAR 包，不要再当主包用。新玩家直接下 v1.0.0。

只有在回滚旧存档或排查历史问题时才用 0.1.0；对照本文教程时请注意上述差异，Quick Shulker、Printer、Flashback、Carpet 扩展、ETF/EMF 等章节对 0.1.0 不适用。

IMPORTANT

投影、自由相机、灵活放置、连锁操作、Litematica Printer 和 Carpet 规则可能受到服务器规则限制。进入多人服务器前，请先确认允许使用的功能范围。

本次文件盘点结论#

• mods/ 中共有 69 个 .jar，每个都能读取到独立的 fabric.mod.json；另有 1 个加载器 JSON 文件不是模组。
• 没有发现重复的顶层 Mod ID。
• 潜影盒相关已从旧文的 Better Shulkers 换成 Quick Shulker；config/bettershulkers.toml 是历史残留，当前不生效。
• Carpet 生态从单一 GCA 扩展到 GCA + Carpet TIS Addition + REMS Carpet Addition + Carpet Org Addition 四件套。
• 新增录像模组 Flashback（约 200 MB），以及实体资源包兼容层 ETF + EMF。
• 当前实例可以进入游戏和世界，但 Trade Cycling 1.0.20 与 Visible Traders 1.3.2 的联动初始化失败，文章后面会给出影响范围和处理方式。

环境要求#

• 使用 64 位 Java 21。
• 使用 Minecraft 1.21.1 对应的 Fabric Loader。
• 不要混入 Forge、NeoForge 或其他 Minecraft 版本的模组。
• 首次启动建议分配 4–6 GB 内存，使用大型资源包或光影时再按需增加。

首次启动流程#

1. 启动游戏后打开 Mod Menu，确认模组列表正常。
2. 创建测试世界，不要立刻进入唯一的重要存档。
3. 检查 Sodium 视频设置、JourneyMap、JEI、Jade 和 Masa 系模组菜单。
4. 使用 Controlling 检查按键冲突。
5. 确认没有启动、渲染和按键异常后，再导入存档、原理图与地图数据。

重要目录#

最常用快捷键#

全部已知快捷键#

已知冲突#

• M：Litematica 前缀键，同时 JourneyMap 用于切换小地图；Litematica 组合键需要连续/组合输入，通常仍可使用。
• O：JEI 物品列表开关与 Iris 光影包选择冲突，建议修改 Iris 为 Ctrl + O。
• R：JEI 查看配方与 Iris 重载光影冲突，建议修改 Iris 为 Ctrl + R。
• K：Iris 光影开关与 Modern UI 配置中心冲突，建议把 Modern UI 改为 Shift + K，保留 Iris 的快速开关。
• ****：JourneyMap 小地图预设与 Tweakeroo 工具切换存在冲突。
• C：Trade Cycling 与部分模组默认配置入口可能冲突。
• F6：Zoomify 备用缩放键与 Super Resolution 配置键冲突，建议给 Super Resolution 换键。
• `（反引号）：FTB Ultimine 与 Litematica Printer 开关组合键共用反引号，注意 Caps Lock 状态。
• 左 Alt：Litematica、MiniHUD、Tweakeroo 多处作为修饰键，操作前确认当前工具模式。

建议的未绑定功能#

• EntityCulling 开关：建议绑定仅用于排错的组合键。
• LambDynamicLights 开关：建议绑定，刷怪测试前快速关闭。
• Neat 血条开关：建议绑定，截图和大型实体农场时关闭。
• Dynamic FPS 强制/禁用：一般保持未绑定即可。
• Flashback 标记 1–4：录像剪辑需要章节点时再绑定。
• Super Resolution 配置：与 Zoomify 冲突，建议改绑。

Carpet Mod（地毯）#

生电整合包的规则控制、假人测试和调试核心。

• 模组 ID：carpet
• 当前版本：1.4.147+v240613
• 运行环境：客户端与服务端/通用

快捷键

该模组没有需要玩家操作的快捷键，或当前没有绑定快捷键。

快速入门 进入有权限的单人世界后，在聊天框输入 /carpet 查看规则。使用 /carpet <规则名> 查看说明，使用 /carpet <规则名> <值> 临时修改规则；追加 setDefault 可把规则写入当前世界配置。

假人教程

• 生成假人：/player Bot spawn
• 让假人站到指定位置：先站好位置和朝向，再生成同名假人。
• 攻击：/player Bot attack continuous
• 持续使用物品：/player Bot use continuous
• 停止动作：/player Bot stop
• 下线：/player Bot kill
• 移动、跳跃、潜行、转向可通过 /player Bot move ...、jump、sneak、look 子命令组合。

生电常用方法

1. 用假人测试刷怪塔挂机位、村民繁殖、农场收集和区块加载边界。
2. 修改规则前先用 /carpet <规则名> 阅读说明，避免把测试规则永久写入主世界。
3. 世界级规则保存在存档目录的 carpet.conf；整合包默认规则位于 config/carpet/default_carpet.conf。
4. 使用 /log 订阅 TPS、mobcaps 等记录器时，可在聊天栏持续观察服务器状态。

推荐与注意事项

• 主世界只永久保存明确需要的规则，临时测试结束后恢复默认。
• 假人名称不要与真实玩家重名。
• 结构方块范围功能与 Tweakeroo 有冲突时，以 Carpet 规则结果为准。

依赖关系

• 无额外模组依赖，或依赖已打包在模组内部。

配置与数据位置

• config/carpet/default_carpet.conf

官方资料

• 项目主页或官方文档

Gugle Carpet Addition（GCA）#

围绕 Carpet 扩展的生电规则、假人交互和实用功能集合。

• 模组 ID：gca_wrapper
• 当前版本：2.12.6+build.94
• 运行环境：客户端与服务端/通用

快捷键

该模组没有需要玩家操作的快捷键，或当前没有绑定快捷键。

使用方式 GCA 通过 Carpet 规则系统工作。输入 /carpet 后搜索带有 GCA 分类或前缀的规则；输入 /carpet <规则名> 查看该版本内置说明。

推荐流程

1. 新建测试世界，先确认规则作用和默认值。
2. 用 /carpet <规则名> <值> 临时启用。
3. 验证机器不会被规则改变后，再决定是否写入世界默认配置。
4. 配合 Carpet 假人完成挂机、自动操作、容器交互和农场压力测试。

为什么不列死全部规则 GCA 的规则会随构建版本调整，教程以游戏内 /carpet 自动补全和说明为准，避免博客中的旧规则名称误导玩家。

推荐与注意事项

• 它不是独立替代品，必须与 Carpet 一起使用。
• 升级 GCA 后先在测试世界检查旧规则。
• 服务器使用时应由服主统一管理规则。

依赖关系

• 无额外模组依赖，或依赖已打包在模组内部。

配置与数据位置

• 世界目录/carpet.conf
• config/carpet/default_carpet.conf

官方资料

• 项目主页或官方文档

Carpet TIS Addition（Carpet-TIS）#

TIS 社区维护的 Carpet 扩展，补上大量实用工具和趣味规则，是生电服务器最常见的附加包之一。

• 模组 ID：carpet-tis-addition
• 当前版本：1.82.4
• 运行环境：客户端与服务端/通用；依赖 Carpet ≥ 1.4.147

快速入门

安装后 /carpet 规则列表会多出 TIS 前缀的条目。先用 /carpet <规则名> 读说明，再决定是否开启。常用方向包括掉落物计数、区块加载调试、刷怪塔测试辅助和一些仅方便调试的“非原版”工具。

推荐与注意事项

• 规则默认大多关闭，不会偷偷改玩法；但开启后会影响世界机制，主世界慎用。
• 与 GCA、REMS、Org 同时安装时规则列表会很长，建议配合搜索或文档定位。
• 服务器联机需服务端同步安装，否则客户端规则无效。

依赖关系

• carpet：>=1.4.147
• mixinextras：>=0.3.0（通常由 Carpet/加载器链带入）

配置与数据位置

• config/carpettisaddition/

官方资料

• 项目主页或官方文档

REMS Carpet Addition（Carpet-REMS）#

作者按自己需求整理的 Carpet 扩展，补一些“别人有但我还想要”的生电向功能。

• 模组 ID：remscarpetaddition
• 当前版本：1.3.30
• 运行环境：客户端与服务端/通用；依赖 Carpet ≥ 1.4.147

快速入门

同样挂在 /carpet 规则表下。功能面比 TIS 窄，但有些小工具很顺手。先扫一遍规则名，按需开启。

推荐与注意事项

• 规则数量少于 TIS，和 TIS/GCA 可共存，但注意同类规则别重复开启。
• 改机制类规则前先在测试世界验证。

依赖关系

• carpet：>=1.4.147

配置与数据位置

• config/ 下 REMS 相关目录（随 Carpet 规则系统管理）

官方资料

• 项目主页或官方文档

Carpet Org Addition（Carpet-ORG）#

一个“非常 Not Vanilla”的 Carpet 扩展：实用和无用的功能都有，默认全部关闭，必须手动开。

• 模组 ID：carpet-org-addition
• 当前版本：1.41.6
• 运行环境：客户端与服务端/通用；依赖 Carpet + Fabric API

快速入门

安装后规则表会多出 Org 相关条目。默认不改变任何游戏机制，所有功能都要手动开启。适合单人实验、做演示或折腾数据；进服前先问规则。

推荐与注意事项

• 名字里带 Org 就是“不原版”的意思，别在纯净服乱开。
• 规则默认关闭是优点，但开启后可能改变掉落、红石或实体行为。
• 多人环境以服务端配置为准。

依赖关系

• fabric-api
• carpet

配置与数据位置

• config/carpetorgaddition/

官方资料

• 项目主页或官方文档

Litematica Printer（打印机）#

配合 Litematica 原理图自动放置/破坏方块，把“照着投影盖”变成半自动施工。

• 模组 ID：litematica-printer-wrapper（包装多版本包，内部实现为 litematica-printer）
• 当前版本：1.3-beta.4
• 运行环境：客户端；依赖 Litematica

快捷键

怎么用

1. 先用 Litematica 放好原理图并进入 Easy Place / 放置管理状态。
2. 按 Z + Y 打开打印机面板，确认材料、范围和限速。
3. 按 Caps Lock + \ 开关自动打印（注意与 FTB Ultimine 的反引号键区分 Caps Lock 状态）。
4. 当前配置 workingSwitch.enabled=false，默认不自动开工；面板里 renderHud 与 missingMaterialHud 开着，方便看缺料。
5. printerAutoDisable=true：缺料或完成后会自动停，减少翻车。

推荐与注意事项

• 这模组在多数服务器属于违规自动化，联机前先确认规则。
• 当前 placeInterval=1、breakCooldown=3，速度偏保守；调快前先看 TPS。
• printerLagCheck=true，卡顿会自动刹车，别关。
• 材料不够时打印机不会硬来，先补料再继续。

依赖关系

• litematica
• malilib

配置与数据位置

• config/litematica-printer.json

官方资料

• 项目主页或官方文档

TweakerMore（TK 扩展）#

Fallen_Breath 维护的客户端微调合集，和 Tweakeroo / MaLiLib 同族，补一堆 Tweakeroo 没有的小开关。

• 模组 ID：tweakermore
• 当前版本：3.33.0
• 运行环境：仅客户端；依赖 MaLiLib

快速入门

在模组菜单或 MaLiLib 配置入口打开 TweakerMore。功能按模块分组：方块放置辅助、实体渲染微调、快捷键扩展、HUD 小工具等。默认改动很小，按需勾选。

推荐与注意事项

• 和 Tweakeroo 功能有重叠，两边都开同类开关时以实测为准。
• 依赖 MaLiLib，删 MaLiLib 会连带它一起挂。
• 调试期一次只开一两个开关，方便回滚。

依赖关系

• malilib：>=0.21.5
• conditional-mixin / mixinextras（通常随依赖链带入）

配置与数据位置

• config/malilib.json（共用）与 TweakerMore 自身配置项

官方资料

• 项目主页或官方文档

Litematica（投影）#

建筑和生电机器的区域选择、原理图保存、放置、材料统计与逐层施工工具。

• 模组 ID：litematica
• 当前版本：0.19.61
• 运行环境：仅客户端

快捷键

制作原理图

1. 按 M 打开主菜单，在区域选择中创建选区。
2. 手持木棍作为选择工具：左键设置角点 1，右键设置角点 2，中键选择已有元素。
3. 检查选区尺寸和包含范围。
4. 使用 Ctrl + Alt + S 保存为原理图文件。

加载与放置

1. M → 加载原理图 选择文件。
2. 创建放置后按 M + P 打开放置管理。
3. 调整坐标、旋转、镜像和子区域开关。
4. 按 M + G 控制投影显示，按 M + R 控制全部渲染。

生存施工

• M + L 打开材料列表，查看总需求、缺少数量和已完成数量。
• 使用逐层模式配合 Page Up/Page Down，适合从下到上施工。
• 简单放置需要服务器或 Carpet 支持准确放置协议；不支持时仍可把投影视作普通施工参考。
• M + V 打开验证器，检查错误方块、缺失方块和多余方块。

文件位置 原理图通常保存在实例的 schematics 目录。发布整合包时不要未经授权分发他人的建筑原理图。

推荐与注意事项

• 大型投影先关闭不需要的子区域，显著降低渲染压力。
• 先确认原点与旋转方向，再开始收集材料。
• Easy Place 不是服务器权限绕过工具。

依赖关系

• malilib：>=0.21.10-

配置与数据位置

• config/litematica.json
• config/litematica/
• schematics/

官方资料

• 项目主页或官方文档

MiniHUD（迷你 HUD）#

显示坐标、区块、刷怪范围、结构边界、光照和各种生电调试覆盖层。

• 模组 ID：minihud
• 当前版本：0.32.60
• 运行环境：仅客户端

快捷键

基础使用 按 H + C 打开配置。先在信息行中启用需要的文本，再在渲染器中启用结构、区块和范围覆盖层。H 是总开关，出现画面过于杂乱时可立即关闭。

生电常用覆盖层

• 区块边界：规划区块加载器、红石跨区块线路和刷怪塔位置。
• 史莱姆区块：寻找史莱姆农场位置。
• 光照信息：检查真实方块光与天空光，不要被动态光源视觉效果误导。
• 刷怪球体/范围：围绕挂机点检查 24、32、128 格等关键距离。
• 结构边界：定位要塞、海底神殿、女巫小屋等依赖结构边界的机器。
• 蜂箱、村民、方块实体等信息行：按需要启用，避免长期显示全部内容。

推荐配置方法 为“日常”“刷怪塔调试”“区块边界”建立不同使用习惯，每次只打开一组覆盖层。大型结构边界和实体信息不要长期全开。

推荐与注意事项

• 动态光源只改变视觉，刷怪判断以 MiniHUD 读取的真实光照为准。
• 覆盖层看不到时检查总开关 H 和对应渲染器开关。
• 多人服务器部分数据可能需要服务端支持。

依赖关系

• malilib：>=0.21.10-

配置与数据位置

• config/minihud.json
• config/minihud/

官方资料

• 项目主页或官方文档

Tweakeroo（TK）#

自由相机、灵活放置、快速方块放置、工具切换和大量客户端操作增强。

• 模组 ID：tweakeroo
• 当前版本：0.21.61
• 运行环境：仅客户端

快捷键

自由相机 按 F4 进入自由相机。玩家实体仍留在原地，适合检查建筑背面、机器内部和整体比例。X + P 可管理相机预设位置。配置里还能决定自由相机时是否允许玩家输入、移动玩家、显示手和状态栏。

灵活方块放置

1. 在 X + C 中启用 Flexible Block Placement。
2. 按住左 Ctrl 调整放置偏移，按住左 Alt 调整旋转方向。
3. 对活塞、观察者、漏斗、楼梯等方向敏感方块尤其有用。
4. 服务端支持准确放置协议时可靠性更高。

放置限制 使用 Z + 数字 选择平面、表面、列、直线、对角线或层限制，适合快速铺墙、道路和大面积平台。

快速放置与工具切换 U 切换快速方块放置；反斜杠切换工具自动选择。使用前先在测试区域确认速度，避免连续误放或误拆。

推荐与注意事项

• Freecam 与独立 Freecam 模组功能高度重复，不需要重复安装。
• Carpet 和 Tweakeroo 同时修改结构方块范围时会发生覆盖冲突。
• 快速点击、持续使用和快速放置不要在服务器禁止自动操作时使用。

依赖关系

• malilib：>=0.21.9-

配置与数据位置

• config/tweakeroo.json
• config/tweakeroo/

官方资料

• 项目主页或官方文档

Trade Cycling（村民交易刷新）#

在村民尚未锁定交易时，用快捷键快速重置工作站并刷新交易。

• 模组 ID：trade_cycling
• 当前版本：1.21.1-1.0.20
• 运行环境：客户端与服务端/通用

快捷键

使用步骤

1. 放置村民对应工作站，让村民获得职业。
2. 打开交易界面并查看第一轮交易。
3. 在尚未与该村民完成任何交易时按 C。
4. 模组会尝试重置工作站并让村民重新获取职业，随后生成新交易。
5. 出现目标交易后完成一次交易，将职业和交易锁定。

建筑党用途 可快速获得修补、精准采集、效率等附魔书，以及石匠提供的石英、砖块和装饰材料交易。

推荐与注意事项

• 只对尚未锁定交易的村民有效。
• 确保工作站可被正常破坏、重新放置且村民能寻路绑定。
• 多人服务器必须允许对应行为。
• 当前 latest.log 显示它与 Visible Traders 的兼容层发生 NoSuchMethodException。基础刷新功能和“显示后续交易”应分别测试，不要默认两者联动正常。

依赖关系

• 无额外模组依赖，或依赖已打包在模组内部。

配置与数据位置

• config/trade_cycling/

官方资料

• 项目主页或官方文档

Visible Traders（可见村民交易）#

提前显示村民尚未解锁的后续交易，减少为了确认高等级交易而反复培养村民的试错成本。

• 模组 ID：visibletraders
• 当前版本：1.3.2
• 运行环境：客户端与服务端/通用

快捷键

没有独立快捷键，功能直接集成在村民交易界面中。

从零开始

1. 给未就业村民放置工作站，让它获得职业。
2. 右键村民打开交易界面。
3. 正常可交易的项目仍然显示在前面；尚未解锁的职业等级交易会提前展示。
4. 如果某项显示“正在生成”，等待服务器完成该村民的交易生成后再查看。
5. 根据后续交易是否符合需求，决定继续升级村民，或在尚未交易时更换工作站。

与 Trade Cycling 配合

理论上可以先查看交易，再用 Trade Cycling 刷新未锁定村民。但当前实例中 Trade Cycling 的 Visible Traders 兼容层找不到 1.3.2 提供的方法，因此联动初始化失败。实际使用时按下面顺序排查：

1. 单独打开交易界面，确认 Visible Traders 能否显示后续交易。
2. 再按 C 测试 Trade Cycling 的基础刷新。
3. 如果出现界面不同步、交易不刷新或日志持续报错，改用相互兼容的版本组合，或暂时只保留其中一个。
4. 不要在唯一的重要村民交易厅中直接测试版本更换。

推荐与注意事项

• 它不会替代正常的村民升级流程，只是提前显示后续交易。
• 多人服务器需要服务端支持，客户端单独安装不能保证拿到未生成的交易数据。
• 当前整合包应把它标记为“已安装，但与 Trade Cycling 联动异常”。

依赖关系

• fabric-api：>=0.116.7+1.21.1
• Java：>=21

配置与数据位置

• 当前版本没有需要普通玩家维护的独立配置文件。

官方资料

• 项目主页或官方文档

FTB Ultimine（连锁破坏）#

按住快捷键一次挖掘或处理成片方块，可切换不同形状。

• 模组 ID：ftbultimine
• 当前版本：2101.1.15
• 运行环境：客户端与服务端/通用

快捷键

基础挖掘 按住反引号键再破坏方块，模组会高亮即将处理的方块。当前服务器配置单次最多处理 64 个方块，并按每个方块增加饥饿消耗。

形状切换 当前配置要求按住 Ultimine 键才能用方向键切换形状。常见模式包括连通同类方块、平面、直线和范围形状。按住 Ultimine 键并潜行可显示形状菜单。

右键批量操作 当前配置允许按住 Ultimine 键批量收割作物、用锄头耕地、用铲子铺路、用斧头去皮或除蜡；普通右键成熟作物也会直接收割。

建筑注意事项 拆除临时脚手架和大片同类方块很快，但机器附近极易误拆。观察白色预览轮廓后再操作。

推荐与注意事项

• 红石机器附近建议临时改为单方块模式。
• 当前 prevent_tool_break 为 0，不会主动保留最后耐久。
• 该模组改变原版挖掘方式，发布博客时应明确标为便利功能。

依赖关系

• fabric：>=0.100.1+1.21
• architectury：>=13.0.6
• ftblibrary：>=2101.1.28

配置与数据位置

• config/ftbultimine-client.snbt
• config/ftbultimine-server.snbt

官方资料

• 项目主页或官方文档

Grind Enchantments（砂轮增强）#

使用砂轮把物品附魔转移到书上，并可拆分附魔书。

• 模组 ID：grindenchantments
• 当前版本：4.0.0+1.21.1
• 运行环境：客户端与服务端/通用

快捷键

该模组没有需要玩家操作的快捷键，或当前没有绑定快捷键。

提取物品附魔

1. 把带附魔的工具、武器或装备放进砂轮上方槽位。
2. 在另一个输入槽放入普通书。
3. 输出会得到附魔书，同时返还去除附魔后的物品。

拆分附魔书 把带多个附魔的附魔书放入上方，再放入一本空书，可把列表顶部的附魔转移到另一本文书中。重复操作即可逐项拆分。

用途 适合回收探索获得的装备附魔、整理仓库中的附魔书，以及保留建筑工具上的高价值附魔。

推荐与注意事项

• 它明显改变原版砂轮机制。
• 操作前检查诅咒附魔和经验消耗规则。
• 重要装备先用普通物品测试一次。

依赖关系

• fabric-lifecycle-events-v1：*
• fabric-api-base：*
• fabric-registry-sync-v0：*
• fabric-networking-api-v1：*

配置与数据位置

• config/grindenchantments/

官方资料

• 项目主页或官方文档

Elytra Slot（鞘翅槽位）#

通过 Trinkets 增加独立鞘翅槽，让胸甲与鞘翅同时装备。

• 模组 ID：elytraslot
• 当前版本：9.0.1+1.21.1
• 运行环境：客户端与服务端/通用

快捷键

该模组没有需要玩家操作的快捷键，或当前没有绑定快捷键。

使用方法 打开玩家物品栏，在 Trinkets 饰品栏中找到鞘翅槽，把鞘翅拖入该槽位。装备后仍可在原胸甲栏穿戴胸甲，飞行操作与原版鞘翅一致。

卸载前处理 移除 Elytra Slot 或 Trinkets 前，必须先把额外槽位中的鞘翅取出并放回普通物品栏或箱子。

推荐与注意事项

• 属于改变原版装备平衡的便利模组。
• 多人服务器需要服务端也安装相同模组。
• 槽位没有显示时先确认 Trinkets 正常加载。

依赖关系

• fabric：*
• trinkets：*

配置与数据位置

• 通常不生成需要玩家维护的独立配置文件。

官方资料

• 项目主页或官方文档

Trinkets（饰品栏 API）#

提供可由其他模组注册的额外装备槽；本整合包主要用于 Elytra Slot。

• 模组 ID：trinkets
• 当前版本：3.10.0
• 运行环境：客户端与服务端/通用

快捷键

该模组没有需要玩家操作的快捷键，或当前没有绑定快捷键。

玩家如何使用 Trinkets 本身主要提供槽位系统，不一定添加可装备物品。打开物品栏后，通过饰品栏界面放入兼容物品。本整合包中最直接的用途是为 Elytra Slot 提供独立鞘翅槽。

数据包作者 高级用户可以通过数据包定义槽位组、槽位数量和允许装备的物品标签。普通玩家无需配置。

推荐与注意事项

• 不要因为看到空槽位就随意移除，它可能是其他装备模组的依赖。
• 移除前先清空所有额外槽位。

依赖关系

• fabric-api：>=0.51.2
• cardinal-components-entity：>=3.0.0-0
• cardinal-components-base：>=3.0.0-0

配置与数据位置

• 通常不生成需要玩家维护的独立配置文件。

官方资料

• 项目主页或官方文档

Inventory Profiles Next（一键整理）#

提供容器排序、自动补货、物品锁定、配置档和自定义排序规则。

• 模组 ID：inventoryprofilesnext
• 当前版本：2.2.6
• 运行环境：仅客户端

快捷键

该模组没有需要玩家操作的快捷键，或当前没有绑定快捷键。

快速开始 打开物品栏或箱子后，界面边缘会出现排序按钮。可分别按名称、数量或类别整理玩家背包和容器。第一次使用先在设置中确认按钮位置，避免与 JEI/Jade 界面重叠。

自动补货 启用 Auto Refill 后，快捷栏中的方块或工具耗尽时，会尝试从背包补入同类物品。建筑连续铺方块非常实用，但处理带名称、耐久或 NBT 的物品时应检查匹配规则。

锁定槽位 把重要工具、火箭和食物所在槽位锁定，排序时这些槽位不会被打乱。大型仓库操作前尤其建议锁定快捷栏。

配置档 在 Hotkeys → Profiles 中设置“保存当前状态”“应用配置档”等快捷键。可为建筑、红石施工、探索分别保存快捷栏布局。本实例尚未为 Profiles 分配快捷键，需要玩家自行设置。

自定义规则 规则文件位于配置目录，可用物品 ID、标签和通配符定义排序优先级。修改后先用普通箱子测试。

推荐与注意事项

• 不要对复杂分类仓库无脑点击双向移动按钮。
• 服务器延迟高时减少连续排序操作。
• 当前配置的 Profiles 和 Auto Refill 功能处于关闭状态，可按需开启。

依赖关系

• libipn：>=6.6.3 <6.7
• fabric-language-kotlin：>=1.13.10+kotlin.2.3.20

配置与数据位置

• config/inventoryprofilesnext/
• config/libIPN/

官方资料

• 项目主页或官方文档

Quick Shulker（快捷潜影盒）#

手持或背包里直接右键打开潜影盒，还能顺手开工作台、砂轮、铁砧、末影箱；比旧版 Better Shulkers 更轻、更通用。

• 模组 ID：quickshulker
• 当前版本：3.0.0-1.21.1
• 运行环境：客户端为主，多人需双方允许

快捷键

直接打开容器

当前配置全开：

1. 手持潜影盒右键 → 直接打开，不用先放地上。
2. 背包里悬停潜影盒右键 → 打开；再右键可关闭（rightClickClose 当前为 false，按配置说明执行）。
3. 按 F9 也能打开手中或悬停的容器。
4. 工作台、砂轮、铁砧、末影箱同样支持快捷打开（quickCraftingTables / quickStonecutter / quickAnvil / quickEChest 均为 true）。

嵌套收纳（Bundling）

当前 supportsBundling* 全开：

1. 对着潜影盒右键拿物品 → 可把物品塞进盒。
2. 拿着物品对潜影盒右键 → 快捷放入。
3. 潜影盒对潜影盒右键 → 盒间转移。
4. 对着空槽右键 → 从盒里取出物品。
5. 拿着潜影盒拖拽 → 批量存/取。

推荐与注意事项

• 这是 Quick Shulker，不是旧文的 Better Shulkers；没有 /shulker set 绑定材料和 Material Collector 附魔那套玩法。
• config/bettershulkers.toml 是历史残留文件，当前不生效，可删。
• 多人服务器若未安装或禁用，右键行为会回退原版或无效。
• 和 Inventory Profiles Next、Mouse Tweaks 叠用时，鼠标手势可能触发多次存取，先在测试箱上练。

依赖关系

• fabric（Fabric Loader）
• Java ≥ 21

配置与数据位置

• config/quickshulkerconfig.json5

官方资料

• 项目主页或官方文档

Mouse Tweaks（鼠标整理增强）#

改进物品栏拖拽、连续分发和快速收集操作。

• 模组 ID：mousetweaks
• 当前版本：2.26
• 运行环境：仅客户端

快捷键

右键拖动 拿起一组物品后按住右键划过多个槽位，可向每个槽位连续放入一个物品，比原版重复点击更快。

Shift 拖动 按住 Shift 和鼠标左键划过物品堆，可把经过的物品快速移动到另一侧容器。

滚轮搬运 鼠标指向物品后滚动滚轮，可以在玩家背包和当前容器之间连续转移同类物品。滚动方向与行为可在配置文件中调整。

推荐与注意事项

• 与 Inventory Profiles Next 同时使用时先熟悉两者边界。
• 高延迟服务器不要过快滚动。
• 误操作时检查 MouseTweaks.cfg 中的 WheelTweak 设置。

依赖关系

• fabric-api：*

配置与数据位置

• config/MouseTweaks.cfg

官方资料

• 项目主页或官方文档

AppleSkin（苹果皮）#

显示食物恢复量、饱和度、消耗进度和 HUD 预测。

• 模组 ID：appleskin
• 当前版本：3.0.6+mc1.21
• 运行环境：仅客户端

快捷键

显示内容

• 食物提示中显示饥饿值与饱和度。
• 手持食物时在饥饿条上预览恢复结果。
• 在 HUD 中显示当前饱和度和消耗进度。
• F3 调试界面显示饥饿、饱和度和消耗数据。

当前配置已开启自动显示，不必按 Shift。

推荐与注意事项

• 只改变客户端显示，不改变食物数值。
• HUD 太拥挤时可关闭健康恢复预测或消耗条。

依赖关系

• fabric-api：*

配置与数据位置

• config/appleskin.json5

官方资料

• 项目主页或官方文档

Zoomify（缩放）#

可平滑缩放、滚轮调倍率并保存缩放行为。

• 模组 ID：zoomify
• 当前版本：2.15.2+1.21.1
• 运行环境：仅客户端

快捷键

基础缩放 按住鼠标侧键 4 进入缩放，松开恢复。没有侧键时使用 F6。缩放过程中可根据配置使用滚轮调整倍率。

建筑用途

• 从远处检查立面比例和重复图案。
• 对齐远距离桥梁、道路和屋顶轮廓。
• 观察生电机器状态而不进入危险区域。

配置 通过 Mod Menu 打开 Zoomify 设置，可调整初始倍率、滚轮灵敏度、平滑动画、保持缩放和鼠标灵敏度补偿。

推荐与注意事项

• F6 可能与其他辅助功能冲突。
• 缩放只放大现有画面，不会增加服务器发送的区块距离。

依赖关系

• fabric-language-kotlin：>=1.13.8+kotlin.2.3.0
• yet_another_config_lib_v3：>=3.6.6

配置与数据位置

• config/zoomify.json

官方资料

• 项目主页或官方文档

Better Advancements（更好的进度）#

把原版进度界面拉大、排版更清晰，完成度一眼能扫完。

• 模组 ID：betteradvancements
• 当前版本：0.4.3.21
• 运行环境：仅客户端

怎么用

打开进度界面即可生效，无独立快捷键。窗口更大、标签更清楚，翻页更少。

推荐与注意事项

• 纯视觉改进，不影响进度数据。
• 和 Modern UI 同开时若字体/缩放怪异，先单独测。

依赖关系

• fabric-api

配置与数据位置

• config/betteradvancements.json

官方资料

• 项目主页或官方文档

Cherished Worlds（存档置顶）#

收藏/置顶常用存档，让它们永远排在世界列表最上面。

• 模组 ID：cherishedworlds
• 当前版本：10.1.1+1.21.1
• 运行环境：仅客户端

怎么用

1. 打开单人世界列表。
2. 在目标世界上点星标/收藏（界面按钮）。
3. 收藏的存档会固定在列表顶部，不再被新存档挤下去。

推荐与注意事项

• 只改列表排序，不改存档内容。
• 实例目录里有 cherishedworlds-favorites.dat，迁移时一起拷。

依赖关系

• fabric-api

配置与数据位置

• cherishedworlds-favorites.dat（版本根目录）

官方资料

• 项目主页或官方文档

3D Skin Layers（3D 皮肤层）#

把皮肤外层渲染成立体厚度，披风、袖子、帽子不再是纸片。

• 模组 ID：skinlayers3d
• 当前版本：1.11.2
• 运行环境：仅客户端

怎么用

安装即生效。在皮肤外层启用的区域会以 3D 模型渲染，截图和第三人称明显更好看。

推荐与注意事项

• 只影响渲染，不动皮肤数据。
• 低配机可关或调低厚度以省性能。

依赖关系

• fabric-api

配置与数据位置

• config/skinlayers.json

官方资料

• 项目主页或官方文档

Chat Heads（聊天头像）#

聊天栏每条消息前显示说话玩家的头像，联机认人快很多。

• 模组 ID：chat_heads
• 当前版本：0.15.7
• 运行环境：仅客户端

怎么用

安装后聊天自动显示头像，无按键。单人自言自语也会显示自己的头。

推荐与注意事项

• 纯 UI，不改聊天数据。
• 和 Chat Animation 同开体验更好。

依赖关系

• Fabric Loader ≥ 0.17.0

配置与数据位置

• config/chat_heads.json5

官方资料

• 项目主页或官方文档

Chat Animation（聊天动画）#

聊天消息出入带动画，不再是生硬的一整块。

• 模组 ID：chatanimation
• 当前版本：1.3.1
• 运行环境：仅客户端

怎么用

安装即生效。新消息淡入/滑入，旧消息淡出。

推荐与注意事项

• 纯动画，不影响消息内容。
• 截图时若不想拍到动画中间帧，可等稳定后再截。

依赖关系

• 无额外模组依赖

配置与数据位置

• config/chatanimation.json

官方资料

• 项目主页或官方文档

Eating Animation（进食动画）#

吃喝时物品有简单帧动画，不再只是手部动作。

• 模组 ID：eatinganimationid
• 当前版本：1.21+1.9.72
• 运行环境：仅客户端

怎么用

安装后进食/饮用自动播放物品动画。

推荐与注意事项

• 纯视觉，不改食物数值。
• 和自定义物品模型资源包同开时偶尔会遮挡，可单独测。

依赖关系

• fabric-api

配置与数据位置

• 模组菜单内配置（无强制独立文件）

官方资料

• 项目主页或官方文档

No Fire Overlay（去火焰遮罩）#

身上着火时不再糊一脸火焰贴图，烧着也能看清路。

• 模组 ID：no-fire-overlay
• 当前版本：1.1.0
• 运行环境：仅客户端

怎么用

安装即生效。着火时画面不再被第一人称火焰遮罩盖住。

推荐与注意事项

• 极轻量，可当纯 QoL 常开。
• 不代表免疫火焰伤害，只是去掉遮罩。

依赖关系

• fabric-api

配置与数据位置

• config/no-fire-overlay.json

官方资料

• 项目主页或官方文档

JourneyMap（旅行地图）#

提供小地图、全屏地图、路径点、洞穴地图和地图记录。

• 模组 ID：journeymap
• 当前版本：1.21.1-6.0.1
• 运行环境：仅客户端

快捷键

第一次使用 按 J 打开全屏地图。当前 JourneyMap 数据目录已清空，进入世界后会根据探索范围重新生成地图。按 M 切换小地图，反斜杠切换预设。

路径点

1. 在游戏中按句号快速创建当前位置路径点。
2. 在全屏地图中移动到目标位置，按逗号创建地图坐标路径点。
3. 按 N 打开路径点管理，可编辑名称、颜色、维度和可见性。
4. 对生电世界建议使用统一前缀：[农场]、[仓库]、[传送门]、[施工]。

建筑用途

• 标记采石场、材料仓库、主城区与机器坐标。
• 使用全屏地图检查道路、城区轮廓和大型地形工程。
• 为不同维度建立传送门路径点，记录坐标换算后的出口。

空间管理 地图数据位于 journeymap/data。不再使用的服务器地图可单独删除；单人地图删除后不会损坏世界，但会丢失已探索地图记录。

推荐与注意事项

• 定期清理不再玩的多人服务器地图。
• 路径点很重要时单独备份 JourneyMap 数据。
• 左 Win 作为地图选项键较特殊，可改成不易冲突的组合键。

依赖关系

• fabric-api：>=0.100.4
• commonnetworking：>=1.0.16-1.21

配置与数据位置

• journeymap/config/
• journeymap/data/
• config/journeymap-server.json

官方资料

• 项目主页或官方文档

JourneyMap Integration（JMI）#

把其他模组或服务器信息整合为 JourneyMap 路径点和标记。

• 模组 ID：jmi
• 当前版本：1.21.1-1.9
• 运行环境：客户端与服务端/通用

快捷键

该模组没有需要玩家操作的快捷键，或当前没有绑定快捷键。

使用方式 JMI 本身通常没有独立主界面，功能通过 JourneyMap 路径点和配置文件体现。当前配置允许相关整合生成地图标记，也可以根据特定方块或消息创建路径点。

配置建议 打开 config/jmi-client.json5，按需要启用或关闭各模组整合。若地图上出现大量无用标记，优先关闭对应集成，而不是删除 JourneyMap 数据。

推荐与注意事项

• 必须与 JourneyMap 同时存在。
• 整合对象未安装时，对应开关通常不会生效。
• 地图标记过多会影响可读性。

依赖关系

• fabric-api：*
• journeymap：*

配置与数据位置

• config/jmi-client.json5

官方资料

• 项目主页或官方文档

Jade（方块/实体信息）#

查看准星所指方块、容器、红石状态和实体信息。

• 模组 ID：jade
• 当前版本：15.10.5+fabric
• 运行环境：客户端与服务端/通用

快捷键

基础使用 把准星对准方块或实体，屏幕顶部会显示名称、模组来源和附加信息。按小键盘 1 快速隐藏或显示 Overlay，小键盘 0 打开详细配置。

生电用途

• 查看容器、漏斗和方块实体状态。
• 确认作物成熟度、蜂箱蜂蜜等级和红石组件朝向。
• 检查实体生命、职业和基础属性。
• 小键盘 3/4 可跳转 JEI 配方或用途页面。

显示控制 在配置中按插件逐项关闭不需要的信息。建筑模式建议只保留方块名称、状态和容器概要，避免遮挡画面。

推荐与注意事项

• 没有小键盘的键盘应先重绑定。
• 与 MiniHUD/Neat 同时显示时可能拥挤。
• 服务器不提供的数据无法仅靠客户端读取。

依赖关系

• fabric-api：>=0.99

配置与数据位置

• config/jade/

官方资料

• 项目主页或官方文档

JEI（物品与配方浏览）#

浏览物品列表、配方、用途、搜索和书签。

• 模组 ID：jei
• 当前版本：19.39.0.371
• 运行环境：客户端与服务端/通用

快捷键

搜索 按 F 聚焦搜索框。直接输入名称搜索；使用 @模组名 按模组过滤，使用 #标签、$工具提示 等高级前缀可进一步筛选，实际可用前缀以 JEI 配置提示为准。

配方与用途 鼠标指向物品按 R 查看制作方式，按 U 查看该物品参与的配方。鼠标左键/右键也分别绑定了配方和用途。

书签 指向物品按 A 加入左侧书签。建筑项目前可把全部材料加入书签，作为施工采购清单。再次按 A 移除。

配方转移 打开工作台配方页面后点击转移按钮，把背包中的材料摆入工作台。服务器端或配方复杂时可能只显示缺少材料。

推荐与注意事项

• 当前 O 同时也是 Iris 光影包界面快捷键，发生冲突时建议修改其中一个。
• JER 插件曾出现过加载警告，若配方界面异常可先禁用 JER 排查。
• 作弊模式必须由玩家主动开启，不建议整合包默认启用。

依赖关系

• fabric-api：>=0.102.0+1.21

配置与数据位置

• config/jei/

官方资料

• 项目主页或官方文档

Just Enough Resources（JER）#

在 JEI 中展示矿物分布、怪物掉落、地牢战利品和世界生成信息。

• 模组 ID：jeresources
• 当前版本：1.6.0.17
• 运行环境：客户端与服务端/通用

快捷键

该模组没有需要玩家操作的快捷键，或当前没有绑定快捷键。

使用方式 打开 JEI 配方界面后，JER 会新增矿物生成、怪物掉落、世界生成和战利品等分类。对矿物按用途键 U，可查看高度分布；对怪物掉落物查看配方/用途可进入对应掉落页面。

生电用途 可快速查怪物掉落、刷怪条件和矿物高度，但原版生电玩家也应以 Wiki、实际测试和 MiniHUD 数据为准。

故障排查 如果 JEI 启动时出现 JER 插件异常、分类空白或物品缺失，可先移除 JER 测试；JEI 本体不依赖 JER。

推荐与注意事项

• 它是 JEI 扩展，不是独立物品浏览器。
• 世界生成数据可能因版本、数据包或服务器配置而不准确。

依赖关系

• fabric：*

配置与数据位置

• config/jei/jeresources/（若生成）

官方资料

• 项目主页或官方文档

Neat（实体血条）#

在实体头顶显示生命值、护甲、属性与状态。

• 模组 ID：neat
• 当前版本：1.21-47-FABRIC
• 运行环境：仅客户端

快捷键

使用方式 靠近实体并保持视线，实体头顶会出现血条。当前配置最大显示距离 24 格，无视线时最多 8 格；显示当前生命、最大生命、百分比和护甲。

配置建议 通过 Mod Menu 调整距离、背景、血条尺寸、文字高度和信息项。建筑截图或视频中建议关闭，避免画面杂乱。

推荐与注意事项

• 本整合包未绑定开关键，建议设置一个不冲突的快捷键。
• 与 Jade 同时启用时信息重复。
• 大量实体农场可能增加界面绘制负担。

依赖关系

• fabric：>=0.100
• cloth-config：>=15.0.140

配置与数据位置

• config/neat-client.json5

官方资料

• 项目主页或官方文档

Better Ping Display（延迟数字显示）#

在多人游戏列表中显示精确延迟数值。

• 模组 ID：betterpingdisplay
• 当前版本：1.1.1
• 运行环境：仅客户端

快捷键

该模组没有需要玩家操作的快捷键，或当前没有绑定快捷键。

使用方式 打开多人游戏服务器列表，信号图标附近会显示毫秒延迟。它没有必要的游戏内快捷键，也不会改变网络连接。

判断延迟 低延迟适合红石操作和连续放置；延迟突然升高时应避免快速容器操作或批量施工。

推荐与注意事项

• 只改变显示，不会降低 Ping。
• 本地单人世界没有明显用途。

依赖关系

• 无额外模组依赖，或依赖已打包在模组内部。

配置与数据位置

• config/betterpingdisplay.json

官方资料

• 项目主页或官方文档

Controlling（键位搜索）#

增强控制设置，支持搜索、按键筛选和冲突定位。

• 模组 ID：controlling
• 当前版本：19.0.5
• 运行环境：仅客户端

快捷键

该模组没有需要玩家操作的快捷键，或当前没有绑定快捷键。

使用方法 进入“选项 → 控制”，使用新增搜索框按功能名查找快捷键。可按未绑定、冲突、类别或具体按键进行筛选。

整合包维护流程

1. 搜索“未绑定”，给常用功能设置按键。
2. 搜索“冲突”，重点检查 O、M、I、F、C、反斜杠和小键盘。
3. 每次新增模组后重新检查冲突。
4. 不常用功能保持未绑定，减少误触。

推荐与注意事项

• 依赖 Searchables。
• 更换键盘布局后重新检查小键盘和符号键。

依赖关系

• fabric-api：*
• searchables：>=1.0.1

配置与数据位置

• 通常不生成需要玩家维护的独立配置文件。

官方资料

• 项目主页或官方文档

IMBlocker（输入法冲突修复）#

降低中文输入法在游戏按键、聊天和快捷键中的冲突。

• 模组 ID：imblocker
• 当前版本：5.5.4
• 运行环境：仅客户端

快捷键

使用方式 游戏过程中如果中文输入法导致移动键失效、快捷键被候选框截获或聊天状态异常，按右 Shift 使用本实例配置的解除键。

推荐习惯 游戏操作时切到英文输入；需要聊天、命名潜影盒或告示牌时再切中文。

推荐与注意事项

• 右 Shift 可能与潜行或其他功能冲突。
• 不同输入法行为不同，必要时在系统输入法中关闭游戏模式快捷键。

依赖关系

• 无额外模组依赖，或依赖已打包在模组内部。

配置与数据位置

• config/imblocker.json

官方资料

• 项目主页或官方文档

Mod Menu（模组菜单）#

在主菜单和暂停菜单查看模组、版本、依赖和配置入口。

• 模组 ID：modmenu
• 当前版本：11.0.4
• 运行环境：仅客户端

快捷键

使用方式 在主菜单点击“模组”进入列表。选择模组后可以查看描述、版本、依赖、主页和配置按钮。

排错用途 新增或更新模组后先确认它出现在列表中；如果缺失，检查版本、加载器和依赖。配置按钮为灰色表示该模组没有通过 Mod Menu 提供配置页面。

推荐与注意事项

• 前置库也会显示在列表中，但通常不需要操作。
• 发布博客时可用 Mod Menu 截图展示整合包清单。

依赖关系

• fabric-screen-api-v1：>=1.0.4
• fabric-lifecycle-events-v1：*
• fabric-key-binding-api-v1：*
• fabric-resource-loader-v0：*

配置与数据位置

• config/modmenu.json

官方资料

• 项目主页或官方文档

Modern UI（现代化 UI）#

重做文字渲染、字体回退、提示框、界面模糊和部分设置界面，改善中文与高分辨率显示体验。

• 模组 ID：modernui
• 当前版本：3.13.0.1
• 运行环境：仅客户端

快捷键

当前 K 同时被 Iris 用作光影开关。第一次进入游戏先打开“选项 → 控制 → 按键绑定”，搜索 Modern UI，把配置中心改成 Shift + K 或其他空闲组合键。

从零开始

1. 调整按键冲突后，按新的快捷键打开 Modern UI Center。
2. 在 Screen 中设置界面背景、模糊半径、淡入时间和窗口失焦帧率。
3. 在 Tooltip 中设置圆角、标题居中、边框、阴影和自适应稀有度颜色。
4. 在 Text 和 Font 中选择首选字体、中文回退字体、字号、抗锯齿和彩色 Emoji。
5. 修改后点击“应用”；提示需要重启的项目必须完全退出游戏后再启动。

当前实例配置

• 界面淡入时间：200 ms
• 高斯模糊：开启，半径 7
• 现代化圆角提示框：开启
• 提示框标题居中、分隔线和自适应颜色：开启
• 首选字体：Inter Frozen Medium
• 中文回退字体包含 Source Han Sans CN Medium
• 失焦帧率上限：30 FPS

性能与兼容

• 低端显卡出现打开背包掉帧时，先关闭 Blur Effect 或降低 Blur Radius。
• Iris 光影启用时，Modern UI 的世界文字着色器会自动受到兼容限制；GUI 文字和配置中心仍可工作。
• 字体错位、缺字或模糊时，先恢复默认字体列表，再逐个添加自定义字体。
• Modern UI 与 ModernFix 是两个完全不同的模组：前者负责界面和文字，后者负责修复与性能。

依赖关系

• fabric-api：>=0.90.7
• forgeconfigapiport：>=21.0.5
• Java：>=21

配置与数据位置

• config/ModernUI/client.toml
• config/ModernUI/text.toml
• config/ModernUI/common.toml

官方资料

• 项目主页或官方文档

CustomSkinLoader（万用皮肤补丁）#

从多个皮肤源加载玩家皮肤和披风。

• 模组 ID：customskinloader-bootstrap
• 当前版本：15.0.1
• 运行环境：仅客户端

快捷键

该模组没有需要玩家操作的快捷键，或当前没有绑定快捷键。

使用方式 模组启动后自动处理皮肤加载。普通玩家无需快捷键。首次启动会生成配置，可调整皮肤站点列表、缓存和日志。

排错 皮肤不显示时，先确认网络、正版登录状态和皮肤源可用性，再清理该模组皮肤缓存。不要同时配置大量不可信第三方皮肤源。

推荐与注意事项

• 正版皮肤正常时不一定需要额外配置。
• 皮肤源配置可能包含站点地址，发布整合包前检查隐私信息。

依赖关系

• 无额外模组依赖，或依赖已打包在模组内部。

配置与数据位置

• CustomSkinLoader 配置与缓存目录（首次运行后生成）

官方资料

• 项目主页或官方文档

Lan Server Properties（局域网联机设置）#

开放局域网世界时自定义端口、在线模式和服务器属性。

• 模组 ID：lanserverproperties
• 当前版本：1.13.2
• 运行环境：仅客户端；安装到专用服务器不会提供额外功能

快捷键

该模组没有需要玩家操作的快捷键，或当前没有绑定快捷键。

使用方式 进入单人世界后打开“对局域网开放”。模组会提供额外服务器参数，例如端口等。设置完成后启动局域网世界，其他玩家使用主机 IP 与端口连接。

网络说明 同一路由器内通常使用局域网地址；跨网络仍需要端口映射、虚拟局域网或隧道服务。本模组本身不会自动完成公网穿透。

推荐与注意事项

• 开放前备份世界。
• 不要随意关闭身份验证或把端口暴露到公网。
• 防火墙必须允许 Java/Minecraft 对应端口。

依赖关系

• 无额外模组依赖，或依赖已打包在模组内部。

配置与数据位置

• config/lsp.json

官方资料

• 项目主页或官方文档

Flashback（闪回）#

录下游戏过程，在时间轴里回放、打标记、导出电影镜头。整合包里最大的单体模组（约 200 MB）。

• 模组 ID：flashback
• 当前版本：0.39.8
• 运行环境：客户端；依赖 Fabric API；适配 MC 1.21–1.21.1

快捷键

怎么用

1. 游戏内打开 Flashback 界面（默认入口在按键设置里搜 flashback）。
2. 开始录制 → 玩/建造/生电操作。
3. 结束后进入回放编辑器，拖时间轴、切相机、打标记。
4. 导出视频或截图序列，做建筑延时、机器演示、剧情片都行。

推荐与注意事项

• 文件巨大，磁盘紧张别乱开长录制。
• 录制期有性能开销，机器演示时注意 MSPT。
• 标记键当前未绑定，剪辑前先绑好。
• 不要拿它录服务器机密内容外传。

依赖关系

• fabric-api
• Java ≥ 21

配置与数据位置

• config/flashback/
• flashback/（录像数据目录）

官方资料

• 项目主页或官方文档

Sodium（钠）#

重写客户端渲染管线，提高帧率并减少卡顿。

• 模组 ID：sodium
• 当前版本：0.8.12+mc1.21.1
• 运行环境：仅客户端

快捷键

该模组没有需要玩家操作的快捷键，或当前没有绑定快捷键。

设置入口 进入“选项 → 视频设置”。Sodium 会重新组织页面，提供常规、质量、性能和高级选项。

建筑/生电推荐

• 渲染距离：日常 16–24；大型建筑展示可临时提高。
• 模拟距离：建议 12–16；32 会显著增加单人服务器负担。
• 区块更新线程：保持默认，出现区块闪烁再排查资源包与 Iris。
• 实体距离：大型农场调试时适当提高，日常不必拉满。
• 垂直同步：追求低延迟可关闭；画面撕裂明显时开启。

排错 材质缺失、透明层错误或闪烁时，依次测试资源包、Iris、EntityCulling 和 Sodium 设置，不要一次改动多项。

推荐与注意事项

• 不要安装与当前 Sodium 版本不匹配的扩展。
• 更新 Sodium 时同时核对 Iris 兼容版本。
• 性能瓶颈可能来自模拟距离而非显卡。

依赖关系

• fabric-renderer-api-v1：*
• fabric-rendering-fluids-v1：>=2.0.0
• fabric-rendering-data-attachment-v1：*
• fabric-resource-loader-v0：*
• fabric-block-view-api-v2：*

配置与数据位置

• config/sodium-options.json
• config/sodium-mixins.properties

官方资料

• 项目主页或官方文档

Continuity（连接纹理）#

在 Fabric 环境中支持 OptiFine 风格的连接纹理、发光纹理和自定义方块渲染层。

• 模组 ID：continuity
• 当前版本：3.0.0+1.21
• 运行环境：仅客户端

快捷键

没有独立快捷键，通过资源包页面和 Mod Menu 配置。

从零开始

1. 进入“选项 → 资源包”。
2. 启用 Default Connected Textures，让玻璃、砂岩和书架等内置纹理连接。
3. 启用 Glass Pane Culling Fix，减少相邻玻璃板之间不必要的内部面。
4. 点击完成，等待资源重新加载；必要时按 F3 + T 手动重载资源。
5. 放置一排玻璃或书架检查接缝。如果仍显示原版边框，检查资源包顺序和 Continuity 配置。

当前实例已经启用：

• continuity:default
• continuity:glass_pane_culling_fix
• 连接纹理、发光纹理和自定义方块层三个功能开关

添加其他资源包

Continuity 能读取使用 OptiFine CTM、发光纹理和自定义方块层格式的资源包。把兼容资源包放入 resourcepacks/ 后，在资源包页面启用即可，不需要安装 OptiFine。

排错

• 纹理接缝错误：先只保留 Continuity 内置资源包测试。
• 方块透明层异常：临时关闭 Custom Block Layers，再检查资源包声明。
• 发光纹理不显示：确认资源包确实包含对应 emissive 配置，并重新加载资源。
• 与 More Culling 同时出现方块缺面时，先分别关闭 Continuity 的 Manual Culling 和 More Culling 的 BlockState Culling，判断责任项。

依赖关系

• fabric-api：>=0.100.1

配置与数据位置

• config/continuity.json
• resourcepacks/

官方资料

• 项目主页或官方文档

Lithium（锂）#

优化游戏逻辑、实体、方块刻和数据结构，尽量不改变原版行为。

• 模组 ID：lithium
• 当前版本：0.15.4+mc1.21.1
• 运行环境：客户端与服务端/通用

快捷键

该模组没有需要玩家操作的快捷键，或当前没有绑定快捷键。

使用方式 安装后自动生效，没有游戏内快捷键。主要优化单人世界内置服务器和多人服务器逻辑性能。

生电注意 机器行为异常时，可通过 config/lithium.properties 针对单个优化模块排查，而不是直接删除整个模组。修改前记录原值并逐项测试。

推荐与注意事项

• 保持默认配置通常最安全。
• 精密红石问题应先在无模组测试世界复现。

依赖关系

• 无额外模组依赖，或依赖已打包在模组内部。

配置与数据位置

• config/lithium.properties

官方资料

• 项目主页或官方文档

FerriteCore（铁氧体磁芯）#

降低方块状态、模型等数据占用的内存。

• 模组 ID：ferritecore
• 当前版本：7.0.3
• 运行环境：客户端与服务端/通用

快捷键

该模组没有需要玩家操作的快捷键，或当前没有绑定快捷键。

使用方式 安装后自动工作，不提供常用快捷键。它更偏向降低内存占用，而不是直接提高 GPU 帧率。

推荐 保持默认配置。只有启动阶段崩溃或模型相关兼容问题明确指向 FerriteCore 时，才调整 mixin 配置。

推荐与注意事项

• 不要为了“看起来更轻量”随意关闭优化项。
• 内存占用仍高时检查资源包、JourneyMap、原理图和光影缓存。

依赖关系

• 无额外模组依赖，或依赖已打包在模组内部。

配置与数据位置

• config/ferritecore.mixin.properties

官方资料

• 项目主页或官方文档

ModernFix（现代化修复）#

提供启动、内存、资源加载和兼容性修复。

• 模组 ID：modernfix
• 当前版本：5.25.1+mc1.21.1
• 运行环境：客户端与服务端/通用

快捷键

该模组没有需要玩家操作的快捷键，或当前没有绑定快捷键。

使用方式 默认自动启用一组修复，没有日常快捷键。日志中通常会显示启用的 mixin 和缓存行为。

故障排查 如果某个模组启动异常并明确指出 ModernFix mixin，打开 modernfix-mixins.properties，只禁用相关条目进行验证。不要复制其他版本的配置。

推荐与注意事项

• 它与 Modern UI 没有功能关系：ModernFix 负责修复和性能，Modern UI 负责界面与文字。
• 修改 mixin 后必须完全退出并重新启动游戏。

依赖关系

• 无额外模组依赖，或依赖已打包在模组内部。

配置与数据位置

• config/modernfix-mixins.properties

官方资料

• 项目主页或官方文档

EntityCulling（实体遮挡剔除）#

不渲染被墙体等遮挡的实体和方块实体。

• 模组 ID：entityculling
• 当前版本：1.10.5
• 运行环境：仅客户端

快捷键

使用方式 默认自动生效。它会检测实体是否真正可见，被墙体遮挡时跳过绘制，从而改善大型仓库、村民大厅和机器区的帧率。

排错 实体、箱子或方块实体异常消失时，先在控制设置中给 EntityCulling Toggle 绑定临时按键，对比开关前后。确认是剔除问题后再调整配置中的白名单。

推荐与注意事项

• 它只影响渲染，不会停止实体运算。
• 建议绑定一个排错用快捷键，但日常不必频繁切换。

依赖关系

• fabric-api：*

配置与数据位置

• config/entityculling.json

官方资料

• 项目主页或官方文档

More Culling（更多剔除）#

优化方块面、云、雨雪、告示牌文字、展示框、画和树叶等渲染；与 EntityCulling 的作用范围不同。

• 模组 ID：moreculling
• 当前版本：1.0.9
• 运行环境：仅客户端

快捷键

没有独立快捷键。当前配置会把 More Culling 选项加入 Sodium 视频设置，也可以从 Mod Menu 打开。

从零开始

1. 打开“选项 → 视频设置”，寻找 More Culling 分类；找不到时从 Mod Menu 进入配置。
2. 保持默认值进入普通世界，观察树叶、告示牌、展示框、地图墙、信标和雨雪。
3. 再到大型仓库、地图墙或森林区域比较帧率。
4. 如果出现物品展示框、树叶或模组方块缺面，只关闭对应项目，不要一次关闭全部剔除。

当前实例已启用

• 云、雨雪、告示牌文字、画和信标光柱剔除
• BlockState Culling
• 自定义展示框渲染器
• 展示框地图剔除和 LOD，LOD 距离为 16
• 三面展示框剔除
• 默认树叶剔除模式
• 默认允许作用于模组方块

与 EntityCulling 的区别

• EntityCulling：判断整个实体或方块实体是否被墙遮挡。
• More Culling：减少模型内部、背面、远距离展示框、树叶和天气等不需要绘制的部分。
• 两者可以同时使用；发生显示异常时需要分别测试，不能只关闭其中一个就认定问题已排除。

排错

• 某个方块出现透明洞：关闭 BlockState Culling，或把方块 ID 加入 dontCull。
• 地图墙远处内容过早消失：关闭 Item Frame LOD 或增大 LOD Range。
• 树叶视觉不自然：切换 Leaves Culling Mode，或恢复 Default。
• 修改后仍异常：使用配置界面的 Reset Cache，或完全重启游戏。

依赖关系

• cloth-config：>=15.0.0

配置与数据位置

• config/moreculling.toml

官方资料

• 项目主页或官方文档

Dynamic FPS（动态帧率）#

游戏失焦、最小化或闲置时降低帧率和资源占用。

• 模组 ID：dynamic_fps
• 当前版本：3.11.4
• 运行环境：仅客户端

快捷键

使用方式 切出游戏窗口后，模组会按配置降低 FPS、音量或暂停部分渲染。关闭单人世界的失焦暂停后，它适合挂机时切到其他程序，可减少显卡功耗和风扇噪音。

生电挂机

当前实例的 options.txt 为 pauseOnLostFocus:true，直接切出窗口会让单人世界暂停。需要挂机时先按 F3 + P 关闭“失去焦点时暂停”，并在聊天提示或 options.txt 中确认状态已经变为 false。

Modern UI 当前也设置了失焦 30 FPS、失焦音量 0.5 和最小化音量 0.25。它与 Dynamic FPS 的后台限制功能重叠，建议只让其中一个负责失焦帧率和音量，避免设置互相覆盖。Dynamic FPS 可以在 Mod Menu 中调整失焦 FPS、音量和状态提示。

推荐与注意事项

• 客户端降帧不等于服务器停止。
• 长时间挂机仍应监控温度和存档备份。

依赖关系

• mixinextras：>=0.3.2
• fabric-resource-loader-v0：*
• fabric-lifecycle-events-v1：*

配置与数据位置

• Dynamic FPS 配置（通过 Mod Menu）

官方资料

• 项目主页或官方文档

Iris（光影加载器）#

在 Sodium 环境中加载兼容光影包。

• 模组 ID：iris
• 当前版本：1.8.14-beta.1+mc1.21.1
• 运行环境：仅客户端

快捷键

使用方式 按 K 快速开关光影，按 O 打开光影包选择。当前配置已选择 photon_v1.2a.zip，但 enableShaders=false，即默认关闭。

建筑展示 施工时关闭光影获得稳定帧率；完成后再开启光影截图。调整阴影距离、体积云、反射和抗锯齿时，每次只改一组设置。

快捷键冲突 O 与 JEI 的显示开关冲突，R 与 JEI 查看配方冲突。建议把 Iris 光影包界面改为 Ctrl + O，重载改为 Ctrl + R。

推荐与注意事项

• 光影警告通常来自光影包本身的选项或版本兼容。
• 更新 Iris 时同步核对 Sodium 与光影包版本。
• 生电测试真实光照时关闭光影与动态光源。

依赖关系

• sodium：0.8.x

配置与数据位置

• config/iris.properties
• shaderpacks/

官方资料

• 项目主页或官方文档

LambDynamicLights（动态光源）#

手持或掉落发光物品时产生客户端动态照明。

• 模组 ID：lambdynlights
• 当前版本：4.8.10+1.21.1
• 运行环境：仅客户端

快捷键

使用方式 手持火把、灯笼等光源移动时，周围会出现动态照明。当前模式为 Fancy，并启用了实体、自身、光效实体等光源。

生电注意 动态光源不会改变世界真实方块光，也不会阻止刷怪。检查刷怪平台时必须使用 MiniHUD 或 F3 读取真实光照。

性能 大型掉落物、实体农场或大量光源实体可能增加区块重建。卡顿时先切换到较简单模式或关闭实体动态光源。

推荐与注意事项

• 建议为开关绑定快捷键，施工展示时开，刷怪测试时关。
• 不要把动态光源当成实际照明。

依赖关系

• lambdynlights_runtime：>=4.8.10+1.21.1

配置与数据位置

• config/lambdynlights.toml

官方资料

• 项目主页或官方文档

Clumps（经验球合并）#

把附近经验球合并，降低经验农场产生的实体数量。

• 模组 ID：clumps
• 当前版本：19.0.0.1
• 运行环境：客户端与服务端/通用

快捷键

该模组没有需要玩家操作的快捷键，或当前没有绑定快捷键。

使用方式 安装后自动生效，没有快捷键。经验球会按模组逻辑合并，减少大量经验实体造成的卡顿。

生电测试注意 如果要测量原版经验球生成、合并、拾取速度或实体数量，应暂时移除 Clumps 后再测试。日常使用经验农场时保留可显著降低实体压力。

推荐与注意事项

• 它会改变经验球实体表现。
• 不要把装有 Clumps 的测试结果直接当作纯原版性能数据。

依赖关系

• 无额外模组依赖，或依赖已打包在模组内部。

配置与数据位置

• 通常不生成需要玩家维护的独立配置文件。

官方资料

• 项目主页或官方文档

Ixeris（多线程优化）#

缓冲原始输入、把事件轮询挪到独立线程，减少主线程输入处理卡顿。

• 模组 ID：ixeris
• 当前版本：4.6.5+1.21.1-fabric
• 运行环境：客户端；适配 MC 1.21–1.21.1

怎么用

安装即生效，无按键。对键鼠输入密集的操作（连点、快速切栏）更跟手。

推荐与注意事项

• 很底层的输入优化，一般不用配。
• 若出现按键“吃输入”或粘键，先禁用它复现。

依赖关系

• Fabric Loader ≥ 0.16.0

配置与数据位置

• config/ixeris.toml

官方资料

• 项目主页或官方文档

Super Resolution（超分辨率）#

低分辨率渲染再放大，换帧率。OpenGL 路径的超分实验特性，当前是 alpha。

• 模组 ID：super_resolution
• 当前版本：0.9.1-alpha.1+opengl
• 运行环境：客户端；依赖 Fabric API；Java ≥ 21

快捷键

怎么用

1. 按 F6（或改绑后的键）打开配置。
2. 选择渲染缩放比，帧率上去了、画面会糊一点。
3. 光影、大型资源包场景下收益更明显，也更容易出兼容问题。

推荐与注意事项

• alpha 品质，当实验特性用，别当稳定依赖。
• 与 Iris/光影、Modern UI、Sodium 同开时先小范围试。
• 画面闪烁、UI 错位时优先关它。
• 与 Zoomify 的 F6 冲突，先改键再日常用。

依赖关系

• fabric-api
• Java ≥ 21

配置与数据位置

• config/super_resolution/

官方资料

• 项目主页或官方文档

Entity Texture Features（实体纹理特性 / ETF）#

让资源包驱动实体纹理：随机皮肤、自发光、眨眼、玩家皮肤扩展等 OptiFine 向特性。

• 模组 ID：entity_texture_features
• 当前版本：7.1
• 运行环境：仅客户端

怎么用

安装后配合支持 ETF 的资源包即可。支持 OptiFine 风格的随机/自定义纹理与自发光纹理。

推荐与注意事项

• 和 Continuity、自定义实体模型资源包是一套视觉链路。
• 纹理异常时按“资源包 → ETF → EMF”顺序排查。

依赖关系

• 无强制模组依赖（EMF 依赖它）

配置与数据位置

• config/entity_texture_features.json
• config/etf_warnings.json

官方资料

• 项目主页或官方文档

Entity Model Features（实体模型特性 / EMF）#

ETF 的扩展，支持 OptiFine 格式的自定义实体模型（CEM）资源包。

• 模组 ID：entity_model_features
• 当前版本：3.2.4
• 运行环境：仅客户端；依赖 ETF ≥ 7.1

怎么用

与 ETF 一起装，再加支持 CEM 的资源包，实体就能换自定义模型。

推荐与注意事项

• 必须先有 ETF，单独丢它进 mods/ 会缺依赖。
• 和其他模型替换模组互斥时，二选一。

依赖关系

• entity_texture_features：>=7.1

配置与数据位置

• config/entity_model_features.json

官方资料

• 项目主页或官方文档

Fabric API#

Fabric 生态最常用的基础 API 集合，为大量模组提供事件、资源、网络和渲染接口。

• 模组 ID：fabric-api
• 当前版本：0.116.14+1.21.1
• 运行环境：客户端与服务端/通用

快捷键

该模组没有需要玩家操作的快捷键，或当前没有绑定快捷键。

玩家需要做什么 无需快捷键和日常操作。只要版本与 Minecraft 1.21.1、Fabric Loader 匹配并放在 mods 目录即可。

排错 如果启动提示缺少某个 fabric-* 模块，优先确认 Fabric API 是否存在、版本是否正确、文件是否损坏。不要从 Fabric API 大包中手工删除子模块。

推荐与注意事项

• 本整合包的核心依赖，不建议移除。
• 更新时确认仍支持 Minecraft 1.21.1。

依赖关系

• 无额外模组依赖，或依赖已打包在模组内部。

配置与数据位置

• config/fabric/（部分模块可能生成）

官方资料

• 项目主页或官方文档

MaLiLib#

Litematica、MiniHUD 和 Tweakeroo 的配置、渲染、热键与 GUI 前置库。

• 模组 ID：malilib
• 当前版本：0.21.10
• 运行环境：仅客户端

快捷键

使用方式 普通玩家主要通过 A + C 打开 MaLiLib 配置列表，然后进入 Litematica、MiniHUD、Tweakeroo 等模组设置。多数功能由上层模组提供。

热键编辑 MaLiLib 热键支持组合键、按下/按住/切换等触发方式。编辑快捷键时点击对应按钮，再按下完整组合；右键通常可清除或打开高级热键设置。

推荐与注意事项

• 三个 Masa 工具任意一个存在就必须保留 MaLiLib。
• 配置损坏时先备份 config，再重置单个模组文件。

依赖关系

• fabric-networking-api-v1：>=4.2.0
• fabric-resource-loader-v0：*

配置与数据位置

• config/malilib.json

官方资料

• 项目主页或官方文档

Placeholder API#

向模组提供可替换的文本占位符，例如玩家、世界和服务器信息。

• 模组 ID：placeholder-api
• 当前版本：2.4.2+1.21
• 运行环境：客户端与服务端/通用

快捷键

该模组没有需要玩家操作的快捷键，或当前没有绑定快捷键。

玩家需要做什么 没有独立快捷键，通常由其他模组在 HUD、消息、地图标记或文本格式中调用。普通玩家无需配置。

内容作者 支持它的配置中可能出现类似占位符表达式；具体格式由调用它的模组决定。

推荐与注意事项

• 当前没有明显的直接操作入口。
• 移除前先确认所有 HUD、地图和服务器工具不再依赖。

依赖关系

• 无额外模组依赖，或依赖已打包在模组内部。

配置与数据位置

• 通常不生成需要玩家维护的独立配置文件。

官方资料

• 项目主页或官方文档

Architectury API#

让跨 Fabric/Forge 平台模组共享代码的运行库。

• 模组 ID：architectury
• 当前版本：13.0.11
• 运行环境：客户端与服务端/通用

快捷键

该模组没有需要玩家操作的快捷键，或当前没有绑定快捷键。

玩家需要做什么 无需操作。本整合包中主要服务于 FTB Library 与 FTB Ultimine。启动器会根据模组声明检查依赖。

是否能删除 只有在移除所有依赖 Architectury 的模组后才能删除。

推荐与注意事项

• 前置库本身通常不会添加可见功能。
• 版本不匹配会在启动阶段直接报错。

依赖关系

• fabric-api：>=0.100.0

配置与数据位置

• 通常不生成需要玩家维护的独立配置文件。

官方资料

• 项目主页或官方文档

Cardinal Components API#

为实体、世界、物品等对象附加持久化组件数据。

• 模组 ID：cardinal-components
• 当前版本：6.1.3
• 运行环境：客户端与服务端/通用

快捷键

该模组没有需要玩家操作的快捷键，或当前没有绑定快捷键。

玩家需要做什么 没有快捷键。本整合包中主要被 Trinkets 使用，用于保存额外装备槽及相关数据。

卸载风险 删除依赖它的内容模组前，先清空额外装备槽。直接移除可能让保存于组件中的数据暂时不可访问。

推荐与注意事项

• 只要 Trinkets 仍在就应保留。
• 不要手工编辑存档中的组件数据。

依赖关系

• 无额外模组依赖，或依赖已打包在模组内部。

配置与数据位置

• config/cardinal-components-api.properties

官方资料

• 项目主页或官方文档

Cloth Config#

为模组提供统一的配置界面组件。

• 模组 ID：cloth-config
• 当前版本：15.0.140
• 运行环境：客户端与服务端/通用

快捷键

该模组没有需要玩家操作的快捷键，或当前没有绑定快捷键。

玩家需要做什么 Cloth Config 不提供独立玩法，通常在 Mod Menu 点击其他模组的“配置”按钮时被调用。本整合包中的 Neat 等模组依赖它。

排错 配置界面打不开时检查 Cloth Config 版本和对应模组的依赖要求。

推荐与注意事项

• 只要 Neat 或其他依赖者仍在就应保留。
• 它与配置文件内容不是同一概念。

依赖关系

• 无额外模组依赖，或依赖已打包在模组内部。

配置与数据位置

• 通常不生成需要玩家维护的独立配置文件。

官方资料

• 项目主页或官方文档

Forge Config API Port#

把 Forge/NeoForge 风格的配置系统移植到 Fabric，供 Modern UI 等跨加载器模组读取、保存和同步配置。

• 模组 ID：forgeconfigapiport
• 当前版本：21.1.6
• 运行环境：客户端与服务端/通用

快捷键

没有独立快捷键，它是配置前置库。

玩家需要做什么

普通玩家不需要直接操作。打开 Modern UI 配置中心、修改配置并保存时，它在后台提供 Forge 风格的配置加载能力。

是否能删除

当前 Modern UI 明确依赖 Forge Config API Port，因此不能单独删除。只有移除所有依赖它的模组后，才可以从 mods/ 中移除。

配置和默认配置

• config/forgeconfigapiport.toml 控制配置文件监听器等基础行为。
• defaultconfigs/ 可为新世界提供默认服务端配置。
• 当前文件监听器处于开启状态，手工修改配置可能触发自动重载；重要修改前仍应备份。

排错

• 启动提示缺少 forgeconfigapiport：确认 JAR 存在并适配 Minecraft 1.21.1。
• Modern UI 配置无法保存：检查配置目录写入权限和 TOML 语法。
• 不要把它当成 Forge 加载器；它只移植配置 API，不会让 Fabric 直接运行任意 Forge Mod。

依赖关系

• fabric-api：>=0.102.0
• Java：>=17

配置与数据位置

• config/forgeconfigapiport.toml
• defaultconfigs/

官方资料

• 项目主页或官方文档

Fabric Language Kotlin#

为使用 Kotlin 编写的 Fabric 模组提供运行时与语言适配。

• 模组 ID：fabric-language-kotlin
• 当前版本：1.13.13+kotlin.2.4.10
• 运行环境：客户端与服务端/通用

快捷键

该模组没有需要玩家操作的快捷键，或当前没有绑定快捷键。

玩家需要做什么 没有快捷键和配置。本整合包中的 Zoomify、Inventory Profiles Next/libIPN 等需要 Kotlin 运行环境。

排错 提示缺少 Kotlin 或版本过低时，应更新 Fabric Language Kotlin，而不是单独下载 Kotlin 标准库文件。

推荐与注意事项

• 文件较大是因为包含 Kotlin 运行库，属于正常情况。
• 保留 Zoomify 或 Inventory Profiles Next 时不能移除。

依赖关系

• 无额外模组依赖，或依赖已打包在模组内部。

配置与数据位置

• 通常不生成需要玩家维护的独立配置文件。

官方资料

• 项目主页或官方文档

FTB Library#

FTB 系列模组共用的配置、网络、界面和数据功能库。

• 模组 ID：ftblibrary
• 当前版本：2101.1.33
• 运行环境：客户端与服务端/通用

快捷键

该模组没有需要玩家操作的快捷键，或当前没有绑定快捷键。

玩家需要做什么 普通玩家无需单独操作。本整合包中由 FTB Ultimine 使用，相关配置以 SNBT 文件呈现。

是否能删除 只有移除 FTB Ultimine 等全部 FTB 依赖模组后才能删除，并通常可同时检查 Architectury 是否仍被需要。

推荐与注意事项

• FTB Library 本身不是连锁挖掘功能。
• 不要把服务端配置与客户端配置混用。

依赖关系

• fabric：>=0.102.1+1.21.1
• architectury：>=13.0.6

配置与数据位置

• config/ftblibrary-client.snbt

官方资料

• 项目主页或官方文档

libIPN#

Inventory Profiles Next 的核心逻辑、配置和排序前置库。

• 模组 ID：libipn
• 当前版本：6.6.3
• 运行环境：仅客户端

快捷键

该模组没有需要玩家操作的快捷键，或当前没有绑定快捷键。

玩家需要做什么 无需单独打开。Inventory Profiles Next 的排序、补货、锁定和配置档功能依赖它。

配置关系 部分 IPN 设置和规则保存在 config/libIPN，备份 Inventory Profiles Next 配置时应连同该目录一起备份。

推荐与注意事项

• 保留 Inventory Profiles Next 时必须保留。
• 升级时确保 libIPN 与 IPN 要求的版本范围匹配。

依赖关系

• fabric-language-kotlin：>=1.13.7+kotlin.2.2.21

配置与数据位置

• config/libIPN/

官方资料

• 项目主页或官方文档

Searchables#

为 Controlling 等模组提供通用搜索框和筛选组件。

• 模组 ID：searchables
• 当前版本：1.0.2
• 运行环境：仅客户端

快捷键

该模组没有需要玩家操作的快捷键，或当前没有绑定快捷键。

玩家需要做什么 没有独立快捷键。进入控制设置使用 Controlling 的搜索功能时，Searchables 在后台提供搜索组件。

是否能删除 只要 Controlling 存在就应保留。

推荐与注意事项

• 启动报缺少 Searchables 时不要忽略，否则 Controlling 无法加载。

依赖关系

• 无额外模组依赖，或依赖已打包在模组内部。

配置与数据位置

• 通常不生成需要玩家维护的独立配置文件。

官方资料

• 项目主页或官方文档

YetAnotherConfigLib（YACL）#

为 Zoomify 等模组提供现代化配置界面。

• 模组 ID：yet_another_config_lib_v3
• 当前版本：3.8.2+1.21.1-fabric
• 运行环境：客户端与服务端/通用

快捷键

该模组没有需要玩家操作的快捷键，或当前没有绑定快捷键。

玩家需要做什么 YACL 通常没有独立入口。通过 Mod Menu 打开 Zoomify 等模组配置时会使用它提供的界面。

配置 config/yacl.json5 保存 YACL 自身的界面行为，例如颜色选择器提示和复杂图片预加载。

推荐与注意事项

• 保留 Zoomify 时必须保留符合版本要求的 YACL。
• YACL 与 Modern UI 可以同时存在：YACL 为其他 Mod 构建配置页面，Modern UI 负责全局界面和文字渲染。

依赖关系

• fabric-api：>=0.104.0+1.21.1

配置与数据位置

• config/yacl.json5

官方资料

• 项目主页或官方文档

启动提示缺少依赖#

启动错误通常会写出缺少的 Mod ID 和版本范围。按照日志提示补齐依赖，不要只根据 JAR 文件名猜测。

快捷键没有反应#

1. 使用 Controlling 搜索功能名称。
2. 检查功能是否未绑定或存在冲突。
3. 检查 Masa 系模组总开关是否关闭。
4. 确认组合键的前缀键和触发顺序。
5. 确认服务器是否安装对应模组或允许该功能。

画面、HUD 或实体显示异常#

依次测试：资源包 → Iris 和光影 → Sodium → EntityCulling → MiniHUD、Jade、Neat → 动态光源。每次只改变一个变量，才能定位真正原因。

存档无法进入#

• 先复制存档，再开始排错。
• 查看日志中最早出现的异常，而不只是最后一行。
• 检查最近是否移除了添加方块、物品、装备槽或数据组件的模组。
• 恢复最近一次可用的模组和配置组合后再测试。

语言列表为空#

如果 options.txt 已设置 lang:zh_cn，但语言列表仍完全为空，通常是共享资源没有下载完整。

1. 完全关闭游戏。
2. 使用启动器的“检查文件”“补全文件”或“重新下载资源”。
3. 确认启动器检查了共享的 .minecraft/assets/，而不是只下载版本 JAR。
4. 重点检查 assets/indexes/ 和 assets/objects/。
5. 补全资源后重新启动。

语言或按键无法保存#

查看 logs/latest.log 是否出现 Error saving option。常见原因包括配置文件只读、目录没有写入权限、模组持续覆盖选项，或 Gamma、亮度值超出原版允许范围。

必要时先备份 options.txt，再让游戏重新生成。