- 版权类型
- 原创
- 插件中文名称
- 入服欢迎
- 插件英文名称
- JoinMessage
- 原帖地址
- #
- 支持的核心（服务端）
- Spigot
- Paper
- Purpur
- PufferFish
- 前置组件
- PlaceholderAPI http/://www.spigotmc.org/resources/placeholderapi.6245/
- 适配版本（Java）
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
- 1.16
- 1.15
- 1.14
- 1.13
- 1.12
[MD]
# JoinMessage - 多功能服务器提示插件
✨ **全版本兼容 | 高度自定义 | 优雅简洁** ✨
`支持 1.12-1.21` `PlaceholderAPI集成` `轻量高效`
---
## 🌟 插件介绍
**JoinMessage** 是一款专业的服务器提示增强插件，通过简洁美观的符号标识（`[+]`加入/`[-]`离开）结合色彩区分，为您的服务器提供现代化提示系统。内置一言问候和整点报时功能，全面提升玩家体验！
---
## 🚀 核心功能
### ✅ 智能进退服提示
```yaml
# 默认效果：
[+] 玩家名 # 绿色加入提示
[-] 玩家名 # 红色离开提示
```
- **颜色自定义**：支持 `&` 颜色代码
- **变量扩展**：兼容 PlaceholderAPI 所有变量
- **简洁设计**：无冗余信息，直观显示玩家动态
### 📜 每日一言（Hitokoto）
玩家加入时随机显示中文名言/句子
`[一言] 生活不止眼前的苟且，还有诗和远方 - 高晓松`
### ⏰ 整点报时系统
每小时自动广播时间提醒
`叮咚！现在是 14 点整！`
---
## ⚙️ 技术特性
| 功能 | 说明 |
|------|------|
| **多版本支持** | 完美兼容 1.12 至最新 1.21 版本 |
| **PAPI集成** | 原生支持 PlaceholderAPI 变量 |
| **异步处理** | 网络请求不阻塞主线程 |
| **热重载** | `/jm reload` 即时生效配置更改 |
| **零依赖** | 无需额外库（除PAPI） |
---
## 📥 安装指南
1. 下载 [JoinMessage.jar](https://example.com/download)
2. 放入服务端 `plugins` 文件夹
3. 重启服务器生成配置文件
4. 编辑 `plugins/JoinMessage/config.yml` 自定义设置
5. 使用 `/jm reload` 重载配置
> **依赖项**：
> - 必装 [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/)
> - 推荐 [Vault](https://www.spigotmc.org/resources/vault.34315/) (经济变量支持)
---
## ⚙️ 配置文件详解
```yaml
# 进退服消息配置
join-message: "&a[+] %player%"
quit-message: "&c[-] %player%"
# 一言功能设置
hitokoto-enable: true
hitokoto-api: "https://v1.hitokoto.cn/"
hitokoto-format: "&7[&6一言&7] &f%hitokoto% &7-&f %from%"
# 整点报时设置
hourly-bell-enable: true
hourly-bell-format: "&e叮咚！现在是 &6%hour%&e 点整！"
```
### 🔧 配置说明
| 参数 | 默认值 | 说明 |
|------|--------|------|
| `join-message` | `&a[+] %player%` | 进服消息格式 |
| `quit-message` | `&c[-] %player%` | 退服消息格式 |
| `hitokoto-enable` | `true` | 启用一言功能 |
| `hitokoto-format` | `&7[&6一言&7]...` | 一言显示格式 |
| `hourly-bell-enable` | `true` | 启用整点报时 |
> **可用变量**：
> - `%player%`：玩家名称
> - `%hour%`：当前小时(24时制)
> - `%hitokoto%`：一言内容
> - `%from%`：句子出处
> - **PAPI变量**：`%player_world%`, `%vault_balance%` 等
---
## 📋 命令与权限
| 命令 | 权限 | 功能 | 默认 |
|------|------|------|------|
| `/jm reload` | `joinmessage.reload` | 重载配置 | OP |
| `/jm` | 无 | 查看插件信息 | 所有玩家 |
---
## ❓ 常见问题
**Q：如何修改消息颜色？**
> 在配置中使用 `&` + 颜色代码，如 `&4`深红，`&b`天蓝
**Q：为什么一言不显示？**
> 1. 检查 `hitokoto-enable: true`
> 2. 尝试更换API：`hitokoto-api: "https://international.v1.hitokoto.cn/"`
> 3. 确保服务器能访问外网
**Q：如何关闭整点报时？**
> 设置 `hourly-bell-enable: false`
---
## 📥 下载信息
| 项目 | 详情 |
|------|------|
| **最新版本** | v1.0.1 |
| **适用核心** | Paper/Spigot/任何Bukkit核心 |
| **下载地址** | [立即下载](https://www.minebbs.com/resources/joinmessage.12670/download) |
---
[/MD]
