Visual MOTD Editor for Modern Minecraft Servers
Instant hot-reloading deployment, no server restarts needed. Design server list appearances, player hover tooltips, multi-frame animations, and favicons visually in your browser.
The classic way to set an MOTD is to edit raw text files with cryptic color codes (&a, &e), reload plugins, and refresh the Minecraft server list over and over again to try to guess what it is going to look like.
NexMOTD takes the guesswork out of configuration with an interactive, visual browser workspace:
| Use Case | Description & Benefit |
|---|---|
| Instant Hot-Reload | Publish server sales, event announcements, or MOTD updates live in 1-click without server restarts or YAML syntax errors. |
| Pixel-Perfect RGB Gradients | Visually edit multi-stop gradient text using a visual sequence editor with pixel-perfect Adventure MiniMessage tag rendering. |
| Keyframe MOTD Animations | Make multi-frame keyframe sequences to rotate server lines on exact tick intervals (e.g. switching IP, features, or rewards). |
| Custom Player Hover & Status | Customize player count hover tooltips (staff list, rules, web links) and protocol text (ONLINE 24/7, JOIN NOW). |
| Drag & Drop Favicons | Drag any image onto the preview card and NexMOTD will crop and resize it to a 64×64 PNG server icon automatically. |
| Universal Proxy & Server Support | Deploy across Paper/Spigot, Velocity proxy networks, and BungeeCord/Waterfall clusters with zero ping latency impact (< 50µs). |
| Feature | Description |
|---|---|
| Visual Editor | In-browser MOTD editor with live Minecraft server list preview |
| Hot Reload | Configuration changes sent instantly over WebSocket |
| Animated MOTDs | Time-based keyframes with per-frame tick timing |
| RGB Gradients | Multi-stop color stop sequence builder with MiniMessage support |
| In-Place Favicon | Upload 64×64 PNG server icons directly to preview card |
| Player Hover | Customize player list tooltips and custom player count text |
| Zero-Latency Pings | Lock-free ping path (< 50µs latency impact) |
| Localhost Bound | Embedded server binds to 127.0.0.1 with startup token auth |
| Platform | Supported Versions | Java | Output File |
|---|---|---|---|
| Paper / Spigot / Folia | 1.20.x, 1.20.5, 1.20.6, 1.21.x, 26.x | Java 21+ | platform-paper-1.0-SNAPSHOT.jar |
| Velocity Proxy | 3.3.0+ (Minecraft 1.20 – 1.21.x / 26.x) | Java 21+ | platform-velocity-1.0-SNAPSHOT.jar |
| BungeeCord / Waterfall | 1.20 – 1.21.x / 26.x | Java 21+ | platform-bungee-1.0-SNAPSHOT.jar |
- Download or build the JAR for your server platform.
- Place the JAR into your
plugins/folder and start up the server. - Copy the Authentication Token generated in your server startup console:
- Open
http://localhost:30120in your browser and paste in the session authentication token (or click the direct URL logged in your console).
Compiling From Source & Installation
- Java 21 or higher
- Gradle wrapper (included)
# Clone repository
git clone https://github.com/sizwinz/NexMOTD.git
cd NexMOTD
# Build all modules and bundle web frontend
./gradlew clean buildPlatform JARs are compiled and written to:
platform-paper/build/libs/platform-paper-1.0-SNAPSHOT.jarplatform-velocity/build/libs/platform-velocity-1.0-SNAPSHOT.jarplatform-bungee/build/libs/platform-bungee-1.0-SNAPSHOT.jar
Web Editor Workflow & Dynamic Variables
- Edit MOTD Lines — Type text with color codes (
&a,&e) or click 1-click gradient presets (Sunset,Aqua,Emerald,Cyber). - Live Gradient Sync in Real-time — Drag the color pins in Gradient Builder and see the live preview change in real-time.
- Timeline Animation — Add keyframe nodes to cycle the lines of the server list on time-synchronized tick intervals.
- Interactive Server Icon — Drag any image into the 64×64 preview icon slot, or click on it.
- Publish — Hit Publish to Server to deploy instantly.
| Variable | Resolves To |
|---|---|
%online% |
Current online player count |
%max% |
Maximum player count capacity |
%version% |
Minecraft server version string (e.g. 1.20.4) |
Architecture & Zero Latency Performance Path
NexMOTD/
├── core/ # Platform-agnostic compiler, lock-free revision store & web server
├── platform-paper/ # Paper / Spigot event interceptor
├── platform-velocity/ # Velocity proxy ping listener
├── platform-bungee/ # BungeeCord proxy ping listener
└── web/ # React + Vite visual browser editor
Client Ping → Platform Event Interceptor
↓
AtomicReference Revision Store (Lock-Free Read)
↓
MOTDAnimationSync.getActiveFrame() [Nanosecond System Time Offset]
↓
Pre-Compiled Favicon & Placeholder Interpolation
↓
Send Event Response
In-Game Verification Guide Step-by-Step
- Build and install: Place
platform-paper-1.0-SNAPSHOT.jarinto your Paper server'splugins/folder and start the server. - Console Authentication: Look for
[NexMOTD] Authentication Token: <token>in console logs. - Open Browser Editor: Go to
http://localhost:30120, provide the token, and edit the MOTD text. - Enable Hot Reload: To ensure that the deployment is instantaneous and does not require any restarting, simply refresh your server in the Multiplayer menu of the Minecraft client.
We are always looking for contributions. Please see our Contributing Guidelines for details on how to send pull requests, report issues, and code conventions.
- Fork the repository
- Checkout a new branch for the feature (
git checkout -b feat/amazing-feature) - Commit your changes (
git commit -m 'feat: add amazing feature') - Push to the branch (
git push origin feat/amazing-feature) - Open a Pull Request
Released under the MIT License. See LICENSE for the full details of the license.