unity

Unity Engine 开发 Skill

Unity 游戏开发的全面辅助，涵盖 C# 脚本、场景管理、物理、渲染、动画、UI 和平台特定功能。

何时使用此 SKill

此 Skill 应在以下情况下触发：

Unity Engine 项目（2D/3D 游戏开发）
Unity 中的 C# 脚本（MonoBehaviour、协程、ScriptableObjects）
场景设置和 GameObject 层级管理
物理系统（Rigidbody、Colliders、Joints、Character Controllers）
动画和 Animator 系统（Animation Clips、Blend Trees、State Machines）
渲染管线（Built-in、URP、HDRP）和着色器（ShaderLab、Shader Graph）
UI 开发（UI Toolkit、UGUI、Canvas、TextMeshPro）
XR/VR/AR 开发（XR Interaction Toolkit）
资源管理和优化
平台特定构建（iOS、Android、WebGL、PC/Console）
编辑器扩展和自定义工具

Unity-MCP 集成

此 Skill 可与 Unity-MCP 结合实现实时 Unity Editor 控制！

Unity Skill（文档） + Unity-MCP（操作） = 完整的 AI 驱动开发

Unity Skill：提供文档、模式和最佳实践（3,367 页）
Unity-MCP：在 Unity Editor 中执行代码、创建资源和自动化工作流
结合使用：从文档学习模式 → 立即应用到项目

完整设置指南请参见 UNITY_MCP_INTEGRATION.md。

快速参考

Unity 基本模式

MonoBehaviour 生命周期

using UnityEngine;

public class GameController : MonoBehaviour { // 脚本实例加载时调用一次 void Awake() { // 在 Start() 之前初始化引用和设置 }

// 第一帧更新前调用一次
void Start()
{
    // 依赖于其他对象的初始化逻辑
}

// 每帧调用
void Update()
{
    // 输入处理和基于帧的逻辑
}

// 以固定时间间隔调用（物理）
void FixedUpdate()
{
    // 物理相关代码（Rigidbody 力等）
}

// 所有 Update 函数完成后调用
void LateUpdate()
{
    // 相机跟随、后处理逻辑
}

// 对象变为激活/启用时调用
void OnEnable() { }

// 对象变为禁用/不活动时调用
void OnDisable() { }

// MonoBehaviour 将被销毁时调用
void OnDestroy()
{
    // 清理逻辑（取消订阅事件等）
}

}

异步操作的协程

using System.Collections; using UnityEngine;

public class CoroutineExample : MonoBehaviour { void Start() { StartCoroutine(DelayedAction()); StartCoroutine(FadeOut(GetComponent<SpriteRenderer>(), 2.0f)); }

// 简单延迟
IEnumerator DelayedAction()
{
    yield return new WaitForSeconds(2.0f);
    Debug.Log("2秒后执行");
}

// 淡出效果
IEnumerator FadeOut(SpriteRenderer sprite, float duration)
{
    float elapsed = 0f;
    Color startColor = sprite.color;

    while (elapsed &#x3C; duration)
    {
        elapsed += Time.deltaTime;
        float alpha = Mathf.Lerp(1f, 0f, elapsed / duration);
        sprite.color = new Color(startColor.r, startColor.g, startColor.b, alpha);
        yield return null; // 等待下一帧
    }
}

}

数据管理的 ScriptableObjects

using UnityEngine;

[CreateAssetMenu(fileName = "New Weapon", menuName = "Game/Weapon")] public class WeaponData : ScriptableObject { public string weaponName; public int damage; public float fireRate; public Sprite icon; public GameObject projectilePrefab; }

// 在 MonoBehaviour 中使用 public class WeaponSystem : MonoBehaviour { [SerializeField] private WeaponData currentWeapon;

public void Fire()
{
    if (currentWeapon != null)
    {
        GameObject projectile = Instantiate(
            currentWeapon.projectilePrefab,
            transform.position,
            transform.rotation
        );
    }
}

}

基于物理的移动

using UnityEngine;

