Skip to content

Commit de0b02b

Browse files
update Open Source Docs from Roblox internal teams
1 parent 990d690 commit de0b02b

File tree

1 file changed

+20
-29
lines changed

1 file changed

+20
-29
lines changed

content/en-us/production/publishing/publish-experiences-and-places.md

Lines changed: 20 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -326,45 +326,36 @@ To allow strong language between players in text chat within your experience:
326326

327327
## Release updates
328328

329-
When you publish an updated version of an experience to Roblox, players aren't immediately removed from the old version of the experience. Instead, you can transition players to the new version by either restarting or shutting down all of your servers, each with advantages and disadvantages.
329+
When you publish an updated version of an experience to Roblox, players aren't immediately removed from old versions of the experience. Instead, you can migrate players to the updated version by restarting all of your outdated servers.
330330

331-
If you don't take an action, players transition to the new version of the experience as the servers running the old version eventually empty and shut down. This option is non‑disruptive, but your player base might be playing different versions of the experience for a prolonged period of time. Reserve this approach for only minor updates.
331+
If you don't restart servers, players will transition to the new version of the experience as the servers running old versions eventually empty and shut down. This option is non‑disruptive, but your player base might be playing different versions of the experience for a prolonged period of time.
332332

333333
### Restart servers
334334

335-
The **Restart Servers for Updates** option is the best choice for most updates. When you choose this option, Roblox performs the following actions:
335+
To restart servers for release updates:
336336

337-
- Stops matchmaking to servers running the old version of the experience. Servers running the latest version are unaffected.
338-
- Starts replacement servers.
339-
- Shuts down old servers as their replacements become ready.
340-
- Automatically teleports players to rejoin the new version of the experience. All players on an existing server connect to the same replacement server.
337+
1. Go to [Creations](https://create.roblox.com/dashboard/creations) and select the experience you want to restart servers for.
338+
2. Go to **Services** > **Server Management**.
339+
3. Select the places you want to restart.
340+
4. Click **Restart servers**.
341+
5. In the **Confirm Server Restart** dialog:
342+
1. Select one or both of the following restart options:
343+
- **Restart only servers with outdated versions** to avoid restarting servers that are running the latest published place version.
344+
- **Delay server restart** to delay the shutdown of servers and allow players a set time between 1 and 60 minutes to leave the experience on their own instead of being temporarily disconnected. This is also known as server bleed-off.
345+
2. Click **Restart**.
341346

342-
Depending on the number of servers to replace, this process can take up to six minutes, although most experiences update in less than one minute.
343-
344-
To restart all servers for updates:
345-
346-
1. Navigate to the [Creator Dashboard][creatordashboard].
347-
1. Hover over the experience's thumbnail, click the **⋯** button, and select **Restart Servers for Updates**.
348-
349-
<img src="../../assets/creator-dashboard/Options-Button-Experience-Public.png" width="200" />
350-
351-
1. Confirm restart by clicking the **Restart** button.
347+
<Alert severity="warning">
348+
Unless you have an experience update workflow that is independent of place version, we recommend that you always select **Restart only servers with outdated versions** to avoid unnecessarily disconnecting players.
349+
</Alert>
352350

353-
### Shut down all servers
351+
After you restart servers, Roblox:
354352

355-
The **Shut Down All Servers** option performs the same process as **Restart Servers for Updates**, except it applies to **all** servers rather than those running old versions of the experience. This option is only recommended if you have a process for updating your experiences that does not involve publishing new place versions.
353+
1. Stops all matchmaking to servers designated for shutdown. Players who join your experience by clicking the **Play** button will not be matched to these servers, but they can still join them by accepting invites, teleporting, or joining another user from their profile.
354+
2. Waits for the configured delay time, if you selected the **Delay server restart** option.
355+
3. Automatically teleports players to the updated version of the experience. All players on the same old server are sent to the same replacement server running the new version.
356356

357357
<Alert severity="info">
358-
Players will automatically reconnect after the servers have shut down. If you would like to completely shut down an experience and not allow players to reconnect, such as in a situation where you need to fix a critical bug causing data loss, you can make the experience private.
358+
If you want to completely shut down your experience and not allow players to reconnect after you restart your servers, you must make the experience private.
359359
</Alert>
360360

361-
To shut down all servers:
362-
363-
1. Navigate to the [Creator Dashboard][creatordashboard].
364-
1. Hover over an experience's thumbnail, click the **&ctdot;** button, and select **Shut Down All Servers**.
365-
366-
<img src="../../assets/creator-dashboard/Options-Button-Experience-Public.png" width="200" />
367-
368-
1. Confirm shutdown by clicking the **OK** button.
369-
370361
[creatordashboard]: https://create.roblox.com/dashboard/creations

0 commit comments

Comments
 (0)