ModsJava
WonderEvents
The best framework for expansions & addons! Everything in one place.
⬇ Download on HangarOpen in MCModsHubGet it on Google Play →
# WonderEvents
The best framework for expansions & addons! Everything in one place.
[](https://ko-fi.com/maxxvoiid/donate)
[](https://modrinth.com/plugin/wonderevents)
[](https://github.com/Voiid-Studios/voiidstudios/blob/main/LICENSE.md)
[](https://github.com/Voiid-Studios/wonderevents)
## ❓ What is WonderEvents?
WonderEvents (WE) is the core framework behind Voiid Studios' Minecraft events plugins. Instead of shipping one monolithic plugin per server, WE gives you a lightweight cross-platform base (Spigot/Paper/forks) that expansions and addons plug directly into.
Expansions and addons are just `.jar` files dropped into their respective folders — WonderEvents discovers them, resolves their dependencies, and loads them automatically, no server restart juggling needed.
## ✨ Features
- 🧩 **Expansions & Addons system** — drop-in `.jar` modules with their own `wonder-manifest.yml`, dependency resolution and versioned compatibility checks
- 📦 **Preinstalled content support** — expansions/addons can ship bundled inside the plugin itself and get installed automatically on first run
- 🔄 **Hot reload** — `/wonder reload `, no full server restart required
- 🖥️ **Cross-platform core** — automatic Paper/Spigot platform adapters and scheduler handling
- 🎨 Adventure/MiniMessage-powered text formatting, with a YAML-driven multi-language message system
- 🛠️ Simple developer API (`WEAPI`, `WEABootstrap`, `WEACommand`, `WEAListener`, `WEAModule`) for building your own expansions/addons on top of WE.
## 📋 Requirements
- **Minecraft version:** `1.16+`
- **Server software:** Spigot, Paper or forks (CraftBukkit and Folia are NOT supported!)
- No external dependencies required — everything WonderEvents needs ships bundled inside the plugin
## 🚀 Installation
1. Download the [latest version here](https://modrinth.com/project/wonderevents/versions)
2. Place the downloaded `.jar` file in your server's `plugins/` folder
3. Restart the server, WonderEvents is ready! ⚡
4. (Optional) Drop any additional expansions/addons into `plugins/WonderEvents/expansions/` and `plugins/WonderEvents/addons/`
## 📖 How to use it
- Manage everything through `/wonder` (alias `/wonderevents`):
- `/wonder help` — shows all available commands
- `/wonder reload ` — reloads WonderEvents without restarting the server
- `/wonder expansions list` / `enable ` / `disable ` — manage installed expansions
- `/wonder addons list` / `enable ` / `disable ` — manage installed addons
- Configure WonderEvents in `plugins/WonderEvents/config.yml`:
- `faststats_metrics` — toggle anonymous metrics
- `auto_update` — automatically download new stable releases when found
- `update_notification` — notify players with `wonderevents.updatenotify` (and console) when an update is available
- `language` — pick the language file used from `messages/origins/`
## 📚 WonderWiki VERY SOON!
## ⚡ fastStats
WonderEvents is a free Minecraft Java mod. Compatible with Minecraft 1.16, 1.16.1, 1.16.2, 1.16.3 and newer. Available via Hangar. Download it and open it directly in the game.
Explore more