【Unity】ネットワーク未経験でも作れるマルチプレイヤー入門（Netcode for GameObjects）

2024年5月13日2026年6月11日

Unity Netcode for GameObjects を使うと、Host や Client の起動、プレイヤーオブジェクトの生成、位置の同期など、マルチプレイヤーゲームに必要な基本機能を比較的少ないコードで実装できます。

初めてネットワーク機能を触ると、Host、Client、Owner などの言葉が出てきて少し分かりにくく感じるかもしれません。

この記事では、できるだけ小さな2Dサンプルを作りながら、Unity Netcode for GameObjects の基本を確認していきます。H キーで Host、C キーで Client を起動し、自分のプレイヤーだけを動かせるところまで作ります。

まずは、Host、Client、Owner の関係を簡単に整理しておきます。
Host は Server と Client を兼ねた起動方法です。Client は Host に接続し、それぞれ自分が所有する Player だけを操作します。

【Unity】UNETとNetCodeについて

UNETとNetCodeは、Unityでネットワーク機能を実装するための異なるアプローチを提供するライブラリです ...

 https://soft-rime.com/post-16731/

NetCodeで２Dネットワークアプリのシンプルなサンプルを作る

NetCodeはUnityで利用できるネットワークライブラリの一つで、マルチプレイヤーゲームの開発を容易にするために設計されています。ここでは、Unityで2Dマルチプレイヤーゲームのサンプルプロジェクトを作成する手順を説明します。

新しいプロジェクトを作成する

Unity Hubから２Dのプロジェクト（MultiPlayerSample）を作成します

パッケージマネージャーで Netcode for GameObjects をインストールする

1. エディタのメニューから、Window ＞ Package Management ＞ Package Manager を選択します。

2. Package Manager ウィンドウの左サイドバーにある Sources ＞ Unity Registry を選択します。
3. 中央上部の検索窓（虫眼鏡マーク）に「net」または「Netcode for GameObjects」と入力します。
4. 検索結果に表示された Netcode for GameObjects を選択し、右側にある Install ボタンをクリックします。

インストールが完了すると…

インストールが正常に完了すると、画面が次のように変化します。

• パッケージ名の右側に 緑色のチェックマーク（導入済みの印） が表示されます。
• 先ほどまで「Install」だったボタンが、Locate や Manage という表示に切り替わります。

インストールが完了すると、自動的にプロジェクトへ組み込まれます。左上の「All Packages」に切り替えて確認することもできますが、チェックマークがついたのを確認できたら、そのまま Package Manager ウィンドウを閉じてしまって大丈夫です！

基本的なコンポーネントを作成する

マルチプレイヤーゲームの基本的な構成要素を作成します。

ネットワークマネージャーの作成とトランスポートの選択

ネットワークマネージャーを追加し、プロジェクトにUnityトランスポートを追加します。NetworkManagerは、プロジェクトのネットコード関連の設定をすべて設定するコンポーネントです。Unity Transportは、Netcodeがサーバーとクライアント間の通信に使用するトランスポート層です。詳細については、こちらをご覧ください。

• [Hierarchy]ウィンドウを右クリックします。
• [Create Empty] を選択し、空のゲームオブジェクトを作成します
• 名前をNetworkManagerに変更します
• [Inspector] で[ Add Component]（コンポーネントの追加） をクリックし、NetworkManagerコンポーネントを選択します。

検索窓で、一部入力がわかりやすいです

[NetworkManagerゲームオブジェクト]の[NetworkManagerコンポーネント]で、NetworkTransportフィールドを見つけます。

「Select transport…」（トランスポートを選択）をクリックします。

UnityTransportを選択します。

シーンを保存します。

接続されたプレーヤーごとにオブジェクトを生成する

ここではプレイヤーオブジェクトを追加し、接続しているプレイヤーごとに生成（スポーン）させます。

[Hierarchyウィンドウ]で右クリックし、2D Object > Sprite > Circleを作成します。

