WonderEvents

!Security Notice

!WonderEvents Banner

!Divider

⚠️ WonderEvents requires these dependencies!

!Divider

❓ 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

✨ 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 <all|configs|expansions|addons>, 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

📋 Requirements

• Minecraft version: 1.16+
• Server software: Spigot, Paper or forks (CraftBukkit and Folia are NOT supported!)
• Required dependency: TsunamiLib (install its .jar alongside WonderEvents)

!Divider

🚀 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

📖 How to use it

• Manage everything through /wonder (alias /wonderevents):
  • /wonder help — shows all available commands
  • /wonder reload <all|configs|expansions|addons> — reloads WonderEvents without restarting the server
  • /wonder expansions list / enable <id> / disable <id> — manage installed expansions
  • /wonder addons list / enable <id> / disable <id> — 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
  • Messages.language — pick the language file used from langs/

!Divider

📚 WonderWiki VERY SOON!

While we're working on WonderWiki, you can access the JDocs!

⚡ fastStats