MagicUtils
A modular toolkit for Minecraft server & mod development - shared building blocks for configuration, localisation, commands, logging, placeholders, HTTP clients, and diagnostics, with a single API across Bukkit/Paper/Folia, BungeeCord, Velocity, Fabric, and NeoForge.
Write your plugin or mod once against MagicUtils, and it runs on every platform - the per-platform wiring (loaders, adapters, mappings) is handled for you.
What it gives you
- Commands - a declarative, annotation-based command engine with Brigadier support, arguments, sender types, and permissions, identical on every platform.
- Config - type-safe configuration with YAML and TOML backends.
- Localisation - a language/messages system with per-scope resolution.
- Logging - a structured logger with a fluent builder and MiniMessage-style formatting.
- Placeholders - a placeholder engine (with PlaceholderAPI / MiniPlaceholders bridges).
- HTTP client - a small, dependency-light HTTP client for talking to web services.
- Diagnostics - a runtime self-check suite exposed via the
/magicutilscommand (/mu), so you can verify the shared runtime is healthy on any server.
Two ways to use it
1. As a standalone plugin/mod (this page)
Drop the bundle for your platform into plugins/ (Bukkit/Bungee/Velocity) or mods/ (Fabric/NeoForge). It boots the shared MagicUtils runtime and registers the /magicutils command with diagnostics. Other plugins/mods can then depend on it instead of shading MagicUtils themselves.
2. As a library dependency
Add the Maven repository and depend on the modules you need:
repositories {
maven("https://maven.theroer.dev/releases/")
}
dependencies {
implementation("dev.ua.theroer:magicutils-bukkit:<version>")
implementation("dev.ua.theroer:magicutils-config-yaml:<version>")
}
Platforms & versions
| Platform | Loaders |
|---|---|
| Bukkit | Paper · Purpur · Spigot · Bukkit · Folia |
| Proxy | Velocity · BungeeCord · Waterfall |
| Fabric | Fabric · Quilt |
| NeoForge | NeoForge |
Supported Minecraft versions span 1.20 through 26.2. Each platform's jar is compatibility-smoke-tested on a real server with the diagnostics suite before release.
📖 Docs: https://magicutils.theroer.dev/ 📦 Maven: https://maven.theroer.dev/releases/
Alpha channel: the API is stabilising toward 1.x. Feedback and issue reports are welcome.
No gallery available for this project.
| Version | Minecraft | Loader | Download |
|---|---|---|---|
|
1.27.4-alpha-bungee-java21 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.2
|
bungeecord, waterfall
|
Download |
|
1.27.4-alpha-velocity-java21 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.2
|
velocity
|
Download |
|
1.27.4-alpha-neoforge-java25 |
26.1, 26.2
|
neoforge
|
Download |
|
1.27.4-alpha-neoforge-java21 |
1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
neoforge
|
Download |
|
1.27.4-alpha-fabric-java25 |
26.1, 26.2
|
fabric, quilt
|
Download |
|
1.27.4-alpha-fabric-java21 |
1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
fabric, quilt
|
Download |
|
1.27.4-alpha-fabric-java17 |
1.20.1, 1.20.2, 1.20.3, 1.20.4
|
fabric, quilt
|
Download |
|
1.27.4-alpha-bukkit-java25 |
26.1, 26.1.1, 26.1.2, 26.2
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
1.27.4-alpha-bukkit-java21 |
1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
1.27.4-alpha-bukkit-java17 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
1.27.1-alpha-bungee-java25 |
26.1, 26.2
|
bungeecord, waterfall
|
Download |
|
1.27.1-alpha-bungee-java21 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
bungeecord, waterfall
|
Download |
|
1.27.1-alpha-velocity-java25 |
26.1, 26.2
|
velocity
|
Download |
|
1.27.1-alpha-velocity-java21 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
velocity
|
Download |
|
1.27.1-alpha-neoforge-java25 |
26.1, 26.2
|
neoforge
|
Download |
|
1.27.1-alpha-neoforge-java21 |
1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
neoforge
|
Download |
|
1.27.1-alpha-fabric-java25 |
26.1, 26.2
|
fabric, quilt
|
Download |
|
1.27.1-alpha-fabric-java21 |
1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
fabric, quilt
|
Download |
|
1.27.1-alpha-fabric-java17 |
1.20.1, 1.20.2, 1.20.3, 1.20.4
|
fabric, quilt
|
Download |
|
1.27.1-alpha-bukkit-java25 |
26.1, 26.1.1, 26.1.2, 26.2
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
1.27.1-alpha-bukkit-java21 |
1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
1.27.1-alpha-bukkit-java17 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
1.27.0-alpha-bungee-java25 |
26.1, 26.2
|
bungeecord, waterfall
|
Download |
|
1.27.0-alpha-bungee-java21 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
bungeecord, waterfall
|
Download |
|
1.27.0-alpha-velocity-java25 |
26.1, 26.2
|
velocity
|
Download |
|
1.27.0-alpha-velocity-java21 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
velocity
|
Download |
|
1.27.0-alpha-neoforge-java25 |
26.1, 26.2
|
neoforge
|
Download |
|
1.27.0-alpha-neoforge-java21 |
1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
neoforge
|
Download |
|
1.27.0-alpha-fabric-java25 |
26.1, 26.2
|
fabric, quilt
|
Download |
|
1.27.0-alpha-fabric-java21 |
1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
fabric, quilt
|
Download |
|
1.27.0-alpha-fabric-java17 |
1.20.1, 1.20.2, 1.20.3, 1.20.4
|
fabric, quilt
|
Download |
|
1.27.0-alpha-bukkit-java25 |
26.1, 26.1.1, 26.1.2, 26.2
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
1.27.0-alpha-bukkit-java21 |
1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
1.27.0-alpha-bukkit-java17 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
1.23.0-alpha-bungee-mc262 |
26.1, 26.2
|
bungeecord, waterfall
|
Download |
|
1.23.0-alpha-bungee-mc12110 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
bungeecord, waterfall
|
Download |
|
1.23.0-alpha-velocity-mc262 |
26.1, 26.2
|
velocity
|
Download |
|
1.23.0-alpha-velocity-mc12110 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
velocity
|
Download |
|
1.23.0-alpha-neoforge-mc262 |
26.1, 26.2
|
neoforge
|
Download |
|
1.23.0-alpha-neoforge-mc12110 |
1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
neoforge
|
Download |
|
1.23.0-alpha-fabric-mc262 |
26.1, 26.2
|
fabric, quilt
|
Download |
|
1.23.0-alpha-fabric-mc12110 |
1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
fabric, quilt
|
Download |
|
1.23.0-alpha-fabric-mc1201 |
1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6
|
fabric, quilt
|
Download |
|
1.23.0-alpha-bukkit-mc262 |
26.2
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
1.23.0-alpha-bukkit-mc2611 |
26.1, 26.1.1, 26.1.2
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
1.23.0-alpha-bukkit-mc12110 |
1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
bukkit, folia, paper, purpur, spigot
|
Download |
|
1.23.0-alpha-bukkit-mc1201 |
1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6
|
bukkit, folia, paper, purpur, spigot
|
Download |