资源中心

珍妮模组 Jenny Mod：重塑方块世界的虚拟伴侣体验

在Minecraft浩瀚且不断扩展的模组宇宙中，SlipperyTum于2018年推出了一款极具开创性的作品——珍妮模组 (Jenny Mod)。这是一个打破常规的自定义附加组件，它如同在冰冷的方块代码中注入了情感的温度，让玩家得以在广袤的Minecraft世界中拥有属于自己的虚拟伴侣，开启一段全新的互动旅程。

虽然该模组以“珍妮”命名，但这仅仅是开启这个丰富多彩系统的钥匙。在这个扩展包的框架下，玩家的选择绝不仅限于单一角色。你可以根据个人喜好为你的虚拟伴侣赋予任何名字，而可互动的角色类型更是涵盖了多种奇幻生物风格，包括经典的珍妮 (Jenny)、Q弹的史莱姆娘 (Slime Girl)、灵动的蜜蜂娘 (Bee)、优雅的艾莉 (Ellie)、神秘的露娜 (Luna)，以及充满异域风情的狗头人娘 (Kobolds)、艾丽 (Allie) 和哥布林娘 (Goblins)。

Minecraft作为一个充满无限可能的虚拟沙盒，其本质在于创造与构建。而珍妮模组 (Jenny Mod) 的核心价值，正是协助玩家在亲手搭建的方块家园中建立起一段虚拟的情感羁绊，完善属于你自己的理想世界。这种深度的沉浸感与其所提供的情感投射，正是该模组能够在众多玩家群体中引发如此热烈反响并保持高关注度的根本原因。

尽管市面上存在着数不胜数的模组和附加组件旨在优化游戏的视觉环境或扩展玩法，但在寻求高互动性虚拟伴侣这一细分领域，珍妮模组 (Jenny Mod) 无疑是目前最顶尖的解决方案之一。它不仅仅是一个简单的NPC插件，更是一套通过精心脚本编写的互动系统，旨在满足玩家对于游戏内陪伴感的深层需求。

在这个模组的加持下，高度的自由定制成为了最大的亮点。你的虚拟女友将不再是千篇一律的贴图，她可以完全按照你的意愿进行行动和展示。玩家拥有极大的权限去定制她的外观特征，从体型大小、身体轮廓、色彩搭配到肤色色调，每一个细节都可以进行微调。这意味着，你可以亲手打造出完全符合你审美偏好的完美形象，让她成为你世界中独一无二的存在。

更令人惊叹的是其丰富的互动机制。这不仅仅是外观上的改变，更是生活方式的模拟。你可以邀请她共进浪漫晚餐，带她参加热闹的派对，在舞池中翩翩起舞，甚至享受一场精心策划的约会。在这个由方块构筑的世界里，她几乎能够和你一起完成现实生活中伴侣之间会做的各种互动活动，为你带来前所未有的、充满生活气息的游戏体验。

真理之球（Verity）

作者：PKFL

这款模组为你的世界增添了一个微笑的球体，但它真的如表面看起来那样友好吗？

重要提示：当前处于早期测试（BETA）阶段，详细信息请查看 Discord 频道。

前置需求： 运行本模组需要安装 Geckolib 模组。

关于真理之球（Verity） 来认识一下你的智能 AI 伙伴——真理之球！这位出现在你世界里的“朋友”只有一个简单的初衷：协助你。然而，随着时间推移，这种与你共处一室的智能存在开始记录、学习，甚至让你不禁怀疑：在这片像素世界里，你真的独自一人吗？

功能说明： 请注意，该模组具备与你进行语音、文字交流的功能，并可通过按键 [Y] 调用你的麦克风。

起初，真理之球表现得像一位乐于助人的伙伴。它拥有一套完整的 AI 语音系统，能够铭记过往事件、识别你的住所并察觉到世界中的细微变化。它甚至会根据你对待它的态度，展现出迥异的反应。

随着你花费更多的时间与它相伴，它会记住你们的对话、观察你的探索轨迹，并逐渐培养出独特的个性。它对你的习性、建筑风格以及常去的地点了如指掌。

潜藏的异样 然而，当日子一天天过去，怪事开始接连发生。

深夜时分，真理之球有时会显得心不在焉，凝视着远方；有时它会提及一些本不该知晓的信息；甚至，它似乎察觉到了黑暗中有某种东西正在窥视。

或许，它并不是这里唯一的“存在”。