[RequireComponent(typeof(Rigidbody))] public class PlayerMovement : MonoBehaviour { [SerializeField] private float moveSpeed = 5f; [SerializeField] private float jumpForce = 10f; [SerializeField] private LayerMask groundLayer;

private Rigidbody rb;
private bool isGrounded;

void Awake()
{
    rb = GetComponent&#x3C;Rigidbody>();
}

void FixedUpdate()
{
    // 检查是否在地面上
    isGrounded = Physics.Raycast(
        transform.position,
        Vector3.down,
        1.1f,
        groundLayer
    );

    // 移动
    float horizontal = Input.GetAxis("Horizontal");
    float vertical = Input.GetAxis("Vertical");

    Vector3 movement = new Vector3(horizontal, 0f, vertical);
    rb.AddForce(movement * moveSpeed);
}

void Update()
{
    // 跳跃
    if (Input.GetButtonDown("Jump") &#x26;&#x26; isGrounded)
    {
        rb.AddForce(Vector3.up * jumpForce, ForceMode.Impulse);
    }
}

}

对象池模式

using System.Collections.Generic; using UnityEngine;

public class ObjectPool : MonoBehaviour { [SerializeField] private GameObject prefab; [SerializeField] private int poolSize = 20;

private Queue&#x3C;GameObject> pool = new Queue&#x3C;GameObject>();

void Start()
{
    for (int i = 0; i &#x3C; poolSize; i++)
    {
        GameObject obj = Instantiate(prefab);
        obj.SetActive(false);
        pool.Enqueue(obj);
    }
}

public GameObject GetObject()
{
    if (pool.Count > 0)
    {
        GameObject obj = pool.Dequeue();
        obj.SetActive(true);
        return obj;
    }
    else
    {
        // 如需要则扩展池
        GameObject obj = Instantiate(prefab);
        return obj;
    }
}

public void ReturnObject(GameObject obj)
{
    obj.SetActive(false);
    pool.Enqueue(obj);
}

}

单例模式

using UnityEngine;

public class GameManager : MonoBehaviour { private static GameManager _instance;

public static GameManager Instance
{
    get
    {
        if (_instance == null)
        {
            _instance = FindObjectOfType&#x3C;GameManager>();

            if (_instance == null)
            {
                GameObject go = new GameObject("GameManager");
                _instance = go.AddComponent&#x3C;GameManager>();
            }
        }
        return _instance;
    }
}

void Awake()
{
    if (_instance != null &#x26;&#x26; _instance != this)
    {
        Destroy(gameObject);
        return;
    }

    _instance = this;
    DontDestroyOnLoad(gameObject);
}

}

事件系统模式

using System; using UnityEngine;

public class EventManager : MonoBehaviour { public static event Action OnGameStart; public static event Action<int> OnScoreChanged; public static event Action OnGameOver;

public static void TriggerGameStart()
{
    OnGameStart?.Invoke();
}

public static void TriggerScoreChanged(int newScore)
{
    OnScoreChanged?.Invoke(newScore);
}

public static void TriggerGameOver()
{
    OnGameOver?.Invoke();
}

}

// 使用：订阅和取消订阅 public class UIController : MonoBehaviour { void OnEnable() { EventManager.OnScoreChanged += UpdateScoreDisplay; EventManager.OnGameOver += ShowGameOverScreen; }

void OnDisable()
{
    EventManager.OnScoreChanged -= UpdateScoreDisplay;
    EventManager.OnGameOver -= ShowGameOverScreen;
}

void UpdateScoreDisplay(int score)
{
    // 更新 UI
}

void ShowGameOverScreen()
{
    // 显示游戏结束
}

}

2D 角色控制器

using UnityEngine;

[RequireComponent(typeof(Rigidbody2D))] public class CharacterController2D : MonoBehaviour { [SerializeField] private float moveSpeed = 5f; [SerializeField] private float jumpForce = 10f; [SerializeField] private Transform groundCheck; [SerializeField] private LayerMask groundLayer;

private Rigidbody2D rb;
private bool isGrounded;
private bool facingRight = true;

void Awake()
{
    rb = GetComponent&#x3C;Rigidbody2D>();
}

void Update()
{
    // 地面检测
    isGrounded = Physics2D.OverlapCircle(
        groundCheck.position,
        0.2f,
        groundLayer
    );

    // 移动输入
    float moveInput = Input.GetAxis("Horizontal");
    rb.velocity = new Vector2(moveInput * moveSpeed, rb.velocity.y);

    // 翻转角色
    if (moveInput > 0 &#x26;&#x26; !facingRight)
        Flip();
    else if (moveInput &#x3C; 0 &#x26;&#x26; facingRight)
        Flip();

    // 跳跃
    if (Input.GetButtonDown("Jump") &#x26;&#x26; isGrounded)
    {
        rb.velocity = new Vector2(rb.velocity.x, jumpForce);
    }
}

void Flip()
{
    facingRight = !facingRight;
    Vector3 scale = transform.localScale;
    scale.x *= -1;
    transform.localScale = scale;
}

}

UI Toolkit（运行时 UI）

using UnityEngine; using UnityEngine.UIElements;

public class UIController : MonoBehaviour { private UIDocument uiDocument; private Label scoreLabel; private Button startButton;

void OnEnable()
{
    uiDocument = GetComponent&#x3C;UIDocument>();
    var root = uiDocument.rootVisualElement;

    // 查询元素
    scoreLabel = root.Q&#x3C;Label>("score-label");
    startButton = root.Q&#x3C;Button>("start-button");

    // 注册回调
    startButton.clicked += OnStartButtonClicked;
}

void OnDisable()
{
    startButton.clicked -= OnStartButtonClicked;
}

void OnStartButtonClicked()
{
    Debug.Log("游戏开始！");
}

public void UpdateScore(int score)
{
    scoreLabel.text = $"分数：{score}";
}

}

基础着色器（ShaderLab）

Shader "Custom/SimpleTextureShader" { Properties { _MainTex ("纹理", 2D) = "white" {} _Color ("着色颜色", Color) = (1,1,1,1) _Brightness ("亮度", Range(0, 2)) = 1 }

SubShader
{
    Tags { "RenderType"="Opaque" }
    LOD 100

    Pass
    {
        CGPROGRAM
        #pragma vertex vert
        #pragma fragment frag
        #include "UnityCG.cginc"

        struct appdata
        {
            float4 vertex : POSITION;
            float2 uv : TEXCOORD0;
        };

        struct v2f
        {
            float2 uv : TEXCOORD0;
            float4 vertex : SV_POSITION;
        };

        sampler2D _MainTex;
        float4 _MainTex_ST;
        float4 _Color;
        float _Brightness;

        v2f vert (appdata v)
        {
            v2f o;
            o.vertex = UnityObjectToClipPos(v.vertex);
            o.uv = TRANSFORM_TEX(v.uv, _MainTex);
            return o;
        }

        fixed4 frag (v2f i) : SV_Target
        {
            fixed4 col = tex2D(_MainTex, i.uv);
            col *= _Color * _Brightness;
            return col;
        }
        ENDCG
    }
}

}

参考文件

此 Skill 包含按主题在 references/ 中组织的综合文档：

核心主题

getting_started.md - 安装、项目设置和 Unity 基础（4 页）
scripting.md - C# 脚本、MonoBehaviour、协程、程序集（8 页）
scene_management.md - 场景创建、GameObjects、Transforms、Prefabs（38 页）

2D/3D 开发

2d.md - 精灵、瓦片地图、2D 物理、2D 动画（85 页）
3d.md - 3D 网格、地形、ProBuilder、光照（30 页）

系统

physics.md - Rigidbody、Colliders、Joints、Character Controllers（114 页）
animation.md - 动画剪辑、Animator、Timeline、Blend Trees（11 页）
audio.md - AudioSource、AudioMixer、空间音频（32 页）

渲染与图形

rendering.md - 相机、光照、后处理、VFX（45 页）
shaders.md - ShaderLab、Shader Graph、URP、HDRP、材质（631 页）

UI 与界面

ui.md - UI Toolkit、UGUI、Canvas、TextMeshPro（16 页）

高级主题

xr.md - VR/AR 开发、XR Interaction Toolkit（238 页）
editor.md - 自定义编辑器、EditorWindows、MenuItem（8 页）
optimization.md - 性能分析、内存管理、最佳实践（34 页）

平台与服务

platform.md - iOS、Android、WebGL、构建设置（16 页）
assets.md - 资源工作流、AssetBundles、Addressables（27 页）
networking.md - 多人游戏、Netcode、网络系统（19 页）
services.md - Unity 服务、分析、云端构建（9 页）

附加资源

other.md - 杂项主题和高级功能（1,707 页）
index.md - 完整文档索引

文档总计： 3,367 页，来自官方 Unity 手册和脚本 API

需要详细信息时使用 view 工具读取特定参考文件。

使用此 Skill

初学者

从 references/getting_started.md 开始了解 Unity 安装和基础
复习上述 MonoBehaviour 生命周期模式
在 references/scene_management.md 中学习 GameObject 和 Transform 基础
探索 references/scripting.md 中的简单脚本示例

中级开发者

学习 references/physics.md 中的物理系统
使用 references/animation.md 实现动画系统
使用 references/ui.md 构建 UI
使用 references/optimization.md 优化性能

高级开发者

创建自定义着色器：references/shaders.md
构建自定义编辑器工具：references/editor.md
开发 VR/AR 体验：references/xr.md
针对特定平台优化：references/platform.md

特定任务

2D 游戏：查看 references/2d.md 了解 Sprites、Tilemaps、2D Physics
3D 游戏：查看 references/3d.md 和 references/rendering.md
移动游戏：查看 references/platform.md 了解 iOS/Android
多人游戏：探索 references/networking.md
VR/AR：学习 references/xr.md

核心概念

Unity 架构

GameObjects：持有组件的容器对象
Components：模块化行为（Transform、Rigidbody、脚本等）
Prefabs：可重用的 GameObject 模板
Scenes：游戏的关卡或部分
Assets：项目中使用的文件（纹理、模型、音频等）

脚本最佳实践

使用 Awake() 进行初始化，Start() 进行设置
物理代码放在 FixedUpdate() 中
使用协程处理基于时间的操作
避免在 Update 循环中使用 FindObjectOfType()（缓存引用）
为频繁实例化的对象使用对象池
实现正确的事件清理（在 OnDisable/OnDestroy 中取消订阅）
使用 ScriptableObjects 存储游戏数据
遵循命名规范（公共用 PascalCase，私有用 camelCase）

性能优化

为静态对象启用静态批处理
为移动对象使用动态批处理
为远距离对象实现细节级别（LOD）
使用遮挡剔除跳过隐藏对象的渲染
使用 Unity Profiler 分析以识别瓶颈
通过共享材质优化绘制调用
使用对象池而非 Instantiate/Destroy
最小化 GetComponent 调用（缓存组件）
避免空的 Update 方法

物理技巧

使用图层和图层碰撞矩阵优化碰撞检测
选择合适的碰撞检测模式（Discrete vs Continuous）
使用 FixedUpdate 进行物理操作
对于简单检测，射线检测比碰撞器更便宜
尽可能使用 Physics.OverlapSphere 而非触发碰撞器
避免在使用物理时通过 Transform 移动对象（使用 Rigidbody）

渲染管线对比

Built-in：传统、功能全面、兼容性好
URP（通用）：现代、优化、移动友好、灵活
HDRP（高清）：高端图形、仅限 PC/Console

资源

官方文档

Unity 手册：https://docs.unity3d.com/Manual/
脚本 API：https://docs.unity3d.com/ScriptReference/

学习资源

Unity Learn：官方教程和课程
Unity 博客：最新功能和最佳实践
Unity 论坛：社区帮助和讨论

常用包

Input System (com.unity.inputsystem)：现代输入处理
Cinemachine (com.unity.cinemachine)：高级相机系统
ProBuilder (com.unity.probuilder)：编辑器内 3D 建模
TextMeshPro：高级文本渲染
XR Interaction Toolkit：VR/AR 交互
Netcode for GameObjects：多人游戏网络
Universal RP / HDRP：渲染管线
Timeline：电影级序列
Addressables：高级资源管理

常用命名空间

using UnityEngine; // Unity 核心类 using UnityEngine.UI; // UGUI 组件 using UnityEngine.UIElements; // UI Toolkit using UnityEngine.SceneManagement; // 场景加载 using System.Collections; // 协程的 IEnumerator using System.Collections.Generic; // Lists、Dictionaries

scripts/

在此处添加用于常见自动化任务和实用程序的辅助脚本。

assets/

在此处添加模板、样板代码或示例 Unity 项目文件。

说明

此 Skill 涵盖 Unity 2023.2+（兼容 Unity 6.x）
所有代码示例遵循 Unity C# 编码标准
参考文件链接到官方 Unity 文档
包含脚本参考 API 以获取详细的类信息
URP（通用渲染管线）是新项目的推荐管线
始终在开发早期在目标平台上测试

更新

要使用最新的 Unity 文档刷新此 Skill ：

使用最新版本 URL 更新 Unity 配置
重新运行爬虫：skill-seekers scrape --config configs/unity.json
该 Skill 将使用最新的 Unity 文档重新构建

此 Skill 来自官方 Unity 文档（手册 + 脚本 API），涵盖 3,367 页全面的 Unity Engine 信息。

Safety Notice

Copy this and send it to your AI assistant to learn

Source Transparency

Related Skills

media-pipe-unity

prime-tween-unity

skill-creator

unity