资源中心

**Xaero的小地图 (Xaero's Minimap)** 这款模组能够在你的屏幕角落展开一副详尽的战术图表，实时显示周边的地形地貌、玩家动向、生物群落以及各类实体信息。它赋予你创建“路径点”的能力，指引你从容寻回曾经涉足的地点。 ### 警示：切勿将 XaeroPlus 与本模组混用！ 请务必注意，XaeroPlus 并非本人开发，且与官方毫无关联。该第三方插件会引发难以追踪的严重错误乃至游戏崩溃。更令人担忧的是，据称它与某些服务器破坏团伙存在瓜葛，这可能会导致你在服务器中的建筑成果面临极大风险。 与市面上众多同类模组不同，Xaero的小地图极其注重保留 **原版 Minecraft 的美学风格**，旨在成为游戏界面中浑然天成的一部分，而非突兀的附加组件。值得一提的是，它是 **Minecraft 历史上首个采用旋转方形设计的地图模组**。在极其丰富的自定义选项中，你依然可以选择传统的 **圆形地图**，或者设定 **锁定地图旋转**（转而使用方向箭头来指示方位）。 雷达系统能够以 **自定义颜色的圆点** 或 **图标（通常是头像）** 的形式，精准显示周围的实体，涵盖 **玩家、生物及掉落物**。除了提供基础的 **指南针方位**，你还可以自行部署 **路径点**，这些标记将在小地图和游戏世界中同步显现。路径点不仅能助你重返旧地或抵达特定坐标，更支持 **传送功能**。此外，该模组具备透视能力，能够显示地表之上的结构以及地下的深邃环境（即 **洞穴模式**）。 这仅仅是该模组众多特性中的冰山一角。为了全面了解其潜能，请详细阅读下方的“小地图特性”章节。为了适应多人服务器的规则环境，本模组提供了两个版本：完整版与公平竞争版（Fair-play），后者专为公平 PVP 环境设计。**本模组主要在客户端运行。将其安装在服务端并非必须，但能解锁诸如“世界识别”等额外功能。** **特性概览** * **完美复刻原版 Minecraft 的视觉风格**。 * 提供多种小地图尺寸选项，包括自动调整模式。 * 具备多级缩放功能，视野掌控随心所欲。 * 两种地图形状可供选择：**方形或圆形**。 * **性能优化卓越**，运行流畅度超越市面上绝大多数同类竞品。 * 通过“更改位置”设置，你可以将地图安置在屏幕的任意角落。甚至支持以 1 像素为单位的微调，这在与其他 UI 模组共存时尤为实用。 * 两种方块颜色模式：**原版模式**（采用原版地图颜色）和 **精准模式**（直接采用方块纹理和生物群系的颜色）。你还可以在原版模式下单独开启生物群系着色。 * 支持自定义按键（默认为 Z 键）暂时放大地图，以便更清晰地观察周围环境。**所有按键绑定均位于原版控制菜单中。** 此外，你还可以定制放大时的行为，例如让地图居中显示或自动切换至最大缩放级别。 * 通过“地形深度”和“地形坡度”设置，你可以自定义地图的阴影效果，增强立体感。 * 与 **Xaero的世界地图 (Xaero's World Map)** 完美兼容。默认情况下，它会直接调用世界地图模组生成的纹理，而非重复加载，从而在使用双模组时显著提升性能。 * 支持服务端配置，并提供游戏内 UI 界面。你可以实时管控服务器上玩家使用模组的权限。支持基于等级/权限系统的管理（`xaero.minimap.enforced_server_profile`），兼容 FTB Ranks、Odyssey Roles、LuckPerms 以及通用权限 API。 * 支持通过绑定特定物品来限制小地图的使用。例如，在配置文件中添加 `minimapItemId:minecraft:compass`，即可实现只有当玩家在快捷栏持有或装备指南针时，小地图才会显示。 * 引入药水效果机制，用于控制服务器/地图中玩家的小地图功能权限。目前支持的效果包括：`xaerominimap:no_minimap`（禁用地图）、`xaerominimap:no_entity_radar`（禁用雷达）、`xaerominimap:no_waypoints`（禁用路径点）、`xaerominimap:no_cave_maps`（禁用洞穴图）。这些效果默认为中性，但你也可以通过在 ID 后添加 `_harmful`（如 `xaerominimap:no_entity_radar_harmful`）将其指定为有害类型。 * 已被翻译成多种语言，打破语言壁垒。 * 支持 **锁定北方** 选项，停止地图旋转，转而用箭头指示角色朝向。 * 得益于 **自动洞穴模式**，无论是地表还是地下探索均能应对自如。该模式在进入建筑物内部时也应能自动激活。你可以自定义触发洞穴模式所需的“实体屋顶”尺寸。例如，设置 3x3 及以上的屋顶尺寸，可以防止你在砍树站在原木下时误触洞穴模式。 * **路径点系统**。支持创建几乎无限数量的路径点。若拥有传送指令权限，可直接传送至路径点。这些标记将在游戏世界内渲染并在小地图上高亮。你可以隐藏全部或特定的路径点。按 **B** 键创建新路径点，按 **U** 键列出所有路径点。在列表中，你可以管理单点或多点，进行排序，或查看其他子世界/维度的路径点。 * **局部与全局路径点机制。** 为了避免屏幕杂乱，你可以创建受“最大绘制距离”限制的局部路径点。这允许你为大区域设置一个全局路径点，而在区域内部设置多个局部路径点。当你超出绘制距离时，仅全局路径点可见。 * **路径点集管理。** 你可以通过将路径点归类到不同的“集”中来组织它们，并通过按键快速切换当前的路径点集。**所有按键绑定均在原版控制菜单中。** * **路径点分享功能。** 你可以在游戏聊天栏中与服务器上的其他玩家分享你的路径点，此操作在路径点列表（按 U）中进行。 * **死亡标记**。每次角色死亡时，系统会自动在死亡地点创建一个 **骷髅形状的路径点**。旧的死亡点会自动转换为普通路径点，如果不希望保留，可以通过“保留旧死亡点”设置将其禁用。 * 支持显示来自 **Open Parties and Claims** 模组的区块声明和盟友玩家。 * 可切换的 **区块网格**。网格线将清晰标示区块的起始与结束位置。 * 可切换的 **史莱姆区块** 模式。能够生成史莱姆的区块将覆盖绿色显示。 * **自定义光照覆盖层**。你可以设置一个光照覆盖层，用自定义颜色标记特定光照范围内的方块（默认为 0 到 7）。此功能本来用于寻找怪物生成的温床，但你也可以将其用于任何用途。 * 多人游戏中的多世界检测。若在服务端同时也安装了本模组，每个服务器世界不仅会有独立的世界地图，还将拥有独立的路径点“子世界”。若未能安装服务端模组，则会采用基于世界出生点的可靠性较低的分离方案。如果服务器只有一个“单一世界”，建议关闭多世界检测。此选项位于 **路径点菜单（按 U） -> 选项** 界面。 * **生物雷达**：在地图上将 **生物** 显示为 **黄色圆点**。**敌对与友好** 生物可配置 **不同颜色**。亦支持显示为 **图标/头像**。请查阅 **“实体雷达”** 设置。 * **玩家雷达**：在地图上将 **玩家** 显示为 **白色圆点或玩家头像**。亦支持显示为 **图标/头像**。请查阅 **“实体雷达”** 设置。 * **物品雷达**：在地图上将 **掉落物** 显示为 **红色圆点**。请查阅 **“实体雷达”** 设置。 * 显示所有 **其他实体**（如箭矢和物品展示框）为 **紫色圆点**，且支持在设置中禁用特定类型的实体。请查阅 **“实体雷达”** 设置。 * 在“实体雷达”设置中，提供 **在小地图上显示实体名称** 的选项。 * 支持放大和缩小按键 **（默认为 I 和 O）**，以便高效调整缩放级别以适应你的使用场景。 * 小地图下方显示 **坐标**。 * 小地图下方显示 **当前生物群系名称**。默认禁用，需在设置中开启（按 Y）。 * 小地图下方显示 **光照等级**。同样默认禁用，需手动开启。 * 小地图下方显示 **当前游戏时间**。默认禁用，支持 12 小时制和 24 小时制。 * 小地图下方显示 **当前视角角度**。默认禁用。 * 支持一键隐藏/取消隐藏所有界面中的路径点坐标，这对于直播或视频录制非常有用。 * 支持完全隐藏/取消隐藏下拉菜单中提及的所有服务器地址。默认设置为“部分隐藏”，这在大多数情况下能够提供足够的隐私保护。 * **海量设置选项**。功能繁多，不胜枚举。请在游戏中按 **Y** 键打开设置界面亲自探索。 * 两个模组版本：完整版与公平竞争版。**完整版** 功能无限制。**公平竞争版** 不显示任何实体或洞穴地图，更适合与不使用小地图的玩家进行 PVP 对抗。 **常见问题解答 (FAQ)** **为何路径点传送功能对我失效？** 造成此现象的原因可能多种多样。该模组通过发送聊天命令来执行传送操作，默认指令为 `/tp @s x y z`，因此你必须拥有相应的权限。原版的 `/tp` 命令通常需要管理员权限（作弊开启），但在非原版服务器上，通过特定插件可能拥有独立的命令权限。如果是指令不匹配，你可以在小地图设置中的“默认传送命令”选项，或在路径点菜单的“传送聊天命令”选项中（针对特定服务器）进行更改。非原版传送指令通常不支持 `@s` 这样的选择器，因此你可能需要从配置的命令中移除它。此外，世界地图上的右键传送使用的是另一套独立设置，详情请参阅世界地图说明页面的 FAQ。 如果“传送”按钮呈现为灰色禁用状态，这也暗示了多种可能性。最常见的原因是你正在尝试使用并非来自当前“自动（auto）”子世界、但同属一个维度的路径点。如果当前的“自动”子世界并非你应该使用的那个，请手动选中正确的子世界，并在路径点菜单的选项中点击“设为自动子世界（Make Sub-world Auto）”。这将交换两个子世界的数据，使你能够传送到现已归入“自动”子世界的路径点。 若“自动”子世界选择无误但按钮依旧禁用，那很可能是服务器或该世界手动禁用了传送功能。请检查路径点菜单选项中的传送开关。如果确被禁用，你只能通过修改游戏目录下 `xaero/minimap`（旧版本为 XaeroWaypoints）文件夹中的服务器特定配置文件来启用它。强烈建议在编辑任何配置文件前退出 Minecraft，并养成定期备份的习惯。 **为何我的路径点在特定服务器上神秘消失了？** 请保持冷静，你的数据几乎肯定没有被删除。如果你同时使用了世界地图模组且地图也发生了重置，请务必先参照世界地图描述页面 FAQ 中的 *“为何我的世界地图在特定服务器‘重置’了？”* 一节进行恢复。如果已完成该步骤，请继续阅读。 首先，按 U 键打开完整的路径点菜单（若 U 键无效请检查原版控制设置）。浏览右上角下拉菜单中列出的子世界。当前服务器地址的所有路径点子世界都应罗列于此。如果其中没有任何一个包含你当前所在维度的数据，那么很可能是服务器地址发生了变更。请在 **左上角** 的下拉菜单中找到旧的服务器地址，选中它，然后执行 *选项 -> 设为当前世界/服务器（Make World/Server Auto）*。此时，你应该能在右上角的菜单中找到正确的子世界了。如果该子世界已被标记为 (auto)，意味着它已被自动选中，那么问题应当已解决。若标记为 (auto) 的是错误的子世界，请继续阅读。 *正在使用世界地图模组？* 导致错误子世界被自动选中的最常见原因之一，是在多人游戏中未能正确使用世界地图模组（自 1.6 版本起）。请务必在确认前为当前世界选择正确的地图，这直接决定了哪些路径点会对你可见。地图选择菜单位于世界地图界面的左下角图标（除非默认已打开）。如果服务器环境允许，建议将地图选择模式更改为自动模式之一。 你当前确认的地图决定了哪个路径点子世界被视为“自动”。这允许每个创建的地图拥有独立的数据。在任何时候，你都可以通过路径点菜单（按 U）右上角的下拉列表查看非自动的子世界。若要将任意子世界绑定到当前地图并设为自动，请选择 *选项 -> 设为自动子世界*。 *未使用世界地图模组？* 如果错误的子世界被视为 (auto) 并自动选中，这通常是由于服务器插件改变了原版指南针的行为，从而干扰了模组的“多世界”检测功能（如果已开启该功能，默认是关闭的）。在此类情况下，指南针通常指向玩家床的位置而非世界出生点。如果是睡在另一张床上导致路径点消失，只需重新睡回原本的床通常能修复问题。 如果是由于新添加的插件导致（且无法移除该插件），你可以按以下步骤恢复路径点： 1. 在路径点界面的右上角下拉菜单中找到包含你所需数据的正确“子世界”（先从主世界尝试）。 2. 使用 *选项 -> 设为自动子世界*。 3. 对每个维度重复此操作（操作前需先进入对应维度！）。 4. 如果这是一个简单的单世界服务器（没有大厅世界、小游戏世界、创造地皮世界等），请在同一 *选项* 菜单中关闭“多世界检测”。日后若有需要，可随时重新开启。 *如有疑问，请随时联系我！* **如何添加自定义实体图标或覆盖默认图标？** **首要前提是：请确保你已在 小地图设置 -> 实体雷达类别 中启用了实体图标/头像显示，无论是设为“总是”还是“玩家列表”。你必须先知道如何显示它们，本节内容才对你有意义。** 从模组版本 21.6.0 开始，你可以通过制作资源包（或将其包含在你自己的模组中）来用自定义精灵图/图像覆盖实体的默认图标。此外，你还可以通过编写简单的模组或代码，为实体变体（即同一种实体的不同形态拥有不同图标）添加或改进支持。不过，对于大多数简单的多变体实体类型而言，这通常是不必要的。 默认情况下，小地图模组使用绑定到实体的渲染器/模型来渲染所有图标。这支持所有原版生物以及一些头部模型部件易于识别（如头、耳、鼻等）的简单双足/四足生物。如果模组无法识别，则会退而求其次显示彩色圆点。 用于覆盖图标的相关资源目录位于 `/assets/xaerominimap/entity/icon/`。你可以在模组的 jar 文件中找到此路径并提取文件作为参考。jar 包内包含一个示例文件 `/assets/xaerominimap/entity/icon/definition/example_mod/example_entity.json`，用于演示如何覆盖模组实体的图标。该文件对应假设存在的实体类型 `example_mod:example_entity`。请仔细阅读 `example_entity.json` 中的注释，了解其结构，以便创建你自己的图标定义文件。 此外，`/assets/xaerominimap/entity/icon/definition/minecraft/` 目录下包含多个原版实体类型的示例文件，其中可能包含关于默认实体变体支持的额外说明。默认情况下，实体变体支持非常简单，变体 ID 仅仅是实体的主纹理资源位置。 如果你在小地图配置文件中将 `debugEntityVariantIds` 选项设为 true，那么新遇到的实体（变体）的变体 ID 将会打印在聊天栏和日志/控制台中。 从版本 21.8.0 开始，你还可以配置自定义的基于模型的渲染。请阅读示例文件 `/assets/xaerominimap/entity/icon/definition/example_mod/example_entity.json` 中的注释以获取所需的全部信息。 如果你想查看自定义图标的实际应用案例或直接使用它，请查看 babybluetit 的这个精彩项目：`https://www.curseforge.com/minecraft/texture-packs/xaeros-minimap-modded-support` **如何在我的服务器上禁止使用洞穴模式和/或实体雷达？** 要实现此目的，请在服务端安装本模组（撰写本文时需 NeoForge/Forge/Fabric/Quilt 服务端）。 **_如果你的小地图版本至少为 25.3.0，请设置并使用“小地图服务器设置”按键绑定来打开服务器设置界面。你可以在那里强制执行几乎任何选项，包括洞穴模式、实体雷达，甚至创建自定义实体雷达类别。_** 在旧版本模组中，当你启动服务器时，服务器目录（非世界文件夹）的 config 文件夹中通常会生成一个新的“common”配置文件。在该文件中，你可以找到多个选项来禁用玩家的特定模组功能。更改后需要重启服务器。 另外，如果你无法安装该模组，可以在玩家登录时发送包含以下字符串的服务器/系统消息，这些隐藏代码将触发相应功能： **`§f§a§i§r§x§a§e§r§o`** - 强制客户端禁用洞穴模式（包括世界地图）和实体雷达（公平竞争模式）。 **`§x§a§e§r§o§m§m§n§e§t§h§e§r§i§s§f§a§i§r`** - 允许小地图洞穴模式在下界工作，即便处于公平竞争模式下。世界地图有一个几乎相同的独立代码。 **`§n§o§m§i§n§i§m§a§p`** - 完全禁用小地图。 **`§r§e§s§e§t§x§a§e§r§o`** - 重置所有系统消息标记。 这里有一个第三方 Spigot 插件可简化此操作（非本人制作）：XMMForceFairPlay 以及一个具有类似功能的第三方数据包（非本人制作）：Xaero's Map Server Utils *使用任何第三方插件风险自负。* **安装了模组的服务器如何允许原版客户端玩家加入？** 请在服务器目录（非世界文件夹）下的 config 文件夹中找到“common”配置文件，通常路径为 `config/xaero/minimap`。其中有一个选项允许你 **禁用状态效果的注册**，正是这种状态效果注册阻止了原版玩家的加入。更改设置后需要重启服务器。如果使用了世界地图模组，也请执行相同的操作。 **开发者指南** 若想将你的模组与本模组挂钩，首先请将以下仓库添加到你的构建脚本中： ```javascript repositories { maven { url "https://chocolateminecraft.com/maven" name "Xaero's Maven" } } ``` 如果你使用的是 Forge，请确保在你的项目中应用了 Mixin gradle 插件 (`org.spongepowered.mixin`)，除非你的版本是 1.12.2。 最后，添加以下一个或多个依赖声明，请将 `` 和 `` 替换为 `https://chocolateminecraft.com/maven/xaero/minimap` 页面上显示的实际值。 Forge (使用 1.21.1 之前的官方 Mojang 映射): ```javascript implementation "xaero.minimap:xaerominimap-forge-::dev"//特意不进行反混淆！ ``` Forge (使用 1.21.1 及之后的官方 Mojang 映射): ```javascript implementation "xaero.minimap:xaerominimap-forge-:" ``` Forge (使用其他映射): ```javascript implementation fg.deobf("xaero.lib:xaerolib-forge-:+") implementation fg.deobf("xaero.minimap:xaerominimap-forge-:") ``` Fabric: ```javascript modImplementation "xaero.minimap:xaerominimap-fabric-:" ``` NeoForge: ```javascript implementation "xaero.minimap:xaerominimap-neoforge-:" ``` 在多加载器设置中的“common”项目里: ```javascript compileOnly "xaero.minimap:xaerominimap-common-:" ```

