CladeWelcome
一款功能强大且轻量级的 Minecraft 服务器欢迎插件,专注于性能、自定义和兼容性。
⭐ 特性
- 可定制的加入和离开消息(支持传统
&代码、&#RRGGBB十六进制色值和 MiniMessage) - 基于权限的分组(管理员、OP、默认以及您自己的分组,例如 VIP),每组拥有独立的消息和音效
- 回归玩家的欢迎回来消息
- 首次加入烟花效果和首次加入命令
- 支持标题栏、动作栏和 BossBar
- 自定义音效和信息面板
- 支持 Discord Webhook 用于加入/离开事件通知
- 支持 PlaceholderAPI
- 每个模块都支持按玩家单独开关
- 10 种语言
- 本地 YAML 或 MySQL 存储,并支持自动降级
? 最新版本:1.3.0
- 修复了 MySQL 支持问题(驱动现在由服务器加载)
%ping%和%joins%等占位符不再过时- Light 模式下不再修改配置文件
- 更新检查器支持 Modrinth 和 Hangar
- 新增
database.use-ssl选项 - 大量错误修复和优化
⚡ 性能模式
Light(默认) 推荐用于小型和中型服务器:提供更好的性能和更低的内存占用。动画和粒子效果被禁用。
Heavy 适用于希望启用所有视觉效果的服务器:包括动画(渐变、彩虹、打字机、波浪、脉冲、滚动)和粒子效果。
? 要求
- Java 17+
- Minecraft 1.17.x – 1.21.x
- Paper, Purpur 或 Spigot
- 可选:PlaceholderAPI、MySQL(服务器首次启动时会自动下载驱动,需要访问 Maven Central 的互联网连接)、任何权限插件(如 LuckPerms)以支持自定义分组
? 命令
| 命令 | 描述 |
|---|---|
/cw help |
显示帮助信息 |
/cw reload |
重新加载配置 |
/cw lang <code> |
更改语言 |
/cw status |
显示插件状态 |
/cw preview <type> [player] |
预览效果 |
/cw toggle [module] |
为自己静音/取消静音模块 |
? 权限
| 权限 | 描述 | 默认值 |
|---|---|---|
cladewelcome.admin |
所有管理命令 | op |
cladewelcome.reload |
重新加载插件 | op |
cladewelcome.lang |
更改语言 | op |
cladewelcome.status |
查看插件状态 | op |
cladewelcome.toggle |
切换自身模块 | true |
cladewelcome.op |
OP 加入消息组 | op |
cladewelcome.vip |
VIP 加入消息组 | false |
cladewelcome.default |
默认加入消息组 | true |
? 语言
英语、俄语、乌兹别克语、德语、西班牙语、土耳其语、法语、波兰语、葡萄牙语、意大利语。
❤️ 致谢
感谢您使用 CladeWelcome。您的反馈和建议有助于改进本项目。
作者:Vunlior · 许可证:Apache License 2.0
CladeWelcome
A powerful and lightweight welcome plugin for Minecraft servers, focused on performance, customization and compatibility.
⭐ Features
- Customizable join and quit messages (legacy
&codes,&#RRGGBBhex and MiniMessage) - Permission-based groups (admin, op, default and your own, e.g. VIP) with their own messages and sounds
- Welcome-back message for returning players
- First-join firework and first-join commands
- Title, ActionBar and BossBar support
- Custom sounds and info panel
- Discord webhook for join/quit events
- PlaceholderAPI support
- Per-player toggles for every module
- 10 languages
- Local YAML or MySQL storage with automatic fallback
🆕 Latest version: 1.3.0
- MySQL support fixed (the driver is now loaded by the server)
- Placeholders such as
%ping%and%joins%are never stale anymore - The config is no longer modified in Light mode
- Update checker supports Modrinth and Hangar
- New
database.use-ssloption - Many bug fixes and optimizations
⚡ Performance modes
Light (default) is recommended for small and medium servers: better performance and lower memory usage. Animations and particles are disabled.
Heavy is for servers that want every visual feature: animations (gradient, rainbow, typing, wave, pulsing, scrolling) and particles.
📋 Requirements
- Java 17+
- Minecraft 1.17.x – 1.21.x
- Paper, Purpur or Spigot
- Optional: PlaceholderAPI, MySQL (the driver is downloaded by the server on first start, internet access to Maven Central is required once), any permissions plugin such as LuckPerms for custom groups
🛠 Commands
| Command | Description |
|---|---|
/cw help |
Show help |
/cw reload |
Reload configuration |
/cw lang <code> |
Change language |
/cw status |
Show plugin status |
/cw preview <type> [player] |
Preview an effect |
/cw toggle [module] |
Mute/unmute modules for yourself |
🔑 Permissions
| Permission | Description | Default |
|---|---|---|
cladewelcome.admin |
All administrative commands | op |
cladewelcome.reload |
Reload the plugin | op |
cladewelcome.lang |
Change language | op |
cladewelcome.status |
View plugin status | op |
cladewelcome.toggle |
Toggle modules for yourself | true |
cladewelcome.op |
OP join message group | op |
cladewelcome.vip |
VIP join message group | false |
cladewelcome.default |
Default join message group | true |
🌍 Languages
English, Russian, Uzbek, German, Spanish, Turkish, French, Polish, Portuguese, Italian.
❤️ Thank you
Thank you for using CladeWelcome. Your feedback and suggestions help improve the project.
Author: Vunlior · License: Apache License 2.0
下载 CladeWelcome
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CladeWelcome
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CladeWelcome
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CladeWelcome
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CladeWelcome
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CladeWelcome
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CladeWelcome
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CladeWelcome
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CladeWelcome
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CladeWelcome
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
[1.4.0] - 2026-11-11
新增
- 自动配置更新: 启动时,新的选项会被添加到现有的
config.yml中(每个config-version仅执行一次),你的数值和分组设置会被保留,旧文件会另存为config.yml.bak。不再需要在更新后手动删除配置文件。 - 隐身支持: 拥有
vanished元数据(SuperVanish、PremiumVanish、Essentials 等)的玩家不再产生加入/离开消息或 Discord 帖子。新增了vanish.*选项以及可选的cladewelcome.silent权限。 - 缺失的翻译:针对 de、es、fr、pl、pt、it、tr 和 uz 语言,补充了
database.*、preview.*、command.help-preview和config-issues的翻译。
更改
- 不再引用 Hangar;更新检查器现在仅使用 Modrinth。
- 移除了反编译遗留的冗余类型转换。
[1.3.0] - 2026-11-07
Added
- 本项目采用 Apache License 2.0 许可(包含
LICENSE、NOTICE、THIRD_PARTY_NOTICES.md,以及每个源文件中的 SPDX 头信息)。 config.yml中新增update-check.source/update-check.project/update-check.download-url:更新检查器现在支持使用 Modrinth。config.yml中新增database.use-ssl选项。- 新增语言键
preview.*、command.help-preview和config-issues(支持 EN、RU、UZ;其他语言默认回退至英语)。 .gitattributes和完整的.gitignore文件。
Fixed
- MySQL 支持在插件启用时崩溃,原因是 HikariCP 和 MySQL 驱动未包含在 jar 包中。现在它们通过
plugin.yml中的libraries:加载,且数据库连接失败时会回退到本地文件存储,而不是禁用插件。 - 过时的占位符:
%ping%、%joins%和 PlaceholderAPI 的值在heavy性能模式下会被缓存长达 5 分钟。现在占位符会在缓存查找之前进行解析。 - 内存泄漏: 组件缓存无限增长。现在已限制为 512 条条目,并清理过期条目。
performance-mode: light在下次保存配置时静默覆盖了config.yml中的animations.enabled和particles.enabled。 现在不再修改配置文件;轻量模式仅在实际运行时禁用这些功能。- 启动时的竞态条件: 语言文件异步加载,导致玩家在启动期间加入可能触发
NullPointerException。现在语言加载改为同步且原子操作。 /cw reload和/cw lang不再从异步线程操作 Bukkit 配置。/cw lang现在仅重写language:行,从而保留config.yml中的注释。- 更新检查器在版本号字符串不同时就会报告“有更新”(即使你运行的是较新的构建版本)。现在仅报告严格更新的版本,并使用 Gson 解析响应而非字符串搜索。
/cw toggle每次点击都在主线程上重写整个设置文件或表格。现在仅异步保存受影响的玩家数据。- 修复无效的
pom.xml(<n>标签、错误的 XSD URL、未使用的dependencyManagement),并移除反编译器残留代码(未使用的变量、冗余的类型转换)。
Changed
- 版本号方案现采用
MAJOR.MINOR.PATCH(语义化版本控制),取代之前的x.y.z.w.a。历史版本映射如下:1.2.0.0.a → 1.2.0。 - 硬编码的英文/俄文命令消息已移至语言文件中。
- 发布版 jar 文件名改为
CladeWelcome_v<version>_1.17-1.21_Universal.jar(例如CladeWelcome_v1.3.0_1.17-1.21_Universal.jar)。 - MySQL 连接池大小缩减至 5 个连接,连接超时时间缩短至 10 秒。
更新日志
CladeWelcome 的所有重要更改都将在此文件中记录。
[1.2.0.0.a] - 2026-05-26
新增
- 性能模式:添加了轻量/重度模式以优化性能
- 轻量模式:禁用动画、粒子效果和缓存,以获得最佳性能
- 重度模式:启用所有功能并开启缓存以提升性能
- 调试模式:添加了用于故障排除的详细日志记录的调试模式
- 配置验证:在启动时自动验证配置
- 验证动画类型
- 验证 BossBar 颜色格式
- 验证可点击操作
- 验证 URL 格式
- 组件缓存:为解析后的组件实现了带 TTL(5 分钟)的缓存系统
- 提高重复调用的性能
- 在重载和禁用时自动清除缓存
- 分组的自定义声音:添加了对特定于分组的声音的支持
- 不同玩家等级(vip、admin 等)使用不同的声音
- 每个分组可配置的音量和音调
- 为兼容旧版配置文件结构提供回退支持
- BossBar 渐变色:添加了 BossBar 的渐变色支持
- 可配置的渐变颜色
- 与渐变动画类型配合使用
- 可点击内容中的多条命令:添加了支持用分号分隔的多条命令
- 异步语言加载:语言文件现在进行异步加载,以获得更好的性能
- JavaDoc 文档:为关键方法添加了全面的 JavaDoc 文档
- README.md:创建了包含安装、配置和故障排除指南的全面 README 文件
修复
- 动画中的十六进制代码:修复了所有 6 种动画类型以正确跳过十六进制颜色代码
- RainbowAnimation
- GradientAnimation
- TypingAnimation
- ScrollingAnimation
- WaveAnimation
- PulsingAnimation
- 可点击聊天:修复了可点击聊天功能
- 改进了 URL 检测并将其转换为可点击链接
- 修复了点击事件的应用
- 为兼容旧版配置文件结构提供回退支持
- 已弃用的方法:修复了已弃用方法的警告
- 在 hideJoinMessage、hideQuitMessage、sendLegacyTitle 中添加了 @SuppressWarnings("deprecation") 以隐藏警告
- 这些方法作为旧版 Minecraft 版本的回退方案
- 更新检查器显示:修复了启动横幅中更新检查器的版本显示
- 当版本尚未获取时,现在显示“Checking...”
- 防止空版本显示
- 错误处理:通过 try-catch 块改进了错误处理
- 添加到 sendJoinMessage、sendSubtitle、playSound
- 更好的日志记录和堆栈跟踪输出
- 声音系统:修复了声音播放问题,并提供对旧版配置文件结构的回退支持
- 玩家设置:添加了玩家设置文件创建的日志记录
更改
- 启动/关闭横幅:更新了控制台消息,包含全面的信息
- 添加了更新检查器状态
- 添加了 MySQL 状态
- 添加了动画状态
- 添加了平台支持信息(Spigot/Paper/Purpur 1.17.x-1.21.x)
- Discord 链接:将所有 Discord 链接更新为
- 已在 README.md 中更新
- 已在所有语言文件中更新(en, ru, de, es, fr, it, pl, pt, tr, uz)
- 配置文件结构:添加了新的配置部分
- performance-mode
- debug
- sounds.default
- sounds.groups
- bossbar.gradient-enabled
- bossbar.gradient-colors
移除
- 悬停提示:从可点击聊天中移除了所有悬停提示,以获得更简洁的用户界面
技术改进
- 代码质量:改进了代码组织和可读性
- 性能:优化了字符串操作和缓存
- 兼容性:针对不同服务器版本提供了更好的回退机制
- 日志记录:增强了支持调试模式的日志记录
- 错误恢复:当功能失败时实现优雅降级
配置
- 添加了
performance-mode设置(light/heavy) - 添加了
debug.enabled设置 - 添加了
sounds.default.sound、sounds.default.volume、sounds.default.pitch - 添加了
sounds.groups部分以支持特定于分组的声音 - 添加了
bossbar.gradient-enabled设置 - 添加了
bossbar.gradient-colors列表
语言文件
- 更新了所有语言文件中的 Discord 链接
- 改进了翻译以提高一致性
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