fabricbukkitloader

插件

· 作者 luzichen114514

一个 Paper 1.21 插件,允许服务器加载 Fabric 1.21 的模组。

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

最新 1.0.1 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

插件说明

功能特性

一个 Paper 1.21+ 插件,使服务器能够加载 Fabric 1.21+ 模组。

  • ? Fabric 模组加载 - 在 Paper 服务器上加载并运行 Fabric 模组
  • ⚙️ 配置管理 - 灵活的配置系统,支持热重载
  • ? 事件适配 - 自动将 Bukkit 事件转换为 Fabric 事件格式
  • ⌨️ 命令适配 - 支持 Fabric 模组命令在 Paper 服务器上运行
  • ? 安全控制 - 白名单/黑名单系统,插件签名验证
  • ? 管理界面 - 便捷的管理命令和监控功能

安装

前置条件

  • Paper 1.21+ 服务器
  • Java 21
  • Maven 3.6+(用于编译)

安装步骤

  1. 下载插件

    • 从发布页面下载 FabricBukkitLoader-1.0.0.jar
    • 或使用本项目中的预编译 jar 文件
  2. 安装插件

    • 将 FabricBukkitLoader-1.0.0.jar 放入服务器的 plugins 文件夹
    • 启动服务器,插件将自动生成配置文件
  3. 配置插件

    • 编辑 plugins/FabricBukkitLoader/config.yml 配置文件
    • 进行必要的设置(参见配置说明)
  4. 添加 Fabric 模组

    • 将 Fabric 模组 .jar 文件放入服务器根目录下的 mods/ 文件夹中
    • 重启服务器或使用 /fabricloader reload 命令加载模组

配置

主配置文件 (config.yml)

# 启用/禁用插件加载
enable-plugin-loading: true

# 启用/禁用调试日志
debug-logging: false

# 模组目录路径(相对于服务器根目录)
mods-directory: "mods"

# 自动重载插件
auto-reload-plugins: true

# 最大加载插件数量
max-plugins: 100

# 插件兼容模式
allow-incompatible-plugins: false

# 事件适配器设置
event-adapter:
  enabled: true
  priority-handling: "NORMAL"
  event-filtering: true

# 命令适配器设置
command-adapter:
  enabled: true
  enable-aliases: true
  enable-permissions: true

# 日志设置
logging:
  log-plugin-loading: true
  log-plugin-errors: true
  log-command-execution: false
  log-event-handling: false

# 安全设置
security:
  verify-plugin-signatures: false
  allow-unsigned-plugins: true
  whitelist-plugins: []
  blacklist-plugins: []

命令

主要命令

  • /fabricloader help - 显示帮助信息
  • /fabricloader info - 显示插件信息
  • /fabricloader mods - 列出已加载的 Fabric 模组
  • /fabricloader reload - 重载插件配置

管理员命令(需要 OP 权限)

  • /fabricloader load <mod-file> - 加载指定的模组文件
  • /fabricloader unload <mod-id> - 卸载指定的模组

快捷命令

  • /fblmods - 快速查看已加载模组列表
  • /fbl - /fabricloader 的别名

权限

fabricbukkit.loader.* - 所有权限
fabricbukkit.loader.admin - 管理员权限
fabricbukkit.loader.mods - 查看模组列表
fabricbukkit.loader.reload - 重载插件
fabricbukkit.loader.info - 查看插件信息

开发

项目结构

fabric-bukkit-loader/
├── src/main/java/com/fabricbukkit/loader/
│   ├── FabricBukkitLoader.java    # 主类
│   ├── ModConfigManager.java      # 配置管理器
│   ├── ModLoader.java             # 模组加载器
│   ├── EventAdapter.java          # 事件适配器
│   ├── CommandAdapter.java        # 命令适配器
│   └── LoadedMod.java             # 模组实体类
├── src/main/resources/
│   └── plugin.yml                 # 插件配置
├── pom.xml                        # Maven 配置
└── README.md                      # 文档

构建项目

# 构建
mvn clean package

# 生成的 jar 文件位于 target/ 目录中

API 使用

// 获取插件实例
FabricBukkitLoader plugin = FabricBukkitLoader.getInstance();

// 获取已加载的模组
Map<String, LoadedMod> mods = plugin.getLoadedMods();