动力航空 (Create Aeronautics)

作者：ryanhcode 模组类别：功能拓展

无论是打造翱翔天际的飞艇与飞机，还是构建驰骋大地的汽车与卡车，一切皆能在方块世界中实现。只要你有足够的构思，动力航空模组都能帮你将其变为现实。

关于本模组

动力航空是基于动力机械 (Create) 核心机制的深度扩展。通过引入 Sable 物理引擎，它赋予了玩家构建各类载具与复杂物理装置的无限可能。无论是想驾驶飞机环游世界、操控无人机进行侦察，还是为了在地面制造一辆能够行驶的卡车甚至奇特的机械怪杰，该模组都能提供所需的全部功能性组件。

本模组的内容主要涵盖以下三大板块：

模拟系统 (Simulated)：这是整个项目的基石。它提供了组装功能、红石控制元件，以及与物理模拟载具互动所必需的全套基础设施。 航空系统 (Aeronautics)：专为飞行爱好者打造。利用热气流、飞行螺旋桨以及赋予浮空能力的神秘矿石，助力玩家构建各式飞行器。 越野系统 (Offroad)：致力于地面载具的开发。你可以赋予各种类似车轮的部件实际的驱动功能，从而打造出功能齐全且外形各异的地面交通工具。

前置需求

