CustomWelcome - CustomWelcome

CustomWelcome 是一款简洁易用的插件，专为自定义服务器中的玩家加入、离开消息以及欢迎信息（MOTD）而设计。

💡重要须知

• 本插件必须搭配 PlaceholderAPI 使用。
• 所有加入、离开和 MOTD 消息的可见性均需要对应的权限支持。完整权限列表请访问插件发布页查看。

🎮功能特性

• 自定义加入/离开消息：完全控制玩家加入和离开服务器时在聊天栏显示的信息。
• 首次加入消息：可设置仅对新玩家显示的独特欢迎语，并支持显示历史玩家总数。
• 可配置的 MOTD：自定义玩家加入时看到的欢迎消息，支持多行和颜色代码。
• 服务器列表 MOTD：自定义在服务器列表（如多人游戏菜单）中显示的描述信息。
• 灵活的开关控制：所有消息均可通过配置文件单独启用或禁用。
• 加入清屏：可配置在玩家加入时是否清空其聊天栏。

🔧指令列表

• /cw version – 查看插件版本。
• /cw reload – 重载插件配置文件。
• /cw motd – 预览当前配置中的 MOTD 效果。
• /cw – 显示帮助信息。

🔧权限节点

• customwelcome.admin – 允许使用所有管理员指令。

✨安装与依赖

前置需求

• 必须安装 PlaceholderAPI。

可用变量

本插件支持所有 PlaceholderAPI 提供的变量。常用示例：

• %player_name% – 玩家名称。
• %player_count% – 服务器历史加入玩家总数（用于首次加入消息）。

更多变量请查阅 PlaceholderAPI Wiki。

⭐配置文件示例

以下是配置文件 config.yml 的核心内容示例，你可以根据需要进行修改：

# 加入与离开消息配置
config:
  clear-chat-on-join: true
  enable-join-message: true
  join-message: "&7[&a+&7] &bPlayer &d%player_name% &bhas joined the server."
  enable-quit-message: true
  quit-message: "&7[&c-&7] &bPlayer &d%player_name% &bhas left the server."
  enable-first-join-message: true
  first-join-message: "&7[&a+&7] &bPlayer &d%player_name% &bis new on the server. &7(&8#%player_count%&7)"
  priority: 1

# 玩家加入时显示的 MOTD
motd:
  enable-motd-message: true
  priority: 0
  motd-message:
    - "&7&m▶----------------------------◀"
    - "&d        &8[&6✦&8] &dExample Server &8[&6✦&8]"
    - "&f         Welcome back &b%player_name%"
    - ""
    - "&e            www.example.com"
    - "&7&m▶----------------------------◀"

# 服务器列表显示的 MOTD
server-list-motd:
  enable-server-list-motd-message: true
  message: "&aWelcome to the server! Visit our website at www.your-site.com"
  player-count: 0 # 建议保持默认，无需修改

❓注意事项与支持

• 这是开发者的第一个插件，如果你发现任何错误、漏洞或有改进建议，欢迎通过 Discord 或 GitHub 提交反馈。
• 感谢你的下载与使用！