名前をPlayerに変更します。

Playerを選択した状態で、Inspector でNetcode > NetworkObjectコンポーネントを追加します。

ネットワーク転送用のコードを作成し、アタッチします

Playerを選択した状態でClientNetworkTransformスクリプトをPlayerにアタッチします

using Unity.Netcode.Components;

public class ClientNetworkTransform : NetworkTransform
{
    protected override bool OnIsServerAuthoritative()
    {
        return false;
    }
}

Player移動スクリプトの作成

次のスクリプトをPlayerにアタッチします

using Unity.Netcode;
using UnityEngine;
// 新しいInput Systemを使用するために必要です
using UnityEngine.InputSystem; 

public class PlayerController : NetworkBehaviour
{
    [SerializeField] float moveSpeed = 4f;
    void Update()
    {
        // 自分が操作するオブジェクトでなければ処理をスキップ
        if (!IsOwner) return;

        Move();
    }

    void Move()
    {
        Vector2 inputVector = Vector2.zero;

        // キーボードの入力を取得
        if (Keyboard.current != null)
        {
            // 矢印キーまたはWASDキーの入力をベクトルとして取得
            float moveHorizontal = 0f;
            float moveVertical = 0f;

            if (Keyboard.current.leftArrowKey.isPressed || Keyboard.current.aKey.isPressed) moveHorizontal = -1f;
            if (Keyboard.current.rightArrowKey.isPressed || Keyboard.current.dKey.isPressed) moveHorizontal = 1f;
            if (Keyboard.current.upArrowKey.isPressed || Keyboard.current.wKey.isPressed) moveVertical = 1f;
            if (Keyboard.current.downArrowKey.isPressed || Keyboard.current.sKey.isPressed) moveVertical = -1f;

            inputVector = new Vector2(moveHorizontal, moveVertical).normalized;
        }

        // transform.position で移動
        transform.position += new Vector3(inputVector.x, inputVector.y, 0f) * moveSpeed * Time.deltaTime;
    }
}

• [Projectウィンドウ]の[Assetsフォルダ]を選択します
• [Assetsフォルダ]内を右クリックし、Create > FolderでPrefabsでフォルダを作成します
• 先ほど作成した[Prefabsフォルダ]にドラッグして、PlayerからPrefabを作成します。
• 名前をPlayerPrefabに変更します
• Playerをシーンから削除します。

• [Hierarchyウィンドウ]の[NetworkManagerゲームオブジェクト] を選択します。
• [NetworkManager コンポーネント]で、Player Prefab フィールドを探します。
• 作成したPlayerPrefabをこのフィールドにドラッグします。

補足: 生成されるプレイヤーオブジェクトについて

ここで設定した PlayerPrefab は、接続したプレイヤーごとに自動で生成されます。
ただし、プレイヤーごとに別々の Prefab が選ばれるわけではありません。Host も Client も、同じ PlayerPrefab からそれぞれのプレイヤーオブジェクトが作られます。
同じ Prefab から作られていても、生成されたオブジェクトには「誰が所有しているか」という情報があります。その情報を表すのが OwnerClientId です。
簡単な例として、Host のプレイヤーを青、Client のプレイヤーを赤にしてみます。

using Unity.Netcode;
using UnityEngine;
// 新しいInput Systemを使用するために必要です
using UnityEngine.InputSystem;

public class PlayerController : NetworkBehaviour
{
    [SerializeField]
    float moveSpeed = 4;

    SpriteRenderer spriteRenderer;

    public override void OnNetworkSpawn()
    {
        spriteRenderer = GetComponent<SpriteRenderer>();

        if (OwnerClientId == NetworkManager.ServerClientId)
        {
            spriteRenderer.color = Color.blue;
        }
        else
        {
            spriteRenderer.color = Color.red;
        }
    }

    void Update()
    {
        if (!IsOwner) return;

        Move();
    }