若要启动并运行动力航空模组，必须确保在游戏环境中同时安装了以下两个必备模组：

动力机械 (Create) Sable

已知兼容性警告

请开发者与玩家注意，目前动力航空与 Iris 着色器 (Iris Shaders) 共同使用时，可能会产生视觉渲染方面的异常。

Just Enough Items (JEI) 的使用指南

Just Enough Items (JEI) 是专为 Minecraft 设计的一款物品与合成配方查看模组，其底层代码经过深度优化，旨在为您提供卓越的稳定性与流畅的交互性能。

操作指南

物品栏设置 (可通过 Minecraft 设置 -> 控制 菜单调整)

查看合成配方：将鼠标悬停在物品上方并按下 R 键。 查看物品用途：将鼠标悬停在物品上方并按下 U 键。 开关物品列表覆盖层：按下 Control + O 键。

物品列表交互

查看合成配方：左键点击物品，或选中后按下 R 键。 查看物品用途：右键点击物品，或选中后按下 U 键。 翻页：使用鼠标滚轮进行操作。

搜索功能

选择搜索栏：点击搜索条，或按下 Control + F。 清空当前搜索：右键点击搜索栏。 切换上一条搜索记录：按向上箭头键。 按模组名称搜索：在单词前加 @ 符号（例如：@thaum）。 组合搜索项：同时键入多个关键词（例如：wand @thaum）。 排除搜索项：在单词前加 - 符号（例如：@thaum -wand）。 搜索包含空格的术语：将词组包裹在引号内（例如："two words"）。

合成配方视图

翻页：使用鼠标滚轮。 查看所有合成配方：点击配方分类的名称。 将物品移入工作台：点击 [+] 按钮。若需移动多组，可启用 Shift+点击操作。

高级搜索语法

仅搜索工具提示内容：在单词前加 # 符号。 按矿物词典 (OreDict) 名称搜索：在单词前加 $ 符号。 按创造模式物品栏搜索：在单词前加 % 符号。 多重搜索：使用 | 字符分隔术语，例如 "wrench|hammer"。

作弊模式启用状态下

获取一组完整物品：左键点击物品。 获取单个物品：右键点击物品。 删除物品：将物品拖拽至物品列表区域即可。

物品列表编辑模式启用状态下 (相关控制按键会在游戏内物品信息提示中显示)

隐藏物品：Control + 左键点击该物品。 隐藏该物品及其子物品：Control + 右键点击该物品。 隐藏某个模组下的所有物品：Control + Shift + 左键点击该物品。

常见问题 (FAQ)

我可以将 JEI 添加到我的模组整合包中吗？ 当然可以！

JEI 可以仅在客户端运行，或者在原版服务器上使用吗？ 在 1.21.1 及以下版本中，答案是肯定的，不过部分功能将不可用：

“将物品移入工作台”的 [+] 按钮功能。 获取带有大量 NBT 数据的物品。 删除物品的功能。

关于 1.21.2 及以上版本：从 Minecraft 1.21.2 开始，服务器会负责存储合成配方而非客户端。因此，请务必在服务器端安装 JEI 和 NeoForge/Fabric，以便将配方数据同步至客户端。

Yes Steve Model 模组介绍

Yes Steve Model 是一款专为 Minecraft 打造的玩家模型修改模组，旨在为游戏提供深度定制化体验。该模组以 GeckoLib 动画引擎为技术底座，能够精确调用我的世界基岩版 (Minecraft Bedrock Edition) 的模型与动画资源，从而赋予玩家根据个人喜好自定义游戏内玩家模型和动作的灵活性。

平台支持情况

