Bukkit Fabric Loader（English version）

A Fabric mod that allows loading and running Bukkit/Spigot/Paper plugins on Fabric 1.21 servers.

Current Version: 1.0.2

Features

✅ Load Bukkit/Spigot/Paper plugins (.jar format)
✅ Full plugin lifecycle management (load, enable, disable)
✅ Event system bridging
✅ Command system support
✅ Scheduler support
✅ Permission system
✅ Multi-world support (basic)
✅ Chinese output and detailed error messages
✅ Plugin loading progress display

Supported Minecraft Versions

Minecraft 1.21.x
Java 21
Fabric Loader 0.16.9
Fabric API 0.102.0

Plugin Compatibility

Fully Compatible

Most plugins that do not use NMS (underlying code)
Plugins based on the Bukkit API
Plugins that use the standard event system
Simple command plugins

Partially Compatible

Plugins that use basic NMS (may require adjustments)
Plugins that rely on Spigot/Paper-specific features

Not Compatible

Plugins that require BungeeCord
Plugins that heavily depend on Spigot internal implementations
Plugins that use ProtocolLib (requires special adaptation)
Plugins that require automatic dependency downloads (LibraryLoader functionality unavailable)

Known Limitations

LibraryLoader is not supported: Plugins cannot automatically download dependencies. If a plugin requires additional library files, they must be manually placed in the plugins folder.
Event system: Basic functionality is implemented, but some complex events may not trigger properly.
Performance overhead: There may be slight performance overhead due to the bridging layer.
NMS support: Limited support for NMS (Netty Minecraft Server).

License

This project is open-source under the MIT License.

Acknowledgements

Fabric Team - Excellent mod loader
PaperMC Team - Excellent server software
SpigotMC - Implementation of the Bukkit API

Note: This project is still under development and may contain bugs. Please thoroughly test it before using it in a production environment!

Bukkit Fabric Loader（中文版本）

一个Fabric模组，允许在Fabric 1.21+服务器上加载和运行Bukkit/Spigot/Paper插件。

当前版本：1.0.2

功能特性

✅ 加载Bukkit/Spigot/Paper插件（.jar格式）
✅ 完整的插件生命周期管理（加载、启用、禁用）
✅ 事件系统桥接
✅ 命令系统支持
✅ 调度器（Scheduler）支持
✅ 权限系统
✅ 多世界支持（基础）
✅ 中文输出和详细的错误提示
✅ 插件加载进度显示

支持的Minecraft版本

Minecraft 1.21.x
Java 21+
Fabric Loader 0.16.9+
Fabric API 0.102.0+

插件兼容性

完全兼容

大多数不使用NMS（底层代码）的插件
基于Bukkit API的插件
使用标准事件系统的插件
简单的命令插件

部分兼容

使用基本NMS的插件（可能需要调整）
依赖于Spigot/Paper特定功能的插件

不兼容

需要BungeeCord的插件
深度依赖Spigot内部实现的插件
使用ProtocolLib的插件（需要特殊适配）
需要自动下载依赖库的插件（LibraryLoader 功能不可用）

已知限制

LibraryLoader 不支持：插件无法自动下载依赖库。如果插件需要额外的库文件，必须手动将它们放在 plugins 文件夹中。
事件系统：虽然已实现基本功能，但某些复杂事件可能无法正常触发。
性能开销：由于桥接层的存在，可能会有轻微的性能开销。
NMS 支持：对 NMS（Netty Minecraft Server）的支持有限。

许可证

本项目基于MIT许可证开源。

致谢

Fabric Team - 优秀的模组加载器
PaperMC Team - 优秀的服务端软件
SpigotMC - Bukkit API的实现

注意：本项目仍在开发中，可能存在bug。请在生产环境使用前充分测试！~~~~

BukkitFabricLoader

📖About BukkitFabricLoader