    void Move()
    {
        // キーボードの入力を取得（新しいInput System）
        if (Keyboard.current == null) return;

        float moveHorizontal = 0f;
        float moveVertical = 0f;

        if (Keyboard.current.leftArrowKey.isPressed || Keyboard.current.aKey.isPressed) moveHorizontal = -1f;
        if (Keyboard.current.rightArrowKey.isPressed || Keyboard.current.dKey.isPressed) moveHorizontal = 1f;
        if (Keyboard.current.upArrowKey.isPressed || Keyboard.current.wKey.isPressed) moveVertical = 1f;
        if (Keyboard.current.downArrowKey.isPressed || Keyboard.current.sKey.isPressed) moveVertical = -1f;

        Vector2 movement = new Vector2(moveHorizontal, moveVertical).normalized;
        transform.position += new Vector3(movement.x, movement.y, 0f) * moveSpeed * Time.deltaTime;
    }
}

NetworkManager.ServerClientId はサーバー側の ClientId で、値は 0 です。Host はサーバーとクライアントを兼ねているため、Host のプレイヤーオブジェクトは基本的に OwnerClientId == 0 になります。
一方、Client として接続したプレイヤーには、別の OwnerClientId が割り当てられます。

Host の PlayerObject   OwnerClientId = 0
Client の PlayerObject OwnerClientId = 1 以降

このように、Prefab 自体は同じでも、OwnerClientId を使うことでプレイヤーごとに見た目や処理を変えることができます。

より本格的には: playerNumber を別に管理する

OwnerClientId は Netcode が接続ごとに割り当てる ID です。簡単な色分けや、「Host か Client か」を見分ける程度であれば OwnerClientId で十分です。
ただし、ゲーム内で使う「1P」「2P」のような番号として、そのまま使うとは限りません。
たとえば、画面に 1P、2P と表示したい場合や、チーム分け、席順、キャラクター選択と紐づけたい場合は、ゲーム側で playerNumber を別に管理すると扱いやすくなります。
考え方は次のように分けると分かりやすいです。

OwnerClientId = Netcode が接続ごとに割り当てる ID
playerNumber  = ゲーム側で決めるプレイヤー番号

入門段階ではまず OwnerClientId を使って確認し、ゲームとしてルールを増やしていく段階で playerNumber を用意するとよいでしょう。
一点だけ注意です。以前出した PlayerNumberManager のような別クラス方式は、記事のこの段階では少し重いです。ここでは「考え方だけ紹介」くらいに留める方が、初心者向け記事の流れを壊しにくいです。
確認根拠として、Netcode の実装では ServerClientId は 0、NetworkVariable の初期書き込み権限は Server になっています: NetworkManager.cs (line 585)、NetworkVariableBase.cs (line 225)。

ホストの役割とクライアントの役割を選択できるようにします

次のスクリプトを作成し、[NetworkManagerゲームオブジェクト]にアタッチします

using Unity.Netcode;
using UnityEngine;
using UnityEngine.InputSystem;

public class Selector : MonoBehaviour
{
    private string mode = "";

    private void Update()
    {
        var nm = NetworkManager.Singleton;
        if (nm == null) return;
        if (nm.IsClient || nm.IsServer) return;

        var kb = Keyboard.current;
        if (kb == null) return;

        if (kb.hKey.wasPressedThisFrame)
        {
            nm.StartHost();
            mode = "ホスト";
        }
        else if (kb.cKey.wasPressedThisFrame)
        {
            nm.StartClient();
            mode = "クライアント";
        }
    }

    private void OnGUI()
    {
        GUI.skin.label.fontSize = 22;
        GUI.skin.label.normal.textColor = Color.white;

        if (mode == "")
        {
            GUI.Label(new Rect(10, 10, 600, 80),
                "H キー : ホストとして開始\nC キー : クライアントとして開始");
        }
        else
        {
            GUI.Label(new Rect(10, 10, 600, 40), "モード : " + mode);
        }
    }
}

シーンを保存します。

ビルドにシーンを追加する