在该模组的发展过程中，技术架构经历了重要的演进。版本 1.1.5 及更早期的构建完全基于 Java 开发，因此具备极其出色的跨平台兼容性，能够同时运行于三大主流系统及移动端。

然而，为了提升运行效率并加强模组安全性，自 1.2.0 版本起，开发团队将核心的加密与渲染模块重构为 C++ 语言。这一战略性调整虽然显著强化了渲染性能与数据安全，但也导致了对跨平台支持的局限性。目前各系统的支持情况如下：

系统兼容性列表

Windows (AMD64 架构)：客户端与服务端均获得全面支持。 Linux (AMD64 架构)：客户端与服务端均获得全面支持。 Android (AArch64 架构)：支持客户端运行，但暂不支持服务端运行。 macOS (Intel 架构)：目前暂不支持。 macOS (Apple Silicon 架构)：目前暂不支持。 模组功能解析

Yes Steve Model 模组在设计之初便充分考量了服务器社区的实际运维需求，并专门集成了多项优化功能，确保其能够适应各种服务器环境：

客户端模型自动化同步：玩家在加入服务器时，系统会自动将模型资源推送并同步至客户端，无需玩家进行繁琐的手动下载。 模型文件加密保护：发送至客户端的所有模型文件均采用加密二进制格式，有效防止了模型资源被轻易窃取或篡改。 模型权限认证机制：模组引入了灵活的权限系统，服务器管理员（OP）可通过指令对特定模型进行授权管理，确保仅在许可情况下方可启用特定外观。 原版玩家模型增强：模组优化并新增了默认的史蒂夫 (Steve) 与亚历克斯 (Alex) 模型，且两者均支持自动调用玩家的皮肤显示，保持了原版特性与自定义功能的兼容。

得益于极简的定制逻辑，用户无需编写复杂的配置文件。只需将模型文件、纹理贴图及动画资源放置于指定文件夹内，并在游戏内执行重载指令，系统便能自动完成加载与同步。

客户端交互与使用说明

对于普通玩家而言，该模组的操作同样简便高效。当玩家首次进入配备此模组的服务器后，系统需要约十秒左右的时间用于模型同步。同步完成后，玩家仅需按下快捷键 Alt + Y 即可唤出交互界面，进行如下操作：

模型切换：点击按钮即可快速切换至目标模型。若按钮右上角的图标呈现红色，则意味着该模型尚未获得授权。此外，图标上的数字代表了该模型当前可供切换的材质数量。 纹理切换：针对拥有多种皮肤或材质的模型，玩家可通过点击左右切换按钮，轻松更换模型的外观样式。 模型分类管理：界面提供分类筛选功能，玩家可以在“全部模型”、“授权模型”以及“原版模型”（目前仅支持史蒂夫与亚历克斯）之间进行自由切换，以便快速找到心仪的外观。

Iris 光影加载器

重塑视觉体验的基石

在Minecraft的广阔世界中，光影效果往往是决定沉浸感的关键一环。Iris 光影加载器（Iris Shaders）正是为此而生的新一代图形引擎核心。它不仅仅是一个简单的工具，更是一把开启现代视觉盛宴的钥匙，专为那些追求极致画面与流畅体验的玩家量身打造。

兼容并蓄，无缝衔接

Iris 的设计哲学在于“传承与进化”。它天生具备强大的兼容性，能够完美支持现有的 OptiFine 光影包。这意味着，您无需抛弃那些钟爱的经典光影配置，便能在 Iris 的驱动下，让熟悉的光影焕发出前所未有的生机。无论是晨曦微露的柔和，还是末影龙息的震撼，Iris 都能以更高效的方式将其精准呈现。

现代化架构，性能飞跃

告别卡顿，拥抱丝滑。作为一个现代化的光影加载方案，Iris 采用了最前沿的代码架构，旨在打破传统加载器的性能瓶颈。它在确保画面绚丽的同时，极大地优化了帧率表现，让“高画质”与“高流畅度”不再是鱼与熊掌不可兼得的选择。

简而言之，Iris 光影加载器是连接原版画质与次世代视觉体验的桥梁，它既尊重过去的经典，又引领着未来的方向。

Cloth Config API (布料配置接口)

专为 Minecraft 模组打造的标准化配置库

Cloth Config API 不仅仅是一个简单的运行库，它是模组生态系统中至关重要的配置屏幕应用程序接口（API）。该工具旨在为模组开发者提供一套标准化的解决方案，用于构建清晰、易用的游戏内设置菜单，从而替代繁琐的配置文件编辑，大幅提升最终用户的交互体验。

开发者百科指南

https://shedaniel.gitbook.io/cloth-config/

3D皮肤图层 (3D Skin Layers)

让你的角色更加立体，赋予皮肤全新的视觉维度。

核心功能

本模组旨在取代原版游戏中扁平的玩家皮肤第二图层，将其替换为完全建模的3D版本。为了优化性能，模组内置了智能机制：当玩家距离超过12格时，会自动切换回原版的高效2D渲染模式，从而确保游戏帧率稳定。同时，该模组全面支持透明元素渲染，这意味着眼镜、护目镜及其他装饰性细节将完美呈现。

本模组仅在客户端运行，属于纯视觉模组，因此无需在服务器端安装，可在任何游戏环境中无缝使用。

让你的角色外观既具备深度，又兼顾性能与美观。

详细特性 将扁平的皮肤外层替换为完整的3D模型。 为夹克、袖口、帽子等装饰性细节增加视觉深度。 完美支持透明度渲染，适用于眼镜、护目镜等物品。 同样适用于玩家头部的装备。 性能表现 自动机制：距离超过12格时，自动切换回原版2D渲染。 性能优化：即便在多人服务器或玩家密集的区域，也能保持稳定的帧率。 部署便捷：完全客户端运行，无需服务器端安装。 兼容性概览 Minecraft版本 加载器 状态 备注 1.16.5+ Fabric/Forge*/NeoForge 支持 最新版 1.16.5 Forge 不支持 过时 在获得JarInJar支持前暂不支持 1.12.2/1.8.9 Forge 不支持 过时 未来可能会有更新 模组名称 状态 备注 Essential 支持 - 越肩视角重置 (Shoulder Surfing Reloaded) 支持 - 玩家动画师 (Player Animator) 支持 包含基于此模组的如“更好的战斗 (Better Combat)”和“表情动作 (Emotecraft)” 自定义皮肤加载器 (CustomSkinLoader) 部分支持 需要安装该辅助模组 Lunar客户端 (Lunar Client) 不支持 将永远不会获得支持 已知问题与限制 由于外层模型略大于玩家本体模型，部分皮肤在3D化后可能无法完全对齐。 转角处的锯齿图案可能会连接在一起。这是3D建模算法的固有特性，可以通过在缝隙处填充微透明像素来缓解。 使用光影包时，物体侧面可能会出现异常阴影，该问题正在尝试解决中。 常见问题解答

需要将模组安装到服务器吗？ 不需要。这是一个纯客户端模组，无需在服务器端进行任何安装。

该模组支持高清皮肤吗？ 不支持。由于像素形状无法匹配，高清皮肤无法实现3D化。

模组图层穿透了模组盔甲怎么办？ 部分模组盔甲比原版更贴合身体。请在模组设置中调小3D尺寸，直到完全贴合为止。

皮肤图层相对于身体偏移了怎么办？ 这通常是因为你使用了ETF或EMF资源包。请确保将其更新至与当前Minecraft版本相匹配的版本。

图层消失了或模组不工作？ 在寻求帮助前，请检查以下事项：

检查“选项 > 皮肤与个性化”中是否意外禁用了皮肤图层。 检查模组设置中的功能是否已开启。 确认模组是否出现在已加载的模组列表中。 皮肤应通过Mojang渠道加载，其他皮肤加载方案可能不受支持。 确保你的皮肤文件本身确实包含第二图层的内容，模组无法无中生有。

关于Minecraft盗版客户端的问题： 请购买正版游戏，非法复制的游戏版本不在本模组的支持范围内。

The Aether 模组简介

