结构之眼

结构之眼

将任何物品转化为指向任意结构的下界之眼。

结构之眼允许你指定一件物品（原版或模组）来指向你所选择的结构。右键点击该物品，它会像原版的下界之眼一样发射出去：它会飘向最近的匹配结构，悬停，然后掉落，为玩家指明大致的前进方向。

它是为整合包开发者打造的。无需编写Java代码，无需重启，也不需要复杂的设置——你可以直接在游戏内菜单或通过单个配置文件将物品分配给结构。

---

特性

• 🧭 任意物品 → 任意结构。使用 minecraft:ender_eye、某个模组的饰品或任何其他物品来定位村庄、堡垒、模组地牢——你想要的一切。
• 🎯 真实的下界之眼行为。复用原版的下界之眼，因此飞行轨迹、弧线和掉落手感与真实物品完全一致——并且飞行的眼睛甚至还会显示你的物品的纹理。
• ⚙️ 两种配置方式：适合初学者的配置菜单，或用于高级控制的数据包JSON。
• ♻️ 可重复使用或消耗品。可选择使用后是否消耗该物品，并可设置可选的冷却时间。
• 🌍 跨维度感知。将物品指向下界、末地或模组维度中的结构。如果玩家在错误的维度使用它，他们会收到一条有用的提示信息，而不是毫无反应（可切换）。
• 🏷️ 支持结构标签。可指向单个结构、通过 #tag 指向整个群系，或指向一个列表。
• 🔁 实时重载。通过 /reload 即可应用更改——无需重启游戏。

---

如何使用（简易指南）

无需任何文件。在游戏内：

1. 按 Esc → 模组 → 结构之眼 → 配置
2. 打开 物品至结构映射 并点击 ＋
3. 输入一行内容并点击 完成：

minecraft:ender_eye > #minecraft:village

像读句子一样理解它：“ender_eye 寻找村庄。”

要将其限制在单个维度，请在末尾添加 @ <维度>：

minecraft:blaze_rod > minecraft:fortress @ minecraft:the_nether

行格式： <物品> > <结构>（可选 @ <维度>）

• ID 的格式为 modid:name（例如 minecraft:ender_eye）。
• 在结构前放置 # 以匹配整个群系，例如 #minecraft:village。

你也可以直接在 config/structureeyes-common.toml 中编辑这些行——这是整合包发布时所携带的文件。所有配置行的消耗 / 冷却 / 搜索半径均来自 [defaults] 部分。

---

高级：数据包映射

如需针对每个物品进行控制（每个物品不同的消耗/冷却/提示信息），请将JSON文件添加至：

data/<你的命名空间>/structureeyes/structure_eyes/<名称>.json

{
  "item": "minecraft:ender_eye",
  "target": "#minecraft:village",
  "search_radius": 100,
  "consume_on_use": true,
  "cooldown_ticks": 0,
  "dimension": "minecraft:overworld"
}

配置行和数据包映射可以并存使用——选择最适合你的方式，或者两者都用。

---

注意事项

• 默认不包含任何映射——在你分配物品之前它不会执行任何操作，因此开箱即用时绝不会干扰原版物品。
• 定位在服务端进行，因此可在单人游戏和专用服务器上正常工作。
• 结构只能在其生成的维度中被定位（这正是跨维度提示信息的作用）。