前缀标题系统

前缀标题系统

一个简单的前缀与后缀标题系统。

TitleTextMod 指令系统

TitleTextMod 提供了一套完整的指令系统，用于管理玩家的经验值/等级、段位、称号（前缀/后缀）以及飞行权限。以下是所有可用指令的详细指南。

📋 指令概览

指令 权限等级 用途
/exp 管理员（等级 2） 管理玩家经验值与等级
/level 管理员（等级 2） 仅管理等级（旧版兼容）
/rank 管理员（等级 2） 设置玩家段位
/set 管理员（等级 2） 设置玩家称号（前缀/后缀）
/fly 管理员（等级 2） 切换飞行（仅 VIP 及以上）
/info 所有人 查看玩家信息

🔹 /exp — 经验值与等级管理

管理玩家经验值与等级的核心指令。支持两种模式：independent（独立）和 shared（共享）。

语法

/exp add <points> [player]
/exp set <points> [player]
/exp remove <points> [player]
/exp level add <levels> [player]
/exp level set <levels> [player]
/exp level remove <levels> [player]
/exp query [player]

参数

参数 类型 说明
points 整数 经验值数量（add/remove 要求 ≥ 1，set 要求 ≥ 0）
levels 整数 等级数量
player 玩家选择器 可选，默认为指令执行者

示例

# 为自己增加 100 点经验值
/exp add 100

# 将 Steve 的经验值设置为 5000 点
/exp set 5000 Steve

# 从 Alex 身上移除 200 点经验值
/exp remove 200 Alex

# 为所有玩家增加 5 级
/exp level add 5 @a

# 将自己的等级设置为 10
/exp level set 10

# 查询 Steve 当前的经验值与等级
/exp query Steve

反馈

  • 经验值已更新：Set <player>'s experience to <value>
  • 等级已更新：Set <player>'s level to <level name>
  • 查询结果：显示当前经验值、等级以及模式（独立/共享）

🔹 /level — 等级管理（独立版）

与 /exp level 类似，但作为独立指令以兼容旧版本。

语法

/level add <amount>
/level set <amount>
/level remove <amount>

参数

参数 类型 说明
amount 整数 add/remove 要求 ≥ 1，set 要求 0 ≤ 数值 ≤ 最大等级

示例

/level add 3       # 增加 3 级
/level set 20      # 将等级设置为 20
/level remove 1    # 移除 1 级

注意事项

  • 仅在独立经验模式下有效。
  • 在共享模式下，返回 Shared mode does not support level operations。

🔹 /rank — 段位管理

设置玩家的段位。支持 Tab 补全。

语法

/rank <player> <rank>

参数

参数 类型 说明
player 玩家选择器 目标玩家
rank 字符串 段位名称（见下文）

可用段位

段位 说明
NONE 无段位
VIP VIP 会员
MVP MVP 会员
ADMIN 管理员

Tab 补全会自动提示可用段位。

示例

/rank Steve VIP
/rank Alex MVP
/rank Notch ADMIN

反馈

  • 成功：Set <player>'s rank to <rank>

🔹 /set — 称号管理

为玩家设置自定义前缀/后缀（称号）。支持富文本（颜色、加粗等）。

语法

/set setPrefix <targets> <prefix>
/set setSuffix <targets> <suffix>
/set clear <targets>
/set get <player>

参数

参数 类型 说明
targets 玩家选择器 支持多个目标（@a、@p 等）
prefix 文本组件 支持 Minecraft 格式化代码，例如 §6[VIP]
suffix 文本组件 同上

示例

# 将 Steve 的前缀设置为金色的 [VIP]
/set setPrefix Steve {"text":"[VIP]","color":"gold"}

# 将所有玩家的后缀设置为 [Adventurer]
/set setSuffix @a {"text":"[Adventurer]","color":"aqua"}

# 清除 Alex 的称号
/set clear Alex

# 查看 Notch 当前的称号
/set get Notch

反馈

  • 前缀已设置：Set <player>'s prefix to <content>
  • 批量操作：Set suffix for <count> players
  • 已清除：Cleared <player>'s title
  • 查询结果：显示目标玩家的前缀与后缀

注意事项

  • 如果新称号与当前称号完全相同，返回 Title unchanged 并中止操作。
  • 支持一次性操作多个玩家。

🔹 /fly — 飞行控制

切换玩家的飞行状态。仅VIP 及以上段位在生存模式下可用。

语法

/fly <true|false>

参数

参数 类型 说明
true 布尔值 启用飞行
false 布尔值 禁用飞行

示例

/fly true     # 启用飞行
/fly false    # 禁用飞行

要求

  • 执行者必须是玩家。
  • 玩家必须处于生存模式。
  • 玩家段位必须为 VIP 或更高。

反馈

  • 成功：Toggled flight for <player>
  • 失败：Flight command failed / Insufficient permissions, VIP or higher required

🔹 /info — 玩家信息

查看玩家当前的经验值、等级、称号等信息。

语法

/info
/info <player>

参数

参数 类型 说明
player 玩家选择器 可选，默认为你自己

示例

/info             # 查看自己的信息
/info Steve       # 查看 Steve 的信息

输出示例

=== Player Info ===
Name: Steve
Level: Elite Adventurer
Experience: 12580
Prefix: [VIP]
Suffix: [Starlight]

权限

所有玩家均可用。

🛡️ 权限等级

Minecraft 指令权限遵循以下等级（对应 Commands.LEVEL_*）：

等级 常量 说明
0 LEVEL_ALL 所有玩家
1 LEVEL_MODERATORS 版主
2 LEVEL_GAMEMASTERS 游戏管理员（OP 等级 2）
3 LEVEL_ADMINS 管理员（OP 等级 3）
4 LEVEL_OWNERS 服主（OP 等级 4）

本文档中除 /info 外的所有指令均需要 等级 2（管理员） 或更高权限。

🌍 本地化

所有指令反馈消息均使用 Component.translatable，支持客户端自动切换语言。翻译键包括：

键 含义
commands.exp.success.exp 经验值修改成功
commands.exp.success.level 等级修改成功
commands.exp.query 查询结果
commands.exp.error.notPlayer 执行者不是玩家
commands.exp.error.invalidAmount 无效数量
commands.exp.error.sharedModeUnsupported 不支持共享模式
commands.rank.success 段位设置成功
commands.rank.error.invalid_rank 无效段位
commands.title.setPrefix.success.single 单个前缀设置成功
commands.title.setPrefix.success.multiple 批量前缀设置成功
commands.title.clear.success.single 单个称号清除成功
commands.title.get 称号查询结果
commands.fly.success 飞行切换成功
commands.fly.error.rank 段位不足
commands.info.* 信息查询相关

📌 使用技巧

  1. 优先使用 /exp 而非 /level —— 它提供更多功能以及目标选择器。
  2. 批量操作 —— 使用 @a、@p 等一次性管理多个玩家。
  3. 调试 —— 搭配 /info 实时验证结果。
  4. 共享经验模式 —— 仅可使用 /exp add 和 /exp query；直接设置等级被禁用。

本文档由 HongHuan 团队维护。如有疑问，请提交 issue 或联系服主。