FrontLeaves Augment 聚合主体插件

📌 项目定位

frontleaves-augment 是 FrontLeaves MC 生态下的自研全功能聚合主体插件，遵循 ADR-0006 架构约束：

1. 常规业务聚合：全面整合原细粒度分散的子插件业务（economy 经济、essentials 基础传送、status 在线监控、title 称号、nodrop 死亡保护等）；
2. 反作弊独立隔离：严禁并入反作弊体系，frontleaves-matrix 保持为独立工程，专注于反作弊规则判定、高频 Tick 行为审计与异常告警，防止主体插件过重（Overweight）；
3. 通信通道单例化：依赖前置底座 frontleaves-lib 暴露的单例通道，全服共用唯一的 HTTP/2 TCP 复合长连接，避免多插件连接风暴。

🧱 模块架构

com.frontleaves.plugins.augment/
├── Augment.java             # 插件入口，接管生命周期与通道复用
├── command/                 # 命令层：Brigadier / Paper 命令集中注册与执行
├── config/                  # 配置层：全局扁平化业务配置与 i18n 语言管理
├── event/                   # 事件层：全服自定义 Bukkit 事件定义
├── grpc/                    # 通信层：复用单例通道的 RPC 客户端与双向流处理器
├── init/                    # 初始化层：命令、监听器与 gRPC 编排初始化
├── listener/                # 监听器层：事件监听集中注册与生命周期分发
├── logic/                   # 业务逻辑层：经济、基础传送、玩家数据、称号缓存、监控采集等核心 Service
├── model/                   # 模型层：业务实体模型与数据对象
├── papi/                    # 扩展层：PlaceholderAPI 占位符扩展
└── util/                    # 工具层：消息构造、转换与权限工具

🛠️ 构建与部署

# 编译打包
mvn clean package

# 产物位置
# target/frontleaves-augment-1.0.0.jar

部署要求：

• 服务端核心：Paper / Youer 1.21.1-R0.1-SNAPSHOT
• 运行环境：Java 21
• 前置依赖：必须放置 frontleaves-lib.jar

⚠️ 服务端部署与冲突防范

上线时服务端 plugins/ 目录中同时只能存在以下三位一体自研插件：

1. frontleaves-lib.jar（前置底座）
2. frontleaves-augment.jar（玩法综合体）
3. frontleaves-matrix.jar（独立反作弊体系）

必须移除旧的子插件 Jar 包（frontleaves-emoney.jar、frontleaves-essentials.jar、frontleaves-status.jar、frontleaves-tag.jar、frontleaves-nodrop.jar、command-binding.jar），否则命令与监听器将重复注册并产生冲突。