资源中心

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

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盗版客户端的问题： 请购买正版游戏，非法复制的游戏版本不在本模组的支持范围内。

LambDynamicLights - 动态光影模组

LambDynamicLights 是 Minecraft 社区中功能最为完备且经过深度优化的动态光影模组。

关于该模组

每当夜幕降临，周围便陷入一片漆黑。在这种伸手不见五指的情况下，手中如果能有一支火把或灯笼来照亮前路，那该有多好……

现在，这一切通过 LambDynamicLights 模组得以实现。它能够为游戏引入动态光影机制，让你在黑暗中也能手持发光物看清周围的环境。

所谓动态光影，是指当实体手持具备光源属性的物品、或是实体自身处于着火状态时所产生的光照效果。

如果您正在寻找能够替代 OptiFine 的模组组合，请务必查看这份推荐列表。

核心功能 动态照明：提供流畅的实时光照效果。 平滑设置：您可以自行调节动态光影的更新平滑度。 物品照明：任何手持发光物品的实体都会向周围散射光线。 物品的光照属性可通过资源包进行自定义，并完美兼容各类模组物品。 特定物品（如普通火把、灵魂火把等）在水下将无法发光。 实体自然发光：多种生物及实体能够自带光效，包括： 悦灵 (Allay) 烈焰人 (Blaze) 火球 (Fireball) 发光鱿鱼 (Glow Squid) 岩浆怪 (Magma Cube) 光灵箭 (Spectral Arrow) 着火照明：处于燃烧状态的实体会自动释放光芒。 开发者支持：为开发者及资源包作者提供简便易用的 API 接口。详情请参阅在线文档。 更多特性：等待您的探索。 场景展示 掉落物发光：掉落在地上的发光物品，现在也能产生真实的动态光源。 手持发光：当实体手持具备光照属性的物品时，周围环境将随之亮起。 烈焰喷射：任何陷入燃烧状态的实体都将成为行走的火源。 即将爆炸：苦力怕在引爆前会根据爆炸进度渐进式地发出强光。 发光鱿鱼：那些引人注目的发光鱿鱼终于在你的世界里名副其实了。 守卫者激光：守卫者的激光束现在拥有了视觉特效，极具张力。 萤火虫：萤火虫粒子在飞行过程中会不断释放光芒。 配置界面：v4.0.0 版本引入了直观的设置界面。 使用说明

使用方法非常简单：

Fabric 版本：将其放置于 mods 文件夹中，同时需安装 Fabric API 和 ModMenu（若追求更高性能，建议搭配 Sodium 使用）。 NeoForge 版本：直接安装至 mods 文件夹即可（同样推荐搭配 Sodium 以提升性能）。

模组安装后即刻生效。您可以通过视频设置或模组列表进入配置界面进行个性化调整。如需获取帮助，欢迎加入我的 Discord 服务器进行交流。

集成与兼容性 Sodium：强烈建议安装以获得最佳性能表现。 Beltborne Lanterns：允许将灯笼装备在腰带上，实现全天候随身携带光源。 Illuminated：一款基于 LambDynamicLights 开发的手电筒模组。

初始结构 (Starter Structure)

初始结构 (Starter Structure) 是一款功能强大的模组，它赋予了你在世界初次生成时，在出生点自动构建预设建筑的能力。通过该模组，系统会在配置文件夹中读取架构文件（Schematic），并将其放置在指定的世界出生点位置。

该模组兼容结构方块架构 (SBS, .nbt 文件) 和世界编辑架构 (WES, .schem/.schematic 文件)。其中，SBS 文件能够包含实体数据，从而直接生成已保存的实体；WES 文件虽然不包含实体信息，但你可以通过在架构中放置告示牌来指定实体的生成位置。两者均支持自定义 NBT 数据。特别说明：你无需在服务器或客户端中长期安装世界编辑 (WorldEdit) 即可使用此模组，它仅在生成架构文件时作为工具使用，完成后即可将其移除。你也可以在其他实例中创建架构，然后将文件复制到所需的整合包中。

此外，模组还提供了丰富的配置选项，你可以精确控制玩家的出生位置（即建筑生成位置）以及建筑的放置方式。

配置选项详解

以下是所有可用的配置项说明：

是否生成建筑 (shouldGenerateStructure) (默认值: true) 决定是否在该模组配置目录('./config/starterstructure/schematics/...')下的架构文件生成。

强制精确出生点 (forceExactSpawn) (默认值: true) 通常玩家出生点是随机的。启用此项后，玩家将始终在设定的精确坐标（即最近的空气方块上方）生成。

建筑放置时忽略树木 (ignoreTreesDuringStructurePlacement) (默认值: true) 防止建筑生成在树木上方，放置过程中会自动忽略树叶和原木方块。

生成时忽略拼图和结构方块 (generationIgnoreJigsawAndStructureBlocks) (默认值: true) 默认情况下，架构文件中可能包含的拼图或结构方块在生成时会被忽略。

保护建筑方块 (protectStructureBlocks) (默认值: true) 决定生成的建筑方块是否受到保护，防止被破坏。

保护生成实体 (protectSpawnedEntities) (默认值: true) 决定在建筑内生成的实体是否受到伤害保护。

创造模式玩家忽略保护 (playersInCreativeModeIgnoreProtection) (默认值: true) 启用后，创造模式玩家将能够破坏或放置被保护的建筑方块。