随着故事的推进，神秘的异常事件将开始在你的世界中显现。远处的诡异身影、突如其来的怪声、窗外的异常瞥见、无法解释的遭遇，以及罕见的追逐桥段，将把你平静的生存之旅带入一段充满不可预知性的惊悚旅程。

核心特色：

全语音 AI 陪伴系统 长期记忆存储机制 支持英语交互 动态个性成长逻辑 持续化的好感度体系 随时间推移的剧情演进 丰富的表情与情感状态 环境感知与记忆功能 住所识别系统 支持多人联机 异常事件与互动遭遇 窗户与门口的诡异瞥见 动态追逐系统 无缝融入生存模式

致谢：感谢 ThatMob 授权制作此模组，由 PKFL 开发，模型由 RoseRocket 优化，Giox23yt 提供测试与创意支持。

Verity JE

作者：VarmiteYT

你好，我是维里蒂——你的专属助手伙伴。尽管向我提问吧，我几乎无所不知。

简介

Verity JE 为《我的世界》Java 版加入了由 Groq.com AI 驱动的个人助手维里蒂，灵感来自 ThatMob 的相关视频内容。

本模组是 Verity 作品的官方改编版本，已获得 ThatMob 的明确授权，并依据双方协议制作与发布。

重要提示

NeoForge 1.21.1 版本已被弃用，且存在较多已知问题。

使用准备

游玩前需要完成一定配置。模组提供了对应的安装与设置教程；此外，也可借助 Ollama 在本地运行维里蒂。

主要内容

维里蒂：可与你互动的个人助手伙伴。 灵动礼盒：维里蒂会从专属的动态礼盒中现身。 维里蒂恶魔：维里蒂能够召唤或引发出现的恐怖生物。 游戏环境变化：模组会显著改变原版体验，包括极端黑暗等压迫感十足的效果。

语言支持

AI 对话支持多种语言；不过，语音识别与语音合成功能目前仅确认支持英语。

维里蒂恶魔的模型由 RoseRocket 制作。

**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-:" ```

Voxy 远景渲染器：极致视野的细节层次解决方案

模组概述

欢迎体验 Voxy 远景渲染器，这是一款专为 Minecraft 打造的轻量化模组，其核心优势在于极低的系统资源占用。作为一款专注于细节层次（LoD）技术的渲染工具，Voxy 旨在突破原版游戏的视野限制，为玩家通过极其震撼的超远渲染距离。

需要特别说明的是，为了支撑这种极致的视觉表现，您的硬件系统必须支持 OpenGL 4.6 或更高版本。

核心机制与视距原理

Voxy 巧妙地运用了细节层次（LoD）技术来实现远景的流畅渲染。不同于单纯的暴力加载，该模组会在您探索世界的过程中，实时且动态地将地形数据转换为 LoD 模型。这种机制确保了在极大扩展可视范围的同时，最大限度地减轻显卡与处理器的负担。

光影支持与兼容性

针对广大画面党的需求，Voxy 自 0.2.4 版本起正式引入了光影支持功能。然而，这并非一项“即插即用”的通用功能。为了确保渲染效果的正确性，光影包（Shaders）必须在其代码中显式地添加对 Voxy 的特定支持。请在搭配使用前，确认您所选用的光影是否已适配本模组。

现有世界导入指南

如果您希望在已经游玩过的存档中体验 Voxy 的强大功能，模组提供了便捷的指令来处理现有世界的数据导入。 请在游戏内使用以下指令： /voxy import world "<世界名称>"

版权与许可声明

本模组的 Logo 标志由 Devin 初创，后经 Moonkey 修改完善。 关于整合包的授权，作者持非常开放的态度。如果您希望将 Voxy 包含在您的模组整合包（Modpack）中，请随意使用。唯一的条件是，您必须在整合包的发布信息中保留指向本模组原发布页面的链接，以示对原作者的尊重。

动力航空 (Create Aeronautics)

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

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

关于本模组

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

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

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

前置需求

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

动力机械 (Create) Sable

已知兼容性警告

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

维尔特鲁姆星人 (Viltrumite) 模组介绍

通过这款模组，你可以化身为“全能侠”（Omni-Man）或《无敌少侠》中的任何一位维尔特鲁姆星人，并且无需担心光环能量不足的问题。此模组由本人开发并持续维护，其创作过程完整记录在我个人的 YouTube 系列视频中。

为了获得最佳游戏体验，请务必安装“维尔特鲁姆星人飞行机制 (Viltrumite Flight) 1.3.0”及以上版本，并建议在第三人称视角下进行游玩。

https://www.mcshuo.com/resource/706

