灵撷

Ling Gacha Addon（共鸣系统）

Ling Gacha Addon 是 ling_q_shop（Minecraft 1.21.1 NeoForge）的一个扩展模组，将受《鸣潮》启发的完整抽卡共鸣系统带入 Minecraft。

---

主要特性

1. 卡池类型

• 限定共鸣者（角色卡池）：
  • 50/50 规则：有 50% 的几率抽中当期 5 星物品。若未抽中，则下一次 5 星必定为当期概率提升物品。
• 限定武器（武器卡池）：
  • 100% 必得：抽到 5 星物品时，必定为当期概率提升武器，不会歪到其他物品。
• 新手共鸣（新手卡池）：
  • 十连抽取享有 20% 折扣（仅需消耗相当于 8 抽的原粹晶石），且前 50 抽内必定获得一个 5 星物品。
• 常驻共鸣（永久卡池）：
  • 包含 5 星、4 星和 3 星奖励的常驻奖池。

2. 概率与保底机制

• 5 星（传说）：基础概率为 0.8%。软保底从第 65-79 抽开始（概率急剧上升）。硬保底为第 80 抽必定获得 5 星。
• 4 星（史诗）：基础概率为 6.0%。每 10 抽必定至少获得一个 4 星物品。
• 3 星（补给品）：基础概率为 93.2%。
• 余辉珊瑚返利：抽取物品可获得余辉珊瑚（5 星返还 15 个，4 星返还 3 个，3 星返还 1 个）。
• 各卡池独立保底：每个卡池独立追踪各自的 5 星保底、4 星保底、保底状态和抽取次数。

3. 抽卡邮箱 / 奖励存储

• 背包溢出保护：抽取抽卡时，获得的物品会自动存入玩家专属的抽卡邮箱中。
• 选择性领取与批量领取：玩家可以查看奖励、浏览抽取日期，并逐个领取物品或使用“全部领取”功能。
• 容量安全：即使玩家背包已满，物品也绝不会掉落在地面或丢失。

4. 自定义媒体与动画引擎

• 支持的格式：支持动态 GIF（.gif）、精灵帧序列（.afma）、PNG（.png）和 JPEG（.jpg）。
• 卡池背景：将背景文件放入 config/ling_gacha/backgrounds/ 目录，或使用资源路径（例如 ling_gacha:textures/gui/banners/featured_character.png）。
• 自定义抽取动画：将抽取动画文件放入 config/ling_gacha/animations/ 目录：
  • pull_5star.gif / pull_5star.afma — 抽到 5 星物品时播放。
  • pull_4star.gif / pull_4star.afma — 抽到 4 星物品时播放。
  • pull_3star.gif / pull_3star.afma — 抽到 3 星物品时播放。
  • pull.gif / pull.afma — 默认抽取动画。
  • 若没有自定义动画文件，则使用内置的频率声波频谱图作为后备。

5. 游戏内管理员编辑器

• 权限要求：需要 OP 2 级、创造模式，或为单人世界主机。
• 编辑模式：直接在抽卡界面中切换 [编辑模式]，可以：
  • 创建新卡池并自定义标题、副标题、抽取费用、折扣和背景。
  • 打开 [奖池] 编辑物品权重、自定义显示名称、概率提升状态和稀有度等级。
  • 点击 [+ 添加手持物品] 可将手持物品连同完整 SNBT 数据立即注册到卡池中。

---

使用方法

1. 打开抽卡界面

• 命令：/convene 或 /gacha
• ESC 暂停菜单：点击游戏菜单右侧的三叶草图标按钮。
• 共鸣潮汐物品：右键点击 ling_gacha:convene_tide 令牌物品。

2. 配置与数据存储

• 卡池配置：config/ling_gacha/banners.json
  • 存储所有卡池定义、物品池、费用、折扣和背景纹理。
• 玩家数据：config/ling_gacha/playerdata/<Player_UUID>.json
  • 安全服务端存储，用于玩家的保底计数、抽取历史、余辉珊瑚和邮箱物品。
• 重载命令：/convene reload 或 /gacha reload（仅管理员可用）。