Search Results for

    Show / Hide Table of Contents

    为主武器添加蓄力伤害

    中文 | English

    在仓库根目录运行以下命令,用本机 Unity MCP 回放本页示例。

    python Docs/Manual/manual/tools/tutorials.py run lua-api2-charged-shot
    
    点击展开 MCP 操作点击收起 MCP 操作

    准备教学样例。${变量} 由配方提供。

    {
      "variables": {
        "script": "${fixture}/ChargedShot.lua",
        "prefab": "${fixture}/Tutorial_ChargedShot.prefab"
      },
      "calls": [
        {
          "tool": "invoke",
          "arguments": {
            "path": "static:UnityEditor.AssetDatabase/CreateFolder",
            "args": [
              "${fixtureParent}",
              "${folder}"
            ]
          },
          "expect": {
            "contains": "(String)"
          }
        }
      ]
    }
    

    1. 导入脚本并绑定载具

    在 Lua 源码目录创建 ChargedShot.lua,复制下方脚本,按 Lua Hello World 导入 Unity。选中 VehicleTextData 的载具级 Lua 行为,将导入资产加到列表。若要在独立测试预制体上试验,可用 LuaBehaviorMono 的挂载方式,并让它位于载具层级内。

    保留 chargeTime = 4 秒和 maxBonus = 0.5。示例选择武器索引 0。需要另一个武器时,先用 WeaponAPI.GetWeaponCount 看可用数量,再修改索引。找不到武器或蓄力时长不大于零时,脚本停用周期更新。

    用 BuffAPI.CreateValueBuff 创建一个可修改的 Buff,挂到武器的 DamageBuffedCoff。第二个参数 false 选加法,数值 0.5 表示加 50%。传 true 时系数参与乘法叠加。保留同一对象,只在数值变化时用 SetValue 更新它,省去反复移除和创建。行为销毁时调用 RemoveBuff。

    Behavior()
    Property = {
        maxBonus = { type = "number", value = 0.5 },
        chargeTime = { type = "number", value = 4 },
    }
    
    local ChargedShot = class("ChargedShot")
    
    function ChargedShot:OnVehicleReady(vehicle)
        local weapon = WeaponAPI.GetWeapon(vehicle, 0)
        if weapon == nil or self.chargeTime <= 0 then
            self.script:SetUpdateEnabled(false)
            return
        end
        self.weapon = weapon
        self.damage = weapon.DamageBuffedCoff
        self.charge = 0
        self.buff = BuffAPI.CreateValueBuff("Charged Shot", false, 0)
        self.damage:AddBuff(self.buff)
        WeaponAPI.OnFired(self.script, weapon, function()
            self.charge = 0
            self.buff:SetValue(0)
        end)
        self.script:SetUpdateInterval(0.1)
    end
    
    function ChargedShot:OnUpdated(dt)
        if self.buff == nil or not WeaponAPI.IsReloaded(self.weapon) then
            return
        end
        self.charge = math.min(self.charge + dt / self.chargeTime, 1)
        self.buff:SetValue(self.charge * self.maxBonus)
    end
    
    function ChargedShot:OnDestroyed()
        if self.buff ~= nil then
            self.damage:RemoveBuff(self.buff)
            self.buff = nil
        end
    end
    
    return ChargedShot
    
    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:System.IO.File/Copy",
          "args": [
            "../../Docs/Manual/tutorials/lua-api2-charged-shot/example.lua",
            "${script}"
          ]
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:UnityEditor.AssetDatabase/ImportAsset",
          "args": [
            "${script}",
            "ForceSynchronousImport"
          ]
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "prefab_edit",
        "arguments": {
          "json": {
            "path": "${prefab}",
            "mode": "create",
            "component": "ShanghaiWindy.Core.Lua.LuaBehaviorMono",
            "children": [],
            "references": [
              {
                "property": "luaBehavior",
                "asset": "${script}",
                "type": "ShanghaiWindy.Core.Lua.LuaBehaviorScript"
              }
            ],
            "values": {
              "instanceLuaProperty": {
                "numberProperties": [
                  {
                    "variableName": "maxBonus",
                    "value": 0.5
                  },
                  {
                    "variableName": "chargeTime",
                    "value": 4
                  }
                ]
              }
            }
          }
        },
        "expect": {
          "equals": {
            "ok": true
          }
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${prefab}/LuaBehaviorMono/luaBehavior/name"
        },
        "expect": {
          "contains": "(String) ChargedShot"
        }
      }
    ]
    

    2. 按装填、蓄力和开火顺序试验

    1. 让武器完成装填。装填期间脚本跳过蓄力。
    2. 等约两秒后开火一次,再完整装填并等超过四秒后开火。可先临时记录 self.charge,确认它随 dt / chargeTime 增长,达到 1 后不再增长。更新间隔设为 0.1 秒,按收到的 dt 积累。
    3. 检查 OnFired 同时清零蓄力与 Buff 数值。移除脚本后再查看 Buff 是否已从武器移除。测试实际伤害时使用相同的弹种和目标,并保持命中位置一致。

    回放使用 xLua 测试替身核对装填门槛、蓄力上限、开火复位和销毁清理。

    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:ShanghaiWindy.Core.AssetBundleManager/LuaEnv/DoString",
          "args": [
            "local E = setmetatable({ Behavior = function() end, class = function() return {} end, print = function() end }, { __index = _G })\nlocal reloaded, value, callback = false, 0, nil\nlocal adds, removes = 0, 0\nlocal buff = { SetValue = function(_, coefficient) value = coefficient end }\nlocal weapon = { DamageBuffedCoff = {\n    AddBuff = function(_, x) assert(x == buff); adds = adds + 1 end,\n    RemoveBuff = function(_, x) assert(x == buff); removes = removes + 1 end,\n} }\nE.WeaponAPI = {\n    GetWeapon = function(_, i) assert(i == 0); return weapon end,\n    IsReloaded = function(_) return reloaded end,\n    OnFired = function(_, _, cb) callback = cb end,\n}\nE.BuffAPI = { CreateValueBuff = function() return buff end }\n\nlocal B = assert(loadfile('../../Docs/Manual/tutorials/lua-api2-charged-shot/example.lua', 't', E))()\nlocal function instance(t) return setmetatable(t, { __index = B }) end\nlocal script = { SetUpdateInterval = function(_, x) assert(x == 0.1) end }\nlocal instance = instance({ script = script, chargeTime = 4, maxBonus = 0.5 })\ninstance:OnUpdated(1)\ninstance:OnVehicleReady({})\ninstance:OnUpdated(2)\nassert(value == 0 and adds == 1)\nreloaded = true\ninstance:OnUpdated(2)\nassert(value == 0.25)\ninstance:OnUpdated(5)\nassert(value == 0.5)\ncallback()\nassert(value == 0)\nreloaded = false\ninstance:OnUpdated(1)\nassert(value == 0)\ninstance:OnDestroyed()\nassert(removes == 1)\nlocal realBuff = CS.ShanghaiWindy.Core.API.BuffAPI.CreateValueBuff(\"Example\", false, 0)\nrealBuff:SetValue(0.5)\nassert(realBuff:GetValue() == 0.5)\nreturn \"Lua example passed\"\n",
            "manual-lua-api2-charged-shot",
            "null"
          ]
        },
        "expect": {
          "contains": "Lua example passed"
        }
      }
    ]
    
    In this article
    Back to top Panzer War Document