- 版权类型
- 原创
- 插件中文名称
- 逸云加入插件
- 插件英文名称
- YiyunJoin
- 原帖地址
- #
- 支持的核心（服务端）
- Spigot
- Paper
- Folia
- Purpur
- Leaves
- 其他核心
- 语言支持
- 中文（简体）
- 前置组件
- authme(可选)
- 适配版本（Java）
- 最新版本
- 26.x
- 1.21
- 1.20
[MD]
# ✨ YiyunJoin
**让每一次相遇都充满仪式感**
**Paper 1.20.1+** | **Folia 支持** | **Java 21+**
***
## ✨ 功能特性
- 🎨 **多模式欢迎消息** - ActionBar / Chat / Title 动画，支持渐变色和权限组差异化
- 🔔 **整点报时系统** - 自定义报时时间点，零误差累积，高性能轮询机制
- 💬 **一言 (Hitokoto)** - 每次加入随机展示一句名言，支持自定义格式
- 🎁 **欢迎奖励系统** - 一键欢迎按钮，增进社区互动
- 🔊 **音效系统** - 多场景自定义音效
- 👋 **退出消息** - 个性化离线提示
***
## ⚡ 快速开始
1. 下载 `YiyunJoin-x.x.x.jar` 放入 `plugins/` 文件夹
2. 重启服务器，自动生成配置文件
3. 编辑 `plugins/YiyunJoin/config.yml`
4. 执行 `/yj reload` 重载配置（无需重启）
***
## 📖 核心配置
### 欢迎消息
```yaml
welcome:
default-mode: BOTH # ACTIONBAR / CHAT / BOTH
templates:
default:
actionbar: "<green>[+] {player}</green>"
chat:
- "<green>[+] {player}</green>"
vip: # 需要权限 yiyunjoin.vip
actionbar: "<gradient:#F093FB:#F5576C>✦ VIP {player} 加入了</gradient>"
title:
enabled: true
text: "<gradient:#F093FB:#F5576C><bold>欢迎加入</bold></gradient>"
subtitle: "<yellow>{player}</yellow> <gray>首次来到服务器</gray>"
```
### 整点报时
```yaml
chime:
enabled: true
check-interval: 10 # 检查频率（秒），推荐 10
message: "<yellow>🔔 现在是 {time}，整点报时！</yellow>"
12-hour-format: false # false = 24小时制
sound:
enabled: true
type: BLOCK_NOTE_BLOCK_BELL
custom-times: # 自定义报时时间点
- time: "08:30"
message: "<yellow>☀️ 早上好！新的一天开始了</yellow>"
- time: "12:30"
message: "<gold>🍽️ 午餐时间到了，记得休息哦</gold>"
- time: "20:30"
message: "<blue>🌙 夜深了，早点休息吧</blue>"
```
### 一言 (Hitokoto)
```yaml
hitokoto:
enabled: true
timeout: 5000 # 超时时间（毫秒）
show-on-join: true
# 支持变量：{hitokoto} {from} {from_who}
format: "<gray>[<gold>一言</gold>] <white>{hitokoto}</white> <gray>-</gray> <yellow>{from}</yellow>"
```
### 欢迎奖励
```yaml
welcome-reward:
enabled: true
button:
text: "<click:run_command:/welcome {player}><gradient:#F093FB:#F5576C>[点击欢迎]</gradient></click>"
cooldown: 30 # 冷却时间（秒）
reward:
daily-limit: 10 # 每日上限
```
***
## 🎨 格式说明
插件使用 **MiniMessage** 格式，支持：
| 效果 | 写法 | 示例 |
| --- | ----------------------------------- | --------------- |
| 渐变色 | `<gradient:#颜色1:#颜色2>文本</gradient>` | 见上方配置 |
| 粗体 | `<bold>文本</bold>` | **粗体** |
| 斜体 | `<italic>文本</italic>` | *斜体* |
| 颜色 | `<color名称>文本</color>` | `<red>红色</red>` |
***
## 📋 命令与权限
| 命令 | 权限 | 说明 |
| ---------------- | ---------------------- | ------ |
| `/yj reload` | yiyunjoin.admin.reload | 重载配置 |
| `/yj stats [玩家]` | yiyunjoin.admin.stats | 查看统计 |
| `/welcome 玩家名` | 无 | 欢迎指定玩家 |
| 权限节点 | 用途 |
| --------------- | -------- |
| yiyunjoin.vip | VIP 欢迎样式 |
| yiyunjoin.admin | 管理员样式 |
***
## ❓ 常见问题
**Q: 支持哪些服务端？**
A: Paper 1.20.1+、Folia 1.20.1+
**Q: 会影响服务器性能吗？**
A: 完全不会。所有 I/O 异步执行，内存占用极低极低
***
## 🔧 其他设置
- **存储方式：** YAML（默认）/ MySQL（适合大型服、群组服）
- **AuthMe 集成：** 自动检测，登录成功后才会显示欢迎消息
- **调试模式：** 设置 `settings.debug: true` 查看详细日志
***
[/MD]
