Home›Java›Mods›fabricbukkitloader
fabricbukkitloader
ModsJava

fabricbukkitloader

by luzichen114514 · on Modrinth

⬇ Download on Modrinth
Open in MC Java ModsGet it on Google Play →

Plugin description

Features

A Paper 1.21+ plugin that enables servers to load Fabric 1.21+ mods.

Installation

Prerequisites

Installation Steps

  1. Download Plugin

    • Download FabricBukkitLoader-1.0.0.jar from the releases page
    • Or use the pre-compiled jar file in this project

  2. Install Plugin

    • Place FabricBukkitLoader-1.0.0.jar in your server's plugins folder
    • Start the server, the plugin will automatically generate configuration files

  3. Configure Plugin

    • Edit the plugins/FabricBukkitLoader/config.yml configuration file
    • Make necessary settings (see configuration instructions)

  4. Add Fabric Mods

    • Place Fabric mod .jar files in the mods/ folder in the server root directory
    • Restart the server or use the /fabricloader reload command to load mods

Configuration

Main Configuration File (config.yml)

# Enable/disable plugin loading
enable-plugin-loading: true

# Enable/disable debug logging
debug-logging: false

# Mods directory path (relative to server root)
mods-directory: "mods"

# Auto reload plugins
auto-reload-plugins: true

# Maximum number of plugins to load
max-plugins: 100

# Plugin compatibility mode
allow-incompatible-plugins: false

# Event adapter settings
event-adapter:
  enabled: true
  priority-handling: "NORMAL"
  event-filtering: true

# Command adapter settings
command-adapter:
  enabled: true
  enable-aliases: true
  enable-permissions: true

# Logging settings
logging:
  log-plugin-loading: true
  log-plugin-errors: true
  log-command-execution: false
  log-event-handling: false

# Security settings
security:
  verify-plugin-signatures: false
  allow-unsigned-plugins: true
  whitelist-plugins: []
  blacklist-plugins: []

Commands

Main Commands

Admin Commands (OP permission required)

Shortcut Commands

Permissions

fabricbukkit.loader.* - All permissions
fabricbukkit.loader.admin - Admin permissions
fabricbukkit.loader.mods - View mods list
fabricbukkit.loader.reload - Reload plugin
fabricbukkit.loader.info - View plugin information

Development

Project Structure

fabric-bukkit-loader/
├── src/main/java/com/fabricbukkit/loader/
│   ├── FabricBukkitLoader.java    # Main class
│   ├── ModConfigManager.java      # Configuration manager
│   ├── ModLoader.java             # Mod loader
│   ├── EventAdapter.java          # Event adapter
│   ├── CommandAdapter.java        # Command adapter
│   └── LoadedMod.java             # Mod entity class
├── src/main/resources/
│   └── plugin.yml                 # Plugin configuration
├── pom.xml                        # Maven configuration
└── README.md                      # Documentation

Build Project

# Build
mvn clean package

# Generated jar file is in target/ directory

API Usage

// Get plugin instance
FabricBukkitLoader plugin = FabricBukkitLoader.getInstance();

// Get loaded mods
Map<String, LoadedMod> mods = plugin.getLoadedMods();

// Load new mod
ModLoader modLoader = plugin.getModLoader();
LoadedMod mod = modLoader.loadMod(modFile);

// Event adaptation
EventAdapter eventAdapter = plugin.getEventAdapter();
eventAdapter.registerModEvents(mod);

// Command adaptation
CommandAdapter commandAdapter = plugin.getCommandAdapter();
commandAdapter.registerModCommands(mod);

Supported Fabric Mods

This plugin supports most Fabric mods that don't require client-side modifications, including:

Note: Mods requiring client support (such as new blocks, new item rendering) may not be fully compatible.

FAQ

Q: Plugin cannot load certain Fabric mods?

A: Check the following:

Q: How to debug mod loading issues?

A: Enable debug logging in config.yml:

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

Q: Does it support all Fabric mods?

A: No, mods requiring client-side modifications are not supported. Server-side functionality usually works normally.

Q: What about performance impact?

A: The plugin itself has minimal overhead. Mod performance depends on the specific mod implementation.

Changelog

v1.0.0

Contributing

  1. Fork this repository
  2. Create a feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details

Acknowledgments

Made with ❤️ for the Minecraft Modding Community

中文翻译

FbBLoader

功能特性

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

安装说明

前提条件

安装步骤

  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: []

使用命令

主要命令

管理命令 (需要 OP 权限)

快捷命令

权限节点

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（如新方块、新物品渲染）可能无法完全兼容。

常见问题

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

A: 检查以下几点：

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

开发环境搭建

  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 文件了解详情

致谢

Made with ❤️ for the Minecraft Modding Community

Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

Verified by MCModsHub

These come from our own check of the pack file, not from the source page.

Explore more

All Mods for JavaAll Minecraft Java modsJava mods for 1.21