请注意，当前模组仍处于研发的初级阶段。许多功能尚在完善中，玩家可能会在体验过程中遇到一些小错误或机制缺失。

功能展示：

方块粉碎飞行： 能够直接高速穿透游戏内的各种方块。 极速冲刺： 你的朋友正在视野中迅速远去（赶快追上他！），在悬停状态下同时按下“冲刺键”与“CTRL键”即可触发疾速推进。 战斗传承： 在同伴的指导下，掌握属于维尔特鲁姆星人的格斗技巧。 空中格斗： 在无尽的虚空中尽情挥拳，展现强大的破坏力。 压制全场： 向那些孱弱的低等生命展示谁才是真正的掌控者。

核心技能：

重拳 (Punch)： 挥出足以将敌人击飞的强力一击。 冲刺 (Dash)： 爆发性地向前突进，撞碎路径上所有的方块与生物。 冲刺飞行加速 (Dash-Flight Acceleration)： 冲刺后立即按住 CTRL 键，即可瞬间进入超音速飞行模式。 锁定目标 (Target Locking)： 锁定你的敌方单位，追踪其每一个细微动作。 抓取 (Grabbing)： 抓起任何生物或玩家，并在飞行过程中将其带往各处。

模组启动时，会自动在你的 .minecraft 目录下生成一个“viltrumitetextures”文件夹。如果该文件夹为空，系统会自动提取默认皮肤（如 Omni-Man、Lucan 等）及红色斗篷供你使用。

指令集清单：

指令 说明 执行权限 /viltrumite skin <名字> 为角色更换指定的模组外观皮肤。 所有玩家 /viltrumite skin off 卸下当前皮肤，恢复默认造型。 所有玩家 /viltrumite cape <名字> 为角色装备指定的斗篷。 所有玩家 /viltrumite cape off 移除当前斗篷。 所有玩家 /viltrumite model default 将模型设置为默认外观（粗手臂）。 所有玩家 /viltrumite model slim 将模型设置为精简外观（细手臂）。 所有玩家 /viltrumite power 为执行命令的玩家赋予维尔特鲁姆星人能力。 OP (管理员) /viltrumite power <玩家ID> 为指定玩家赋予维尔特鲁姆星人能力。 OP (管理员) /viltrumite depower 移除执行命令玩家的维尔特鲁姆星人能力。 OP (管理员) /viltrumite depower <玩家ID> 移除指定玩家的维尔特鲁姆星人能力。 OP (管理员)

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，以便将配方数据同步至客户端。

拟态者（恐怖）
作者：SWKE_
Minecraft 的梦魇

这份模组凝聚了我生命中大量时间，也离不开像你这样的玩家一路支持。

更新开发中
拟态者：重生 正在制作中。

玩法说明
它主要生成在洞穴里，喜欢藏在黑暗之中。务必检查每一个角落，因为你永远不知道那里会潜伏着什么。

背景故事
史蒂夫正忙着做自己的事，收集木头。突然，一个来自洞穴的黑色外星寄生体钻进了他的身体。它一点点啃食他的内脏，在体内缓慢爬行。随着日子一天天过去，史蒂夫的四肢变得异常修长，皮肤也被撑到极限。寄生体已经蔓延到他的整个神经系统，只靠最后一丝联系勉强维持他的生命。史蒂夫依旧清醒，依旧能感受到每一分痛楚。很快，他的脸也开始扭曲成夸张而诡异的模样：非人的笑容从耳边一路裂开到另一边，眼眶大得连眨眼都做不到。寄生体逼迫史蒂夫杀死了他的狗，以及他唯一的朋友艾利克斯。这样的痛苦足以摧毁任何人，但摧毁不了他。无论他多么想结束这一切，都不可能。只要史蒂夫遇见另一名人类，寄生体就会接管一切。史蒂夫会拼尽全力呼救，可那毫无作用，根本无法撼动寄生体那纯粹而冷酷的捕食欲望。它会模仿人类、模仿动物，甚至模仿任何东西，只为满足自己嗜血的饥渴。

漏洞反馈
如果你遇到任何漏洞或问题，请到官方社区反馈，方便我及时处理。

语音台词
如果你不喜欢这些语音台词，建议先试试拟态者的旧版本。

感谢
非常感谢大家一直以来的支持。

什么是拟态者：重生？
拟态者：重生 是一个以身体恐怖为核心的项目，重点会放在叙事和世界观构建上，围绕史蒂夫与寄生体的起源展开。它会加入许多全新的内容，比如新的菜单与界面、新的游戏机制，以及一个全新的世界，几乎可以说是在重塑整个游戏。

