You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/learn/distributed-authority-quick-start.md
+6
Original file line number
Diff line number
Diff line change
@@ -150,6 +150,12 @@ public class ConnectionManager : MonoBehaviour
150
150
}
151
151
```
152
152
153
+
:::note
154
+
155
+
It's important to wait until `OnClientConnectedCallback` has been triggered before spawning objects. Spawning objects early will result in errors and unexpected behaviour.
156
+
157
+
:::
158
+
153
159
2. Add the `ConnectionManager` component script you created to the *NetworkManager* object.
Copy file name to clipboardExpand all lines: tools/porting-to-dgs/client-vs-dgs.md
+4-4
Original file line number
Diff line number
Diff line change
@@ -41,11 +41,11 @@ The following table lists some pros and cons of using a client-hosted hosting ap
41
41
| Client-hosted games are simpler to debug and profile compared to dedicated server-hosted games (your development PC can also run the host, a DGS might run on specialized hardware). | Players can more easily cheat because they have physical access to the server. |
42
42
| The above makes it great for LAN (local area network) parties. | Client-hosted games don’t scale well. Player hardware usually isn’t capable of hosting game sessions with hundreds of connections. |
43
43
44
-
✝ However, some games might generate more traffic (compared to compute resources), which might make a client-hosted game more expensive than using a service like Game Server Hosting (Multiplay) if relying too much on Relay.
44
+
✝ However, some games might generate more traffic (compared to compute resources), which might make a client-hosted game more expensive than using a service like Unity Multiplay Hosting if relying too much on Relay.
45
45
46
46
## Dedicated server-hosted games
47
47
48
-
A dedicated server-hosted game is a game that runs server builds on hardware that’s dedicated to hosting the game. The dedicated server might be in an [on-premise data center](./hosting-considerations.md#developer-hosted-cloud), in the [cloud](./hosting-considerations#developer-hosted-cloud), or made available through a [managed service provider](#managed-service-provider), such as Unity’s [Game Server Hosting](https://docs.unity.com/game-server-hosting). In any case, players don’t usually have access to the server build.
48
+
A dedicated server-hosted game is a game that runs server builds on hardware that’s dedicated to hosting the game. The dedicated server might be in an [on-premise data center](./hosting-considerations.md#developer-hosted-cloud), in the [cloud](./hosting-considerations#developer-hosted-cloud), or made available through a [managed service provider](#managed-service-provider), such as Unity’s [Multiplay Hosting](https://docs.unity.com/game-server-hosting). In any case, players don’t usually have access to the server build.
49
49
50
50
Games that benefit most from a dedicated server-hosted hosting approach include those that:
51
51
@@ -61,9 +61,9 @@ The following table lists some pros and cons of using a dedicated server hosting
61
61
| There’s no extra lag due to relay based connections. | You must consider scalability because the number of players connected to your server fleet can change drastically in a short time. |
62
62
| You have more control over performance and quality of service since you as a developer control the hardware the server runs on. | It can quickly get expensive, depending on how you host the server build. |
63
63
| It’s easier to think about the server part of your code and the client part of your code when there’s no overlap like a client-hosted game. | It’s more complicated to debug because you usually need to run the production build in a virtual machine for testing. |
64
-
| Clients don’t require as much performance because they'ren’t responsible for the processing and bandwidth overhead involved with hosting. | You have to keep a server build and a client build. |
64
+
| Clients don’t require as much performance because they aren't responsible for the processing and bandwidth overhead involved with hosting. | You have to keep a server build and a client build. |
65
65
| You don’t have to worry about host migrations or what to do when the host player disconnects. ✝ ||
66
66
| You don’t have to worry about the unfairness of the host having zero latency or lag. ||
67
-
| You have the option of using a managed service provider like Game Server Hosting, which allows you to focus on other aspects of your game. ||
67
+
| You have the option of using a managed service provider like Unity Multiplay Hosting, which allows you to focus on other aspects of your game. ||
68
68
69
69
✝ However, you still need to accommodate for unexpected server failures. These failures are less likely to happen, but you still need to handle them with appropriate error messaging.
Copy file name to clipboardExpand all lines: tools/porting-to-dgs/game-changes.md
+5-5
Original file line number
Diff line number
Diff line change
@@ -74,7 +74,7 @@ Games using a DGS hosting approach rely on automation to handle startup events a
74
74
Instead of using in-game menus on start-up, you’ll need to implement an automated startup flow that will `StartServer()` automatically, then wait for your clients to connect. This is also when you might want to set up a lobby in your lobby service or advertise yourself as “ready” to your hosting provider and matchmaking service. After your service knows you’re ready, it can redirect clients to your server.
75
75
76
76
:::note
77
-
If you’re interested in using other Unity services for your multiplayer game, see [Lobby](https://docs.unity.com/lobby), [Game Server Hosting](https://docs.unity.com/game-server-hosting), and [Matchmaker](https://docs.unity.com/matchmaker).
77
+
If you’re interested in using other Unity services for your multiplayer game, see [Lobby](https://docs.unity.com/lobby), [Multiplay Hosting](https://docs.unity.com/game-server-hosting), and [Matchmaker](https://docs.unity.com/matchmaker).
78
78
:::
79
79
80
80
### Automate closing the lobby
@@ -126,7 +126,7 @@ Starting a new game with connected players and keeping the same game session is
126
126
127
127
### Automate exit codes
128
128
129
-
Many hosting providers, such as [Unity’s Game Server Hosting service](https://docs.unity.com/multiplay/), watch your server and react to exit codes. For example, if you have a bug resulting in `StartServer` failing, you can call `Application.Quit(1)` with exit code `1`. Exit codes greater than `0` let the hosting provider know something went wrong and the provider can automatically react to this appropriately by trying to reboot your server or just destroying it.
129
+
Many hosting providers, such as [Unity’s Multiplay Hosting service](https://docs.unity.com/multiplay/), watch your server and react to exit codes. For example, if you have a bug resulting in `StartServer` failing, you can call `Application.Quit(1)` with exit code `1`. Exit codes greater than `0` let the hosting provider know something went wrong and the provider can automatically react to this appropriately by trying to reboot your server or just destroying it.
130
130
131
131
## General game changes
132
132
@@ -296,9 +296,9 @@ I've also seen self-signed certificates used for "offline" purposes, such as enc
296
296
The content in this section might only apply to some hosting providers. Other hosting providers might have zero bandwidth costs for in-datacenter and ingress transfers.
297
297
:::
298
298
299
-
Some hosting providers manage build updates for you and charge for in-datacenter and ingress transfers. One such hosting provider is [Unity’s Game Server Hosting (GSH)](https://docs.unity.com/multiplay/) solution (Multiplay).
299
+
Some hosting providers manage build updates for you and charge for in-datacenter and ingress transfers. One such hosting provider is [Unity’s Multiplay Hosting](https://docs.unity.com/multiplay/) solution.
300
300
301
-
If you use GSH, you can make sure there’s no downtime between updates. GSH performs [build updates and rollouts](https://docs.unity.com/game-server-hosting/legacy/how-do-differential-updates-work.html) in the background. However, you can still [optimize your builds to reduce your bandwidth costs](https://docs.unity.com/game-server-hosting/legacy/cost-optimization.html). For example, you can speed up the update process (and incur fewer charges) by ensuring you have as few changes as possible between build versions.
301
+
If you use Multiplay Hosting, you can make sure there’s no downtime between updates. Multiplay Hosting performs [build updates and rollouts](https://docs.unity.com/game-server-hosting/legacy/how-do-differential-updates-work.html) in the background. However, you can still [optimize your builds to reduce your bandwidth costs](https://docs.unity.com/game-server-hosting/legacy/cost-optimization.html). For example, you can speed up the update process (and incur fewer charges) by ensuring you have as few changes as possible between build versions.
302
302
303
303
There are several ways you can mitigate the differences between build versions. For example, you can use:
304
304
@@ -331,5 +331,5 @@ You can use DGS asset stripping to optimize many aspects of your server-hosted g
331
331
If you’re a small game studio with a small player base, you might not consider the bandwidth costs involved with updating your game. However, these costs can grow quickly without optimizations like incremental builds. A server build of 30 GB and a fleet of 15,000 servers equates to hundreds of terabytes of bandwidth costs for each update.
332
332
333
333
:::tip
334
-
The recommended best practice is to review the bandwidth and related costs of your hosting provider so you can calculate the true cost of rolling out an update. You can view the pricing information for Unity’s Game Server Hosting [here](https://docs.unity.com/game-server-hosting/concepts/pricing.html).
334
+
The recommended best practice is to review the bandwidth and related costs of your hosting provider so you can calculate the true cost of rolling out an update. You can view the pricing information for Unity’s Multiplay Hosting [here](https://docs.unity.com/game-server-hosting/concepts/pricing.html).
Copy file name to clipboardExpand all lines: tools/porting-to-dgs/hosting-considerations.md
+4-4
Original file line number
Diff line number
Diff line change
@@ -81,12 +81,12 @@ Using a cloud hosting solution often saves you money upfront but can cost more t
81
81
| Cloud providers often have data centers located across the world, so you can always have your servers near your users, reducing the latency of their connection. | If there’s a problem in your code causing servers to crash at some odd hour of the night, you can’t rely on the cloud provider to fix it. |
82
82
83
83
:::note
84
-
You can also opt to host your servers with a bare-metal data center, such as Rackspace or Servers.com. Using bare-metal servers comes with its own set of pros and cons. Unity’s Game Server Hosting uses a combination of bare-metal and cloud servers to leverage the advantages of both. See [Machine capacity](https://docs.unity.com/game-server-hosting/legacy/machine-capacity.html) to learn more about the differences between the two options.
84
+
You can also opt to host your servers with a bare-metal data center, such as Rackspace or Servers.com. Using bare-metal servers comes with its own set of pros and cons. Unity’s Multiplay Hosting uses a combination of bare-metal and cloud servers to leverage the advantages of both. See [Machine capacity](https://docs.unity.com/game-server-hosting/legacy/machine-capacity.html) to learn more about the differences between the two options.
85
85
:::
86
86
87
87
### Managed service provider
88
88
89
-
A managed service provider is a service that takes your game server build and manages hosting, scaling, and maintaining it in a white-glove environment. You tell the managed service provider how to run your game, and you often have control over scaling, availability, and other key operation points. Examples of managed service providers include [Unity’s Game Server Hosting](https://docs.unity.com/multiplay/), Amazon Web Services’ Gamelift, Microsoft’s Playfab, and Google’s Agones.
89
+
A managed service provider is a service that takes your game server build and manages hosting, scaling, and maintaining it in a white-glove environment. You tell the managed service provider how to run your game, and you often have control over scaling, availability, and other key operation points. Examples of managed service providers include [Unity’s Multiplay Hosting](https://docs.unity.com/multiplay/), Amazon Web Services’ Gamelift, Microsoft’s Playfab, and Google’s Agones.
90
90
91
91
See the following table to learn more about the pros and cons of opting for a managed service provider to host your game.
92
92
@@ -102,7 +102,7 @@ See the following table to learn more about the pros and cons of opting for a ma
102
102
103
103
Your game server usually needs a way to communicate with their hosting provider, to expose essential information, like the number of connected players, available player slots, map information, and server readiness to accept new player connections.
104
104
105
-
Managed service providers usually provide an SDK you can use to integrate your game. For example, if you use Unity’s Game Server Hosting solution, you can use the [Game Server SDK](https://docs.unity.com/game-server-hosting/sdk/sdk-overview.html).
105
+
Managed service providers usually provide an SDK you can use to integrate your game. For example, if you use Unity’s Multiplay Hosting solution, you can use the [Game Server SDK](https://docs.unity.com/game-server-hosting/sdk/sdk-overview.html).
106
106
107
107
You can also create similar tooling internally if you manage your own infrastructure, such as with an on-premise or cloud-hosted solution.
108
108
@@ -114,7 +114,7 @@ Depending on the nature of your multiplayer game, you might also need to conside
114
114
115
115
The Boss Room sample relies on Unity’s [Lobby service](https://docs.unity.com/lobby/) to advertise hosts for client-hosted games, but you can adapt it for a dedicated-server workflow.
116
116
117
-
The lobby-based matchmaking in the Boss Room sample is minimal and might result in unfair matches if highly skilled players end up in the same lobby as low-skilled players. You can extend the example implementation with Unity’s Matchmaker service, which integrates with Game Server Hosting to match the right players together and send them to the best possible service. See the [Matchplay sample](https://github.com/Unity-Technologies/com.unity.services.samples.matchplay).
117
+
The lobby-based matchmaking in the Boss Room sample is minimal and might result in unfair matches if highly skilled players end up in the same lobby as low-skilled players. You can extend the example implementation with Unity’s Matchmaker service, which integrates with Unity Multiplay Hosting to match the right players together and send them to the best possible service. See the [Matchplay sample](https://github.com/Unity-Technologies/com.unity.services.samples.matchplay).
0 commit comments