以太标题

EtherTitle 是一个 Hytale 服务器插件，允许管理员创建、管理和向玩家显示自定义标题消息。标题会出现在玩家屏幕中央，类似于成就通知或活动通告。

功能特性

• 创建多个命名的标题配置
• 设置自定义主标题和副标题文本
• 向所有在线玩家显示标题
• 使用 JSON 进行持久化存储
• 基于命令的简单操作界面

安装

1. 将插件 JAR 文件放入服务器的 mods 文件夹
2. 启动或重启你的 Hytale 服务器
3. 插件会自动创建 mods/EtherTitle 目录
4. 目录内将生成包含默认示例的 titles.json 文件

 

命令

主命令

/ethertitle

显示包含所有可用子命令的帮助菜单。

---

创建标题

/ethertitle create <name>

使用指定的名称创建一个新的空白标题配置。

示例：

/ethertitle create hola

输出：

标题 'hola' 创建成功！
现在你可以配置它了：
  /ethertitle addtitle hola <文本>
  /ethertitle addsubtitle hola <文本>

---

添加主标题文本

/ethertitle addtitle <name> <text>

设置主标题文本（显示在屏幕中央的大号文字）。

示例：

/ethertitle addtitle hola Welcome!

输出：

主标题已添加到 'hola'
预览：Welcome!

---

添加副标题文本

/ethertitle addsubtitle <name> <text>

设置副标题文本（显示在主标题下方的较小文字）。

示例：

/ethertitle addsubtitle hola Enjoy your stay

输出：

副标题已添加到 'hola'
预览：Enjoy your stay

---

向玩家显示标题

/ethertitle show <name>

将配置好的标题显示给所有在线玩家。

示例：

/ethertitle show hola

输出：

标题 'hola' 已显示！

玩家所见：

• 主标题："Welcome!"（大号文字，屏幕中央）
• 副标题："Enjoy your stay"（较小的文字，位于下方）
• 默认时间：淡入 0.5秒，显示 3.5秒，淡出 1秒

---

列出所有标题

/ethertitle list

显示所有已创建的标题配置。

示例输出：

===========================
  标题 (2)
===========================
> hola
  标题：Welcome!
  副标题：Enjoy your stay
> welcome
  标题：WELCOME!
  副标题：Enjoy your stay on the server

---

删除标题

/ethertitle delete <name>

永久删除一个标题配置。

示例：

/ethertitle delete hola

输出：

标题 'hola' 已删除！

---

重新加载标题

/ethertitle reload

从 titles.json 文件重新加载所有标题。

示例输出：

标题已重新加载！
总共：2 个标题

---

完整使用示例

以下是一个创建名为 "hola" 的标题的逐步示例：

# 第一步：创建标题配置
/ethertitle create hola
# 输出：标题 'hola' 创建成功！
第二步：设置主标题文本
/ethertitle addtitle hola Welcome to the Server!
输出：主标题已添加到 'hola'
输出：预览：Welcome to the Server!
第三步：设置副标题文本
/ethertitle addsubtitle hola Have fun and enjoy your adventure
输出：副标题已添加到 'hola'
输出：预览：Have fun and enjoy your adventure
第四步：向所有玩家显示标题
/ethertitle show hola
输出：标题 'hola' 已显示！
所有在线玩家的屏幕上都将看到此标题
第五步：验证标题已创建
/ethertitle list
输出显示：
> hola
标题：Welcome to the Server!
副标题：Have fun and enjoy your adventure

---

数据存储

文件位置

mods/EtherTitle/titles.json

JSON 结构

{
  "hola": {
    "title": "Welcome to the Server!",
    "subtitle": "Have fun and enjoy your adventure",
    "fadeIn": 10,
    "stay": 70,
    "fadeOut": 20
  },
  "welcome": {
    "title": "WELCOME!",
    "subtitle": "Enjoy your stay on the server",
    "fadeIn": 10,
    "stay": 70,
    "fadeOut": 20
  }
}

时间值

• fadeIn：淡入动画的刻数（10 刻 = 0.5 秒）
• stay：标题显示的刻数（70 刻 = 3.5 秒）
• fadeOut：淡出动画的刻数（20 刻 = 1 秒）

 

---

默认标题

插件自带两个示例标题：

1. "hello"

• 标题：Hello World!
• 副标题：Welcome to the server

2. "welcome"

• 标题：WELCOME!
• 副标题：Enjoy your stay on the server

---

技术细节

标题如何显示

插件使用 Hytale 的 EventTitleUtil.showEventTitleToPlayer() 方法，将标题直接显示在每个玩家的屏幕中央。这与事件通知和成就使用的系统相同。

玩家定位

当使用 /ethertitle show <name> 时，插件会：

1. 从 Universe 中获取所有当前在线玩家
2. 验证每个玩家引用
3. 向每个有效玩家发送标题消息
4. 使用配置的时间值（fadeIn、stay、fadeOut）

持久化

• 所有标题配置会自动保存到 titles.json
• 每个命令执行后都会立即保存更改
• 插件启动时加载该文件
• 使用 /ethertitle reload 手动从磁盘刷新

---

错误消息

消息	原因	解决方案
标题 'hola' 不存在！	尝试修改/显示一个不存在的标题	先用 /ethertitle create hola 创建它
标题 'hola' 已存在！	尝试创建一个重名的标题	使用不同的名称或删除现有标题
显示标题时出错！	显示时的内部错误	检查服务器日志以获取详细信息

---

权限

目前，插件未实现权限系统。所有拥有命令访问权限的玩家均可执行所有命令。这将在未来的版本中修改。

---

版本信息

• 插件版本：1.0.0
• Hytale API：兼容 Hypixel Hytale 服务器 API
• 依赖项：无（仅使用核心 Hytale API）

---