// 加载新模组
ModLoader modLoader = plugin.getModLoader();
LoadedMod mod = modLoader.loadMod(modFile);

// 事件适配
EventAdapter eventAdapter = plugin.getEventAdapter();
eventAdapter.registerModEvents(mod);

// 命令适配
CommandAdapter commandAdapter = plugin.getCommandAdapter();
commandAdapter.registerModCommands(mod);

支持的 Fabric 模组

本插件支持大多数不需要客户端修改的 Fabric 模组,包括:

  • ? 实用模组
  • ?️ 建筑模组
  • ? 存储模组
  • ?️ 机械模组
  • ? 科技模组
  • ⚔️ 战斗模组

注意:需要客户端支持的模组(例如新方块、新物品渲染)可能无法完全兼容。

常见问题

Q: 插件无法加载某些 Fabric 模组?

A: 请检查以下内容:

  • 确认模组是为 Fabric 1.21+ 编译的
  • 检查服务器日志中的错误消息
  • 验证模组依赖是否满足
  • 尝试启用 allow-incompatible-plugins 选项

Q: 如何调试模组加载问题?

A: 在 config.yml 中启用调试日志:

debug-logging: true
logging:
  log-plugin-loading: true
  log-plugin-errors: true

Q: 它支持所有 Fabric 模组吗?

A: 不,不支持需要客户端修改的模组。服务端功能通常可以正常工作。

Q: 对性能有何影响?

A: 插件本身的开销很小。模组性能取决于具体模组的实现。

更新日志

v1.0.0

  • ✨ 首次发布
  • ✨ 支持 Fabric 模组加载
  • ✨ 事件适配系统
  • ✨ 命令适配系统
  • ✨ 配置管理系统
  • ✨ 权限控制系统

贡献指南

  1. Fork 此仓库
  2. 创建功能分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 打开 Pull Request

许可证

本项目采用 MIT 许可证进行授权 - 详情请参阅 LICENSE 文件

致谢

  • PaperMC Team - 提供出色的服务器 API
  • FabricMC Team - 提供模组加载框架
  • 所有贡献者和测试人员

为 Minecraft 模组社区 ❤️ 打造

FbBLoader

功能特性

一个 Paper 1.21+ 插件,使服务器能够加载 Fabric 1.21+ 的 mods。

  • ? Fabric Mod 加载 - 在 Paper 服务器上加载和运行 Fabric mods
  • ⚙️ 配置管理 - 灵活的配置系统,支持热重载
  • ? 事件适配 - 自动将 Bukkit 事件转换为 Fabric 事件格式
  • ⌨️ 命令适配 - 支持 Fabric mod 命令在 Paper 服务器上运行
  • ? 安全控制 - 白名单/黑名单系统,插件签名验证
  • ? 管理界面 - 便捷的管理命令和监控功能

安装说明

前提条件

  • Paper 1.21+ 服务器
  • Java 21
  • Maven 3.6+ (用于编译)

安装步骤

  1. 下载插件

    • 从 releases 页面下载 FabricBukkitLoader-1.0.0.jar
    • 或者使用本项目中已编译好的 jar 文件
  2. 安装插件

    • 将 FabricBukkitLoader-1.0.0.jar 放入服务器的 plugins 文件夹
    • 启动服务器,插件会自动生成配置文件
  3. 配置插件

    • 编辑 plugins/FabricBukkitLoader/config.yml 配置文件
    • 根据需要进行设置(见配置说明)
  4. 添加 Fabric Mods

    • 将 Fabric mod 的 .jar 文件放入服务器根目录的 mods/ 文件夹
    • 重启服务器或使用 /fabricloader reload 命令加载 mods

配置说明

主配置文件 (config.yml)

# 启用/禁用插件加载
enable-plugin-loading: true

# 启用/禁用调试日志
debug-logging: false

# Mods 目录路径(相对于服务器根目录)
mods-directory: "mods"

# 自动重载插件
auto-reload-plugins: true

# 最大插件加载数量
max-plugins: 100

# 插件兼容性模式
allow-incompatible-plugins: false

# 事件适配器设置
event-adapter:
  enabled: true
  priority-handling: "NORMAL"
  event-filtering: true

# 命令适配器设置
command-adapter:
  enabled: true
  enable-aliases: true
  enable-permissions: true

