欢迎传说

WelcomeTale

一个 Hytale 服务器插件，可禁用默认的加入/离开消息广播，并在玩家加入/离开你的服务器时显示自定义欢迎消息。

描述

WelcomeTale 是一个 Hytale 插件，通过全面的消息系统增强玩家体验：

• 全服加入公告：当有人加入时（向所有玩家广播自定义加入消息）
• 私密欢迎消息：直接发送给加入玩家的消息
• 全服离开公告：当有人离开时（向所有玩家广播自定义离开消息）

你可以个性化所有消息格式，支持颜色、多行显示，并可控制是否显示默认加入消息。

GitHub 仓库

下载地址

你可以从多个平台下载 WelcomeTale：

• GitHub Releases - 官方发布
• CurseForge - Hytale 模组仓库
• ModTale - 社区模组平台
• Unified Hytale - Hytale 模组仓库

📢 希望我们在其他平台发布？ 请告诉我们你想看到的平台！

功能特性

• 💬 三重消息系统 - 完全控制玩家连接消息：

  • 加入广播 (JoinMessage) - 当有人加入时向所有玩家广播
  • 私密欢迎 (WelcomePlayerMessage) - 仅发送给加入玩家的个人欢迎消息
  • 离开广播 (LeaveMessage) - 当有人离开时向所有玩家广播

• 🎨 颜色和格式支持 - 使用 Minecraft 颜色代码 (&) 创建多彩、带样式的消息

  • 16 种颜色选项（黑色、蓝色、绿色、青色、红色、紫色、金色、灰色等）
  • 文本格式：粗体 (&l)、斜体 (&o)、重置 (&r)

• 🔗 可点击链接 - 自动检测并将 HTTP/HTTPS 网址转换为可点击链接

  • 链接以青色显示，点击后在浏览器中打开
  • 支持包含路径、查询和参数的复杂 URL

• 📝 多行消息支持 - 使用多行创建漂亮的消息横幅

• 👤 玩家名称占位符 - 使用 {player} 动态插入加入玩家的名称

• 🔕 可选的加入消息控制 - 禁用 Hytale 默认加入消息，实现完全控制

• 🚪 可选的离开消息补丁 - 使用早期插件转换器禁用 Hytale 默认的 "player left world" 消息

• 🔄 热重载配置 - 使用命令 /welcometale 无需重启服务器即可更新设置

• ⚙️ 简单的 JSON 配置 - 简单、易读的配置文件

• 🛡️ 权限系统 - 控制谁可以重载配置

⚠️ 关于默认离开消息的说明： 与加入消息不同，Hytale 不提供通过插件 API 禁用默认 "player left world" 消息的原生方法。要禁用它们，你可以使用 /welcometalepatch 命令自动安装早期插件补丁，或阅读 leaveWorldMessagePatch.md 获取详细说明、手动安装和安全信息。

---

服务器管理员指南

安装方法

1. 从 Releases 页面下载最新版本
2. 将 WelcomeTale-x.x.x.jar 文件放入 Hytale 服务器的 mods 文件夹
3. 启动你的服务器
4. 插件会自动在 mods/com.rmaafs_WelcomeTale 下创建一个文件夹

配置说明

首次设置

首次运行插件时，它会在 mods/com.rmaafs_WelcomeTale 目录下生成一个 config.example.json 文件。

重要提示： 你必须将 config.example.json 重命名为 config.json 才能使用自己的配置。

⚠️ 从旧版本升级？ 请查看服务器 mods/com.rmaafs_WelcomeTale 文件夹中的 config.example.json 文件，以使用新的配置格式。

配置选项

config.json 文件包含以下选项：

{
  "DisableDefaultJoinMessage": true,
  "JoinMessage": ["", "&3&l > &3{player} &b 加入了", ""],
  "LeaveMessage": ["", "&4&l > &4{player} &c 离开了", ""],
  "WelcomePlayerMessage": [
    "",
    "&6&l=====================================",
    "&e&l欢迎来到我们的服务器！",
    "&6&l=====================================",
    "",
    "&7我们很高兴你来到这里，&b{player}&7！",
    "&7准备好迎接&e&l精彩的冒险&r&7吧。",
    "",
    "&6&l> &6加入我们的社区：",
    "&7  - 网站：&ehttps://rmaafs.com",
    "&7  - GitHub：&ehttps://github.com/rmaafs/WelcomeTale",
    "",
    "&6祝你玩得愉快！:)",
    ""
  ],
  "MessageReloaded": "&a配置重载成功！",
  "NoPermission": "&c你没有使用此命令的权限！",
  "CheckForUpdates": true
}

配置字段说明：