The Aether 模组是由原开发团队精心维护的经典力作。该模组不仅完美适配现代 Minecraft 版本，确保了与各种系统的良好兼容性，还对多人联机模式提供了全面的支持，为您和伙伴们开启一段全新的冒险旅程。

关于以太 (The Aether)

The Aether 营造了一个位于万米高空之上的奇幻纬度，这里布满了云端景观和广袤的悬浮群岛。进入此维度后，玩家将置身于一段全新的生存冒险之中。该模组构建了一套基于原版生存逻辑的进度体验，涵盖了多种全新的矿石种类、不可思议的神秘生物，以及三座令人畏惧的地下城。每一座地下城中都镇守着强大的头目，并藏有稀有的顶级装备等待着勇敢者的发掘。

模组核心内容概览

The Aether 引入了极其丰富的内容体系，大部分机制在原版模组的公告中已有详细记载。以下是其核心要素的概括：

它为你提供了一个名为“以太”的险恶云端天堂。这里需要特别提醒，务必小心行事，避免从岛屿边缘坠落，否则你将直接掉回主世界。

维度内包含了一系列全新的方块与资源物品，等待你去采集利用。

新增了三种核心功能性方块：祭坛 (Altar)、冷冻机 (Freezer) 以及孵化器 (Incubator)。

引入了四种材质等级：天根木 (Skyroot)、神圣石 (Holystone)、赞尼特矿 (Zanite) 和重力矿 (Gravitite)。每种材质都拥有一套独特的工具与武器，并赋予其特殊的属性加成。

配备了《知识之书》(Book of Lore)，其中详细记录了模组中每一个方块和物品的所有信息，是新手的必备指南。

拥有一个独特的附件系统，配有专属的图形用户界面 (GUI)，让你能够有效利用并装备在冒险中获得的珍稀战利品。

不仅有模仿主世界生态的生物，还有以太维度独有的原生态物种。

引入了名为“恐鸟”(Moas) 的飞行坐骑系统，它们拥有不同等级的跳跃能力，是你航行于空岛间的得力助手。

包含三座极具挑战性的结构：青铜、白银与黄金地下城。每一座都拥有专属的装备战利品和需要玩家合力击败的强大头目。

系统呈现“永恒之昼”状态。只有在成功征服最终的地下城后，这种状态才会结束。随后的昼夜循环可以通过一个独特的特殊方块——太阳祭坛 (Sun Altar) 进行自由控制。

入门指南

想要迈出探索以太的第一步，你需要进行必要的准备。首先，搭建一个由荧石构成的矩形边框作为门户，随后使用水桶对准边框中心注入水源。一旦门户激活并发出流光，你便可以踏入其中，正式开启你在以太这个危机四伏的云端天堂中的生存挑战。

地下城挑战攻略

以太世界中坐落着三座充满未知的神秘地下城，每一座都由一位实力强悍的头目镇守。

青铜地下城 (Bronze Dungeon) 是哨兵的巢穴，由外形可怖的“滑行者”(Slider) 守卫，这是一种由纯粹石块构成的生物。为了应对挑战，务必留意岛屿内部隐藏的隧道，并确保在挑战前准备好你所能制作出的最强装备。

白银地下城 (Silver Dungeon) 也就是宏伟的瓦尔基里神庙。在这里，你将直接面对瓦尔基里骑士团的考验。若是你证明了自己拥有足够的勇气与实力，便可挑战“瓦尔基里女王”(Valkyrie Queen)。这场对决需要你利用所有的工具储备和作战技巧，方能击败这位远古战士。

在稀有的黄金地下城 (Gold Dungeon) 内部，栖息着太阳之灵 (Sun Spirit)，那是一个由火焰与纯能量组成的永恒生命体。作为统治太阳本身的神明，仅想让他注意到你都需要花费一番功夫。然而，坊间传闻他一直在守护着以太维度中最顶级的珍宝，等待着真正的主人出现。

钠 (Sodium) - 极致的渲染优化解决方案

这是Minecraft历史上最卓越的渲染优化模组之一，专为追求极致流畅体验的玩家打造。现在，无论是使用NeoForge还是Fabric模组加载器，你都能享受到它带来的性能飞跃。

这款模组是数千小时开发心血的结晶，它彻底重构了游戏的渲染管线，旨在让每一位玩家的硬件潜力得到最大释放。

核心特性：为何选择钠 (Sodium)？

钠 (Sodium) 是一个针对Minecraft客户端的强力优化引擎。它的核心使命非常明确：在显著提升游戏帧率（FPS）的同时，彻底根除恼人的微卡顿现象，并顺带修复原版游戏中存在的诸多图形渲染错误。

与其他专注于渲染的模组不同，钠 (Sodium) 在提供顶尖性能的同时，展现了惊人的兼容性。它能与现有的庞大模组生态系统和谐共存，并且严格恪守原版的美学风格——它不会擅自改变游戏的视觉效果，确保你看到的依然是那个原汁原味的方块世界，只是更加丝滑流畅。

安装指南

虽然钠 (Sodium) 支持多种模组加载环境，但为了获得最纯粹、轻量级的体验，我们强烈推荐在 Fabric Loader 环境下使用。

安装步骤： 如果你使用第三方的启动器（如Prism Launcher, HMCL等），它们通常内置了模组加载器的自动安装功能。一旦你的加载器准备就绪，安装过程就变得极其简单：只需将钠 (Sodium) 的文件放入你的 mods 文件夹即可，就像安装其他任何普通模组一样。

如何确认安装成功？ 进入游戏后，打开“视频设置”界面。如果你看到了一套全新的、布局更加现代且功能强大的用户界面，那就说明模组已经成功加载。

配置建议 对于绝大多数玩家来说，你可能根本不需要手动调整任何设置。钠 (Sodium) 内置了智能化的默认配置，它会自动开启所有你系统支持的优化选项。除非你遇到了特定的问题，或者你是需要微调性能的高级用户，否则保持默认即可享受最佳体验。

进阶性能优化：构建完整的优化矩阵

值得注意的是，钠 (Sodium) 专注于优化Minecraft的 图形渲染 代码。如果你的目标是全方位的性能提升，我们建议构建一个完整的优化体系：

锂 (Lithium)： 适用于MC 1.15及以上版本，用于优化游戏内部逻辑和服务器性能。 磷 (Phosphor)： 适用于MC 1.19以下版本，专注优化光照引擎。

这样的模块化设计让玩家可以根据需求自由选择，但作为游戏大师，我通常建议安装全套组件，以获得无懈可击的游戏体验。

硬件兼容性与系统要求

重要警告： 使用OpenGL转换层的设备（例如Android设备，也就是手机版运行Java模组，以及部分基于ARM架构的Windows设备）不仅不在官方支持范围内，而且极大概率会遭遇严重的性能崩溃。请避免在这些环境下使用。

官方支持范围： 我们仅确认为桌面级显卡提供官方支持。你的显卡驱动程序必须保持最新，且硬件需支持 OpenGL 4.5 或更高版本。值得庆幸的是，过去12年内发布的绝大多数主流显卡均满足此要求，包括但不限于：

Intel： HD Graphics 500系列 (Skylake架构) 及更新型号。 NVIDIA： GeForce 400系列 (Fermi架构) 及更新型号。 AMD： Radeon HD 7000系列 (GCN 1架构) 及更新型号。

简而言之： 如果你的台式机显卡能跑动原版Minecraft（要求OpenGL 3.3），它几乎肯定能运行钠 (Sodium)。但请注意，对于非常古老的硬件，开发团队无法保证其永久的兼容性。

故障排除首选方案： 如果你在游戏中遇到崩溃、渲染错误或性能异常，请首先检查一件事：你的显卡驱动是否是最新版本？ 过期的驱动程序是导致渲染故障和性能瓶颈的头号杀手。

问题反馈

如果你发现了BUG、遭遇了崩溃或其他技术难题，请务必使用页面顶部的链接前往问题追踪器进行反馈。在提交报告时，请养成良好的习惯：列出你正在使用的其他模组，并附上相关的崩溃日志文件，这将极大地帮助开发团队定位问题。

