CometWelcome - CometWelcome

CometWelcome 是一款功能全面的玩家欢迎插件，可为你的服务器提供高度可定制的加入/离开消息、标题、音效、烟花、资源包推送等多种欢迎效果。所有消息均支持 PlaceholderAPI 变量，让你能轻松融入玩家数据与个性化内容。

💡重要须知

此插件必须安装 PlaceholderAPI 才能正常工作！

请确保服务器已安装 PlaceholderAPI，下载链接：PlaceholderAPI

首次安装后，请以管理员身份执行以下命令来启用插件功能：

• /papi ecloud download Server
• /papi ecloud download Player
• /papi reload

🎮命令列表

• /cometwelcome - 显示插件帮助、版本等基本信息。
• 别名：/cw、/cometw
• /welcome - 手动在聊天中发送一条“欢迎回来”消息（指向最后加入的玩家）。
• 别名：/wb、/welcomeback
• 请勿在控制台执行此命令
• /cwreload - 重载 CometWelcome 的配置文件，无需重启服务器。
• 别名：/cwrl、/cometwelcomereload、/cometwelcomerl

⭐权限节点

• cw.help - 允许查看 CometWelcome 帮助菜单。
• cw.reload - 允许重载 CometWelcome 的 config.yml。
• cw.updates - （开发中，仅限 OP）当 config.yml 过期时，在聊天中广播消息。
• /welcome 命令默认无需任何权限，所有玩家均可使用。

🔧配置文件详解

配置文件 (config.yml) 版本应与插件版本一致（当前页面顶部可查看）。以下为各主要功能区域的简要说明。

加入消息

控制玩家加入服务器时在聊天栏显示的消息。

• enableJoinMessages：是否启用自定义加入消息。
• joinMessage：加入消息内容，可使用 %p% 代表玩家名，支持 PlaceholderAPI 变量和颜色代码。
• enableCenteredJoinMsg：是否将加入消息居中显示。
• enableJoinHoverMsg：是否使加入消息可点击（点击后发送欢迎语）。
• wbMsg：手动或点击触发的欢迎消息内容。
• joinHoverMsg：鼠标悬停在加入消息上时显示的提示文本。
• joinHoverColor：悬停消息的主颜色代码（无需 & 符号）。

资源包

可配置在玩家加入时强制或推荐其加载资源包。

• enableResourcePack：是否启用资源包发送功能。
• packURL：资源包的直链下载地址。
• kickOnDecline：玩家拒绝资源包时是否踢出。
• kickOnFail：下载失败时是否踢出。
• declinedMessage 等：各种情况下的提示或踢出消息。

控制台前缀

当从控制台执行 /wb 命令时，消息前显示的前缀。

• consoleName：控制台消息前缀，支持颜色代码、Hex 颜色及 PlaceholderAPI 变量。

标题与副标题

玩家加入时在屏幕中央显示的标题消息。

• enableTitleMsg / enableSubtitleMsg：是否启用标题/副标题。
• titleMsg / subtitleMsg：标题/副标题内容。
• fadeIn、stay、fadeOut：标题的淡入、停留、淡出时间（秒）。

BossBar 消息

玩家加入时在 Boss 血条位置显示的消息。

• enableBossBarMsg：是否启用。
• BossBarMessage：显示的文字。
• BossBarStyle：血条样式（如 SOLID、SEGMENTED_20）。
• BossBarColor：血条颜色（如 PURPLE、BLUE）。
• BossBarTime：显示时长（秒）。

ActionBar 消息

玩家加入时在快捷栏上方显示的消息。

• enableActionBarMsg：是否启用。
• actionBarMsg：显示的内容。

加入烟花

玩家加入时在其位置发射烟花。

• enableJoinFireworks：是否启用。
• enableRandomFirework：是否使用随机烟花（若启用，则忽略下方自定义设置）。
• Color1、Color2、Fade1、Fade2：自定义烟花的颜色和褪色颜色（RGB 值，0-255）。
• spawnAmount：烟花发射数量（最多 100）。
• shape：烟花形状（如 LARGE_BALL、STAR）。
• power：烟花升空高度（1-3）。

加入 MOTD

玩家加入后在其聊天栏显示的多行欢迎信息。

• motdEnable：是否启用。
• enableCenteredMOTD：是否居中显示。
• motdMessage：消息内容列表，每行一个条目。支持多行、PlaceholderAPI、颜色代码及 Hex 颜色。

加入/离开音效

玩家加入或离开时播放的音效。

• enableJoinSound / enableQuitSound：是否启用加入/离开音效。
• joinSound / quitSound：音效名称（参考 Bukkit Sound 列表）。
• joinSoundVolume / quitSoundVolume：音量（建议大于 1.0）。
• joinSoundPitch / quitSoundPitch：音高（不超过 2.0）。

离开消息

控制玩家离开服务器时在聊天栏显示的消息。

• enableQuitMessages：是否启用自定义离开消息。
• quitMessage：离开消息内容。
• enableCenteredQuitMsg：是否居中显示。
• enableQuitHoverMsg：是否使离开消息可点击（点击后快速输入私信命令）。
• suggestedCommand：点击后填入聊天栏的命令/消息（如 /mail send %p% <message>）。
• quitHoverMsg：悬停提示文本。
• quitHoverColor：悬停消息的主颜色代码。

❓支持与帮助

如需配置帮助或遇到问题（如配置文件解析错误），请优先通过以下方式联系：

• Discord 支持频道：https://discord.gg/A8GfjsRfBN
• 也可使用在线 YAML 验证器（如 codebeautify.org/yaml-validator）检查配置文件格式。

请注意：请勿在插件评论区内提交错误报告或寻求支持，通过 Discord 或私信联系作者能获得更快的响应。

---

此作品采用知识共享署名-相同方式共享 4.0 国际许可协议进行许可。

下载里程碑：[50] ✓ [100] ✓ [250] ✓ [500] ✓ [1000] ✓

这是作者开发的第一个插件，欢迎反馈你的想法！