任务线标题

---

QuestLines Titles

QuestLines Titles 是一个完全独立的 Hytale 服务器玩家称号系统。玩家可以获取并收集装饰性称号（显示在聊天中、名字上方或任何你的聊天格式化工具读取的位置），并通过原生游戏内界面浏览和装备它们。

无需其他插件。QuestLines Titles 开箱即用，独立运行。如果你也运行 QuestLines 任务插件，它会自动连接，提供任务驱动的称号奖励和需求——但这一集成完全可选。

---

功能

称号系统

• 在一个简单的 titles.json 配置文件中定义任意数量的称号。
• 将称号按类别组织（例如 pvp、builder、misc），以便在界面中清晰分组。
• 称号支持丰富的内联格式：十六进制颜色（{#RRGGBB}）、加粗（{b}）、斜体（{i}）等。
• 每个玩家的称号数据存储在单独的 JSON 文件中——无需数据库。

玩家体验

• /title —— 打开游戏内称号选择界面，玩家可以浏览所有已解锁的称号并设置一个为当前生效的。
• 装备前可以预览称号的完整格式。
• 玩家可以随时清除当前生效的称号。

管理员工具

• /titleadmin grant —— 为玩家解锁一个称号。
• /titleadmin remove —— 撤销玩家的一个称号。
• /titleadmin list —— 查看玩家已解锁的所有称号。
• /titleadmin available —— 列出服务器上定义的所有称号。
• /titleadmin ui —— 打开管理员称号管理界面。

---

PlaceholderAPI 集成

当安装 PlaceholderAPI 时，QuestLines Titles 会自动注册其扩展。这会将玩家当前生效的称号暴露为一个占位符，任何兼容 PlaceholderAPI 的聊天格式化工具（例如 EliteEssentials、EssentialsChat、DeluxeChat）都可以使用。

占位符：%title%

这样在你的聊天格式中使用它：

[%title%] %player_name%: %message%

如果玩家没有生效的称号，该占位符会返回空字符串——不会有括号杂乱，也不会破坏格式。返回的值会保留 &-码，以便你的聊天格式化工具正常应用颜色。

---

可选：VaultUnlocked 集成

如果安装了 VaultUnlocked，QuestLines Titles 会将自己注册为一个 ChatUnlocked 聊天前缀提供者。这允许兼容 VaultUnlocked 的聊天插件直接读取玩家的生效称号，完全无需 PlaceholderAPI。

---

可选：QuestLines 集成

当同时安装了 QuestLines 任务插件时，Titles 会自动注册以下额外功能：

动作（从任何任务响应或对话页面触发）：

• giveTitle: —— 为玩家解锁一个称号。
• removeTitle: —— 撤销玩家的一个称号。

需求（将响应或页面置于称号所有权的限制下）：

• hasTitle: —— 如果玩家拥有该称号则通过。
• titleActive: —— 如果玩家当前装备了该称号则通过。

文本变量（在对话或任务文本中使用）：

• {title} —— 替换为玩家当前的生效称号（纯文本），如果未设置则为空。

---

配置

称号在 QuestLinesTitles/titles.json 文件中定义。首次运行时会生成一个默认集：

{ "pvp:warrior": { "category": "pvp", "value": "{#FF4444}{b}Warrior{/}{/}" }, "misc:newcomer": { "category": "misc", "value": "{#55FFFF}Newcomer{/}" } }

键是称号 ID（用于命令和任务动作），category 是界面中显示的组别，value 是格式化的显示文本。