MCEEW

# MCEEW A real-time Earthquake Early Warning (EEW) plugin for Minecraft servers and Velocity, BungeeCord, and Waterfall proxy networks. ## Features * Receives JMA, CENC, Sichuan, Fujian, CWA, and Chongqing earthquake warnings * Receives final earthquake-list reports from JMA and CENC * Delivers configurable chat and title notifications; Bukkit and Velocity also support their configured sound channel * Supports permission-based delivery and deterministic test alerts * Provides cached earthquake information and safe configuration reload commands * Supports standalone Spigot/Paper/Folia servers, Velocity proxies, and a BungeeCord build compatible with the final Waterfall release ## Choose the correct artifact | Environment | Install | |---|---| | Standalone Spigot 1.13.2+ | `MCEEW-x.y.z.jar` | | Standalone Paper 1.13.2+ | `MCEEW-x.y.z.jar` | | Standalone Folia 1.19.4+ | `MCEEW-x.y.z.jar` | | Velocity network | `MCEEW-Velocity-x.y.z.jar` in the proxy's `plugins/` directory only | | BungeeCord network | `MCEEW-BungeeCord-x.y.z.jar` in the proxy's `plugins/` directory only | | Waterfall final 1.21 release | The same `MCEEW-BungeeCord-x.y.z.jar` | | Backend behind MCEEW-Velocity | Do not install the Bukkit MCEEW artifact | | Backend behind MCEEW-BungeeCord | Do not install the Bukkit MCEEW artifact | `mceew-core` is an internal library and is not a user-installed plugin. ### Important proxy deployment warning When `MCEEW-Velocity` or `MCEEW-BungeeCord` is installed on a proxy, **do not install the Bukkit MCEEW plugin on its backend servers**. The proxy plugin already provides the network's earthquake connection, cache, notifications, targeting, permission checks, commands, information lookup, and reload support. Running both artifacts in the same network is unsupported and not recommended. They are independent plugins: MCEEW does not detect, coordinate, disable, or deduplicate them. Installing both may create duplicate Wolfx connections, player notifications, and console output, with separate cache and lifecycle state. Avoiding this deployment is the administrator's responsibility. Installing only the Bukkit plugin on an individual backend remains valid standalone Bukkit behavior, but it does not provide proxy-wide targeting. ## Installation ### Standalone Bukkit-family server 1. Download or build `MCEEW-x.y.z.jar`. 2. Place it in the Spigot, Paper, or Folia server's `plugins/` directory. 3. Start the server and edit the generated Bukkit configuration if needed. This artifact retains the established Bukkit connection, cache, notifications, commands, bStats, and updater behavior. No proxy settings are required. ### Velocity network 1. Download or build `MCEEW-Velocity-x.y.z.jar`. 2. Place it in `Velocity/plugins/`. 3. Start Velocity once so `plugins/mceew/config.yml` is created and loaded. 4. Configure notifications and network targeting as needed, then use `/eew reload`. 5. Remove the Bukkit MCEEW plugin from backend servers if it is present. No backend MCEEW plugin is required for targeting, permission checks, chat, titles, supported sound, commands, cache/info, or reload. ### BungeeCord / Waterfall network 1. Download or build `MCEEW-BungeeCord-x.y.z.jar`. 2. Place it in the proxy's `plugins/` directory. 3. Start the proxy once so `plugins/MCEEW/config.yml` is created and loaded. 4. Configure notifications and network targeting as needed, then use `/eew reload`. 5. Remove the Bukkit MCEEW plugin from backend servers if it is present. MCEEW uses only the public BungeeCord API. The same artifact is compatible with the final Waterfall 1.21 build 615, but Waterfall itself is archived and end-of-life. There is no Waterfall-specific artifact or code path. ## Requirements and tested platforms | Artifact | Plugin bytecode | Tested platform/runtime | |---|---:|---| | `MCEEW-x.y.z.jar` | Java 11 (major 55) | Spigot/Paper 1.13.2+; Folia 1.19.4+ | | `MCEEW-Velocity-x.y.z.jar` | Java 17 (major 61) | Velocity 3.4.x on Java 17+, 3.5.x on Java 21+, and 4.x on Java 25+ | | `MCEEW-BungeeCord-x.y.z.jar` | Java 11 (major 55) | BungeeCord builds 1999 and 2086; Waterfall 1.21 build 615, each on Java 17 | The pinned automated compatibility smoke matrix is Velocity 3.4.0 build 566 on Java 17, 3.5.1 build 615 on Java 21, 4.0.0 build 6 on Java 25, BungeeCord builds 1999 and 2086 on Java 17, and Waterfall build 615 on Java 17. These checks prove plugin discovery, lifecycle, disabled-runtime commands, reload, shutdown, and linkage. They do not replace real-client notification E2E. Newer Minecraft server releases can require a newer Java runtime than the Bukkit plugin bytecode itself. Use the Java version required by the server or proxy when it is higher. Velocity-delivered sound requires a Minecraft Java client 1.19.3 or newer and a current backend connection. When sound cannot be delivered, chat and title notifications continue; only sound is skipped. There is no packet fallback. BungeeCord and Waterfall