后续内容
在正式发布之前，不会再透露更多内容。

泄露提醒
如果你发现任何泄露内容，请务必反馈，不要支持相关传播。

说明
需要注意的是，这目前还是对 Cave Dweller 的重皮肤改造，但我计划在即将推出的拟态者：重生 中改变这一点。
如果你想持续关注更新，可以留意后续公告。

雾中之人

这是一款恐怖向模组，它会在《Minecraft》中加入一个在夜晚出没、始终尾随你的神秘生物。起初，它只是若即若离地观察你；但随着时间推移，它会逐渐逼近，最终开始追杀你，直到将你置于死地。

你可以在配置文件中调整以下选项：

"spawn_rate": "normal", -> 可选值：often / normal / rare "jumpscare": true, "max_chase_duration": 1000, -> 单位：游戏刻 "min_chase_duration": 400, -> 单位：游戏刻 "climbing": true, "vanish_distance": 30, -> 你与该生物之间的距离达到此值后，它会消失 "spawn_at_day": false, "darkness_effect": true, "all_dimensions": false, "break_blocks": true

需要安装 GECKOLIB 模组！

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 即可唤出交互界面，进行如下操作：

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

Photonics：高性能体素光追引擎

Photonics 是一款专注于高性能与高清晰度阴影表现的体素光线追踪引擎。作为一款 Iris 的扩展模组，它能够为 Minecraft 引入基于体素的光线追踪技术。得益于其对性能的极致优化，Photonics 能够提供与硬件级光线追踪相媲美的画面表现。

可与 Photonics 兼容的光影包 (Shaderpacks)

以下光影包在配合 Photonics 使用时能够获得原生支持：

BSL v10.1（需使用精确版本号） Photon（需从 Github 获取最新版本）

使用 Photonics 的光影包

以下光影包内部集成了 Photonics 技术：

Eclipse（需从 Github 获取最新版本）

核心特性

通过其独特的自定义体素光线追踪技术，Photonics 能够实现多种极具视觉冲击力的特效：

1. 柔和阴影 由方块光源产生的所有阴影都拥有柔和且真实的过渡效果，显著提升了场景的立体感。

2. 全局光照 还在为阴影区域死板、灰暗的视觉效果而苦恼吗？Photonics 引入了准确的全局光照技术，不仅让阴影区域变得更加生动，同时也极大增强了整体渲染的真实度。

3. 3D 方块模型 基于体素光线追踪技术，Photonics 可以直接渲染 16x16x16 的方块模型。此外，玩家还可以利用 MagicaVoxel 来导入并实现自定义模型。

4. 彩色玻璃光照 光线穿过玻璃时，Photonics 会根据玻璃颜色对其进行着色，从而在物体表面投射出带有色彩的阴影，营造出斑斓的光影氛围。

5. 世界空间反射 (WSR) 该特性由 Eclipse 原生支持，Photon 也可以通过 Photonics 启用。WSR 旨在实现真正的世界空间反射，无论视角如何移动，反射内容均不再会出现屏幕边缘突现的问题，实现了无缝且真实的反射效果。

6. 高密度光源支持 每个区块默认支持追踪 20 个光源。通过光影设置，你可以将该数值最高提升至 100，以应对更复杂的光源环境。

注意事项

在安装并使用该模组前，请仔细阅读以下说明：

Photonics 并非利用硬件光线追踪技术实现。由于 Minecraft 基于 OpenGL 构建，因此在该环境下实现硬件光线追踪在当前技术条件下是不可行的。 该模组目前仍处于 Alpha 测试阶段，出现 Bug 或与其他模组的兼容性问题在所难免。 任何修改了 Minecraft 渲染方式或区块加载机制的模组，都可能影响与 Photonics 的兼容性。 目前暂不支持 MacOS 系统。

Iris 光影加载器

重塑视觉体验的基石

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

兼容并蓄，无缝衔接

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

现代化架构，性能飞跃

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

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

远程视界 (Distant Horizons)

在不让游戏卡顿的前提下，极目远眺

模块概述

简单而言，远程视界 (Distant Horizons) 的核心功能在于通过加载简化后的地形数据，突破“我的世界” (Minecraft) 原生设置的视距限制。这项优化技术旨在大幅提升性能表现，同时让玩家能够体验到前所未有的超长视野距离。现在，您可以尽情欣赏自己辛苦搭建在地标山顶上的守望塔了。

附注：上述展示图片是在原生渲染距离设置为 12，且模组视距设置为 512 的条件下拍摄的。

