Search Results for

    Show / Hide Table of Contents

    制作坦克抛壳动画

    中文 | English

    在仓库根目录运行以下命令,用本机 Unity MCP 回放本页示例。 命令也会重拍两种语言的配图。

    python Docs/Manual/manual/tools/tutorials.py run tank-shell-ejection-animation --capture
    
    点击展开 MCP 操作点击收起 MCP 操作

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

    {
      "variables": {
        "rig": "${fixture}/Tutorial_ShellRig.fbx",
        "model": "${fixture}/Tutorial_ShellRig.prefab",
        "clip": "${fixture}/Tutorial_ShellEject.anim",
        "script": "${fixture}/PlayAnimationComponent.lua"
      },
      "calls": [
        {
          "tool": "invoke",
          "arguments": {
            "path": "static:UnityEditor.AssetDatabase/CreateFolder",
            "args": [
              "${fixtureParent}",
              "${folder}"
            ]
          },
          "expect": {
            "regex": "\\(String\\) [a-f0-9]{32}"
          }
        }
      ]
    }
    

    本教程改编自樱花的《坦克抛壳动画》。示例先在 Blender 准备炮塔下的弹壳和抛壳装置,再在 Unity 制作动画,最后用 Lua 将剪辑接到开火事件。

    1. 准备并导入模型

    在 Blender 中将弹壳放到炮塔内,设为炮塔的子级。本例将弹壳节点命名为 Casing。把抛壳装置的枢轴设在旋转中心。如果旋转轴和全局坐标轴不重合,可以放置并旋转一个空物体作为父级。本例用 MechanismPivot 表示这个空物体。

    导出 FBX 后导入 Unity,确认模型下保留 Turret/Casing 和 Turret/MechanismPivot,再创建用于配置的 prefab。配方用 Blender 后台模式生成并导出教学样例。如果 Unity 找不到 Blender,启动编辑器前设置 BLENDER 指向可执行文件。

    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:ShanghaiWindy.Editor.ShellEjectionAuthoring/ExportRig",
          "args": [
            "${fixture}"
          ]
        },
        "expect": {
          "contains": "Tutorial_ShellRig.fbx"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:ShanghaiWindy.Editor.ShellEjectionAuthoring/EnsureRigPrefab",
          "args": [
            "${rig}",
            "${model}"
          ]
        },
        "expect": {
          "regex": "\\(String\\) [a-f0-9]{32}"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${model}/Turret/Casing/name"
        },
        "expect": {
          "contains": "(String) Casing"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${model}/Turret/MechanismPivot/Mechanism/name"
        },
        "expect": {
          "contains": "(String) Mechanism"
        }
      }
    ]
    

    2. 制作并分配动画

    在 Unity 的 Animation 窗口中选择 prefab 根节点,创建 Tutorial_ShellEject.anim 剪辑。为 Casing 的局部 Position 添加起点、抛出和复位三个关键帧。本例在 0.2 秒沿局部 X 轴移动 0.35 个单位,在 0.4 秒回到起点。装置通过 MechanismPivot 的局部 Rotation 曲线在 0.2 秒转到 35° 的打开姿态,随后复位。

    将剪辑设为 Legacy,Wrap Mode 保持 Default。在根节点添加 Animation,指定默认剪辑并关闭 Play Automatically,让 Lua 控制播放。

    Animation 组件的默认剪辑与播放设置

    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:ShanghaiWindy.Editor.ShellEjectionAuthoring/WriteClip",
          "args": [
            "${fixture}",
            "${model}"
          ]
        },
        "expect": {
          "contains": "Turret/Casing/m_LocalPosition.x: 3 keys"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:ShanghaiWindy.Editor.ShellEjectionAuthoring/AssignClip",
          "args": [
            "${model}",
            "${clip}"
          ]
        },
        "expect": {
          "contains": "Tutorial_ShellEject"
        }
      }
    ]
    

    3. 绑定开火事件

    在同一个根节点添加 LuaBehaviorMono,将以下脚本保存为 PlayAnimationComponent.lua 并赋给「行为脚本」。脚本在载具加载后监听第一个火力系统的开火事件。多炮载具应按实际火力列表选择索引。

    Behavior()
    Property = {}
    
    local PlayAnimationComponent = class("PlayAnimationComponent")
    
    function PlayAnimationComponent:OnStarted()
        local animation = self.script:GetNativeComponent("Animation")
        local found, vehicle = self.script:TryGetTankInitSystem()
        if not animation or not found then
            return
        end
    
        VehicleAPI.RegisterVehicleLoadedEvent(vehicle, function()
            VehicleAPI.RegisterBulletFiredEvent(vehicle, 0, function()
                animation:Play()
            end)
        end)
    end
    
    return PlayAnimationComponent
    

    绑定 PlayAnimationComponent

    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:ShanghaiWindy.Editor.ShellEjectionAuthoring/ImportBehavior",
          "args": [
            "${fixture}"
          ]
        },
        "expect": {
          "contains": "PlayAnimationComponent.lua"
        }
      },
      {
        "tool": "prefab_edit",
        "arguments": {
          "json": {
            "path": "${model}",
            "mode": "update",
            "component": "ShanghaiWindy.Core.Lua.LuaBehaviorMono",
            "references": [
              {
                "property": "luaBehavior",
                "asset": "${script}",
                "type": "ShanghaiWindy.Core.Lua.LuaBehaviorScript"
              }
            ]
          }
        },
        "expect": {
          "equals": {
            "ok": true
          }
        }
      }
    ]
    

    4. 保存并核对

    保存 prefab,检查 Animation 和 LuaBehaviorMono 在同一个节点上,再核对默认剪辑、Legacy 设置和 Lua 引用。配方回读了位置曲线和旋转曲线。还需在完整载具上试射,确认开火回调和动画在游戏中按预期运行。

    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${clip}/legacy"
        },
        "expect": {
          "contains": "(Boolean) True"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${clip}/wrapMode"
        },
        "expect": {
          "contains": "Default"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${model}/Animation/clip/name"
        },
        "expect": {
          "contains": "Tutorial_ShellEject"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${model}/Animation/playAutomatically"
        },
        "expect": {
          "contains": "(Boolean) False"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${model}/LuaBehaviorMono/luaBehavior/name"
        },
        "expect": {
          "contains": "PlayAnimationComponent"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${model}/LuaBehaviorMono/luaBehavior/lua"
        },
        "expect": {
          "contains": "RegisterBulletFiredEvent"
        }
      }
    ]
    
    In this article
    Back to top Panzer War Document