创造模式玩家忽略实体保护 (playersInCreativeModeIgnoreEntityProtection) (默认值: false) 启用后，创造模式玩家将能够伤害受到保护的建筑内生成实体。

限制生成实体移动 (preventSpawnedEntityMovement) (默认值: false) 若开启，生成的实体将无法离开其生成的原始方块。默认为关闭。

支持架构下的非告示牌实体生成 (spawnNonSignEntitiesFromSupportedSchematics) (默认值: true) 在结构方块架构中发现非告示牌创建的实体时，是否生成它们。

是否使用建筑坐标 (shouldUseStructurePosition) (默认值: false) 是否启用自定义建筑生成坐标选项。

建筑 X 轴坐标 (generatedStructureXPosition) (默认值: 0, 范围: -10000000 至 10000000) 建筑生成的精确 X 轴坐标。需启用 shouldUseStructurePosition。

建筑 Y 轴坐标 (generatedStructureYPosition) (默认值: 0, 范围: -1000 至 1000) 建筑生成的精确 Y 轴坐标。需启用 shouldUseStructurePosition。

建筑 Z 轴坐标 (generatedStructureZPosition) (默认值: 0, 范围: -10000000 至 10000000) 建筑生成的精确 Z 轴坐标。需启用 shouldUseStructurePosition。

是否使用建筑偏移 (shouldUseStructureOffset) (默认值: false) 是否启用自定义建筑位置偏移选项。

建筑 X 轴偏移 (generatedStructureXOffset) (默认值: 0, 范围: -1000 至 1000) 建筑生成的 X 轴偏移量。需启用 shouldUseStructureOffset。

建筑 Y 轴偏移 (generatedStructureYOffset) (默认值: 0, 范围: -1000 至 1000) 建筑生成的 Y 轴偏移量。例如：当建筑生成高度总是偏高一个方块时，可设为 -1。需启用 shouldUseStructureOffset。

建筑 Z 轴偏移 (generatedStructureZOffset) (默认值: 0, 范围: -1000 至 1000) 建筑生成的 Z 轴偏移量。需启用 shouldUseStructureOffset。

是否使用出生点坐标 (shouldUseSpawnCoordinates) (默认值: false) 是否启用自定义出生点坐标选项。

出生点 X 坐标 (spawnXCoordinate) (默认值: 0, 范围: -10000000 至 10000000) 启用 shouldUseSpawnCoordinates 后设定的新出生点 X 坐标。

出生点 Y 坐标 (spawnYCoordinate) (默认值: 0, 范围: -1000 至 1000) 启用 shouldUseSpawnCoordinates 后设定的新出生点 Y 坐标。

出生点 Z 坐标 (spawnZCoordinate) (默认值: 0, 范围: -10000000 至 10000000) 启用 shouldUseSpawnCoordinates 后设定的新出生点 Z 坐标。

是否使用出生点坐标偏移 (shouldUseSpawnCoordOffsets) (默认值: false) 是否启用自定义出生点坐标偏移选项。

出生点 X 轴坐标偏移 (spawnXCoordOffset) (默认值: 0, 范围: -1000 至 1000) 启用 shouldUseSpawnCoordOffsets 后的坐标偏移量。

出生点 Y 轴坐标偏移 (spawnYCoordOffset) (默认值: 0, 范围: -1000 至 1000) 启用 shouldUseSpawnCoordOffsets 后的坐标偏移量。

出生点 Z 轴坐标偏移 (spawnZCoordOffset) (默认值: 0, 范围: -1000 至 1000) 启用 shouldUseSpawnCoordOffsets 后的坐标偏移量。

配置文件路径与操作指南

配置文件夹位于 ./config/starterstructure/schematics。 你可以放入 .nbt、.schem 或 .schematic 格式的架构文件。若文件夹内包含多个文件，模组将随机选择一个进行生成。

自定义告示牌数据存放在 ./config/starterstructure/signdata 中。 通过将 /summon 指令放入该文件夹内的 .txt 文件，并在架构中放置一个引用该文件的告示牌，即可在生成时创建对应的实体。

如何使用世界编辑 (WorldEdit) 生成架构

使用 //wand 指令获取选区工具。 左键点击第一个方块以确定架构的一个底角。 右键点击对角的第二个方块以确定范围（注意之后需移除临时方块），或者使用 //pos2 指令。 站在你希望建筑生成时玩家所处的位置，输入 //copy 指令。 输入 //schematic save <架构名称> 来生成文件。 文件将保存在 ./config/worldedit/schematics 中。 将其复制到初始结构 (Starter Structure) 的配置文件夹 ./config/starterstructure/schematics 中即可。

当新世界生成时，模组即会自动加载并构建该建筑。

告示牌与实体生成

你可以在生成的建筑内部通过放置告示牌来便捷地生成实体：

简单实体生成： 在告示牌上输入以下信息： [Entity] 模组ID:实体ID （新行会被忽略。该格式即会在建筑生成时在此处生成相应的实体，例如村民。）

自定义 NBT 数据生成： 若需生成更复杂的实体（如带有自定义名称、装备或药水效果），可引用 .txt 文件： 在告示牌第一行输入 [NBT]，第二行输入文件名（不含扩展名）。 示例： [NBT] 文件名

系统将会在 ./config/starterstructure/signdata/文件名.txt 中查找实体数据。该文件内容应为标准的 /summon 指令（你可以使用 MCStacker 等工具生成）。初始结构 (Starter Structure) 会自动移除其中的 /summon 部分并将其转换为正确的 NBT 数据进行生成。