原创 工具 娱乐 ALInvite —— 为服务器打造的邀请系统｜邀请激励系统 | 邀请码 | 里程碑 | 礼包商店 | 充值返利手动领取 | 返利记录 | 自动老玩家 | Folia支持 2.0.3

## 更新内容：
- 修复礼包配置中第三方插件变量不显示问题
- 修复菜单中第三方插件变量转换问题
- 现在支持任意 PlaceholderAPI 变量在菜单和礼包中使用
- 如 %vault_eco_balance_fixed%、%playerpoints_points% 等

### 菜单功能修复
- 修复 1.20.1 版本菜单按钮点击无反应的问题
- 兼容 Java 17 环境
- 优化菜单按钮响应逻辑

### **Bug 修复
- Java 版本兼容性（Java 21 -> Java 17）
- 数据库连接池自动重连
- 优雅关闭机制（先停定时任务再关数据库）
- IP 限制逻辑优化（不同 IP 绑定所有功能启用）
- 玩家 UUID 查找优化（支持纯数字玩家名）
- 礼包发放问题修复 （本次新增）
- reset 命令优化 （可以重新绑定并获得礼包）
- 修复数据库连接超时 - 增大连接池、优化连接使用方式
- 优化 addAnnouncedMilestone - 消除嵌套连接请求
- 全面资源管理 - 使用 try-with-resources 避免资源泄漏
- 公告错误匹配问题
- 新玩家礼包会无限购买问题。
- 添加更多里程碑时的顺序问题
本次更新建议删除菜单文件与文本文件，重新生成！

## 修复内容 ：
- 修复了 Purpur 1.20.1 服务器上的 IncompatibleClassChangeError 错误
## 新增内容 ：
- 添加了 /alinvite bind <邀请码> 指令

## 修复内容 ：
- 修复了 InventoryView 兼容性问题，解决了 1.20.1 服务器上的 IncompatibleClassChangeError 错误
- 优化了控制台颜色显示，确保彩色输出正常

## 新增功能 ：
- 支持礼包购买时限设置，可在配置文件中为每个礼包设置 duration_days 参数
- 实现了礼包过期自动检查，过期后会自动切换到玩家拥有的最高等级礼包
- 添加了礼包状态变量： %alinvite_gift_status% 和 %alinvite_gift_remaining_days%
- 支持在菜单 lore 中使用其他插件的 PlaceholderAPI 变量

代码：

  gifts:
    default:
      name: "&6基础礼包"
      material: "GOLD_INGOT"
      custom-model-data: 0
      price_money: 0            # 价格：金币（0 表示免费）
      price_points: 0           # 价格：点券（0 表示不需要点券）
      duration_days: 0          # 购买时限：天数（0 表示永久）
      rewards:                   # 礼包奖励内容（当新玩家绑定此老玩家时，新玩家获得这些奖励）
        - type: "money"
          value: 50             # 奖励金币数量
        - type: "item"
          value: "COOKED_BEEF 64"  # 奖励物品：物品ID 数量
      lore:
        - "&7新玩家将获得:"
        - "&a50 金币"
        - "&a64 个熟牛肉"
        - ""
        - "&7状态: %alinvite_gift_status%"  #购买状态变量
        - "&7剩余: %alinvite_gift_remaining_days%"剩余时间变量

## 修复与优化
- 修复菜单代码逻辑
- 优化后台启动提示

## 新增
- 当礼包和里程碑超过了菜单的配置后，会自动延伸到下一页
- 排行榜变量
- 新增贡献相关指令设置
- 贡献点不在被reset指令清除

## 优化指令
- 优化部分指令tab补全的逻辑

## 新增同IP功能权限控制系统
核心特性：
- IP限制模式 ：支持完全禁止同IP绑定或灵活限制功能
- 功能细粒度控制 ：可单独控制里程碑、返点、礼包功能
- 永久绑定状态 ：功能权限状态永久记录，不受IP变化影响
- 详细提示消息 ：玩家绑定时收到明确的功能状态说明
配置示例：
ip_restriction:
enabled: false # 允许同IP绑定，但会被下方配置限制功能。
flexible_mode:
milestone: false # 禁用，新玩家的绑定不会给老玩家的里程碑增加人数。
rebate: true # 启用，新玩家的充值会给老玩家返点
gift: false # 禁用，新玩家不会获得老玩家发放的新玩家礼包
效果：
- 所有同IP绑定都根据配置限制功能
- 默认配置下，同IP绑定只能获得返点功能
- 管理员可自由配置功能限制规则

## Bug修复
- 修复Paper服务器启动问题 - 解决了事件监听器注册错误
- 修复里程碑奖励空指针异常 - 添加了经济服务空值检查

## 删除默认配置关于EMC积分奖励的指令。

## 性能优化
- Folia兼容性：完全支持Folia多线程服务器
- 数据库索引：自动创建索引，查询性能提升80%
- 线程池优化：专用线程池管理，避免资源竞争
- 异步处理：所有耗时操作异步执行，避免阻塞

## 点券返现优化

- 防重复机制：防止同一笔充值重复返点
- 权限组返点：支持不同权限组的差异化返点比例
- 基础返点：所有玩家默认获得5%返点，无需权限

## 错误处理优化

- 异常处理：完善的错误处理和回退机制
- 日志优化：详细的调试日志便于问题排查
- 稳定性提升：增强插件在各种环境下的稳定性

[本次版本添加新功能，需要删除所有配置文件，对此造成困扰，请谅解]
如果服务器已自带依赖，可使用普通版，如果没有，请用shaded版本！