性能基准说明

注：使用钠 (Sodium) 获得的具体性能提升幅度，将取决于你个人的软硬件配置。为了提供具有参考价值的数据，我们在测试时特意选用了一台具有代表性的、配备集成显卡的普通电脑，以模拟广大休闲玩家的真实场景。

测试环境概览： 硬件：Intel Core i7-1165G7 (Intel Xe 核显, 2x16 GB双通道内存) 软件：Fedora Linux, OpenJDK 21, Fabric Loader

经典的维度模组再度回归，以焕然一新的面貌重塑以太（The Aether）维度。The Aether II 不仅仅是该系列模组的续作，更是对这一经典传奇的延续与升华。玩家只需通过荧石传送门，即可踏入圣洁群岛（Holy Isles），开启一段充满无限可能的新征程。

经典维度焕新归来

The Aether II 为游戏引入了一个全新的维度，其设计灵感源自我们团队在2011年制作的初代以太模组，并作为近期重制版以太模组的正式续作。我们彻底重构了该经典维度的概念，并带来了全新的生物群系、生物种类、进度系统、遗迹结构以及海量的内容更新。

欢迎来到历史悠久的圣洁群岛，这里是以太世界中瓦尔基里（Valkyries）的故乡。这片土地由壮丽的地貌、凛冽的狂风、广袤的云海以及深邃神秘的洞穴交织而成。玩家可以尽情探索这些漂浮的岛屿，揭开被遗忘遗迹背后的秘密，并将潜藏在各个地牢深处的邪恶驱逐殆尽。

以太世界拥有其独有的原生资源，如天根木（Skyroot）、圣石（Holystone）、赞尼特（Zanite）和重力矿石（Gravitite）。利用这些资源，玩家得以打造具备超自然能力的装备，饲养奇幻生物，并在令人惊叹的维度景观中构建史诗般的要塞。The Aether II 为你提供了重启冒险的机会，带来全新的生存探险体验。

核心机制与玩法深度

圣洁群岛的游戏流程以生存探险为核心，保留了类似原版游戏的生存进度模式，同时融入了全新的矿石、实用方块、丰富的建筑装饰方块、待探索的战利品遗迹以及大量神话生物。不仅如此，The Aether II 还引入了多种旨在拓展和丰富冒险历程的玩法与进度机制。

旅行者指南（Traveller's Guidebook）是此次核心机制的关键。这是一个功能扩展后的玩家图形界面。通过查阅指南，玩家不仅能够为专用的装备槽位配备新装备，还能翻阅关于该维度下的游戏信息与背景知识，甚至还能追踪进度标记，规划穿越世界的最佳路线。

你可以通过这些全新的核心机制来提升生存探险体验，利用进阶的材料强化装备和属性，从而在面对以太世界的怪物与强敌时更具优势。模组新增机制包括：

装备能力 盔甲套装属性加成 全新装备槽位 武器伤害类型划分 增强的状态效果 新式实用方块 指南图鉴系统 飞行坐骑功能 独特的地牢战利品

探索多元生物群系

圣洁群岛由四大主要生物群系主题组成，每一个主题下又包含多种各具特色的生物群系设计。

高地生物群系（Highfields Biomes）

繁茂原野（Flourishing Field）：这是经典的以太景观，连绵起伏的悬浮丘陵、开阔的平原、零星的树木以及丰富的动物群。 翠绿森林（Verdant Woods）：密集的天根树林，为玩家提供了一处躲避以太高空烈日与强风的休憩之所。 静谧林地（Shrouded Forest）：这里的树木遮天蔽日，地面终年被阴影笼罩，林冠层则演变成了一片长满苔藓的绿色庇护所。 微光盆地（Shimmering Basin）：广阔的湖泊与清澈的天空相映成趣，较低的岛屿海拔使其成为岛屿间以及穿梭于云海的绝佳中转站。

磁能生物群系（Magnetic Biomes）

磁极断层（Magnetic Scar）：锯齿状的丘陵与峡谷，由天然地貌和巨大的磁性金属铁矿（Ferrosite）支柱构成。 绿松石森林（Turquoise Forest）：高耸狭窄的铁矿支柱守护着天桦树与铁矿砂。 闪耀沼泽（Glistening Swamp）：巨大的蘑菇与大根树环绕着富含矿物质的水域。 紫罗兰高木林（Violet Highwoods）：表面覆盖着茂密苔藓的高大 wisptop 树，利用滑翔翼和莫亚鸟（Aerbunnies）可以轻松穿梭在树冠之上。

极地生物群系（Arctic Biomes）

寒冷山脉（Frigid Sierra）：覆盖着厚重积雪与冰层的崇山峻岭，是以太生态中最严酷的环境之一。 长青林区（Enduring Woodland）：天松林守护着下方的生态系统，不受猛烈风雪侵扰，成为以太极地中许多动物的安全避难所。 冰封湖泊（Frozen Lakes）：平坦开阔的冰面看似平坦易行，但这之下却隐藏着脆弱的冰穴，随时可能让毫无防备的旅人陷入困境。 凛冽冻原（Sheer Tundra）：覆盖着苔藓的岩石岛屿与冰冻地面，由于缺乏树木，展现出极度开阔的荒原景象。

特殊生物群系

除上述常规地带，我们正在研发多种特殊的稀有生物群系，目前已初步实现了辐射生物群系（Irradiated Biomes）。在未来的更新中，这些岛屿将承载丰富的环境叙事内容与专属战利品。我们同时还在规划一个名为扩张（The Expanse）的云海生物群系，届时将有云中飞船、海盗以及资源丰厚的沉没岛屿巡航于其中。

遗迹、要塞与 respawn 机制

圣洁群岛中散布着许多实用且有趣的结构。尽管目前可探索的遗迹数量有限，但我们计划在后续的 Alpha 测试版本中，增添建筑、废墟、怪物巢穴以及定居点等丰富内容。

除了提供小额战利品和丰富环境多样性的各类建筑外，目前主要的实用结构是旅行者前哨站（Traveller's Outposts）。这些建立在古代瓦尔基里遗迹周围的社区中心，未来将入驻多位独特的NPC角色，而当前主要利用其设置前哨篝火（Outpost Campfire）。

与该篝火互动，即可将其设为除上次睡眠点之外的额外重生点。在以太世界探险时，每当你发现新的前哨站，即便不幸战死，也可以选择回到最近访问的前哨站复活，而无需绕远路回到基地。定期造访前哨站，能确保你以最快速度投入冒险。未来，我们还将提供前哨站NPC运营的莫亚鸟马车服务，只需支付少量费用，便可在各前哨站或主基地间实现快速旅行。

驾驭莫亚鸟翱翔天际

莫亚鸟（Moa）在 The Aether II 中强势回归，并伴随视觉更新与机制重做。若想驯服属于自己的莫亚鸟，你需要先在莫亚鸟巢中找到一枚野生蛋。但请注意，愤怒的亲鸟会全力捍卫巢穴，你需要迅速夺蛋并带回营地。将野生莫亚鸟蛋放置在编织天根木棍方块上，它便会孵化出幼年莫亚鸟。

在饥饿时喂食幼年莫亚鸟以太花瓣或莫亚饲料，经过三轮投喂后，它便会成长为可骑乘的成年莫亚鸟。制作并装备莫亚鸟鞍，即可骑着它自由翱翔。虽然目前的飞行机制尚在开发优化中，但未来我们将完善其飞行与滑翔的操作体验，让穿越圣洁群岛的远方变得更加轻松有趣。

云下区的潜在危机与宝藏

若想获取后期的高级材料与资源，你需要冒险深入圣洁群岛云海之下的云下区（The Undercloud）。

在该区域，下方直接面对虚空，缺乏防护的坠落将引致致命后果。在这些开放式洞穴系统中谨慎行进是挖掘奥肯矿石（Arkenium）、重力矿石（Gravitite）以及腐蚀矿石（Corrobonite）资源的关键。云下区由名为底层页岩（Undershale）的新型石材构成，其硬度远超圣石，需要更高级的镐子才能开采，因此探险前务必在地面升级装备。

