MagicUtils

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 /magicutils command (/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.