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

1. 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.
2. Event system: Basic functionality is implemented, but some complex events may not trigger properly.
3. Performance overhead: There may be slight performance overhead due to the bridging layer.
4. 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 功能不可用）

已知限制

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

许可证

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

致谢

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

---

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