Structure Explorer

模组

· 作者 fella_guy

追踪玩家发现的轨道结构,并支持查看自己、其他玩家的追踪记录以及排行榜

0 本站下载 0 关注 更新于 2 个月前

最新 1.1.5+26.3-fabric · 26.3 · Fabric

一键开服(送7天)

结构探索器

此模组为玩家提供了动力,去尝试发现世界中所有的结构!

我曾想创建一个服务器,激励玩家探索世界的各个角落。随着每隔几个月就会添加更多结构,但我找不到任何能够追踪已发现结构的模组。很多年前我尝试为自己制作一个但失败了,现在我又试了一次,并在两天内完成了它。

它的工作原理是:默认每 5 秒自动检查所有移动中的玩家,判断他们是否处于某个结构内,并将该结构添加到该玩家的已发现结构列表中。 结构的自动发现

⌨ 命令

主要命令:/explorer - 别名:/discoveries

命令 描述
/explorer page? <n> 查看你已发现的結構。页码为可选参数
/explorer player <name> page? <n> 查看其他玩家的发现记录。页码为可选参数
/explorer structure <id> 查看谁发现了特定结构
/explorer instances <id> page? <n> 查看你记录的特定结构实例。页码为可选参数
/explorer here 显示你当前所处结构的详细信息面板
/explorer leaderboard page? <n> 按发现数量排名的顶级玩家列表。页码为可选参数
/explorer playerinstances <player> <id> [OP] 查看任意玩家的实例记录
/explorer reload [OP] 重新加载配置和翻译文件

? 配置文件 - structure_explorer.json

位置:config/structure_explorer/structure_explorer.json

键 (Key) 默认值 描述
checkIntervalMs 5000 模组检查玩家是否进入结构的频率(毫秒)。数值越低 = 响应越快,但会略微增加服务器负载。
showNthDiscoverer true 是否在聊天通知中显示发现者徽章,例如 [首次发现者!] 或 [第 3 位发现者]。
useMonthDayYear false 时间戳格式。false = DD/MM/YYYY HH:MM:SS - true = MM/DD/YYYY HH:MM:SS
trackInstances true 是否记录每次访问的结构实例的坐标和时间戳。当设为 false 时,仅追踪哪些结构类型已被发现。
sounds.newDiscoverySound true 播放新发现结构的音效。
sounds.newInstanceSound true 播放新发现实例的音效。

? 面向模组开发者

Structure Explorer 可以通过两种方式获取结构名称——请选择适合您的一种方式。

选项 1 - 语言文件 (最简单)

如果您的模组已经有语言文件,Structure Explorer 会自动读取它。只需使用以下键格式添加条目:

"structure.<namespace>.<path>": "显示名称"

在 assets/mymod/lang/en_us.json 中的示例:

{
  "structure.mymod.cool_dungeon": "Cool Dungeon"
}

无需额外文件——名称会自动被识别(具体显示方式见下文场景说明)。

注意: 这仅适用于直接打包在模组 JAR 内的语言文件(assets/<namespace>/lang/en_us.json)。Structure Explorer 在服务端运行,无法读取资源包的语言文件——这些文件仅存在于客户端,服务端永远不可见。如果您的语言条目位于单独的资源包中而非模组的 JAR 内,请使用下面的选项 2。

选项 2 - translations.json (完全控制)

如需对前缀、后缀、颜色和确切名称拥有完全控制权,请在您的模组 JAR 内的 data/<your_modid>/structure_explorer/translations.json 处捆绑一个文件,使用与服务端管理员配置相同的翻译文件格式。它会在 config/translations/ 文件之前加载,因此服务端管理员始终可以覆盖它。


两者的交互方式

假设 Katter's Structures 在其语言文件中包含 "structure.kattersstructures.sky_dungeo": "Sky Dungeon"。以下是最终显示名称的确定方式:

场景 1 - 不存在语言条目也不存在翻译条目

例如 kattersstructures:ancient_ruins 且任何地方都未定义 结果:Ancient Ruins [Kattersstructures] 结构路径和命名空间均会被自动美化(下划线转为空格,每个单词首字母大写)并组合在一起——这是原始的回退方案。

场景 2 - 存在语言名称,但在任何地方(模组内置或服务器配置)都没有针对该命名空间的翻译条目

结果:Sky Dungeon [Kattersstructures] 由于没有自定义内容,命名空间会被自动美化并以方括号形式追加。

场景 3 - 翻译条目覆盖了此特定结构的名称

{
  "translations": {
    "kattersstructures": {
      "suffix": " [Katter's Structures]",
      "suffix_color": "gray",
      "structures": { "sky_dungeo": "Big Sky Fortress" }
    }
  }
}

结果:Big Sky Fortress [Katter's Structures] 使用覆盖后的名称,应用样式,且自动方括号消失。

场景 4 - 翻译条目设置了命名空间的样式但未覆盖此结构

{
  "translations": {
    "kattersstructures": {
      "prefix": "Katter's: ",
      "prefix_color": "red"
    }
  }
}

结果:Katter's: Sky Dungeon sky_dungeo 没有覆盖项,因此使用语言文件中的名称作为基础——应用样式,且无自动方括号。


如果有人希望为其他模组制作非官方支持,数据包也可以工作——捆绑一个 data/<your_namespace>/structure_explorer/translations.json,就像上面的选项 2 一样。这些文件会在 config/translations/ 文件之前加载,因此服务端管理员始终可以覆盖它们。


? 翻译

原版结构名称默认已翻译——例如 minecraft:fortress ➡ 下要塞。若要自定义任何命名空间的名称,请将 JSON 文件放置在:

config/structure_explorer/translations/ - 文件可以任意命名(例如 minecraft.json、custom.json),并在内置翻译和模组捆绑翻译之后加载,因此它们始终具有最高优先级。可随时使用 /explorer reload 重新加载(需要 OP 权限)。

翻译文件格式

{
  "replace": false,
  "translations": {
    "namespace": {
      "prefix": "",
      "prefix_color": "",
      "suffix": "",
      "suffix_color": "",
      "name_color": "",
      "structures": {
        "structure_path": "Display Name"
      }
    }
  }
}

以下是一个示例,使用了 Minecraft Vanilla Locations

键 默认值 描述
replace false false 表示与现有翻译合并(新文件在冲突时胜出,前缀/后缀/颜色仅在非空时覆盖)。true 会丢弃该命名空间的所有内置/先前翻译——仅保留你在此处定义的内容。
prefix / suffix "" 显示在结构名称之前/之后的文本,例如 "prefix": "Minecraft: " → Minecraft: Stronghold
prefix_color / suffix_color / name_color (金色) 分别应用于各部分的颜色。详见 Colors。
structures (无) 结构路径 → 显示名称的映射。路径是结构 ID 中冒号之后的部分——例如 minecraft:stronghold → 路径为 stronghold

颜色

命名颜色(不区分大小写):black dark_blue dark_green dark_aqua dark_red dark_purple gold gray dark_gray blue green aqua red light_purple yellow white

十六进制颜色(CSS 风格,以 # 开头):"#FF5500" "#00AAFF" "#FFFFFF"


免责声明:本模组的某些部分使用了 AI 辅助生成。

如果没有修改和学习 TelepathicGrunt 的 WITS mod,我就不可能开始制作此模组。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源