Build a session with Netcode for GameObjects

Build a multiplayer game with sessions using Netcode for GameObjects for projects with GameObject and MonoBehaviour workflows.

読み終わるまでの所要時間 4 分

最終更新 1日前

注

The Multiplayer Services SDK uses sessions to manage groups of players. Sessions relies internally on different combinations of Unity Gaming Services such as Relay, Distributed Authority, Lobby, Matchmaker and Cloud Code, and thus contributes to the billing of those services.

To start a multiplayer game, the host must create a session that other players join to participate in the game. A session represents a group of players that are connected together for a set period of time during a multiplayer game. To learn the principles of Multiplayer Services sessions, explore a simple multiplayer game of moving capsules. In this tutorial, you create one capsule controlled by the session's host and another capsule controlled by a joining player, as well as the necessary game objects and code to add session management to your game.

Prerequisites

In addition to the Multiplayer Services package, ensure that you install the following packages through the Unity Registry in the Editor's Package Manager:

Multiplay Sessions Building Block: Integrates pre-made UI elements as a starting point for your multiplayer projects.
```
Multiplayer Play Mode
```
(or
```
com.unity.multiplayer.playmode
```
): Enables you to test multiplayer functionality without leaving the Unity Editor.
```
Netcode for GameObjects
```
(or
```
com.unity.netcode.gameobjects
```
): Provides networking capabilities to GameObject and MonoBehaviour workflows.

Configure Multiplayer Play Mode

To configure Play Mode for your project to test multiple players:

In the Unity Editor, go to Window > Multiplayer > Multiplayer Play Mode.
In the Multiplayer Play Mode window, enable Player 2.

After adding Player 2, you can test the project with a second window.

Set up Netcode for GameObjects

注

If you are using Netcode for Entities, refer to its instructions instead.

To set up Netcode for GameObjects, attach a Network Manager component to a GameObject:

In the Unity Editor, select GameObject > Create Empty to create a new GameObject in your scene.
Rename it
```
NetworkManager
```
.
Select this NetworkManager you just created.
Select Component > Netcode > Network Manager to attach a Network Manager component.
In the Inspector window, go to Network Transport and select UnityTransport.

Netcode for GameObjects is now set up in your project.

Create the player Prefab

To create a Prefab from a network-enabled capsule:

In the Unity Editor, go to Edit > Project Settings > Player > Other Settings > Configuration > Active Input Handling, then select Both. Changing the input handling might trigger a restart of your Unity Editor.
Close Project Settings.
Right-click (macOS: Ctrl+click) within the Hierarchy window, then select 3D Object > Capsule.
Rename the capsule to
```
Player Prefab
```
.
With this capsule selected, in the Inspector window, select Add Component > Netcode > Network Object.
In the Project tab, right-click (macOS: Ctrl+click) the Scripts folder, then Create > Scripting > Empty C# Script.
Rename this script
```
PlayerController.cs
```
.

Replace the contents of this script with the following code:


using UnityEngine;using Unity.Netcode;public class PlayerController : NetworkBehaviour{    public float speed = 20;    private NetworkTransform _transform;    private void Start()    {        _transform = GetComponent<NetworkTransform>();    }    private void Update()    {        if (!IsOwner) return;        var movement = new Vector3(Input.GetAxis("Horizontal"), Input.GetAxis("Vertical"));        _transform.transform.position += movement * speed * Time.deltaTime;    }}

With the capsule player selected in the Hierarchy window, attach the
```
PlayerController
```
script to its Inspector window. If you receive a prompt that Network Behaviors require a NetworkObject, select Yes to add one.
Still in the Inspector window, select Add Component.
Search for
```
Network Transform
```
, then add it.
Set Network Transform Authority to Client. This improves the reactiveness of player movement for the owning client. Refer to
```
NetworkTransform
```
Authority.
In the Project window, right-click (macOS: Ctrl+click) Assets, then Create > Folder.
Rename this folder
```
Prefabs
```
. Refer to Prefabs.
Make the
```
Player Prefab
```
object you created earlier into a Prefab by dragging it from the Hierarchy window into the
```
Prefabs
```
folder.
Right-click (macOS: Ctrl+click) the capsule within the Scene window and then select Delete to delete the player from the scene.
ヒント
You can remove the player GameObject from the scene because you assigned this network Prefab to the player Prefab property in the
NetworkManager
component. The library doesn't support defining a player object as an in-scene placed NetworkObject.
In the Hierarchy window, select
```
NetworkManager
```
.
In its Inspector window, locate the Default Player Prefab field.
Drag the capsule player from the Project window into the Default Player Prefab field you located.
In the Unity Editor, select File > Save.

At this point, a network-enabled capsule is the default player prefab for the GameObject called

NetworkManager

Add your scene to the build

In Inspector window for

NetworkManager

, locate the Enable Scene Management setting (enabled by default). When you enable it, the server can control which scenes load for the clients. However, you must add the current scene to the build to enter Play Mode. To add the current scene to the build:

In the Unity Editor, select File > Build Profiles.
Select Open Scene List.
Select Add Open Scenes.
Close Build Profiles.

The current scene is now included in the build.

Create and join your session

The following steps outline how to create and join your first session with the Multiplayer Sessions Building Block and Multiplayer Services in the Unity Editor.

注

Make sure Multiplayer Play Mode is enabled.

Follow the Multiplayer Sessions Building Block instructions to integrate its samples into your project.
In the Unity Editor's Project window, go to
```
Assets
```
>
```
Scenes
```
.
Open the JoinByCode scene.
In the Toolbar, select Play to enter Play Mode.
In the Game window's Session Name field, enter a name, then select Create.
Copy the session join code.
In the Player 2 window's Session Code field, enter the code and then select Join.

After Player 2 joins the session, two superimposed capsules appear in the scene.

Move the capsules

To move the capsules in your multiplayer session:

Click within the Game window of the Editor.
Use the arrow keys on your keyboard to move the capsule around the scene. It moves in real time in both the Game window and the Player 2 window.
Click within the Player 2 window.
Use the arrow keys on your keyboard to move the capsule around the scene. Notice that the other capsule (Player 2's capsule) moves this time.

When you enter Play Mode and join the session, you now have a scene of two capsules that can be controlled only by the owning player.

ドキュメント

Development

User Acquisition

Monetization

産業