FiFu Powered 是 FiFu 旗下的 Minecraft 服务器插件工具集，秉承「原版体验，功能增强」的设计理念。它由多个可独立部署、亦可无缝协作的插件模块构成：既有还原原版空岛玩法的核心游戏系统，也有书籍编辑、挖掘榜、血量显示、物品标记等周边工具，以及为整台服务器兜底的数据备份组件。
- 模块化：每个插件独立打包、按需部署、可单独构建
- 原版优先：功能增强建立在保留 Minecraft 原版机制的前提之上
- 统一规范：所有模块遵循同一套代码规范、命令风格与许可协议
- 套件协作：既可作为单插件使用，也可组合成完整的服务器解决方案
- Minecraft 兼容：基于 PaperAPI 开发，
api-version: 1.21 - 模块化设计：每个插件独立打包，可按需部署
- Kotlin/Java 混合开发：充分利用现代 JVM 语言优势
- Gradle 构建系统：统一的依赖管理、构建与产物输出
| 项目 | 选型 |
|---|---|
| 运行环境 | Minecraft 服务端（Paper / 兼容 Spigot API） |
| 开发语言 | Kotlin 2.1.21 + Java |
| 构建工具 | Gradle 8.14.3 + Shadow Plugin |
| 兼容版本 | MC API 1.21（模块版本 1.21.4-SNAPSHOT） |
| 开源许可 | Mulan PSL v2 |
每个模块均有独立文档，点击模块名即可查看对应的
README。
🏝️ FiFuSky — 空岛生存系统
FiFu 生态的核心游戏系统，提供保留原版体验的空岛生存。
- 1024×1024 标准岛屿网格 + 螺旋算法自动分配，可容纳近 3 万个岛屿
- 所有者 / 成员二级权限，实时保护岛屿区块；爆炸、方块事件细粒度控制
- 群系定制、蜂蜜飞行、矿物生成、岛屿参观与收藏等趣味机制
- 命令：
/s、/fs-admin；数据：SQLite（FiFuSky.db）
📖 FiFuBookEdit — 书籍编辑
面向服务器与玩家的书籍 / 文档管理工具。
- 成书一键转可写书；书籍导出为 JSON 文本、也可从文件导入
- 在线成书预览（OP 可指定玩家）；潜行 + 垂直视角右键快捷复制
- 命令：
/book；文件存储于plugins/FiFuBookEdit/
⛏️ FiFuMiningList — 挖掘榜
轻量的挖掘统计与排行榜工具。
- 实时统计破坏方块数，计分板每 1 秒刷新「挖掘榜」
- 首次上线自动并入原版
MINE_BLOCK历史统计；/wjb可隐藏个人榜单 - 命令：
/wjb；配置：config.json
🩸 FiFuBloodVolumeDisplay — 血量显示
战斗辅助插件，即插即用、零配置。
- 近战 / 投射物命中或右键实体时，以屏幕 Title 显示名称与血量，并按剩余比例从绿到深红变色
🐱 FiFuNekoMark — 物品标记
面向特定服主 / 玩家的物品安全标记组件。
- 在物品 Lore 刻下归属印记，非归属者使用将被校验并踢出；支持一键设为不可破坏
- 命令：
/neko-mark <操作符> <参数>（仅内置白名单账号可用）
💊 FiFuYao — 娱乐乘骑
趣味互动小插件。
- 手持箭矢右键 3 格内的任意实体，即可骑乘其上；下线自动解除载具
🗄️ FiFuServerBackup — 服务器数据备份
为整台服务器提供备份与异地容灾的底层保障。
- 定时自动备份 + save-all 钩子；AES-256 加密 / 超大文件分片
- 支持上传自建 HTTP 数据服务器或 FTP，全程 TOTP 鉴权
- 列表、恢复、删除、配置等完整命令；亦可独立运行接收端服务
- 命令：
/backup、/fifu
FiFu 的核心设计哲学是保留 Minecraft 原版玩法与机制、以辅助功能加以增强。无论游戏系统还是工具组件，开发时都遵循以下原则：
- 原版机制保护：绝不破坏 Minecraft 原版的核心游戏机制和平衡性
- 功能而非替代：提供辅助工具和管理功能，而非改变游戏本质玩法
- 体验增强：在保持原版体验的基础上，为玩家和管理员提供便利
- 社区友好：确保所有功能都符合 Minecraft 社区的期望和习惯
- 原版优先：所有组件设计以保留原版游戏特性为前提，在不破坏游戏平衡的前提下提供功能增强
- 统一架构：所有组件遵循 FiFu 统一设计标准，确保一致的用户体验
- 无缝集成：组件间深度协作，提供 1+1>2 的用户体验，同时保持原版游戏的核心魅力
- 模块化部署：支持按需组合，灵活适应不同服务器需求，让每个服务器都能找到最适合的配置方案
- 原版体验：保留 Minecraft 原版游戏机制和玩法，让玩家感受纯正的游戏乐趣
- 直观交互：统一的命令体系和操作逻辑，简化复杂操作
- 沉浸体验：流畅的游戏流程和丰富的视觉反馈，增强游戏代入感
- 个性化定制：支持玩家自定义设置和偏好保存，打造专属游戏体验
- 智能管理：提供完善的管理工具和自动化功能
- 精细控制：详细的权限系统和配置选项
- 数据驱动：基于统计数据的决策支持系统
- 极致优化：轻量级设计和异步处理机制
- 内存安全：严格的内存管理和泄漏防护
- 高可用性：完善的错误处理和恢复机制
- Minecraft 服务端（Paper 或兼容服务端）
- Java 17+
- 足够的服务器内存
# 克隆项目
git clone [repository-url]
cd FiFuPowered
# 构建全部插件(产物统一输出到仓库根目录 build/libs/)
./gradlew clean build# 构建特定插件(模块目录名见 settings.gradle.kts)
./gradlew :fifu-sky:build
./gradlew :fifu-book-editor:build
./gradlew :fifu-mining-list:build
./gradlew :fifu-neko-mark:build
./gradlew :fifu-blood-display:build
./gradlew :fifu-yao:build
./gradlew :fifu-server-backup:build# 将需要的插件 JAR 放入服务端 plugins 目录(文件名形如 fifu-sky-1.21.4-SNAPSHOT.jar)
cp build/libs/fifu-*.jar /path/to/server/plugins/构建产物统一输出到根目录
build/libs/，具体插件名称对应上表各模块。详细命令与玩法见各模块 README。
| 模块 | 主要命令 | 完整说明 |
|---|---|---|
| FiFuSky | /s、/fs-admin |
空岛玩家 / 管理命令，详见其文档 |
| FiFuBookEdit | /book help |
书籍复制、导入导出、预览等 |
| FiFuMiningList | /wjb |
开启 / 关闭挖掘榜显示 |
| FiFuNekoMark | /neko-mark <操作符> <参数> |
物品印记与标记管理 |
| FiFuBloodVolumeDisplay | 无命令 | 攻击 / 右键自动显血 |
| FiFuYao | 无命令 | 持箭右键实体即可骑乘 |
| FiFuServerBackup | /backup、/fifu |
备份状态、列表、恢复、删除、配置等 |
各模块的完整子命令、玩法与配置说明，请查阅上方组件一览中的对应文档。
FiFu 各模块配置方式并不统一，请按模块查看对应文档：
| 模块 | 配置文件 / 存储 |
|---|---|
| FiFuSky | plugins/FiFuSky/：FiFuSky.db（SQLite）、db.setting、FiFuAdminList.json 等 |
| FiFuBookEdit | 书籍文件存储于 plugins/FiFuBookEdit/，无全局配置 |
| FiFuMiningList | plugins/FiFuMiningList/config.json（另含 data.json 等数据文件） |
| FiFuServerBackup | plugins/FiFuServerBackup/ServerBackupConfig.json |
| FiFuNekoMark / FiFuBloodVolumeDisplay / FiFuYao | 无配置文件 |
- 版本同步：紧跟 Minecraft 服务端版本更新，确保最佳兼容性
- 性能迭代：基于用户反馈的持续性能优化和功能增强
- 社区驱动：开放的开发模式，积极响应社区需求和建议
- 质量保证：严格的测试流程和兼容性验证
- 安全防护：完善的安全机制和数据保护措施
- 监控体系：全面的错误监控和自动恢复机制
- 原版兼容：所有功能增强都基于原版游戏机制，确保与 Minecraft 核心体验完美融合
- 深度定制：丰富的配置选项和扩展接口，让每个服务器都能打造独特体验
- 国际化：完整的多语言支持框架，服务全球玩家社区
- 主题系统：灵活的 UI 主题和样式自定义，在不影响原版体验的前提下美化界面
- API 开放：为开发者提供完整的 API 接口和文档，鼓励社区创新
我们诚邀您加入 FiFu 的建设：
- 代码贡献：遵循 FiFu 代码规范，提交高质量的功能增强
- 测试反馈：提供详细的测试报告和改进建议
- 文档完善：协助完善项目文档和使用指南
- 社区建设：参与技术讨论，帮助其他用户解决问题
- 遵循 FiFu 统一的代码规范和注释标准
- 提供完整的单元测试和集成测试
- 更新相关文档和配置示例
- 提交清晰的 Pull Request 描述和变更说明
- 在项目贡献者列表中获得署名
- 参与 FiFu 的重要决策讨论
- 优先体验新功能和测试版本
- 获得 FiFu 社区的技术支持
本项目采用 Mulan PSL v2 许可证，详情请参考 LICENSE 文件。
- 作者：NekokeCore
- 问题反馈：[GitHub Issues]
- 功能建议：[GitHub Discussions]
- 技术交流：[社区论坛]
🍉 Made with ❤️ by FiFu Team
守护原版机制，赋能管理体验