skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
besty0728/unity-skills81 installs

unity-netcode-design

Source-anchored design rules for Netcode for GameObjects 2.x

How do I install this agent skill?

npx skills add https://github.com/besty0728/unity-skills --skill unity-netcode-design
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill is a comprehensive technical reference for Unity Netcode for GameObjects 2.x. It provides architectural rules and lifecycle documentation without any executable scripts or external dependencies. No security issues were detected.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

Netcode for GameObjects - Design Rules

Version scope: com.unity.netcode.gameobjects 2.x. Every rule is distilled from its source, with a file and line cited so the reasoning is auditable.

Advisory module. Every rule is distilled from com.unity.netcode.gameobjects 2.x source. Each rule cites a concrete file/line so the reasoning is auditable.

When to use

Load before writing or reviewing any of:

  • NetworkBehaviour scripts (OnNetworkSpawn / OnNetworkDespawn / RPCs / NetworkVariables)
  • NetworkManager startup / shutdown / scene switching
  • NetworkObject Spawn / Despawn / ChangeOwnership / TrySetParent
  • UnityTransport configuration (direct connect / Relay)
  • Any code that branches on IsHost / IsServer / IsClient / IsOwner

Critical Rule Summary (memorize even if you skip the sub-docs)

#RuleSource anchor
1Spawn() / Despawn() must be called on Server/Host only; client-side calls fail.Runtime/Core/NetworkObject.cs:1884, 1921
2OnNetworkSpawn() runs before Unity Start() and after Awake/OnEnable.Runtime/Core/NetworkBehaviour.cs:704 + InvokeBehaviourNetworkSpawn callers
3Legacy [ServerRpc] method names must end with ServerRpc; [ClientRpc] must end with ClientRpc (ILPP enforced at compile time).Editor/CodeGen/ ILPP validators
4New [Rpc(SendTo.X)] has no naming constraint; SendTo has 11 values.Runtime/Messaging/RpcTargets/RpcTarget.cs:9-80
5PlayerPrefab needs a NetworkObject; NetworkManager registers it into the prefab list itself at start, so a list entry is only needed for overrides.Runtime/Configuration/NetworkConfig.cs:40 + Runtime/Spawning/NetworkPrefabHandler.cs:452
6Nested NetworkObjects are forbidden (NetworkObject inside another NetworkObject prefab). Re-parent at runtime via TrySetParent.Runtime/Core/NetworkObject.cs:2135-2215
7NetworkVariable<T> requires T to be unmanaged or implement INetworkSerializable. string, List<>, class are rejected.Runtime/NetworkVariable/NetworkVariable.cs:12 + ILPP
8NetworkList<T> requires T: unmanaged, IEquatable<T>. It is NOT NetworkVariable<List<T>>.Runtime/NetworkVariable/Collections/NetworkList.cs:14
9NetworkSceneManager.LoadScene/UnloadScene is Server-only.Runtime/SceneManagement/NetworkSceneManager.cs:1496, 1252
10UnityTransport.SetRelayServerData and SetConnectionData are mutually exclusive; use one or the other.Runtime/Transports/UTP/UnityTransport.cs:776-897

Sub-doc Routing

Sub-docWhen to read
LIFECYCLE.mdLifecycle, callback ordering, Awake/OnNetworkSpawn/Start differences
OWNERSHIP.mdIsOwner/IsServer/IsHost permission matrix, ChangeOwnership, Distributed Authority
RPC.mdChoosing RPC attributes, SendTo semantics, RpcInvokePermission, deprecated paths
VARIABLES.mdNetworkVariable/NetworkList init and serialization constraints
SPAWNING.mdPrefab registration → Spawn → Despawn, GlobalObjectIdHash, SpawnAsPlayerObject
SCENE.mdNetworkSceneManager, EnableSceneManagement, in-scene object sync
TRANSPORT.mdUnityTransport direct / Relay configuration; the removed DebugSimulator
PITFALLS.md30 concrete hallucination pitfalls

Routing to Other Modules

  • Generating NetworkBehaviour scripts → use the functional netcode module's netcode_add_network_behaviour_script
  • Bulk attaching NetworkObject/NetworkTransform in the scene → netcode module Components skills
  • Architecture-level decisions (Server-authoritative vs Distributed Authority) → also load architecture

Version Scope

This document targets com.unity.netcode.gameobjects 2.x (validated against 2.13.3, Unity 6000.0+). Some APIs (SendTo.Authority, RpcInvokePermission, the universal [Rpc] attribute) do not exist in 1.x.

NGO 3.x needs Unity 6000.7 (beta) and the netcode module has not been adapted to it yet; the 2.x line is still maintained, and a project on 3.x can pin 2.13.3. Most file:line anchors were taken from earlier 2.x releases, so expect them to be off by a few lines in 2.13.3; the file and symbol names still hold.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/besty0728/unity-skills/unity-netcode-design">View unity-netcode-design on skillZs</a>