Module Overview
MagicUtils is split into focused artifacts so you can depend on only what you
need. The platform adapters wire the shared modules to Bukkit/Paper/Folia,
BungeeCord, Velocity, Fabric, or NeoForge.
Bootstrap helpers are available on every platform: BukkitBootstrap,
BungeeBootstrap, VelocityBootstrap, FabricBootstrap, and NeoForgeBootstrap
(the last two live in the platform's command module).
| Module | Artifact | Notes |
|---|
| Platform API | magicutils-api | Platform, Audience, TaskScheduler, player lifecycle/message events, and shared interfaces. |
| Core | magicutils-core | Shared runtime container (MagicRuntime), reflective access helpers, plus core config/lang/logger/placeholder wiring. |
| HTTP client | magicutils-http-client | HTTP and WebSocket client wrappers with JSON, retries, multipart, and runtime profiles. |
| Config | magicutils-config | JSON/JSONC config engine, migrations, comments. |
| Config YAML | magicutils-config-yaml | Adds YAML support via Jackson. |
| Config TOML | magicutils-config-toml | Adds TOML support via Jackson. |
| Lang | magicutils-lang | Language manager and message helpers. |
| Commands | magicutils-commands | Annotation/builder command framework. |
| Diagnostics | magicutils-diagnostics | Runtime diagnostics service, built-in checks, JSON export, and command helper support. |
| Logger | magicutils-logger | Adventure-based logger core. |
| Placeholders | magicutils-placeholders | Placeholder registry. |
| Processor | magicutils-processor | Annotation processor used by internal tooling. |
| Platform | Artifact | Notes |
|---|
| Bukkit/Paper/Folia | magicutils-bukkit | Includes the shared stack and exposes BukkitBootstrap. Folia is auto-detected for region-aware threading. |
| Bukkit bundle | magicutils-bukkit-bundle | Shared Bukkit/Paper plugin bundle for server installs. |
| BungeeCord | magicutils-bungee | Platform adapter plus config/logger/lang/commands/diagnostics for BungeeCord, with BungeeBootstrap. |
| Velocity | magicutils-velocity | Platform adapter plus config/logger/lang/commands for Velocity. |
| Fabric | magicutils-fabric | Platform API adapter for Fabric modular setups. |
| NeoForge | magicutils-neoforge | Platform adapter for NeoForge; NeoForgeBootstrap lives in magicutils-commands-neoforge. |
| Module | Artifact | Notes |
|---|
| Brigadier base | magicutils-commands-brigadier | Shared Brigadier command registry base. |
| Commands (NeoForge) | magicutils-commands-neoforge | Brigadier integration plus NeoForgeBootstrap. |
| NeoForge bundle | magicutils-neoforge-bundle | Standalone bundle mod for shared server installs. |
| Module | Artifact | Notes |
|---|
| Logger (Fabric) | magicutils-logger-fabric | Fabric logger adapter. |
| Commands (Fabric) | magicutils-commands-fabric | Brigadier integration plus FabricBootstrap. |
| Placeholders (Fabric) | magicutils-placeholders-fabric | Fabric placeholder bridge. |
| Fabric bundle | magicutils-fabric-bundle | Jar-in-jar distribution for shared server installs. |
Use the per-module pages for API details, examples, and configuration options.