探险家工具

探险家工具

一套物品和调整合集,改善探索体验

Explorer's Tools

为探险者准备的小工具与调整。

Minecraft 1.21.1 · NeoForge 21.1.248+ · 无必需依赖(Ars Nouveau 和 JEI 可选)

每项功能均可单独关闭;请参阅配置。


物品

物品 ID 获取方式 作用
苔藓紫水晶 explorerstools:mossy_amethyst 无序合成:苔藓地毯 + 紫水晶碎片(#c:gems/amethyst) 按住右键 2 秒,消耗 3 级经验,将其转化为地表跃迁器。若经验等级不足则失败。
地表跃迁器 explorerstools:surface_warper 灌注苔藓紫水晶 可使用三次(可通过数据包配置)。在主世界地下,按住右键 3 秒即可跃迁至正上方地表。提前松开或受到伤害会取消。它仅在无日光到达之处生效,因此无法将你送上浮空岛或带出洞口。若你正上方的柱状区域没有安全落点,则会尝试附近的柱状区域。
要塞搜寻器 explorerstools:fortress_finder 有序合成:四个下界砖(#c:ingots/nether_brick)环绕一个熔岩桶 在下界,副手持有指南针时:以磁石的方式将指南针调谐至最近的下界要塞。
下界要塞指南针 (一个被命名的原版指南针) 由要塞搜寻器制作 持续指向该要塞;其提示框会显示大致距离。
传送门之杖 explorerstools:portal_rod 有序合成:金粒、哭泣的黑曜石、金粒呈对角线排列 在下界右键点击下界传送门以绑定,将杖变为哭泣传送门之杖。
哭泣传送门之杖 explorerstools:crying_portal_rod 绑定传送门之杖 在下界任意位置潜行 + 右键点击,即可返回绑定的传送门。若传送门已消失,则会变回普通传送门之杖。单独将其放入合成格会解除绑定。
凋灵骷髅碎片 explorerstools:wither_skull_fragment 被玩家击杀的凋灵骷髅:50% 概率掉落,抢夺附魔可提高概率。无玩家的刷怪场不会掉落。 合成格中放置九个可制作凋灵骷髅头。

功能

  • 指南针调谐。 要塞搜寻器是一种数据包“调谐”;数据包可添加更多搜寻器,将指南针指向任意结构或结构标签(参见数据包)。被其他模组禁用的原版结构会被自动跳过(参见模组兼容性),因此搜寻器绝不会因搜索永远不会生成的东西而卡住服务器。
  • /afk。 经过 3 秒倒计时后你便进入挂机状态:原地冻结并免受一切伤害。饥饿、溺水、火焰和怪物都无法伤害你,你也无法使用物品、破坏或放置方块、攻击、丢弃物品或打开物品栏。聊天仍然可用。其他玩家会看到 [afk] 标签。再次运行 /afk 即可返回。管理员(权限等级 2)可通过 /afk <player> 立即切换任何人的状态。默认情况下,AFK 玩家不计入过夜所需的睡眠人数,且其周围不会自然生成怪物。可选地,闲置玩家会自动进入 AFK(默认关闭),并在任何活动时返回。
  • 流浪商人 → 村民。 给流浪商人一个绿宝石块,它可能会定居下来,成为当地生物群系类型的村民(5% 概率,若它此前拒绝过你则为 40%)。每次尝试消耗一个绿宝石块。
  • 唤魔者发光。 唤魔者每次召唤恼鬼时会发光 10 秒,以便你找到施法者。
  • 结构法术保护(需要 Ars Nouveau)。破坏、活化方块、无形、牵引和爆炸无法移除或移动受保护结构内的方块(默认情况下为海底神殿和 YUNG 的沙漠神殿)。仅结构实际部件内的方块受到保护:其外的方块会正常受影响,即使在同一施法内也是如此。牵引仍对怪物生效,爆炸仍造成伤害,其他所有法术在任何地方均可用。
  • JEI 页面(需要 JEI),用于说明非合成配方的内容:苔藓紫水晶灌注、传送门之杖绑定,以及所有指南针调谐,包括数据包调谐。

配置

Explorer's Tools 有两个配置文件。

config/explorerstools-common.toml:功能开关

每项功能一个 enabled 开关,默认均为 true。更改需重启。被禁用功能的物品仍会注册(以免世界丢失它们),但会从创造模式标签页和 JEI 中移除,且不产生任何效果;其配方、掉落物和 /afk 命令会消失。在服务器上,服务器的开关优先:客户端加入时会收到这些设置。

配置节 关闭的功能
[surfaceWarper] 地表跃迁器和苔藓紫水晶
[compassAttunement] 要塞搜寻器和所有数据包调谐
[portalRods] 传送门之杖和哭泣传送门之杖
[witherSkullFragment] 碎片、其掉落物和头颅配方
[afk] /afk 命令
[traderConversion] 流浪商人到村民的转化
[evokerGlow] 唤魔者发光
[structureSpellProtection] 结构法术保护

config/explorerstools-server.toml:可调参数

世界 serverconfig/ 文件夹中的副本会为该世界覆盖此配置。

配置节 键 默认值 含义
surfaceWarper landingRing 2(0–4) 当正上方柱状区域没有安全落点时,也尝试向外至多此数值个方块的柱状区域。
compassAttunement searchRadius 100(1–100) 调谐搜索的距离,以结构放置网格单元为单位(非方块)。100 与 /locate 一致。
afk countdownTicks 60(0–600) /afk 生效前的倒计时。受到伤害、移动或攻击会取消。
afk autoAfkMinutes 0.0 闲置玩家在此分钟数后进入 AFK。0 = 关闭。
afk suppressMobSpawning true AFK 玩家周围不自然生成怪物(除非附近也有活跃玩家)。
afk excludeFromSleep true AFK 玩家不计入睡眠所需玩家数。
traderConversion traderSettleChance 0.05 流浪商人被给予绿宝石块时定居的概率。
traderConversion traderRefusedBonus 0.35 商人拒绝过一次后该概率的增加值。
evokerGlow evokerGlowTicks 200 唤魔者召唤恼鬼后发光时长。
evokerGlow evokerGlowRadius 15 当恼鬼没有主人时,此方块范围内的唤魔者会发光。
structureSpellProtection protectedEffects 破坏、活化方块、无形、牵引、爆炸 无法触碰受保护结构中方块的 Ars Nouveau 符文 ID。
structureSpellProtection blockUnderMiningFatigue false 当施法者处于挖掘疲劳时,也阻止这些符文在任何地方触碰方块。

数据包

Explorer's Tools 读取五类数据。请将 mypack 替换为你自己的命名空间。

指南针调谐

每个搜寻器是一个位于 <namespace>/explorerstools/attunement/<name>.json 的 JSON 文件。在主手使用其物品、副手持有指南针时,会将一个指南针指向当前维度内最近的匹配结构。内置的要塞搜寻器为 data/explorerstools/explorerstools/attunement/fortress_finder.json。

示例,data/mypack/explorerstools/attunement/bastion_finder.json:

{
  "item": "minecraft:ender_eye",
  "structures": ["minecraft:bastion_remnant"],
  "target_name": "Bastion Remnants",
  "name": "Bastion Compass",
  "name_color": "#55FFFF",
  "consume": false,
  "dimensions": ["minecraft:the_nether"],
  "description": {"text": "Use in the Nether with a compass in your off hand", "color": "gray"},
  "found_message": {"text": "The compass turns toward a bastion", "color": "aqua"},
  "not_found_message": "No bastion nearby"
}
字段 含义
item 必需。用于调谐的物品(任意物品;其自身的右键用途会被替换)。
structures 必需。一个结构 ID、一个 #tag,或两者的列表。
name 必需。被调谐指南针的名称:纯文本或文本组件(例如 {"translate": "..."})。已有名称的指南针会保留其名称。
target_name 可选:JEI 显示其寻找的内容。默认为结构名称。
name_color 可选:颜色名称(gold)或 #RRGGBB。
consume 可选,默认 true:物品是否被消耗。
dimensions 可选:生效维度。空或缺省表示任何地方。
description 可选:物品的提示框行。
found_message、not_found_message 可选:动作栏文本。

要移除要塞搜寻器的调谐或更改它,请在您自己的数据包中覆盖该文件。调谐在世界加载时加载,因此新增或编辑的调谐需要重启(而不仅仅是 /reload)。

地表跃迁器使用次数

地表跃迁器可容纳的跃迁次数(其耐久度)是一个 NeoForge 数据映射。模组内置数据在 data/explorerstools/data_maps/item/surface_warper_uses.json 中将其设为 3。要更改它,请在数据包中同一路径放置一个文件。请保留 explorerstools 命名空间:数据映射的文件位于数据映射自身的命名空间下,而非你的数据包命名空间。

{
  "values": {
    "explorerstools:surface_warper": { "uses": 5 }
  }
}

uses 必须至少为 1。新值在 /reload 时生效,包括对世界中已有的跃迁器,服务器会将其发送给客户端,以便其耐久条一致。如果调低该值,已用尽新总数的跃迁器会在下次使用时损坏。

标签

标签 类型 默认内容 使用者
explorerstools:fortress_finder_targets 结构 minecraft:fortress、#betterfortresses:better_fortresses(如存在) 要塞搜寻器指向的目标
explorerstools:spell_protected 结构 minecraft:monument、betteroceanmonuments:ocean_monument、betterdeserttemples:desert_temple(如存在) Ars 法术无法破坏的结构
explorerstools:unsafe_landing 方块 岩浆块、仙人掌、营火、灵魂营火 地表跃迁器不会让你落脚的方块

示例:在 data/explorerstools/tags/worldgen/structure/spell_protected.json 中保护林地府邸免受法术影响:

{
  "values": [
    "minecraft:mansion",
    {"id": "#minecraft:village", "required": false}
  ]
}

示例:在 data/explorerstools/tags/worldgen/structure/fortress_finder_targets.json 中让要塞搜寻器也指向一个模组要塞:

{
  "values": [
    {"id": "mymod:blackstone_fortress", "required": false}
  ]
}

示例:在 data/explorerstools/tags/block/unsafe_landing.json 中永不落在滴水石锥或甜浆果丛上:

{
  "values": ["minecraft:pointed_dripstone", "minecraft:sweet_berry_bush"]
}

标签会添加到默认值之上。在顶部放置 "replace": true 则改为从空列表开始。

配方与 feature_enabled 条件

每个内置配方都是普通 JSON 配方,可在同一路径(data/explorerstools/recipe/<name>.json)被覆盖:mossy_amethyst、fortress_finder、portal_rod、portal_rod_unbind 和 wither_skeleton_skull。每个配方都带有 explorerstools:feature_enabled 条件,该条件也可供你自己的配方和战利品修饰器使用。其 feature 是通用配置中的一个配置节名称(surfaceWarper、compassAttunement、portalRods、witherSkullFragment、afk、traderConversion、evokerGlow 或 structureSpellProtection)。

示例:一个更便宜的要塞搜寻器,会随该功能一同消失,位于 data/explorerstools/recipe/fortress_finder.json:

{
  "neoforge:conditions": [
    {"type": "explorerstools:feature_enabled", "feature": "compassAttunement"}
  ],
  "type": "minecraft:crafting_shapeless",
  "category": "misc",
  "ingredients": [
    {"item": "minecraft:compass"},
    {"tag": "c:ingots/nether_brick"}
  ],
  "result": {"id": "explorerstools:fortress_finder", "count": 1}
}

战利品修饰器(explorerstools:add_item)

凋灵骷髅碎片掉落是一个类型为 explorerstools:add_item 的 NeoForge 全局战利品修饰器,当所有条件通过时,会向一次战利品掷骰添加 count(默认 1)个 item。覆盖 data/explorerstools/loot_modifiers/wither_skull_fragment.json 可更改掉落,或添加你自己的;新的修饰器还须列于 data/neoforge/loot_modifiers/global_loot_modifiers.json 中。

示例:下界要塞箱子中也能从凋灵骷髅获得碎片,位于 data/mypack/loot_modifiers/fortress_fragments.json:

{
  "neoforge:conditions": [
    {"type": "explorerstools:feature_enabled", "feature": "witherSkullFragment"}
  ],
  "type": "explorerstools:add_item",
  "conditions": [
    {"condition": "neoforge:loot_table_id", "loot_table_id": "minecraft:chests/nether_bridge"},
    {"condition": "minecraft:random_chance", "chance": 0.25}
  ],
  "item": "explorerstools:wither_skull_fragment",
  "count": 2
}

以及在 data/neoforge/loot_modifiers/global_loot_modifiers.json 中:

{
  "replace": false,
  "entries": ["mypack:fortress_fragments"]
}

模组兼容性

开箱即用,无需配置。以下均非必需。

模组 Explorer's Tools 的行为
Ars Nouveau(5.13+) 启用结构法术保护。
JEI 为苔藓紫水晶灌注、传送门之杖绑定和所有指南针调谐添加页面。被禁用功能的物品会被隐藏。
YUNG's Better Nether Fortresses 要塞搜寻器指向 YUNG 的要塞。若原版要塞被禁用(YUNG 的默认设置),调谐会跳过它们。
YUNG's Better Ocean Monuments YUNG 的海底神殿受法术保护。原版海底神殿被禁用时,调谐会跳过它们。
YUNG's Better Desert Temples YUNG 的沙漠神殿受法术保护。原版沙漠神殿被禁用时,调谐会跳过它们。
YUNG's Better Jungle Temples 原版丛林神庙被禁用时,调谐会跳过它们。
YUNG's Better Mineshafts 原版废弃矿井(两种)被禁用时,调谐会跳过它们。
YUNG's Better Witch Huts 原版沼泽小屋被禁用时,调谐会跳过它们。
Integrated Dungeons and Structures (IDAS) 当 IDAS 禁用原版沙漠神殿时,调谐会跳过它们。
Integrated Villages 当 Integrated Villages 禁用原版村庄时,调谐会跳过它们(该模组中默认关闭)。

“被禁用时跳过”的检查会读取各模组自身的配置,因此会遵循该模组的设置。这些模组替换了原版结构但仍保留了其放置注册;若无此检查,搜索原版结构时会生成一个又一个区块,寻找永远不会出现的东西。

许可证

GPL-3.0-only