Codex:标题卷轴

Codex:标题卷轴

一个为聊天中玩家名字添加头衔的生活质量模组。

Codex: 称号卷轴

Minecraft NeoForge Version Side Type Source

玩家可以在战利品中找到称号卷轴,右键点击可解锁一个称号,然后打开 /title 查看自己的收藏并选择想要佩戴的称号。尚未找到的称号显示为“?”,不会显示名称、稀有度或风味文本。

模组未内置任何称号。每个称号都是数据包中的一个小型 JSON 文件,因此每个服务器都可以自行编写。

特性

  • 每个称号对应一个物品。卷轴给予哪个称号存储在物品堆叠上,可通过战利品表条目或命令设置。
  • 已解锁的称号和当前佩戴的称号按玩家保存,重新登录与死亡后仍然保留。
  • /title 打开一个网格菜单,每页 54 个称号。点击称号即可佩戴,再次点击即可取下。
  • 稀有度通过槽位边框显示:绿色为普通,蓝色为稀有,紫色为史诗,金色为传说,红色为唯一。
  • 在物品栏中悬停卷轴可显示其称号和稀有度。
  • 未解锁的称号永远不会发送到客户端,因此无法提前读取。
  • 已拥有称号对应的卷轴不会被消耗,因此可以交易。
  • 称号会随原版 /reload 一起重新加载。

添加称号

在 data/<namespace>/titles/<id>.json 添加文件:

{
  "display": "&6Kitsune",
  "rarity": "unique",
  "flavor_text": "Outfoxed the impossible.",
  "chat_color": "&6"
}
  • display(必填):称号文本。& 颜色代码可用。
  • rarity(可选,默认 common):common、rare、epic、legendary 或 unique。
  • flavor_text(可选):解锁后在菜单中显示的一行文本。
  • chat_color(可选):玩家佩戴该称号时聊天消息的颜色,例如 &b 或 &#FFD700。它由你的聊天模组读取,永远不会发送到 /title 菜单。

称号的 id 即其文件名(kitsune)。如果两个数据包使用相同的文件名,第二个会以 namespace:id 的形式使用,并记录一条警告。

给予称号

/titlescroll give <player> <title> [amount]

称号 id 支持 Tab 补全。需要 OP 等级 2。无法放入玩家物品栏的卷轴会掉落在其脚下。

作为战利品表条目:

{
  "type": "minecraft:item",
  "name": "titlescrolls:title_scroll",
  "functions": [
    {
      "function": "minecraft:set_components",
      "components": { "titlescrolls:grants_title": "kitsune" }
    }
  ]
}

在聊天中显示称号

称号卷轴通过 /title 独立运作。要在聊天中显示当前佩戴的称号,请使用可读取它的聊天模组。配合 NeoEssentials 时,称号卷轴会为你的聊天格式注册一个 {active_title} 占位符。

从 1.0.1 更新

1.0.2 将称号卷轴迁入 Codex 系列。jar 文件现在命名为