MagicUtils

MagicUtils

Модульный инструментарий для разработки серверов и модов Minecraft — общие строительные блоки для конфигурации, локализации, команд, логирования, плейсхолдеров, HTTP-клиентов и диагностики, с единым API для Bukkit/Paper/Folia, BungeeCord, Velocity, Fabric и NeoForge. Напиши свой плагин или мод один раз под MagicUtils — и он работает на каждой платформе: платформенная обвязка (загрузчики, адаптеры, маппинги) берётся на себя.

Что это даёт

• Команды — декларативный движок команд на аннотациях с поддержкой Brigadier, аргументами, типами отправителей и правами, одинаковый на всех платформах.
• Конфигурация — типобезопасная конфигурация с бэкендами YAML и TOML.
• Локализация — система языков и сообщений с разрешением по областям.
• Логирование — структурированный логгер с текучим билдером и форматированием в стиле MiniMessage.
• Плейсхолдеры — движок плейсхолдеров (с мостами к PlaceholderAPI / MiniPlaceholders).
• HTTP-клиент — небольшой HTTP-клиент с минимумом зависимостей для обращения к веб-сервисам.
• Диагностика — набор самопроверок во время выполнения, доступный через команду /magicutils (/mu), чтобы проверить работоспособность общего рантайма на любом сервере.

Два способа использования

1. Как отдельный плагин/мод (эта страница) Закинь сборку для своей платформы в plugins/ (Bukkit/Bungee/Velocity) или mods/ (Fabric/NeoForge). Она запускает общий рантайм MagicUtils и регистрирует команду /magicutils с диагностикой. После этого другие плагины/моды могут зависеть от неё, а не включать MagicUtils в себя. 2. Как библиотечную зависимость Добавь Maven-репозиторий и подключи нужные модули:

repositories {
    maven("https://maven.theroer.dev/releases/")
}
dependencies {
    implementation("dev.ua.theroer:magicutils-bukkit:<version>")
    implementation("dev.ua.theroer:magicutils-config-yaml:<version>")
}

Платформы и версии

Поддерживаемые версии Minecraft охватывают 1.20–26.2. Перед релизом jar каждой платформы проходит проверку совместимости на реальном сервере с помощью набора диагностики.

📖 Документация: https://magicutils.theroer.dev/ 📦 Maven: https://maven.theroer.dev/releases/

Альфа-канал: API стабилизируется к 1.x. Отзывы и сообщения об ошибках приветствуются.