AdLike2048/docs/需求-宝石装备合成.md

需求：宝石装备与合成

状态：局外 UI / 存档 / 合成已实现；局内属性与技能已接入战斗。

背景

老项目武器功能改造为宝石：Weapon 表每行一颗宝石；部分宝石带 act_skill。宝石在局外宝石页镶嵌到金木水火土五行，装备后局内对应属性数字获得属性与技能。

配表

表	用途
Weapon	宝石定义：type 1 通用 / 2~6 金木水火土；quality 0~5 与等级对应；itemid 道具；synthesisnumber 合成消耗本宝石数量；synthesisitem 合成目标 id 列表；attritubes / act_skill
Item	type=3 宝石道具；para 指向 Weapon.id

镶嵌规则

• 每五行 4 槽（g1~g4）。
• 通用（type=1）可装任意五行。
• 属性专属（type=2~6）须 type === elementType + 1（elementType 1~5 = 金木水火土），且每五行最多 1 颗专属。
• 目标槽有宝石：先卸再装（或交换）。
• 仓库拖到槽 = 装备；槽拖到仓库区 = 卸下。

拥有量

• 库存：Item 数量（Weapon.itemid）。
• 可用数 = 库存 − 已镶嵌数；仓库与合成只使用可用数。

存档

• OtherDataType.ElementGem
• 格式：element|s0,s1,s2,s3#...（element=1~5，槽位宝石 id，0=空）

一键合成

1. 每轮对当前可用数做快照，仅用快照计算可合成次数；本轮产出不参与本轮材料。
2. 消耗 synthesisnumber 个本宝石，产出 1 个目标：synthesisitem 仅 1 个则取之，多个则随机取 1。
3. 多轮直到无可合成。
4. 弹窗展示：各宝石「合成后可用数 − 合成前可用数」中 delta > 0 的条目。

UI 注意

• 仓库按页签展示，无「全部」、无滚动：btn0~btn5 → Weapon.type 1~6（通用/金木水火土），默认通用。
• 仓库格分帧实例化进 ui_content（Layout 排布）；交互为直接拖拽镶嵌/卸下。
• 仓库全量重建仅：打开页 / 切页签 / 一键合成。镶嵌成功只局部改数量与槽位；失败不刷列表。
• 仓库项 bg 用 宝石框大{quality}；镶嵌位 g1~g4 仍用 宝石框小。

局内（已接入）

五行数字上阵时（TowerLoadoutService.setupCombat）：

1. 本机玩家：gg.gem.getElementSlots(Hero.herotype) 读该五行最多 4 槽宝石。
2. 每颗 attritubes 写入该数字属性（多槽累加）；刷新上阵前清除旧 gem_ modifier。
3. 有 act_skill 的宝石接到原有武器技能槽（主动 / 被动 / atk_buff）；同五行多颗技能宝石时取品质更高者（配表异常时 warn）。
4. AI 对手不读本机镶嵌。

attritubes 类型

type	含义	战斗写入
1	攻击万分比	Attack Mul
2	暴击万分比	CritRate Add
3	暴击伤害万分比	CritDamage Add
4	攻速万分比	aspd_add
5	伤害加成万分比	dmg_mul

实现：assets/script/battle/combat/GemBattleEffect.ts。