挑战地牢与进度升级

在圣洁群岛探索时，你可能会偶然发现神秘的地牢遗迹。这里充满了敌对怪物的围困、稀有的战利品以及强大的 Boss。挑战这些地牢，用实力与装备换取无法通过制作获得的强力战利品。

目前已实现的地牢是哨兵遗迹（The Sentry Ruins），它是对原版铜质地牢的重构。潜入这些被机械生物盘踞的地下设施，惊醒沉睡的滑行者（Slider）——它是一块由纯岩石构成的巨型生物，一旦被惊动便会觉醒，誓死保卫它的沉眠地与珍贵的古代遗物。随着 Alpha 版本的推进，我们将引入更多地牢，包括经典地牢的重构与全新的设计理念。

The Aether II 新增的材料与实用工具旨在拓展后期进阶，而非仅仅依赖附魔随机性。大部分进度围绕奥肯锻炉（Arkenium Forge）展开，它允许玩家通过利用奥肯矿石进行强化，线性提升装备等级。高等级强化需要稀有的腐蚀矿石，且必须使用重力等级的镐子才能开采。

完全升级后的装备与拾取物品将拥有护身符槽位（Charm Slots）。护身符是一种能够为特定装备施加升级效果的战利品，例如增加武器伤害或工具挖掘速度。通过奥肯锻炉，你可以将护身符装备到兼容的槽位上，从而永久性地强化你的装备。哨兵遗迹中已包含少量可供掉落的护身符，快去收集它们，打造出模组中最强大的神装吧！

展望未来

The Aether II 正处于开发早期阶段，新的内容与优化将频繁发布。以下是我们计划在后续 Alpha 版本中推出的内容规划：

感染守护者之树地牢（Infected Guardian Tree Dungeon） 失落的瓦尔基里神庙微型地牢（Lost Valkyrie Temple Mini-Dungeon） 原始熔炉地牢（Primordial Foundry Dungeon） 太阳信徒藏身处微型地牢（Sun Acolyte Hideout Mini-Dungeon） 强盗王堡垒地牢（Bandit King's Fortress Dungeon） 环境氛围与机制增强 各生物群系特有的环境机制 各生物群系特有生物种类 更多杂项建筑 更多的云下区生物群系 云下区特有生物 前哨站NPC交互 定居点系统 非地牢类战利品 新的莫亚鸟骑乘机制 指南图鉴的状态显示页面 更多成就与奖励机制展望

实体剔除 (Entity Culling)

利用异步路径追踪技术，智能隐藏视线之外的方块与实体

虽然现代 Minecraft 的渲染引擎运行速度已经相当可观，但它并不总是足够“聪明”。试想一下，如果某些方块实体或生物完全被墙壁或天花板遮挡，处于玩家的视线盲区，为什么还要耗费宝贵的计算资源去渲染它们？如果能直接跳过这部分渲染，岂不是能极大地释放性能潜力？

本模组引入了异步路径追踪技术 (Asynchronous Path-Tracing)，旨在高效地判定哪些物体是真正对玩家可见的。通过充分利用多核 CPU 的性能，它能够实时计算视线可见性，从而剔除那些被遮挡的方块实体和实体，消除不必要的绘制调用。

这一改动带来了立竿见影的效果：更智能的渲染逻辑，更低的系统开销，以及更强劲的性能表现。

通过仅渲染真正重要的实体，你将解锁前所未有的流畅体验。本模组不仅仅是传统的优化手段，它带来了更高层次的可见性剔除算法，为您提供如丝般顺滑的游戏感受。

多线程路径追踪

压榨闲置性能：利用空闲的 CPU 线程来迅速进行可见性计算。 无阻塞运行：独立于游戏主线程之外运行，不会导致游戏卡顿。 实时数据更新：确保可见性数据始终与游戏画面同步。

智能遮挡剔除

视线阻挡判定：自动跳过渲染那些隐藏在地形或建筑物背后的方块实体和生物。 强化版剔除：工作原理类似于 Minecraft 原版的背面剔除，但更加智能、高效。 画质无损：在显著降低 GPU 负载的同时，完全不影响画面的视觉保真度。

实体运算节流

降低客户端压力：减少不可见实体对客户端造成的性能冲击。 按需更新：仅更新必要的数据，避免资源浪费。 高度兼容：完全可配置，并与大多数模组兼容。

版本支持状态

Minecraft 版本 加载器 (Loader) 状态 版本说明 备注 1.19.4 及以上 Fabric/Forge/NeoForge 支持 最新版 1.16.5 - 1.19.2 Fabric/Forge 不支持 过旧 未来可能会有更新 1.12.2 / 1.8.9 Forge 不支持 过旧 未来可能会有更新 1.7.10 Forge 不支持 过旧 无更新计划 b1.7.3 Babric 不支持 过旧 无更新计划

性能实测参考

本模组的效果对比测试在 Scarland（Hermitcraft 第九季存档）中进行，渲染距离设置为 16 个区块。测试环境为 Minecraft 1.21.5 (Fabric)，同时搭配了 Sodium (钠)、Iris 和 ImmediatelyFast 等优化模组，此时开启本模组依然能带来显著差异。

配置指南与兼容性说明

某些魔法类模组常用于制作特效的客户端实体，可能会因为被误剔除而表现异常。如果您遇到此类问题，请在配置界面中将相关实体加入白名单，以豁免 Tick 剔除或渲染剔除。

此外，对于那些渲染范围远超其自身碰撞箱大小的方块实体，您也需要将其列入白名单。常见的例子包括原版的信标光束、Create（机械动力）模组的滑轮、以及部分 Botania（植物魔法）的方块。

常见问题解答

这个模组需要安装在服务器端吗？

不需要。这是一个完全的客户端模组，无需安装在服务器上即可生效。

这会影响生物行为或刷怪塔效率吗？

不会。本模组仅仅跳过了画面的渲染过程，而不会干涉逻辑模拟。生物仍然会正常生成、移动、由于机制死亡并掉落物品。您的刷怪塔和其他基于游戏机制的设施将保持完全正常运作。

我在 Sodium (钠) 中已经启用了 "Use Entity Culling"，还需要这个模组吗？

是的，依然很有帮助！虽然 Sodium 基于加载的区块进行基础的可见性检查，但本模组的算法更加深入。它通过分析实际的视线路径（Line-of-Sight），能够剔除那些“虽然位于可见区块内，但实际上被墙壁或其他物体遮挡”的实体。这是一种更加激进且精确的优化方案，能够进一步提升性能。

海浪（Coastal Waves）

为你的沙滩增添灵动的破碎波浪！

你是否曾感叹：“为什么始终没人为《我的世界》加入沙滩浪潮？这到底有多难实现？”现在，答案终于揭晓！这款模组——海浪（Coastal Waves），旨在彻底改变你的游戏世界，通过全新的风景波浪，为海岸线注入大气且宁静的破碎海浪声。这些波浪绝非仅仅是装饰，它们拥有独特的机制：不仅能随机将珍贵的材料冲刷并堆积在沙滩上，还能与路径上的实体产生动态交互。这一特性为你的游戏流程注入了新鲜活力，让你重新拥有了探索海滨的充足动力。无论你是热衷于冒险探索、建造宏伟家园，还是仅仅想静坐海边欣赏风景，这项改动都能通过海洋的壮美与馈赠全方位提升你的游戏体验。快投身碧波之中，发掘海浪为你带来的惊喜宝藏吧！

该模组添加并应用了以下标签，所有设置均可根据你的个人偏好进行深度定制：

方块（Blocks）：waves:wave_blocks —— 此列表定义了海浪在海岸上随机留下的方块材质。 流体（Fluids）：waves:has_waves —— 此列表涵盖了能够生成海浪的流体类型。 生物群系（Biomes）：waves:has_waves —— 此列表指定了海浪能够自然生成的地理环境。 实体黑名单（Entities - Blacklist）：waves:wave_interaction_blacklist —— 在此列表中添加的实体将不会与海浪发生任何交互。 实体白名单（Entities - Whitelist）：waves:wave_interaction_whitelist —— 仅在此列表中的实体会被允许与海浪进行互动。