• JoinMessage：全服广播消息，当有人加入时发送给所有玩家

  • 使用 {player} 作为加入玩家名称的占位符
  • 支持使用 & 的颜色代码（参见下方颜色代码部分）
  • 设置为空数组 [] 可禁用服务器广播
  • 示例：["&3&l > &3{player} &b 加入了"]

• LeaveMessage：全服广播消息，当有人离开时发送给所有玩家

  • 使用 {player} 作为离开玩家名称的占位符
  • 支持使用 & 的颜色代码（参见下方颜色代码部分）
  • 设置为空数组 [] 可禁用离开广播
  • 示例：["&3&l < &3{player} &c 离开了"]

• WelcomePlayerMessage：私密欢迎消息，仅发送给加入的玩家

  • 使用 {player} 作为加入玩家名称的占位符
  • 非常适合展示服务器规则、链接或个人问候
  • 设置为空数组 [] 可禁用私密欢迎消息
  • 示例：["&7欢迎 &a{player} &7来到服务器！"]

• DisableDefaultJoinMessage：设置为 true 可禁用默认的 Hytale 加入消息。这让你完全控制加入通知

• MessageReloaded：配置成功重载时显示的消息

• NoPermission：玩家无权限执行命令时显示的消息

• CheckForUpdates：设置为 true 可启用自动更新检查。启用时：

  • 插件在服务器启动时检查 GitHub 上的新版本
  • 拥有 welcometale.reload 权限的用户在加入时如果发现新版本会收到游戏内通知
  • 设置为 false 可禁用所有更新检查和通知
  • 默认值：true

颜色代码

你可以使用 & 符号后跟颜色代码来自定义消息颜色：

颜色代码：

• &0 - 黑色
• &1 - 深蓝色
• &2 - 深绿色
• &3 - 深青色
• &4 - 深红色
• &5 - 深紫色
• &6 - 金色
• &7 - 灰色
• &8 - 深灰色
• &9 - 蓝色
• &a - 绿色
• &b - 青色
• &c - 红色
• &d - 浅紫色
• &e - 黄色
• &f - 白色

格式代码：

• &l - 粗体
• &o - 斜体
• &r - 重置（移除所有格式）

示例：

"WelcomePlayerMessage": ["&7欢迎 &a&l{player}&r &7来到我们的 &b&o精彩&r &7服务器！"]

这将显示："欢迎 {player} 来到我们的 精彩 服务器！" 并带有相应颜色。

多行消息

你可以对 JoinMessage 和 WelcomePlayerMessage 使用数组格式来创建多行消息：

"WelcomePlayerMessage": [
  "&7============================",
  "&a&l欢迎 {player}！",
  "&7感谢你加入我们",
  "&e祝你玩得开心！",
  "&7============================"
]

每行将单独显示，形成漂亮的消息横幅。

消息行为

当玩家加入服务器时：

1. JoinMessage 广播给服务器上的所有玩家（如果不为空）
2. WelcomePlayerMessage 私密发送给加入的玩家（如果不为空）

当玩家离开服务器时：

1. LeaveMessage 广播给服务器上的所有玩家（如果不为空）

如果任何消息字段为空数组 [] 或仅包含空白字符，则该消息不会发送。

重载配置

修改 config.json 文件后，你可以重载配置而无需重启服务器：

游戏内： 运行命令 /welcometale

控制台： 执行 welcometale

这将立即重载所有配置更改。

命令

命令	描述	权限
/welcometale	重载插件配置	welcometale.reload
/welcometalepatch	安装离开消息的早期插件补丁	welcometale.admin

⚠️ 重要提示： 要禁用 Hytale 默认的 "player left world" 消息，请运行 /welcometalepatch 安装禁用此消息的早期插件。安装后需要重启服务器。

注意： 只有拥有 welcometale.reload 权限的用户才能执行此命令。默认情况下，服务器管理员拥有此权限。

更新通知： 拥有 welcometale.reload 权限的用户在加入服务器时，如果发现插件有新版本可用，会收到游戏内通知。要禁用这些通知，请将 config.json 文件中的 CheckForUpdates 设置为 false。

---

🌟 表示支持

如果你发现这个插件有用，请考虑：

• ⭐ 给这个仓库点星 以示支持，并帮助其他人发现它！
• 👀 在 GitHub 上关注 @rmaafs 以获取未来 Hytale 插件和项目的最新动态
• ☕ 请我喝杯咖啡通过 PayPal 支持持续开发

🎨 需要自定义插件？

我接受 自定义插件开发！如果你需要一个根据服务器需求量身定制的特定插件，或想要一个私密的自定义解决方案，请随时联系我。让我们一起实现你的想法！

---

许可证

本项目按原样提供，供 Hytale 服务器使用。