• エディター左上のFile > Build Profilesをクリックします。（Unity 6 では Build Settings から名称が変わっています）
• シーン一覧の右にある＋ボタンをクリックして、現在のシーンを追加します。

Windowモードでゲームを起動できるようにする（全画面ではないモード）

テストしやすいように、全画面表示ではなく、ウィンドウで実行・ウィンドウの移動ができるようにします

• エディター左上のEdit > Project Settings…をクリックします。
• [Playerタブ]を選択します。
• [Resolution and Presentation]を展開します。
• Resolution > Fullscreen Modeから、Fullscreen WindowをWindowedに変更します。
• Resolution > Run In Backgroundにチェックを入れます。
  1台のPCでHostとClientを同時にテストすると、どちらか一方のウィンドウは必ず非アクティブになります。このチェックがオフ（デフォルト）のままだと、非アクティブになった側はネットワーク処理を含めてゲームが停止してしまい、「同期が壊れている」ように見えたり、停止が長く続くとタイムアウトで切断されたりすることがあります。
• Unityエディターのメインウィンドウに戻り、シーンを保存します。

テストで実行してみる

• エディターを実行して、Hキーを押下して、Circleのゲームオブジェクトが作成されるのを確認します
• 上下左右キーで移動できることを確認します

ビルドして、ホスト側、クライアント側としてテストしてみる

今回のサンプルでは、ホスト側を、ビルドして実行している方、クライアント側をUnityエディターで実行している方として構成します

• エディター左上のFile > Build And Runをクリックします。
• [Projectフォルダー]内に[Builds]という新しいフォルダーを作成します。
• 実行ファイル作成。NewworkSampleとして保存します。
• プロジェクトがビルドされ、新しいウィンドウで起動します。
• Unityエディター側も実行します
• 新しいウィンドウの方で、「H」キーを押下します
• Unityエディターの方で、「C」キーを押下します
• それぞれのウィンドウをクリックしてフォーカスを変更し、上下左右キーで移動できることを確認します

H キー・C キーを押してから両方の画面にプレイヤーが表示されるまでの流れをシーケンス図にすると、次のようになります。

実行中の様子

画面上半分が、ビルドして実行しているウィンドウ、下半分がUnityエディターで実行中のウィンドウになります

参考

NetCodeのホスト、サーバー、クライアント

UnityのNetCodeでは、ネットワーク接続の設定において「ホスト」、「サーバー」、「クライアント」という異なる役割があります。それぞれの役割について詳しく説明します。

ホスト

ホストは、サーバーとクライアントの機能を兼ね備えています。つまり、ホストは自身のゲーム状態を管理しつつ、他のクライアントとのデータの同期も行います。ホストモデルは、特に小規模なマルチプレイヤーゲームや、プレイヤーがサーバーとしても機能する必要がある場合に適しています。

サーバー

サーバーはゲームの状態を中央で管理し、ゲームのロジックを処理します。クライアントからの入力を受け取り、それに基づいてゲームの状態を更新し、その結果をすべてのクライアントに送信します。サーバーは通常、クライアントからは独立しており、ゲームの公正性を保つために中立的な役割を果たします。

クライアント

クライアントはゲームのユーザーインターフェースを担当し、プレイヤーの入力をサーバーに送信します。サーバーからのデータを受け取り、それに基づいて画面上の表示を更新します。クライアントはサーバーの決定に従い、自身のゲームの状態を更新します。

違いと役割

• ホスト: サーバーとしての役割も担いながら、自らもクライアントとしてゲームに参加します。これにより、ホストがゲーム状態を直接管理し、他のプレイヤーと対話することができます。
• サーバー: ゲームの全体的な論理と状態を管理し、クライアント間のデータの同期を担当します。サーバーはプレイヤーの一方的な入力に基づく処理を行い、その結果をクライアントに配布します。
• クライアント: サーバーから送られてくるデータをもとに、プレイヤーの画面にゲーム状態を反映します。クライアントは基本的に受動的な役割を担い、サーバーからの指示に従います。

