为主武器添加蓄力伤害
中文 | 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. 按装填、蓄力和开火顺序试验
- 让武器完成装填。装填期间脚本跳过蓄力。
- 等约两秒后开火一次,再完整装填并等超过四秒后开火。可先临时记录
self.charge,确认它随dt / chargeTime增长,达到 1 后不再增长。更新间隔设为 0.1 秒,按收到的dt积累。 - 检查
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"
}
}
]