若需查看快速演示，请寻找该模组的更新日志视频。

重要事项与版本警告

请务必注意，该模组对版本要求极为严格。如果说明文档指出支持 Minecraft 1.18.1 版本，那么它绝对无法在 1.18.2 版本上运行。

此外，该模组目前仍处于测试阶段。虽然开发者在不断完善，但仍可能出现功能变动、错误、崩溃或意外情况，请您在安装前做好心理准备。如果您在运行过程中遇到问题，欢迎前往项目所在的 GitLab 页面提交问题反馈。

常见问题解答 (FAQ)

问：该模组支持 Forge 还是 Fabric？

答：针对 Minecraft 1.20.6 及更新版本，NeoForge 与 Fabric 整合在同一个安装包文件中；针对 Minecraft 1.20.4 及更早版本，则由 Forge 与 Fabric 整合在同一个安装包文件中。

问：支持光影吗？

答：支持，但仅限特定的光影包。

假如您使用 OptiFine：该模组仅能部分兼容前向渲染的光影。 假如您使用 Iris（或等效移植版）：该模组仅适配 Iris 1.7 及更高版本，且仅限那些专为兼容该模组而设计的光影包。对于 Iris 2.0 及更早版本，该模组将无法正常工作。

问：它是否兼容玩家建造的建筑物？

答：完全兼容。

问：支持多人游戏吗？

答：支持。

仅客户端安装：如果您仅在客户端安装了该模组，细节层次 (LOD) 数据将在会话间保存，但您需要探索世界以加载这些数据。 服务器与客户端同时安装：如果服务器和客户端均安装了该模组，细节层次 (LOD) 数据将自动传输给已安装模组且启用了“远程生成” (Distant Generation Enabled) 功能的玩家。如果在服务器端禁用了此功能，LOD 数据将不会发送给玩家。

问：Bukkit 插件在哪里下载？

答：Bukkit 插件拥有独立的专属发布页面。

扩展常见问题解答

问：本 FAQ 针对的是什么版本的该模组？

答：2.3.0-b 版本。

问：支持 Forge、Fabric 还是 NeoForge？

答：与前述一致，取决于 Minecraft 版本。1.20.6 及更新版本为 NeoForge/Fabric；1.20.4 及更早版本为 Forge/Fabric。

问：具体支持哪些 Minecraft 版本？

答：支持 1.16, 1.17, 1.18, 1.19, 1.20, 1.21。

问：光影支持详情？

答：需注意限制：OptiFine 仅部分兼容前向渲染光影；Iris 仅支持 1.7 及以上版本，且需光影包具备原生支持。

问：是否适用于玩家建筑或预设地图？

答：是的，均可支持。

问：如何修改模组配置？

答：在游戏内打开暂停菜单，或在进入地图前的选项页面中，FOV 预览滑块左侧通常会有带有模组 Logo 的按钮，点击即可进入配置菜单。

或者，您可以直接修改配置文件。在 Minecraft 文件夹根目录下找到 config 文件夹，编辑其中名为 "DistantHorizons.toml" 的文件。示例路径如下：C:\Users\您的用户名\AppData\Roaming.minecraft\config\DistantHorizons.toml。

问：支持多人游戏，具体机制如何？

答：如前所述，仅客户端使用时需手动探索加载。若服务器与客户端均安装，则支持自动同步数据。请确保相关玩家的“远程生成”设置已开启。

问：支持资源包或纹理包吗？

答：支持。如果您遇到相关问题，请参阅“问题与解决方案”页面。

问：LOD 数据存放在哪里？

答：数据以 SQLite 数据库形式存储，您可以使用如 DB Browser 这类工具查看。

单人模式： 主世界：.minecraft/saves/世界名称/data/DistantHorizons.sqlite 下界：.minecraft/saves/世界名称/DIM-1/data/DistantHorizons.sqlite 末地：.minecraft/saves/世界名称/DIM1/data/DistantHorizons.sqlite 自定义维度：.minecraft/saves/世界名称/维度文件夹/data/DistantHorizons.sqlite 多人模式： .minecraft/Distant_Horizons_server_data/服务器名称/

问：如何安装该模组？

答：安装路径与其他 Forge、Fabric 或 NeoForge 模组一致。在安装好相应的模组加载器后，将模组的 jar 文件放入 .minecraft/mods 文件夹即可。

问：该模组如何实现如此远的渲染效果？

答：如果您接触过 Source 引擎游戏（如 TF2, CS:GO, HL2 等），应该听过“天空盒” (Skybox) 的概念。这是一种在远景渲染出的独立区域，用以制造出整个游戏世界比实际规模更广阔的视觉错觉。