NetCodeは、これらの役割を効率的に管理し、大規模なマルチプレイヤーゲームでも高いパフォーマンスを提供するよう設計されています。それぞれの役割が明確に分離されていることで、ゲームのスケーラビリティと管理が容易になります。

public override void OnNetworkSpawn()
{
    var spriteRenderer = GetComponent<SpriteRenderer>();

    if (OwnerClientId == 0)
    {
        spriteRenderer.color = Color.blue;
    }
    else
    {
        spriteRenderer.color = Color.red;
    }
}

using Unity.Netcode;
using UnityEngine;

public class PlayerController : NetworkBehaviour
{
    public NetworkVariable<int> PlayerNumber = new NetworkVariable<int>();

    public override void OnNetworkSpawn()
    {
        PlayerNumber.OnValueChanged += OnPlayerNumberChanged;

        ApplyPlayerNumber(PlayerNumber.Value);
    }

    public override void OnNetworkDespawn()
    {
        PlayerNumber.OnValueChanged -= OnPlayerNumberChanged;
    }

    void OnPlayerNumberChanged(int previousValue, int newValue)
    {
        ApplyPlayerNumber(newValue);
    }

    void ApplyPlayerNumber(int playerNumber)
    {
        Debug.Log($"PlayerNumber: {playerNumber}");
    }
}

using System.Collections.Generic;
using Unity.Netcode;
using UnityEngine;

public class PlayerNumberManager : MonoBehaviour
{
    int nextPlayerNumber = 1;
    Dictionary<ulong, int> playerNumbers = new Dictionary<ulong, int>();

    void Start()
    {
        NetworkManager.Singleton.OnClientConnectedCallback += OnClientConnected;
    }

    void OnDestroy()
    {
        if (NetworkManager.Singleton == null) return;

        NetworkManager.Singleton.OnClientConnectedCallback -= OnClientConnected;
    }

    void OnClientConnected(ulong clientId)
    {
        if (!NetworkManager.Singleton.IsServer) return;

        int playerNumber = nextPlayerNumber;
        nextPlayerNumber++;

        playerNumbers[clientId] = playerNumber;

        NetworkObject playerObject = NetworkManager.Singleton.ConnectedClients[clientId].PlayerObject;

        PlayerController playerController = playerObject.GetComponent<PlayerController>();
        playerController.PlayerNumber.Value = playerNumber;
    }
}

Host:   playerNumber = 1
Client: playerNumber = 2

NetworkVariable<T> は他の変数でも使える

NetworkVariable<T> はジェネリック型なので、playerNumber に限らず、サーバーが決めてクライアントに配る値であれば何にでも応用できます。

// T の部分を変えるだけで使える
public NetworkVariable<float> Health      = new NetworkVariable<float>(100f);
public NetworkVariable<bool>  IsReady     = new NetworkVariable<bool>(false);
public NetworkVariable<Color> PlayerColor = new NetworkVariable<Color>();

値が変わったときの処理は OnValueChanged に登録します。記事内の playerNumber と同じパターンです。

public override void OnNetworkSpawn()
{
    Health.OnValueChanged += (prev, next) =>
    {
        healthBar.value = next;  // UI を更新するなど
    };
}

使える型・使えない型をまとめると次のようになります。

このパターンの本質は「サーバーが値を書き込む → 全クライアントに自動で同期 → OnValueChanged で変化を検知」の 3 ステップです。HP・スコア・準備完了フラグ・チームIDなど、サーバーが決めてクライアントに伝える値であれば何にでも使えます。

リンク

Your Netcode "Hello World" Project | Unity Multiplayer

Tutorial that explains creating a project, installing the Netcode for GameObjects package, and c ...

 https://docs-multiplayer.unity3d.com/netcode/current/tutoria...

Install Netcode for GameObjects | Unity Multiplayer

How to install Unity Netcode for GameObjects.

 https://docs-multiplayer.unity3d.com/netcode/current/install...