MagicUtils

插件

· 作者 THEROER

适用于跨平台开发(Bukkit、Folia、Fabric、Velocity 等)的现代模块化 SDK。提供统一的 API,涵盖命令、配置、诊断和智能线程处理。

0 本站下载 0 关注 更新于 3 个月前

最新 1.27.4-alpha-bungee-java21 · 26.2 · BungeeCord / Waterfall

一键开服(送7天)

MagicUtils

面向 Minecraft 服务器与模组开发的模块化工具包 - 为配置、本地化、命令、日志、占位符、HTTP 客户端和诊断功能提供共享构建块,在 Bukkit/Paper/Folia、BungeeCord、Velocity、Fabric 和 NeoForge 上统一 API。

只需针对 MagicUtils 编写一次插件或模组,即可在所有平台上运行——平台相关的接线(加载器、适配器、映射)由你处理。


它提供的功能

  • Commands - 基于声明式注解的命令引擎,支持 Brigadier、参数、发送者类型和权限,各平台表现一致。
  • Config - 具有 YAML 和 TOML 后端的类型安全配置系统。
  • Localisation - 具有按作用域解析功能的语言/消息系统。
  • Logging - 具有流畅构建器和 MiniMessage 风格格式化的结构化日志记录器。
  • Placeholders - 占位符引擎(支持与 PlaceholderAPI / MiniPlaceholders 桥接)。
  • HTTP client - 轻量级 HTTP 客户端,用于与 Web 服务通信。
  • Diagnostics - 通过 /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>")
}

平台与版本

Platform Loaders
Bukkit Paper · Purpur · Spigot · Bukkit · Folia
Proxy Velocity · BungeeCord · Waterfall
Fabric Fabric · Quilt
NeoForge NeoForge

支持的 Minecraft 版本范围从 1.20 到 26.2。每个平台的 jar 在发布前都会在真实服务器上通过诊断套件进行兼容性烟雾测试。


? Docs: ? Maven:

Alpha channel: the API is stabilising toward 1.x. Feedback and issue reports are welcome.

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源