跳到主要内容

PRD-058 神器系统

文档编号：PRD-058
版本：v1.0
状态：已通过
适用端：服务端 / 客户端
脚本挂载：lua/numeric/artifact.lua

1. 背景与目标​

神器提供长线数值追求与主动技能。升级、升星、共鸣、技能解锁适合用 Lua 编排，便于赛季扩展新神器。

目标

  • 4 个神器槽位，分攻击/防御/辅助/特殊。
  • 神器可升级、升星、觉醒，提供属性与主动技能。
  • 同源神器可共鸣，激活额外效果。

2. 核心规则​

2.1 获取与培养​

  • 神器通过活动/副本/跨服联赛产出碎片，集齐激活。
  • 等级 1–50，消耗神器精华；星级 0–5，消耗同名碎片。
  • 觉醒需等级/星级达标 + 觉醒石，解锁第二技能。
  • 属性全角色生效，主动技能需装备到槽位。

2.2 槽位与技能​

  • 4 个槽位，同类型神器只能装备 1 个。
  • 主动技能有独立 CD，不占角色技能栏，可在快捷栏使用。
  • 神器技能受角色属性/元素影响，但不触发武器特效。

2.3 共鸣​

  • 同系列 2/4 件激活共鸣：属性加成/技能强化。
  • 共鸣只统计已装备神器，不统计背包。
  • 切换神器后有 10 秒共鸣失效保护，避免频繁切换。

3. 服务端设计​

3.1 Lua 脚本设计​

-- lua/numeric/artifact.lua
Artifact = {
    slots = { "attack", "defense", "support", "special" },
    max_level = 50,
    max_star = 5,
    resonance = { [2]={atk=0.05}, [4]={atk=0.1, skill=0.1} },
}

function OnEquip(ctx, role, artifact_uid, slot)
    local art = ctx:GetArtifact(artifact_uid)
    if not art or art.slot ~= slot then return ctx:Fail(role, "槽位不匹配") end
    ctx:SetArtifactSlot(role, slot, artifact_uid)
    ctx:RecalcResonance(role)
    ctx:RecalcAttributes(role)
end

function OnUpgrade(ctx, role, artifact_uid)
    local art = ctx:GetArtifact(artifact_uid)
    if art.level >= Artifact.max_level then return ctx:Fail(role, "已满级") end
    if not ctx:Consume(role, "artifact_essence", ctx:UpgradeCost(art.level)) then
        return ctx:Fail(role, "材料不足")
    end
    ctx:AddArtifactLevel(art, 1)
    ctx:RecalcAttributes(role)
end
  • 神器槽、等级、星级、觉醒状态持久化。
  • 共鸣/属性汇总由脚本触发，C++ 提供快照。
  • 主动技能注册到技能系统，使用独立 CD。

3.2 协议​

方向协议说明
C→SCS_ArtifactEquip装备
C→SCS_ArtifactUpgrade升级/升星/觉醒
S→CSC_ArtifactList神器列表
S→CSC_ArtifactState槽位/共鸣/技能

3.3 竞技约束​

  • 竞技场/战场可使用神器技能，但受统一 CD/伤害修正。
  • 神器战力计入匹配，设上限避免单件碾压。
  • 跨服联赛可配置禁用特定神器。

4. 客户端设计​

  • 神器界面：4 槽位、列表、等级/星级、技能预览。
  • 升级/升星材料不足一键跳转。
  • 共鸣提示：当前件数/下一档。
  • 主动技能拖入快捷栏，独立 CD 显示。
  • 觉醒动画与技能演示。

5. 配置与 Lua 接口​

配置说明
artifact_id神器
slot槽位
level_cost升级消耗
star_cost升星消耗
skill_id主动技能
resonance共鸣效果

Lua 接口：GetArtifact、SetArtifactSlot、AddArtifactLevel、RecalcResonance、RecalcAttributes、UpgradeCost。

6. 边界与异常​

场景处理
同类型重复装备替换/拒绝（配置）
碎片不足拒绝
觉醒技能冲突替换并提示
神器被删除登录清理槽位
切换共鸣10 秒保护，防刷属性
热更神器登录重算

7. 验收标准​

  • 获取/装备/升级/升星/觉醒/共鸣正确。
  • 主动技能 CD、伤害、快捷栏正确。
  • 属性/战力重算一致。
  • 竞技禁用/修正生效。
  • 客户端槽位/技能显示一致。