海浪生成的垂直高度（Y轴）可以通过 JSON 文件进行灵活配置。请前往 ./config/waves/waves.json 寻找该配置文件，其中已预设了原版维度的默认参数。

对于那些使用内置实体雷达的小地图模组玩家，如果你希望在地图上隐藏海浪实体，请注意海浪实体的 ID 为 waves:waves。

锂 (Lithium)

绝不妥协的通用游戏逻辑优化方案。适用于各类客户端与服务器。现已支持 Fabric 与 NeoForge 平台！

锂 (Lithium) 是一款现代化的、通用的 Minecraft 优化模组。它致力于改良游戏物理引擎、生物 AI、方块刻（Block Ticking）等多个关键系统，而其核心宗旨在于：在显著提升性能的同时，绝不改变原版游戏的任何机制。

该模组在客户端和服务端均能完美运行。特别值得一提的是，当其安装在服务器上时，玩家的客户端无需安装该模组即可加入（反之亦然），实现了无缝的兼容性。

显著的性能飞跃

对于多玩家服务器而言，管理员将见证每刻耗时（Tick Times）的显著降低，这意味着硬件能够承载更多的实体、加载更多的区块以及支持更多的在线玩家。

即便是在单人游戏中，锂同样能发挥巨大作用。它通过优化负责“计算”世界的内部集成服务端，释放了电脑处理器的算力以处理其他任务。这直接带来了帧率的提升和游戏响应速度的加快。

极致的兼容性

这种对维持原版行为的严格追求，使得锂模组几乎适用于所有运行 Fabric 的 Minecraft 服务器，即便是面对极其复杂的游戏玩法和红石机械也游刃有余。实际上，正是因为我们坚持“不改变原版游戏玩法”的原则，该模组甚至被官方批准用于 Minecraft 速通（Speedrunning）竞赛中。

安装指南

确保您已安装了最新版本的 Fabric Loader，随后只需将模组文件放入您的 mods 文件夹即可完成安装。

无需安装任何其他模组（甚至不需要 Fabric API！）。 无需进行额外设置。 无需为了享受性能提升而创建新世界，旧存档即装即用。

当您在进行安装时，不妨也了解一下 钠 (Sodium) 模组，它能为您进一步提升画面的渲染性能。

配置说明

锂采用了一套独特且灵活的配置系统，允许用户启用或彻底禁用模组提供的特定补丁。这种机制赋予了您对 Minecraft 代码修改的细粒度控制权。因此，若遇到罕见的漏洞或模组不兼容问题，您可以通过它来彻底排查并解决。

欲了解更多详细信息，请查阅关于修改配置文件的 Wiki 条目。

请注意： 如果您的配置文件是空的，这属于完全正常的现象。这仅代表您正在使用默认选项，而这些默认设置已经过精心调校，开箱即可为您提供模组所能达到的最佳性能。

Jade：信息显示模组

Jade 是一款专注于在游戏界面中展示你当前注视目标信息的模组，它实质上是面向 Minecraft 1.16 及更高版本的 Hwyla 或 Waila 模组的衍生作品。作为一款功能强大的信息显示（HUD）模组，Jade 的设计初衷是为玩家提供更出色的交互体验，并为开发者构建了更为完善的应用程序接口（API）。

关于安装环境，Jade 模组支持纯客户端安装。然而，如果你希望体验其全部核心功能，例如查看物品存储内容、酿造台燃料剩余量，以及蜂箱内的蜜蜂数量等高级表现，则需要在服务器端同步安装该模组。

如果你是模组开发者，正在寻求模组之间的联动支持，建议尝试 Jade Addons（支持 NeoForge 和 Fabric）。

默认按键设置

你可以通过以下按键快速使用该工具：

小键盘 0：开启模组配置界面 小键盘 1：切换界面覆盖层开关 小键盘 2：切换液体显示功能 小键盘 3：查看合成配方（需要安装 JEI 模组） 小键盘 4：查看物品用途（需要安装 JEI 模组） 小键盘 5：播报目标名称

Jade 与 Hwyla 的核心区别

Jade 对 Hwyla 进行了全方位的优化，主要的改进点包括：

接口架构重构：重构了 API 设计，不仅运行更稳定，也更利于扩展。 原生内容支持：内置了更多针对原版游戏的附加功能。 高度定制化：通过极高的配置自由度，玩家可以根据个人喜好精细化调整显示内容。 更佳的无障碍体验：提升了整体交互过程中的可访问性与用户友好度。

星球大战：方块战争 (Star Wars The Block Wars)

作者： ironmanivan 模组类型

若你渴望在 Minecraft 中重温那段遥远银河系的传奇故事，《星球大战：方块战争》这一专为 1.21.1 版本打造的模组，将为你开启通往星战宇宙的传送门。这款模组并非仅仅是简单的要素堆砌，而是将整个星球大战系列的精髓深度嵌入了原本方块化的游戏架构中，引入了多元化的行星环境、经典角色、标志性武器与载具，为玩家构建了一个宏大的叙事空间。

在游戏中，玩家拥有充分的决策自主权。你可以选择加入义军同盟，在危机四伏的战火中捍卫自由；亦或是效忠于银河帝国，凭借强大的武力重塑银河秩序。无论是挥舞光剑进行近身肉搏，还是亲自驾驶 X-翼战机或 TIE 战机翱翔于方块天际，该模组旨在通过高度还原的游戏机制，为玩家呈现一场原汁原味的星战冒险。

不仅如此，开发团队在视觉表现上也倾注了大量心血。无论是细节入微的建模设计，还是经过精细打磨的材质纹理，都极大地提升了玩家的游戏沉浸感。结合全新的系统机制，无论是单人探索还是与好友并肩联机，玩家都能在沉醉于沙盒创造乐趣的同时，深度感受科幻经典的独特魅力。

温馨提示： 尽管本模组内置了一定的能量生成功能，但其在复杂工业化体系下的表现相对有限。为了确保各类高科技设备的稳定产出与流畅运行，强烈建议玩家在安装本模组时，额外搭配并使用其他的专业能量类模组。

FerriteCore (铁氧体核心)

内存占用优化方案

本模组旨在通过多种技术途径，大幅度降低 Minecraft 的内存占用率。对于希望深入探究其底层机制的技术型玩家，作者已另行提供了关于改动内容的高阶技术说明。

实测性能表现

内存节省的具体幅度将取决于你所运行的整合包环境。为了直观展示其效能，我们以 All Of Fabric 3 (版本 2.5.9) 进行了基准测试。结果显示，RAM 占用量（堆内存大小）从原始的 1,792 MB 惊人地降至 984 MB。作为横向对比，在相同的测试环境下，若使用 Hydrogen (氢) 模组替代本模组，内存占用量则为 1,335 MB。

上述数据均是在严格控制变量的条件下测得：生成一个固定种子的世界，并静置两分钟后记录数值。项目的展示图片正是源自该测试场景的裁剪版本。

常见问题解答 (FAQ)

Q：我应该将其安装在服务器端，还是仅安装在客户端？

A： 建议双端安装。虽然模组中包含了部分仅针对客户端的优化措施，但也存在一些影响力巨大且针对服务器环境的优化方案。因此，为了获得全方位的性能提升，你应当在客户端和服务器端同时安装本模组。

Q：本模组是否兼容其他模组？

A： 绝大多数情况下是兼容的。目前已知的唯一例外是 Hydrogen (氢) 模组。

具体兼容情况如下：在 Hydrogen 官方正式发布支持的 Minecraft 版本中，FerriteCore 的所有近期版本均能与其兼容。但是，在 Minecraft 1.18 及更高版本中，两者不再兼容。这是因为 Hydrogen 项目在这些高版本中已被官方归档，不再进行任何更新或版本发布。