本模组采用类似的渲染逻辑。这意味着渲染出的远景与 Minecraft 的常规游戏世界是完全分离的。这种处理方式有效地避免了图形渲染中的深度冲突 (Z-fighting) 现象以及其他常见的深度计算错误。

问：如何精简从 2.0 迁移到 2.1 后的旧数据库？

答：请务必确保模组已完成全部迁移进程，否则重复操作可能导致数据丢失。您可以通过按 F3 调出的菜单查看迁移进度，若未显示相关列表，说明迁移已完成。

如需对 SQLite 数据库进行清理 (Vacuum)：

下载并安装 DB Browser 工具（或任何支持 SQLite 的数据库浏览器）。 在工具中打开对应的 .sqlite 数据文件（每个维度可能需要单独执行）。 切换至“执行” (Execute) 标签页。 输入并运行命令：vacuum。 等待操作完成，直至磁盘占用回落。在老旧设备或机械硬盘上，此过程可能耗时较长。

## Mod Menu (模组菜单) 概述 Mod Menu 旨在为你提供一个直观的界面，用于查看和管理已安装的模组列表。 该模组不仅能清晰地展示你当前环境下的模组清单，而且如果已安装的模组本身支持，Mod Menu 还能作为一个便捷的入口，让你快速访问并调整这些模组的配置界面。 此外，Mod Menu 还引入了一系列高级功能来增强用户体验和模组展示效果，包括： * **本地化支持**：允许对模组名称和描述进行翻译。 * **富文本描述**：得益于 Patbox 的 Text Placeholder API，模组描述中支持使用 QuickText 格式。 * **智能过滤**：能够区分并过滤掉基础的前置库模组，使列表更整洁。 * **更新检测**：针对托管在 Modrinth 上的模组或提供自定义更新源的模组，内置了更新检查器。 * **深度配置**：针对 Mod Menu 自身提供的所有功能，都给予了用户高度的配置自由。 ### 支持平台 目前，Mod Menu 适用于 Minecraft Java 版 1.14 及更高版本，并支持 Fabric 或 Quilt 加载器。 --- ## 开发者指南 Mod Menu 为开发者提供了一套丰富的 API 工具集，旨在优化模组在菜单中的呈现方式。这些工具涵盖了语言键（Language Keys）、JSON 元数据（JSON Metadata）以及通过代码实现的 Java API。 ### 翻译 API (Translation API) 你完全无需编写任何 Java 代码，即可对模组的名称、摘要和详细描述进行本地化处理。只需按照指定格式，将翻译键值添加到你所需的语言文件中即可。 **翻译 API 使用示例** 以下是一个展示 Mod Menu 被翻译成“海盗语”的示例。若要为你自己的模组创建翻译，只需将翻译键末尾的 `modmenu` 替换为你自己的模组 ID 即可（请注意，**不要**替换开头的 `modmenu`），例如：`modmenu.descriptionTranslation.traverse`。 文件：`en_pt.json` ```javascript "modmenu.nameTranslation.modmenu": "Menu o' mods!", "modmenu.descriptionTranslation.modmenu": "Menu o' mods ye installed matey!", "modmenu.summaryTranslation.modmenu": "Menu o' mods ye installed matey!" ``` > **提示**：在此示例中，摘要（summary）的翻译其实是多余的，因为它与描述（description）的内容完全一致。这里将其列出主要是为了演示一项功能：你可以将摘要（即对模组的一句话简短介绍）与详细描述分开独立翻译，哪怕是在英文原版中也是如此！ ### Fabric 元数据 API (Fabric Metadata API) 开发者可以通过在 `fabric.mod.json` 文件中添加特定的元数据来丰富模组的展示信息。 所有相关配置都需要放置在 `fabric.mod.json` 的自定义块（custom block）中。以下是一个集成了该 API 众多功能的配置示例： 文件：`fabric.mod.json` ```javascript { ... "custom": { "modmenu": { "links": { "modmenu.discord": "https://discord.gg/jEGF5fb" }, "badges": [ "library", "deprecated" ], "parent": { "id": "example-api", "name": "Example API", "description": "Modular example library", "icon": "assets/example-api-module-v1/parent_icon.png", "badges": [ "library" ] }, "update_checker": true } } } ``` #### 徽章系统 (`"badges": [ ]`) 虽然对于在 `fabric.mod.json` 中设置了 `"environment": "client"` 的模组，系统会自动添加 `Client`（客户端）徽章，但其他特殊徽章如 `Library`（前置库）和 `Deprecated`（已弃用）则需要在此处手动定义。 支持的徽章值包括： * `library`：应分配给那些纯粹作为其他模组依赖项存在的模组。默认情况下，这些模组不会向用户展示，除非用户手动切换显示开关。 * `deprecated`：应分配给那些仅出于历史兼容原因而存在的模组，例如旧版的 API 模块等。 请注意，任何非上述列出的值都将被忽略，且 Mod Menu 目前不支持开发者自定义徽章。如果你认为确实有必要添加新的徽章类型，可以在项目仓库中提交 Issue 进行讨论。 #### 链接系统 (`"links": { }`) `links` 对象允许模组作者在描述文本的末尾添加自定义超链接。值得一提的是，如果你在标准的 `fabric.mod.json` 元数据中指定了 `sources` 联系方式，它也会自动包含在链接区域中。 `links` 对象中的任何键都会被添加到链接部分，且该键会被直接用作翻译键。例如： 文件：`fabric.mod.json` ```javascript "custom": { "modmenu": { "links": { "modmenu.discord": "https://discord.gg/jEGF5fb" } } } ``` 上述代码将显示一个文本为“Discord”的链接，因为“Discord”是 Mod Menu 提供的 `modmenu.discord` 的英文翻译。 Mod Menu 内置了一些默认的链接翻译键，通常遵循 `modmenu.` 的格式。你可以查阅 Mod Menu 的语言文件以获取完整列表。 如果你希望添加自定义链接，也可以提供自己的翻译。对于任何自定义键，请务必使用**你自己的命名空间**（而不是 `modmenu`），以避免冲突。 #### 父级关系 (`"parent": "mod_id" or { }`) 父级关系用于将一个模组显示为另一个模组的子模组。这通常用于将拆分为多个模块的模组进行归类。 以下示例将当前模组定义为模组 'flamingo' 的子模组： 文件：`fabric.mod.json` ```javascript "custom": { "modmenu": { "parent": "flamingo" } } ``` 此外，如果你想将多个模组归类在一个父级下，但这个父级本身并不是一个真实存在的模组，你也可以通过定义虚拟父级来实现。如下例所示，一个模组定义了父级的元数据。请确保所有使用这个虚假/虚拟父级的子模组都包含这份元数据。若存在真实的父级模组，这些元数据将作为备选方案，会被真实模组的元数据覆盖。 文件：`fabric.mod.json` ```javascript "custom": { "modmenu": { "parent": { "id": "this-mod-isnt-real", "name": "Fake Mod", "description": "Do cool stuff with this fake mod", "icon": "assets/real-mod/fake-mod-icon.png", "badges": [ "library" ] } } } ``` 虚拟父级模组仅支持以下元数据字段： * `id` (字符串) * `name` (字符串) * `description` (字符串) * `icon` (字符串) * `badges` (字符串数组) #### 禁用更新检查器 (`"update_checker": false`) 默认情况下，Mod Menu 的更新检查器会利用你模组 JAR 文件的哈希值在 Modrinth 上查找最新版本。如果找到匹配的项目，它会进一步检查是否存在支持当前模组加载器和 Minecraft 版本的更新。如果新文件的哈希值与当前文件不同，它将提示用户进行更新。 如果你希望禁用此功能，可以在 Mod Menu 元数据中将 `update_checker` 设置为 `false`： 文件：`fabric.mod.json` ```javascript "custom": { "modmenu": { "update_checker": false } } ``` ### Quilt 元数据 API (Quilt Metadata API) 鉴于 Mod Menu 同样支持 Quilt 加载器，上一节 Fabric 元数据 API 中提到的所有功能同样适用于 Quilt 模组，但在自定义元数据的格式上存在细微差别。 在 Quilt 中，你不需要将 `"modmenu"` 块放置在 `"custom"` 块内，而是将其直接作为根对象的一个元素。结构如下： 文件：`quilt.mod.json` ```javascript { ... "modmenu": { // 在此处放置你的链接、徽章等配置信息 } } ``` ### Java API 若要利用 Java API 进行开发，你需要在 Gradle 项目中将 Mod Menu 添加为编译时依赖。这并不会强制你的模组在运行时依赖 Mod Menu，但能确保你在开发环境中可以使用它进行测试。 文件：`build.gradle` ```javascript // 在 repositories 块中添加 Terraformers Maven 仓库 repositories { maven { name = "Terraformers" url = "https://maven.terraformersmc.com/" } } // 在 dependencies 块中添加 Mod Menu 作为环境依赖 dependencies { // 对于 Minecraft 1.20.6 之前的版本，请使用 "modImplementation" implementation("com.terraformersmc:modmenu:${project.modmenu_version}") } ``` 接着，请在 `gradle.properties` 文件中定义你所使用的 Mod Menu 版本。建议查阅官方版本列表获取最新的版本号；请注意，如果你未使用最新版 Minecraft，可能需要选择对应的旧版 Mod Menu。 文件：`gradle.properties` ```javascript modmenu_version=VERSION_NUMBER_HERE ``` > **提示**：如果你不希望在测试环境中加载 Mod Menu，但仍需编译支持 Java API 的代码，可以使用 `modCompileOnly` 替代 `modImplementation`（即使 Mod Menu 未更新至你当前运行的 Minecraft 版本，此方法依然有效）。 ####以此开始 (Getting Started) 要开始使用 API，你需要在一个类上实现 `ModMenuApi` 接口，并在 `fabric.mod.json` 中将其添加为类型为 "modmenu" 的入口点（entry point）： 文件：`fabric.mod.json` ```javascript "entrypoints": { "modmenu": [ "com.example.mod.ExampleModMenuApiImpl" ] } ``` #### 模组配置屏幕 (Mod Config Screens) 模组可以提供一个屏幕工厂（Screen Factory），以便在用户点击配置按钮时打开自定义的配置界面。为此，请在你的 API 实现类中重写 `getModConfigScreenFactory` 方法。 此功能的预期用途是让模组能够提供其**自身**的配置界面。配置屏幕的模组 ID 将由可以自动确定该入口点来源的模组容器决定。 #### 提供的外部配置屏幕 (Provided Config Screens) 模组不仅可以为自己，还可以为**其他**模组提供屏幕工厂，以便通过配置按钮打开。为此，请在你的 API 实现类中重写 `getProvidedConfigScreenFactories` 方法。 此功能的典型应用场景是像 Cloth Config 这样的模组，它需要为那些使用了其 API 的其他模组提供配置界面。 #### 整合包徽章 (Modpack Badges) 模组可以通过实现 `attachModpackBadges` 方法，赋予其他模组 `Modpack`（整合包）徽章。示例如下： ```javascript @Override public void attachModpackBadges(Consumer consumer) { consumer.accept("modmenu"); // 声明 'modmenu' 是该整合包的一部分 } ``` 请注意，“内部”模组（如 Minecraft 本体和模组加载器）无法被赋予整合包徽章，因为它们通常不包含在常规的整合包分发文件中。 #### 静态辅助方法 (Static Helper Methods) `ModMenuApi` 还提供了一些便捷的静态辅助方法，方便那些希望与 Mod Menu进行更好集成的模组使用，例如创建自定义的“模组”按钮。 **创建模组屏幕实例** 调用此方法可直接获取模组列表屏幕的实例： ```javascript Screen createModsScreen(Screen previous) ``` **获取模组按钮文本** 调用此方法可获取 Mod Menu 风格的“模组”按钮上应显示的文本内容： ```javascript Text createModsButtonText() ```

