ALInvite 2.1.0 — Lophine 26.2 Folia 传火邀请制

ALInvite 2.1.0

面向 Lophine 26.2 / Folia 的传火邀请制升级版。

主要更新

• 兼容 Lophine 26.2 / Folia 调度器，保留 folia-supported: true。
• 使用 Java 21 编译，支持测试服 Java 25。
• 新增传火邀请名额：每人初始 1 个名额，用完后每 24 小时恢复 1 个，最多积累 1 个。
• 邀请记录、邀请人数、名额扣减使用 SQLite/MySQL 事务处理。
• 增加 IP 绑定限制与跨服 IP 计数，默认每个 IP 最多成功绑定 1 次。
• 新人礼包默认包含：
  • 面包 ×32
  • 石镐 ×1
  • 火把 ×16
  • PlayerPoints ×20
• 邀请里程碑默认调整为：
  • 1 人：10 点券
  • 3 人：50 点券
  • 10 人：200 点券
• 在线累计 24 小时自动获得 alinvite.veteran；PlaceholderAPI 不可用时回退 Bukkit PLAY_ONE_MINUTE 统计。
• 新增 /alinvite generate 兼容别名。
• 新增管理员连带处罚：
  • /alinvite admin punish <被邀请人> [原因]
  • 保留邀请审计记录，避免重复处罚。
  • 插件不会自动监听封禁，需管理员确认后手动执行。
• 增加玩家与管理员返利历史视图，以及返利到账/领取记录类型。
• 修复 Folia 下异步线程直接读取玩家状态、GUI 聊天回调、跨区域消息发送和 reload 任务残留问题。
• SQLite/MySQL JDBC 驱动随 shaded JAR 打包。
• 补充中文部署与验收文档：docs/ourTravel-传火部署与验收.md。

依赖

可选软依赖：

• LuckPerms
• PlaceholderAPI 2.12.3+
• PlayerPoints 3.3.5+
• VaultUnlocked 与 Vault Economy provider
• Redis + MySQL（跨服场景）

缺少可选依赖时，插件保留降级行为；点券/权限/外部占位符功能需要相应插件实际安装。

白名单重要说明

原生 white-list=true 会在玩家进入服务器之前拦截不在白名单中的新人。ALInvite 无法让尚未进入服务器的新人仅凭邀请码完成首次登录。

请使用代理层门禁/激活码、临时关闭原生白名单，或预先导入测试账号。绑定成功后的 whitelist add 登记只对后续连接生效。

验证

• Maven clean test package：通过，13 项测试通过。
• Lophine 26.2 / Folia / Java 25：插件加载、SQLite 初始化、Folia 调度识别和服务器启动完成均通过。
• 已联调 LuckPerms 5.5.71、PlaceholderAPI 2.12.3、PlayerPoints 3.3.5 的插件加载与命令注册。

发布资产

• ALInvite-2.1.0.jar：部署用 shaded JAR。
• 不要部署 original-ALInvite-2.1.0.jar。