- 版权类型
- 原创
- 插件中文名称
- Minecraft 地震预警
- 插件英文名称
- MCEEW
- 原帖地址
- #
- 支持的核心(代理-服务端)
- Bungee
- WaterFall
- Velocity
- LightFall
- LightFall-Client
- Spigot
- PaperSpigot
- Folia
- Purpur
- PufferFish
- Leaves
- 其他核心
- 语言支持
- 多语言
- 适配版本(Java)
- 最新版本
- 26.x
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
- 1.16
- 1.15
- 1.14
- 1.13
[MD]
# MCEEW - Minecraft 实时地震预警
**为 Minecraft 服务器与代理网络提供实时地震预警(EEW)。**
MCEEW 可以接收来自日本、中国大陆、台湾等地区的实时地震预警与地震信息,并通过聊天栏、屏幕标题和提示音等方式,将预警及时推送给在线玩家。
支持 **Spigot / Paper / Folia / Velocity / BungeeCord / Waterfall**。

## 功能特色
- 实时接收多来源地震预警(EEW)
- 支持日本气象厅(JMA)、中国地震台网(CENC)、四川、福建、重庆以及台湾 CWA 等来源
- 支持 JMA 与 CENC 正式地震信息
- 支持聊天栏、Title 标题通知
- Bukkit 与 Velocity 支持可配置的地震预警提示音
- 支持基于权限的玩家通知控制
- 支持内置测试预警,无需等待真实地震即可检查显示效果
- 支持最近地震信息缓存与查询
- 支持安全重载配置
- 支持单服与 Velocity / BungeeCord / Waterfall 群组服部署


## 多地震数据源
MCEEW 当前支持以下实时地震预警及地震信息来源:
- 日本气象厅(JMA)
- 中国地震台网(CENC)
- 四川地震预警
- 福建地震预警
- 重庆地震预警
- 台湾中央气象署(CWA)
不同实时预警来源可根据服务器需求独立启用或关闭。
此外,MCEEW 还会接收 JMA 与 CENC 的正式地震信息,并保存在本地缓存中供命令查询。


## 游戏内预警
发生地震时,MCEEW 可以通过多种方式提醒玩家:
- 聊天栏消息
- 屏幕 Title 标题
- 地震预警提示音(Bukkit / Velocity)
通知内容以及各类通知渠道可以通过配置文件进行调整。


## 支持的平台
| 环境 | 安装文件 |
| --- | --- |
| Spigot 1.13.2+ | `MCEEW-x.y.z.jar` |
| Paper 1.13.2+ | `MCEEW-x.y.z.jar` |
| Folia 1.19.4+ | `MCEEW-x.y.z.jar` |
| Velocity | `MCEEW-Velocity-x.y.z.jar` |
| BungeeCord | `MCEEW-BungeeCord-x.y.z.jar` |
| Waterfall 1.21 最终版本 | 使用相同的 `MCEEW-BungeeCord-x.y.z.jar` |
> [!IMPORTANT]
> 如果已经在 **Velocity、BungeeCord 或 Waterfall 代理端**安装 MCEEW,请不要同时在其后端 Bukkit / Paper / Folia 服务器安装 MCEEW。
>
> 代理端版本已经负责整个群组服的地震数据连接、缓存、通知、目标选择、权限检查、命令和配置重载。
>
> 同时安装代理端与后端版本可能造成重复连接、重复预警以及重复控制台输出。
### Java 与兼容性
| 版本 | 插件字节码 | 已测试环境 |
| --- | ---: | --- |
| Bukkit | Java 11 | Spigot / Paper 1.13.2+、Folia 1.19.4+ |
| Velocity | Java 17 | Velocity 3.4.x / 3.5.x / 4.x |
| BungeeCord / Waterfall | Java 11 | BungeeCord、Waterfall 1.21 最终版本 |
服务器或代理本身如果要求更高版本的 Java,请以服务端或代理端要求为准。
## 群组服支持
### Velocity
Velocity 版本可以直接安装在代理服务器上,统一向整个群组服中的玩家发送地震预警。
支持:
- 全部玩家通知
- 按后端服务器选择玩家
- 按服务器组选择玩家
- 不同地震来源使用不同通知目标
- 按服务器及来源覆盖聊天栏、Title 和提示音设置
- 玩家权限控制
无需在每个后端服务器分别建立地震数据连接。
### BungeeCord / Waterfall
BungeeCord 版本同样支持群组服范围内的统一地震预警、玩家目标选择及权限控制。
Waterfall 使用相同的 BungeeCord 插件文件。
由于兼容性限制,BungeeCord / Waterfall 版本支持聊天栏与 Title 通知,但不提供提示音通道。
## 命令
`/mceew` 是 `/eew` 的别名。
| 命令 | 功能 |
| --- | --- |
| `/eew` | 查看插件版本和可用命令 |
| `/eew info jma` | 查看最近缓存的 JMA 地震信息 |
| `/eew info cenc` | 查看最近缓存的 CENC 地震信息 |
| `/eew test forecast` | 测试 JMA Forecast 预警 |
| `/eew test alert` | 测试 JMA Alert 预警 |
| `/eew test sc` | 测试四川地震预警 |
| `/eew test fj` | 测试福建地震预警 |
| `/eew test cwa` | 测试台湾 CWA 地震预警 |
| `/eew test cenc` | 测试 CENC 地震预警 |
| `/eew test cq` | 测试重庆地震预警 |
| `/eew reload` | 安全重新加载配置 |
测试与重载命令需要 `mceew.admin` 权限。
`/eew info` 查询的是插件本地缓存,不会在执行命令时重新进行网络请求。因此服务器刚启动且尚未收到地震信息时,缓存可能暂时为空。
## 内置预警测试
MCEEW 的测试命令会使用真实通知流程生成固定的测试地震预警。
可以用于检查:
- 聊天栏显示
- Title 显示
- 提示音
- 玩家权限
- 群组服通知目标
- 配置修改结果
测试不会请求真实地震数据,也不会修改插件保存的地震缓存。


## 配置重载
MCEEW 支持在服务器运行期间使用:
```text
/eew reload
```
重新加载配置。
Velocity 与 BungeeCord / Waterfall 版本会先完整验证新配置,只有验证通过后才会应用。
如果配置文件存在错误,当前正在工作的配置与运行状态会保持不变,从而避免因为一次错误修改直接导致地震预警服务失效。
---
MCEEW 的目标是将现实世界中的 **Earthquake Early Warning(地震预警)** 实时带入 Minecraft。
无论是单独运行的生存服、社区服,还是基于 Velocity / BungeeCord 构建的群组服,都可以通过 MCEEW 让玩家在游戏过程中及时收到现实中的地震预警。
[/MD]