环境要求#

• 使用 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。
• ****：JourneyMap 小地图预设与 Tweakeroo 工具切换存在冲突。
• C：Trade Cycling 与部分模组默认配置入口可能冲突。
• 左 Alt：Litematica、MiniHUD、Tweakeroo 多处作为修饰键，操作前确认当前工具模式。

建议的未绑定功能#

• EntityCulling 开关：建议绑定仅用于排错的组合键。
• LambDynamicLights 开关：建议绑定，刷怪测试前快速关闭。
• Neat 血条开关：建议绑定，截图和大型实体农场时关闭。
• Dynamic FPS 强制/禁用：一般保持未绑定即可。

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

官方资料

• 项目主页或官方文档

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. 出现目标交易后完成一次交易，将职业和交易锁定。

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

推荐与注意事项

• 只对尚未锁定交易的村民有效。
• 确保工作站可被正常破坏、重新放置且村民能寻路绑定。
• 多人服务器必须允许对应行为。

依赖关系

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

配置与数据位置

• config/trade_cycling/

官方资料

• 项目主页或官方文档

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/

官方资料

• 项目主页或官方文档

Shulker Box Tooltip（潜影盒预览）#

在物品提示框中直接预览潜影盒和其他容器物品，适合建筑材料管理。

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

快捷键

基础使用 把鼠标停在物品栏、箱子或 JEI 界面中的潜影盒上：按住 Shift 显示紧凑预览；按住 Alt + Shift 显示完整 9×3 槽位布局；预览出现后按住左 Ctrl 锁定提示框，即可把鼠标移入预览并查看内部物品的详细提示。

建筑材料工作流

1. 给潜影盒使用铁砧命名，例如“石材”“红石元件”“深板岩”。
2. 配合颜色分类潜影盒。
3. 在仓库中直接按 Shift 检查，无需反复放置和打开。
4. 与 Litematica 材料列表搭配，快速确认每个盒子携带的材料。

配置 通过 Mod Menu 选择 Shulker Box Tooltip 并点击齿轮，可调整预览模式、颜色、容器类型和锁定方式。配置文件会在首次启动后生成到 config/shulkerboxtooltip.json5。

推荐与注意事项

• 当前安装版本为 5.1.3+1.21.1。
• 若 Shift 没反应，检查是否被其他 Tooltip 模组占用。
• 该模组主要是显示增强，不会修改潜影盒数据。

依赖关系

• fabric-resource-loader-v0：*

配置与数据位置

• config/shulkerboxtooltip.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

官方资料

• 项目主页或官方文档

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

官方资料

• 项目主页或官方文档

CustomSkinLoader（万用皮肤补丁）#

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

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

快捷键

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

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

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

推荐与注意事项

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

依赖关系

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

配置与数据位置

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

官方资料

• 项目主页或官方文档

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

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

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

快捷键

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

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

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

推荐与注意事项

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

依赖关系

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

配置与数据位置

• config/lsp.json

官方资料

• 项目主页或官方文档

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

官方资料

• 项目主页或官方文档

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 没有关系。
• 修改 mixin 后必须完全退出并重新启动游戏。

依赖关系

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

配置与数据位置

• config/modernfix-mixins.properties

官方资料

• 项目主页或官方文档

EntityCulling（实体遮挡剔除）#

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

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

快捷键

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

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

推荐与注意事项

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

依赖关系

• fabric-api：*

配置与数据位置

• config/entityculling.json

官方资料

• 项目主页或官方文档

Dynamic FPS（动态帧率）#

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

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

快捷键

使用方式 切出游戏窗口后，模组会按配置降低 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 的测试结果直接当作纯原版性能数据。

依赖关系

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

配置与数据位置

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

官方资料

• 项目主页或官方文档

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 或其他依赖者仍在就应保留。
• 它与配置文件内容不是同一概念。

依赖关系

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

配置与数据位置

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

官方资料

• 项目主页或官方文档

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 混淆。

依赖关系

• 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，再让游戏重新生成。