uw-network-setup

Network Setup

Generate networking code adapted to the project's chosen package.

Before You Start

1. Read docs/ProjectConfig.yaml for:
   • networking — the package name ("ngo", "mirror", "photon", or "none"). If "none", stop — do not generate networking code.
   • architecture_pattern — "so-first" or "di-first" (affects how network services are wired).
   • mcp.unity_mcp — if true, call refresh_unity after creating files.
2. Read docs/TDD_Template.md for the authority matrix (who owns what data).
3. Read docs/CODING_STANDARDS.md for async patterns (Awaitable + CancellationToken) and class structure.
4. Read docs/NAMING_CONVENTIONS.md for file/class naming.

Package Quick Reference

Each package has a detailed reference file. Read the relevant one before generating code:

• NGO (Netcode for GameObjects): references/ngo.md — Unity's first-party solution. Uses NetworkVariable, [Rpc] attributes.
• Mirror: references/mirror.md — Community open-source. Uses [SyncVar], [Command]/[ClientRpc].
• Photon (PUN2/Fusion): references/photon.md — Cloud-hosted. Uses IPunObservable, [PunRPC].

Core Patterns (All Packages)

State Synchronization

Every package has a mechanism for syncing state from server/host to clients. The pattern is the same — only the syntax differs.

Package	Sync Mechanism	Change Callback	Example
NGO	NetworkVariable<T>	.OnValueChanged += handler	_health.OnValueChanged += OnHealthChanged;
Mirror	[SyncVar(hook = nameof(...))]	Hook method	[SyncVar(hook = nameof(OnHealthChanged))]
Photon	IPunObservable	OnPhotonSerializeView	Manual read/write in serialize callback

Remote Procedure Calls (RPCs)

RPCs let clients request actions on the server, or the server push updates to clients.

NGO:

[Rpc(SendTo.Server)]
public void RequestDamageServerRpc(int amount)
{
    // Runs on server — validate before applying
    if (amount < 0 || amount > MAX_DAMAGE) return;
    _health.Value = Mathf.Max(0, _health.Value - amount);
}

[Rpc(SendTo.ClientsAndHost)]
public void PlayHitEffectClientRpc()
{
    // Runs on all clients — visual/audio only, no game state
}