![WonderEvents Banner](https://voiid-studios.github.io/stuff/assets/project/WonderEvents/banner.png)

![Divider](https://voiid-studios.github.io/stuff/assets/project/WonderEvents/divider.png) ## ❓ 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. ![Divider](https://voiid-studios.github.io/stuff/assets/project/WonderEvents/divider.png) ## ✨ 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. ![Divider](https://voiid-studios.github.io/stuff/assets/project/WonderEvents/divider.png) ## 📋 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 ![Divider](https://voiid-studios.github.io/stuff/assets/project/WonderEvents/divider.png) ## 🚀 Installation 1. Download the latest version. 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/` ![Divider](https://voiid-studios.github.io/stuff/assets/project/WonderEvents/divider.png) ## 📖 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/` ![Divider](https://voiid-studios.github.io/stuff/assets/project/WonderEvents/divider.png) ## 📚 WonderWiki VERY SOON! While we're working on WonderWiki, you can access the [JDocs](https://voiidstudios.pages.dev/jd/wonderevents/)! ## ⚡ fastStats

WonderEvents

26.08.1

26.08.0

26.07.0