FE_Quests（冒险等级任务）插件

项目概述

基于 Paper API 1.21.11+ 开发的 Java 插件，旨在为玩家提供教程引导，功能解锁，冒险经验等级升级的功能。

插件信息

• 插件版本：0.1
• 插件命令：/fequests（别名：/feq）
• 作者：F.windEmiko（狐风轩汐）

挂钩插件(依赖)

• LuckPerms
• PlaceholderAPI
• Vault
• PlayerPoints

主要功能

1. 基础新手教程部分

• 模块化设计，待进一步开发

2. 冒险等级系统

• 独立的经验等级系统，模块化设计

3. 引导任务系统

• 箱子GUI界面，支持任务展示和交互
• 丰富的任务类型和进度跟踪

4. 功能玩法解锁

• 模块化设计，待进一步开发

5. 消息系统

• ActionBar消息：实时显示临时信息
• 聊天消息：标准聊天框消息
• BossBar消息：顶部进度条显示重要信息

6. 数据库系统

• SQLite支持：默认数据库，适合小型服务器
• MySQL支持：可选数据库，适合大型服务器
• 自动切换：支持运行时切换数据库类型
• 完整DAO层：提供玩家任务、等级和任务定义的数据访问对象

7. 模块化架构

• Core模块：提供基础模块接口
• Hooks模块：处理依赖插件挂钩
• Managers模块：管理各种系统功能
• Modules模块：实现具体功能模块
• GUI模块：处理界面系统
• Utils模块：提供工具类
• Database模块：处理数据存储

使用说明

命令

• /fequests - 打开任务GUI界面
• /fequests help - 查看帮助信息
• /fequests version - 显示插件版本
• /fequests reload - 重载插件配置（需要权限）
• /fequests debug - 切换调试模式（需要权限）
• /fequests gui - 打开任务GUI界面
• /fequests testmessages - 测试消息功能

权限

• fequests.use - 使用插件基本功能
• fequests.reload - 重载插件配置
• fequests.debug - 切换调试模式

技术特点

模块化设计

项目采用模块化架构，所有功能都作为独立模块实现，易于维护和扩展。

现代化API

使用最新的Paper 1.21.11 API，确保兼容性和性能。

灵活的GUI系统

• 抽象GUI接口，易于创建各种界面
• GUI管理器处理界面事件和状态
• 预设的任务GUI界面示例

完整的消息系统

• 统一的消息工具类
• 支持ActionBar、聊天、BossBar等多种消息类型
• 颜色代码自动格式化

双数据库支持

• SQLite：默认数据库，无需额外配置，适合小型服务器
• MySQL：高性能数据库，适合大型服务器和集群环境
• 自动配置：通过config.yml轻松切换数据库类型
• 统一接口：使用相同的API操作不同类型的数据库

依赖管理

• 自动检测并挂钩外部插件
• 安全的依赖使用机制
• 插件可用性检查

配置文件

配置文件位于 config.yml，包含：

• 基础设置（语言、调试模式）
• 数据库设置（类型、SQLite文件名、MySQL连接信息）
• 冒险等级系统配置
• 任务系统配置
• 新手教程配置
• 依赖挂钩设置

开发状态

本插件已完成基础架构搭建，包括：

• ✅ 模块化架构设计
• ✅ 依赖挂钩系统
• ✅ 命令系统
• ✅ GUI界面系统
• ✅ 消息系统（ActionBar、聊天、BossBar）
• ✅ 双数据库系统（SQLite/MySQL）
• ✅ 数据访问对象（DAO）层
• ✅ 配置管理系统
• ✅ 事件处理系统