终极欢迎插件

社区插件

您的Hytale服务器的终极社区管理插件！

通过自动广播、欢迎消息和可点击链接来构建您的社区——所有内容均可通过简单的配置文件进行自定义。

加入Hytaleus服务器！https://hytaleus.com/

功能

自动广播

通过可配置间隔的轮播广播消息，让您的玩家随时了解信息。非常适合推广您的Discord、网站或投票链接。

欢迎消息

当新玩家加入服务器时，用可自定义的欢迎消息问候他们，留下良好的第一印象！

可点击链接

所有链接（Discord、网站、投票）在聊天中可点击——玩家只需一次点击即可加入您的社区。

完全自定义

每条消息、颜色和格式选项均可通过config.json文件配置，无需编码！

智能链接检测

• 包含%WEBSITE%的行在未配置网站时自动隐藏
• 包含%VOTE%的行在未配置投票链接时自动隐藏
• 广播可要求在配置特定链接后才显示

实时重新加载

无需重启服务器即可重新加载配置！所有设置（包括广播间隔）都会立即生效。

---

命令

命令	权限	描述
/discord	所有人	显示所有服务器链接（Discord、网站、投票）
/vote	所有人	显示投票链接（仅在配置后可用）
/community	仅OP	无需重启服务器重新加载配置

---

权限

插件使用服务器的permissions.json文件。只有属于包含*（所有权限）的组的玩家才能使用/community。

示例permissions.json：

{
  "users": {
    "your-uuid-here": {
      "groups": ["OP"]
    }
  },
  "groups": {
    "Default": [],
    "OP": ["*"]
  }
}

---

安装

1. 下载community-plugin.jar
2. 将其放入服务器的mods/文件夹
3. 启动服务器
4. 插件将创建mods/community-plugin/config.json
5. 根据您的喜好编辑配置
6. 重启服务器

---

配置

配置文件位于mods/community-plugin/config.json

基本设置

{
  "serverName": "MyServer",
  "discordLink": "https://discord.gg/example",
  "websiteLink": "https://myserver.com",
  "voteLink": "https://vote-site.com/myserver",
  "broadcastIntervalMinutes": 30,
  "enableWelcomeMessage": true,
  "enableBroadcasts": true
}

设置	描述
serverName	您的服务器名称（通过%SERVER%在消息中使用）
discordLink	您的Discord邀请链接
websiteLink	您的网站URL（留空""以禁用）
voteLink	您的投票页面URL（留空""以禁用）
broadcastIntervalMinutes	广播间隔时间（分钟）
enableWelcomeMessage	启用/禁用欢迎消息
enableBroadcasts	启用/禁用自动广播

消息配置

每条消息行是一个包含以下属性的对象：

{
  "text": "Your message here",
  "color": "#FFAA00",
  "bold": true,
  "isLink": false
}

属性	描述
text	消息文本（支持占位符）
color	十六进制颜色代码（例如#FF0000表示红色）
bold	使文本加粗（true/false）
isLink	使文本可点击（true/false）

占位符

在消息中使用以下占位符：

占位符	替换为
%SERVER%	您的服务器名称
%DISCORD%	您的Discord链接
%WEBSITE%	您的网站链接
%VOTE%	您的投票链接

广播配置

广播会轮播配置的消息。您可以要求特定的链接：

{
  "lines": [
    { "text": "Visit our website!", "color": "#FFAA00", "bold": true, "isLink": false },
    { "text": "%WEBSITE%", "color": "#55FFFF", "bold": false, "isLink": true }
  ],
  "requiresWebsite": true,
  "requiresVote": false
}

• requiresWebsite：仅在配置了网站时显示此广播
• requiresVote：仅在配置了投票链接时显示此广播

---

示例配置

{
  "serverName": "MyAwesomeServer",
  "discordLink": "https://discord.gg/example",
  "websiteLink": "https://myserver.com",
  "voteLink": "",
  "broadcastIntervalMinutes": 15,
  "enableWelcomeMessage": true,
  "enableBroadcasts": true,

  "welcomeMessages": [
    { "text": "==========================", "color": "#FFAA00", "bold": false, "isLink": false },
    { "text": "Welcome to %SERVER%!", "color": "#FFAA00", "bold": true, "isLink": false },
    { "text": "==========================", "color": "#FFAA00", "bold": false, "isLink": false },
    { "text": "", "color": "#FFFFFF", "bold": false, "isLink": false },
    { "text": "Discord: %DISCORD%", "color": "#55FF55", "bold": false, "isLink": true },
    { "text": "", "color": "#FFFFFF", "bold": false, "isLink": false },
    { "text": "Have fun!", "color": "#AAAAAA", "bold": false, "isLink": false },
    { "text": "==========================", "color": "#FFAA00", "bold": false, "isLink": false }
  ]
}

---

颜色参考

一些常见的十六进制颜色：

颜色	十六进制代码
金色	#FFAA00
绿色	#55FF55
青色	#55FFFF
红色	#FF5555
蓝色	#5555FF
紫色	#AA55FF
白色	#FFFFFF
灰色	#AAAAAA

---

支持

需要帮助？有建议吗？

• 加入我们的Discord获取支持
• 在我们的GitHub上报告问题

---

享受构建您的社区吧！