Auto-sync: 2026-04-26 12:02

wiki/entities/NetcodeForGameObjects.md

@@ -0,0 +1,43 @@
+---
+title: "Netcode for GameObjects"
+type: entity
+tags: [unity, networking, framework]
+sources: [unity-multiplayer-engineer]
+last_updated: 2026-04-26
+---
+
+## Aliases
+- NGO
+- Netcode for GameObjects (NGO)
+
+## Type
+Unity 官方多人游戏网络框架
+
+## Definition
+Netcode for GameObjects（NGO）是 Unity 官方提供的多人游戏网络编程框架，提供 `NetworkObject`、`NetworkVariable<T>`、`ServerRpc`、`ClientRpc` 等核心网络原语，简化服务器权威多人游戏开发。
+
+## Core Components
+
+| 组件 | 类型 | 用途 |
+|------|------|------|
+| `NetworkObject` | 组件 | 挂载到 GameObject 使其可联网 |
+| `NetworkVariable<T>` | 类型 | 持久化状态同步 |
+| `ServerRpc` | 特性 | 客户端调用 → 服务器执行 |
+| `ClientRpc` | 特性 | 服务器调用 → 所有客户端执行 |
+| `NetworkManager` | 组件 | 网络管理器 |
+| `UnityTransport` | 组件 | 底层传输层（支持直连/Relay） |
+
+## Key Design Decisions
+- **服务器权威**：所有 NetworkVariable write 权限默认为 Server
+- **自动同步**：NetworkVariable 变化自动同步，无需手动调用
+- **Prefabs 注册**：所有联网 Prefab 必须注册到 NetworkPrefabs 列表
+
+## Related Concepts
+- [[ServerAuthority]]: NGO 强制服务器权威
+- [[NetworkVariable]]: 核心数据类型
+- [[UnityRelay]]: 通过 UnityTransport 集成 Relay
+- [[UnityMultiplayerEngineer]]: 使用 NGO 构建游戏的专家
+
+## Related Entities
+- [[UnityGamingServices]]: NGO 与 UGS 深度集成
+- [[UnityTransport]]: NGO 的传输层实现