原创 开源 聊天 娱乐 【欢迎】高版本欢迎插件 1.2.1

[MD]# Welcome Plugin - Minecraft 欢迎插件 一个为 Minecraft Paper/Spigot 服务器设计的智能欢迎插件，当新玩家加入服务器时，会让其他在线玩家自动发送随机的欢迎消息。 ## ✨ 功能特性 - 🎲 **随机欢迎消息** - 从35+条预设消息中随机选择，让每次欢迎都充满惊喜 - 👥 **智能玩家选择** - 支持随机选择部分玩家发送欢迎消息，避免刷屏 - 🆕 **新玩家检测** - 可配置为仅对首次加入的新玩家发送欢迎消息 - ⏰ **延迟控制** - 可自定义消息发送的初始延迟和间隔时间 - 🔄 **热重载配置** - 支持在线重新加载配置文件，无需重启服务器 - 🎨 **颜色代码支持** - 支持 Minecraft 颜色代码，让消息更加生动 ## 📋 系统要求 - **Minecraft 版本**: 1.20+ - **服务端**: Paper/Spigot - **Java 版本**: 17+ ## 🚀 安装方法 1. 下载插件 jar 文件 2. 将文件放入服务器的 `plugins` 文件夹 3. 重启服务器或使用 `/reload` 命令 4. 插件会自动生成默认配置文件 ## ⚙️ 配置说明 配置文件位置：`plugins/Welcome/config.yml` ### 基础配置 ```yaml # 新玩家检测设置 new_player_only: enabled: false # 是否只欢迎新玩家（第一次加入的玩家） # 延迟设置（单位：秒） delay: initial: 10 # 玩家加入后的延迟 interval: 1 # 玩家间消息间隔 # 随机选择玩家设置 random_selection: enabled: true # 是否启用随机选择 player_threshold: 2 # 在线玩家数量阈值，超过此数量时启用随机选择 selection_count: 1 # 随机选择的玩家数量 ``` ### 欢迎消息模板 ```yaml messages: - "大家好，欢迎 %s 加入我们的服务器！" - "%s 来了！大家一起欢迎~" - "哇是 %s！欢迎来到我们的世界~" # ... 更多消息模板 ``` > 💡 **提示**: 使用 `%s` 作为玩家名称的占位符 ## 🎮 使用方法 ### 管理员命令 - `/welcome reload` - 重新加载配置文件 ### 权限节点 - `welcome.reload` - 允许重新加载配置（默认：OP） ## 🔧 工作原理 1. **玩家加入检测** - 监听玩家加入事件 2. **新玩家判断** - 根据配置决定是否只对新玩家生效 3. **延迟执行** - 等待指定时间后开始执行欢迎流程 4. **玩家筛选** - 根据在线人数和配置选择发送消息的玩家 5. **消息发送** - 让选中的玩家依次发送随机欢迎消息 ## 📝 配置示例 ### 场景1：小型服务器（全员欢迎） ```yaml random_selection: enabled: false delay: initial: 5 interval: 2 ``` ### 场景2：大型服务器（随机选择） ```yaml random_selection: enabled: true player_threshold: 10 selection_count: 3 ``` ### 场景3：仅欢迎新玩家 ```yaml new_player_only: enabled: true ``` ## 🛠️ 开发信息 - **开发者**: 9C2211D - **版本**: 1.0-SNAPSHOT - **API 版本**: 1.20 - **构建工具**: Gradle - **依赖**: Paper API 1.20.1 ## 📦 构建项目 ```bash # 克隆项目 git clone <repository-url> cd welcome # 构建插件 ./gradlew build # 运行测试服务器 ./gradlew runServer ``` ## 🤝 贡献指南 欢迎提交 Issue 和 Pull Request！ 1. Fork 本项目 2. 创建功能分支 (`git checkout -b feature/AmazingFeature`) 3. 提交更改 (`git commit -m 'Add some AmazingFeature'`) 4. 推送到分支 (`git push origin feature/AmazingFeature`) 5. 创建 Pull Request ## 📄 许可证 本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情 ## 🎯 未来计划 - [ ] 支持多语言消息模板 - [ ] 添加音效支持 - [ ] 支持自定义消息格式 - [ ] 添加统计功能 - [ ] 支持数据库存储 --- **如果这个插件对你有帮助，请给个 ⭐ Star！** [/MD]