Описание
# 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](https://fabricmc.net/) - Excellent mod loader
- [PaperMC Team](https://papermc.io/) - Excellent server software
- [SpigotMC](https://www.spigotmc.org/) - 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](https://fabricmc.net/) - 优秀的模组加载器
- [PaperMC Team](https://papermc.io/) - 优秀的服务端软件
- [SpigotMC](https://www.spigotmc.org/) - Bukkit API的实现
---
**注意**：本项目仍在开发中，可能存在bug。请在生产环境使用前充分测试！~~~~