# 日志设置
logging:
  log-plugin-loading: true
  log-plugin-errors: true
  log-command-execution: false
  log-event-handling: false

# 安全设置
security:
  verify-plugin-signatures: false
  allow-unsigned-plugins: true
  whitelist-plugins: []
  blacklist-plugins: []

使用命令

主要命令

  • /fabricloader help - 显示帮助信息
  • /fabricloader info - 显示插件信息
  • /fabricloader mods - 列出已加载的 Fabric mods
  • /fabricloader reload - 重载插件配置

管理命令 (需要 OP 权限)

  • /fabricloader load <mod-file> - 加载指定的 mod 文件
  • /fabricloader unload <mod-id> - 卸载指定的 mod

快捷命令

  • /fblmods - 快速查看已加载的 mods 列表
  • /fbl - /fabricloader 的别名

权限节点

fabricbukkit.loader.* - 所有权限
fabricbukkit.loader.admin - 管理权限
fabricbukkit.loader.mods - 查看 mods 列表
fabricbukkit.loader.reload - 重载插件
fabricbukkit.loader.info - 查看插件信息

开发说明

项目结构

fabric-bukkit-loader/
├── src/main/java/com/fabricbukkit/loader/
│   ├── FabricBukkitLoader.java    # 主类
│   ├── ModConfigManager.java      # 配置管理
│   ├── ModLoader.java             # Mod 加载器
│   ├── EventAdapter.java          # 事件适配器
│   ├── CommandAdapter.java        # 命令适配器
│   └── LoadedMod.java             # Mod 实体类
├── src/main/resources/
│   └── plugin.yml                 # 插件配置
├── pom.xml                        # Maven 配置
└── README.md                      # 说明文档

编译项目


# 编译
mvn clean package

# 生成的 jar 文件在 target/ 目录

API 使用

// 获取插件实例
FabricBukkitLoader plugin = FabricBukkitLoader.getInstance();

// 获取已加载的 mods
Map<String, LoadedMod> mods = plugin.getLoadedMods();

// 加载新的 mod
ModLoader modLoader = plugin.getModLoader();
LoadedMod mod = modLoader.loadMod(modFile);

// 事件适配
EventAdapter eventAdapter = plugin.getEventAdapter();
eventAdapter.registerModEvents(mod);

// 命令适配
CommandAdapter commandAdapter = plugin.getCommandAdapter();
commandAdapter.registerModCommands(mod);

支持的 Fabric Mods

本插件支持大多数不需要客户端修改的 Fabric mods,包括:

  • ? 工具类 mods
  • ?️ 建筑类 mods
  • ? 存储类 mods
  • ?️ 机械类 mods
  • ? 科技类 mods
  • ⚔️ 战斗类 mods

注意: 需要客户端支持的 mods(如新方块、新物品渲染)可能无法完全兼容。

常见问题

Q: 插件无法加载某些 Fabric mods?

A: 检查以下几点:

  • 确认 mod 是为 Fabric 1.21+ 版本编译的
  • 查看服务器日志中的错误信息
  • 检查 mod 的依赖是否满足
  • 尝试启用 allow-incompatible-plugins 选项

Q: 如何调试 mod 加载问题?

A: 在 config.yml 中启用调试日志:

debug-logging: true
logging:
  log-plugin-loading: true
  log-plugin-errors: true

Q: 是否支持所有 Fabric mods?

A: 不支持需要客户端修改的 mods。服务器端功能通常可以正常工作。

Q: 性能影响如何?

A: 插件本身开销很小。mod 的性能取决于具体的 mod 实现。

更新日志

v1.0.0

  • ✨ 初始版本
  • ✨ 支持 Fabric mod 加载
  • ✨ 事件适配系统
  • ✨ 命令适配系统
  • ✨ 配置管理系统
  • ✨ 权限控制系统

开发环境搭建

  1. Fork 本仓库
  2. 创建特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 开启 Pull Request

许可证

本项目采用 MIT 许可证进行授权 - 请查看 LICENSE 文件了解详情

致谢

  • PaperMC Team - 提供优秀的服务器 API
  • FabricMC Team - 提供模组加载框架
  • 所有贡献者和测试人员

为 Minecraft 模组社区 ❤️ 打造

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源