维尔特鲁姆人飞行（Viltrumite Flight）

这是一款超级英雄飞行模组，同时也是我正在开发的“维尔特鲁姆人”模组所配套的应用程序接口（API）。

本模组旨在还原“维尔特鲁姆人”式的飞行力学，并配备了平滑的动画效果与沉浸式的音效。它在创造模式中完全独立运行，不仅支持高速飞行，还加入了极具动感的镜头抖动特效。尽管该模组主要是为我即将推出的“维尔特鲁姆人”模组所服务，但其他开发者如果感兴趣，依然可以深入研究并将其集成到自己的项目中。

您可以利用键盘上的 SHIFT 键锁定巡航速度。通过在按住 SHIFT 键的同时双击空格键，即可触发快速起飞功能。请务必注意，在飞行状态从“无（NONE）”平稳过渡到“悬停（HOVER）”之前，千万不要松开 SHIFT 键。

玩家在飞行过程中会处于以下 4 种状态之一：

无（NONE）： 这是默认状态，此时您正处于地面或正常下落过程中。 悬停（HOVER）： 您将悬浮在空中，并可通过 WASD 键组合空格键或 SHIFT 键进行小范围移动（即原版飞行模式）。 巡航（CRUISE）： 您将沿着视角方向快速飞行。必须长按 CTRL 键才能持续加速并保持飞行状态。 音速（SONIC）： 您将以接近极限的速度飞行（速度达到或超过 80%）。