Instances: Difference between revisions

From VRChat Wiki
Tony Lewis (talk | contribs)
m Reverted edits by Usr 2c0d9735-9342-4db3-9c48-5eb152581b08 (talk) to last revision by ~Pausbe
Tag: Rollback
Tony Lewis (talk | contribs)
Removed page from translation
Line 1: Line 1:
<languages/>
<translate>
<!--T:1-->
{{Noticebox/Official}}
{{Noticebox/Official}}
[[File:Instance creation menu.webp|thumb|Create instance menu popup]]
[[File:Instance creation menu.webp|thumb|Create instance menu popup]]
'''Instances''' are unique sessions for a [[Special:MyLanguage/Worlds|world]]. Users can create and join instances of a world, and users in the same instance can perceive and interact with each other in the shared world space, but not with users in other instances of the same world. Instances themselves can have specific properties that affect who is allowed to join, invite, or see who is in the instance. They also have a region, which correlates to a real world server that handles passing connection information between the users in the session.
'''Instances''' are unique sessions for a [[Special:MyLanguage/Worlds|world]]. Users can create and join instances of a world, and users in the same instance can perceive and interact with each other in the shared world space, but not with users in other instances of the same world. Instances themselves can have specific properties that affect who is allowed to join, invite, or see who is in the instance. They also have a region, which correlates to a real world server that handles passing connection information between the users in the session.


<!--T:2-->
==Instance types==
==Instance types==
There are many public and private environments of all genres that the user can explore. Users may also create and join various community groups to meet other users with mutual interests. Users can choose to join a public instance, or create a private instance to be alone or invite friends after adding them. The type of privacy of created instances is up to the user, and follows under the various tiers:
There are many public and private environments of all genres that the user can explore. Users may also create and join various community groups to meet other users with mutual interests. Users can choose to join a public instance, or create a private instance to be alone or invite friends after adding them. The type of privacy of created instances is up to the user, and follows under the various tiers:


<!--T:3-->
{| class="wikitable"
{| class="wikitable"
|+
|+
Line 38: Line 33:
|}
|}


<!--T:4-->
 
{| class="wikitable"
{| class="wikitable"
|+Who can join specific instance types
|+Who can join specific instance types
Line 45: Line 40:
!User
!User
friends
friends
!Invited
!<!--T:51> Invited
user  
<!--T:52> user
 
 
<!--T:23> friends
!<!--T:53> Owner
<!--T:54> friends
!<!--T:55> Invited
<!--T:56> owner


<!--T:23-->
<!--T:24> friends
friends
!<!--T:57> Selected
!Owner
<!--T:58> group role
friends
!Invited
owner


<!--T:24-->
friends
!Selected
group role


<!--T:25-->
<!--T:25> members
members
!<!--T:59> All group
!All group
<!--T:60> members
members
|-
|-
!Public
!<!--T:60> Public
| style="text-align:center;" |✔️
| style="text-align:center;" |✔️
| rowspan="2" style="text-align:center;" |✔️
| rowspan="2" style="text-align:center;" |✔️
Line 74: Line 68:
| rowspan="5" style="text-align:center;" | -
| rowspan="5" style="text-align:center;" | -
|-
|-
!Friends+
!<!--T:61> Friends+
| rowspan="6" style="text-align:center;" | -
| rowspan="6" style="text-align:center;" | -
|-
|-
!Friends
!<!--T:62> Friends
| rowspan="4" style="text-align:center;" | -
| rowspan="4" style="text-align:center;" | -
| style="text-align:center;" | -
| style="text-align:center;" | -
|-
|-
!Invite+
!<!--T:63>Invite+
| style="text-align:center;" |✔️<ref group="note">UI only allows to send an invite after the friend requested to join.</ref>
| style="text-align:center;" |✔️<ref group="note"><!--T:64> UI only allows to send an invite after the friend requested to join.</ref>
| rowspan="5" style="text-align:center;" | -
| rowspan="5" style="text-align:center;" | -
|-
|-
!Invite
!<!--T:65> Invite
| rowspan="2" style="text-align:center;" | -
| rowspan="2" style="text-align:center;" | -
|-
|-
!Group
!<!--T:66> Group
| rowspan="3" style="text-align:center;" | -
| rowspan="3" style="text-align:center;" | -
| colspan="2" style="text-align:center;" |✔️<ref group="note">All or selected roles ("Join Group Instances" group role permission required). Note that all group members can still see the instance, even if they don’t have join permission.</ref>
| colspan="2" style="text-align:center;" |✔️<ref group="note"><!--T:67> All or selected roles ("Join Group Instances" group role permission required). Note that all group members can still see the instance, even if they don’t have join permission.</ref>
|-
|-
!Group+
!<!--T:68> Group+
| rowspan="2" style="text-align:center;" |✔️
| rowspan="2" style="text-align:center;" |✔️
| rowspan="2" style="text-align:center;" |✔️
| rowspan="2" style="text-align:center;" |✔️
Line 98: Line 92:
| rowspan="2" style="text-align:center;" |✔️
| rowspan="2" style="text-align:center;" |✔️
|-
|-
!Group Public
!<!--T:69> Group Public
| style="text-align:center;" |✔️
| style="text-align:center;" |✔️
|}
|}
<references group="note" />
<references group="note" />


<!--T:5-->
===Public instances===
===Public instances===
Public instances are considered easily accessible and include Public and Group Public types.<ref name=":0">https://hello.vrchat.com/community-guidelines</ref>  
Public instances are considered easily accessible and include Public and Group Public types.<ref name=":0">https://hello.vrchat.com/community-guidelines</ref>  


<!--T:6-->
===Private instances===
===Private instances===
Private instances require an invitation or a way to get in and include Friends, Friends+, Invite, Invite+, Group, and Group+ types.<ref name=":0" />
Private instances require an invitation or a way to get in and include Friends, Friends+, Invite, Invite+, Group, and Group+ types.<ref name=":0" />


<!--T:7-->
===Group instances ===
===Group instances ===
Group instances are created by a group and include Group Public, Group+, and Group types.
Group instances are created by a group and include Group Public, Group+, and Group types.


<!--T:8-->
==== Age gated instances ====
==== Age gated instances ====
''See also [[Special:MyLanguage/Age Verification|Age Verification]].''
''See also [[Special:MyLanguage/Age Verification|Age Verification]].''


<!--T:26-->
Optionally, 18+ age verification requirement can be set for a group instance by a group member with a role with "Create Age Gated Instances" permission, so that only users with verified 18+ age can join.  
Optionally, 18+ age verification requirement can be set for a group instance by a group member with a role with "Create Age Gated Instances" permission, so that only users with verified 18+ age can join.  


<!--T:27-->
If a user is age verified, age gated instances will be prioritized and shown at the top of the instance list.
If a user is age verified, age gated instances will be prioritized and shown at the top of the instance list.


<!--T:28-->
<small>(Moderator permissions or Group owner overfill does not allow a user to join if they are not also Age-Verified)</small>
<small>(Moderator permissions or Group owner overfill does not allow a user to join if they are not also Age-Verified)</small>


<!--T:9-->
==== Queues ====
==== Queues ====
Instances can be set up with a queue. When capacity is exceeded, a queue forms, shown by a separate icon that displays its length. The "Join" buttons change to "Join Queue". Users with the group's priority-queue permission are placed at the front (behind any users already there with the same permission); everyone else joins the end. The group owner bypasses the queue entirely.
Instances can be set up with a queue. When capacity is exceeded, a queue forms, shown by a separate icon that displays its length. The "Join" buttons change to "Join Queue". Users with the group's priority-queue permission are placed at the front (behind any users already there with the same permission); everyone else joins the end. The group owner bypasses the queue entirely.


<!--T:10-->
A user can direct-connect to an instance if another of their own clients is already inside. The new client kicks the old one on entry, letting you switch between VR and desktop without losing your slot in a full instance.
A user can direct-connect to an instance if another of their own clients is already inside. The new client kicks the old one on entry, letting you switch between VR and desktop without losing your slot in a full instance.
==Regions==
==Regions==
Whilst selecting an instance type, there are choices for varying regions to better optimize their experience. Choosing an instance closest to your location will see a decrease in [[Special:MyLanguage/:Community:Terminology#Ping|ping]], and ensuring a more stable connection to the instance, preventing disconnections and lag.
Whilst selecting an instance type, there are choices for varying regions to better optimize their experience. Choosing an instance closest to your location will see a decrease in [[Special:MyLanguage/:Community:Terminology#Ping|ping]], and ensuring a more stable connection to the instance, preventing disconnections and lag.


<!--T:11-->
Historically, VRChat ran solely on the U.S. West server. On June 16, 2021, two extra regions - '''Europe, and Japan''' were added to the platform in the [https://docs.vrchat.com/docs/vrchat-202124 Regions update]<ref>https://docs.vrchat.com/docs/vrchat-202124</ref> to distribute server load, and offset increasing user count. On December 1, 2021, VRChat added the '''U.S. East'''<ref>https://docs.vrchat.com/docs/vrchat-202142</ref> region, and renamed the current USA server to ''''U.S. West'''<nowiki/>'. Users are also encouraged to check VRChat's {{VRC link|https://status.vrchat.com|server status}} website or their [https://x.com/VRChat_Status VRChat Status account] on social media for outages, or upon discovering issues when connecting to VRChat.
Historically, VRChat ran solely on the U.S. West server. On June 16, 2021, two extra regions - '''Europe, and Japan''' were added to the platform in the [https://docs.vrchat.com/docs/vrchat-202124 Regions update]<ref>https://docs.vrchat.com/docs/vrchat-202124</ref> to distribute server load, and offset increasing user count. On December 1, 2021, VRChat added the '''U.S. East'''<ref>https://docs.vrchat.com/docs/vrchat-202142</ref> region, and renamed the current USA server to ''''U.S. West'''<nowiki/>'. Users are also encouraged to check VRChat's {{VRC link|https://status.vrchat.com|server status}} website or their [https://x.com/VRChat_Status VRChat Status account] on social media for outages, or upon discovering issues when connecting to VRChat.


<!--T:12-->
{| class="wikitable"
{| class="wikitable"
|+
|+
!Token
!<!--T:70> Token
!Region
!<!--T:71> Region
!Location
!<!--T:72> Location
|-
|-
|usw
|<!--T:73> usw
|U.S. West
|<!--T:74> U.S. West
|San José
|<!--T:75> San José
|-
|-
|use
|<!--T:76> use
|U.S. East
|<!--T:77> U.S. East
|Washington D.C.
|<!--T:78> Washington D.C.
|-
|-
|eu
|<!--T:79> eu
|Europe
|<!--T:80> Europe
|Amsterdam
|<!--T:81> Amsterdam
|-
|-
|jp
|<!--T:82> jp
|Japan
|<!--T:83> Japan
|Tokyo
|<!--T:84> Tokyo
|}
|}


<!--T:13-->
== Instance naming ==
== Instance naming ==
[[File:InstanceNaming.png|thumb|The instance created modal with a display name.]]
[[File:InstanceNaming.png|thumb|The instance created modal with a display name.]]
When creating an instance, the instance creator has the option to change its display name. Instance names appear in instance details located in the Here tab of the Quick Menu and in the instance list of worlds. Instance names have a limit of 32 characters allowed, and the characters <code>.</code>,<code>/</code>, and<code>\</code> are not allowed to be used.
When creating an instance, the instance creator has the option to change its display name. Instance names appear in instance details located in the Here tab of the Quick Menu and in the instance list of worlds. Instance names have a limit of 32 characters allowed, and the characters <code>.</code>,<code>/</code>, and<code>\</code> are not allowed to be used.


<!--T:29-->
Instance naming within the client is [[Special:MyLanguage/VRC+|VRC+]] feature, although naming an instance through the API does not require VRC+.
Instance naming within the client is [[Special:MyLanguage/VRC+|VRC+]] feature, although naming an instance through the API does not require VRC+.


<!--T:14-->
== Instance settings ==
== Instance settings ==
[[File:QuickMenu HereTab.png|thumb|The instance settings UI on the Quick Menu "Here" tab.]]
[[File:QuickMenu HereTab.png|thumb|The instance settings UI on the Quick Menu "Here" tab.]]
After joining an instance, the instance creator can select what type of content is to be allowed within the instance; the default options will be set to the world's default content settings. Changing what type of content is allowed can be made in the '''Here''' tab of the Quick Menu.  
After joining an instance, the instance creator can select what type of content is to be allowed within the instance; the default options will be set to the world's default content settings. Changing what type of content is allowed can be made in the '''Here''' tab of the Quick Menu.  


<!--T:15-->
Instance Settings cannot be set by the instance creator if the instance type is Public or Group Public. Instead, it will respect the world creator's content settings. Items can only be toggled in group instances and will always respect the world creator's content settings regardless of instance type.
Instance Settings cannot be set by the instance creator if the instance type is Public or Group Public. Instead, it will respect the world creator's content settings. Items can only be toggled in group instances and will always respect the world creator's content settings regardless of instance type.


<!--T:30-->
The list of content that can be toggled are:
The list of content that can be toggled are:


<!--T:31-->
* [[Special:MyLanguage/Emojis|Emojis]]
* [[Special:MyLanguage/Emojis|Emojis]]
* [[Special:MyLanguage/Stickers|Stickers]]
* [[Special:MyLanguage/Stickers|Stickers]]
Line 191: Line 168:
* [[Special:MyLanguage/Items|Items]]
* [[Special:MyLanguage/Items|Items]]


<!--T:16-->
== Instance permissions ==
== Instance permissions ==
Your permissions for managing an instance is dependent on whether you are a world author, instance owner, or group moderator.
Your permissions for managing an instance is dependent on whether you are a world author, instance owner, or group moderator.


<!--T:17-->
=== Instance owner ===
=== Instance owner ===
The instance owner, is the person who initiated the instance, and depending on its type can be either a user, a group, or the world author. Instance ownership cannot be changed once assigned. To change instance ownership, a new instance must be opened by another user or group. Instance ownership is often confused with a "master", which is usually tied to [[Special:MyLanguage/Udon|Udon]] world settings.  
The instance owner, is the person who initiated the instance, and depending on its type can be either a user, a group, or the world author. Instance ownership cannot be changed once assigned. To change instance ownership, a new instance must be opened by another user or group. Instance ownership is often confused with a "master", which is usually tied to [[Special:MyLanguage/Udon|Udon]] world settings.  


<!--T:18-->
Instance owners have permission to [[Special:MyLanguage/Trust and Safety#User moderation tools|moderate users]], including kicking, warning or muting them. In the case of a group instance, group moderators and their powers depend on assigned [[Special:MyLanguage/Groups#Group Roles and Permissions|group roles and permissions]].
Instance owners have permission to [[Special:MyLanguage/Trust and Safety#User moderation tools|moderate users]], including kicking, warning or muting them. In the case of a group instance, group moderators and their powers depend on assigned [[Special:MyLanguage/Groups#Group Roles and Permissions|group roles and permissions]].


<!--T:32-->
Public instances do not have an assigned instance owner, and defaults to the world author.
Public instances do not have an assigned instance owner, and defaults to the world author.


<!--T:19-->
=== World author ===
=== World author ===
The author of the world have the same core set of moderation tools as an instance owner, being able to moderate users in the form of kicking, warning, and muting. The author have these additional powers, depending on instance type.
The author of the world have the same core set of moderation tools as an instance owner, being able to moderate users in the form of kicking, warning, and muting. The author have these additional powers, depending on instance type.


<!--T:20-->
===Permission chart ===
=== Permission chart ===
{| class="wikitable"
{| class="wikitable"
|+Moderation permissions for instances
|+<!--T:85> Moderation permissions for instances
!Instance type
!<!--T:86> Instance type
|'''Public'''
|'''<!--T:87> Public'''
|'''Friends+'''
|'''<!--T:88> Friends+'''
|'''Friends'''
|'''<!--T:89> Friends'''
|'''Invite+'''
|'''<!--T:90> Invite+'''
|'''Invite'''
|'''<!--T:91> Invite'''
|'''Group Public'''
|'''<!--T:92> Group Public'''
|'''Group+'''
|'''<!--T:93> Group+'''
|'''Group'''
|'''<!--T:94> Group'''
|-
|-
|'''World author'''
|'''<!--T:95> World author'''
|✔️
|✔️
|✔️
|✔️
Line 230: Line 201:
|✔️
|✔️
|✔️
|✔️
|No
|<!--T:96> No
|No
|<!--T:97> No
|-
|-
|'''Instance owner'''
|'''<!--T:98> Instance owner'''
|No
|<!--T:99> No
|✔️
|✔️
|✔️
|✔️
|✔️
|✔️
|✔️
|✔️
|If moderator
|<!--T:100> If moderator
|If moderator
|<!--T:101> If moderator
|If moderator
|<!--T:102> If moderator
|-
|-
|'''Group moderator'''
|'''<!--T:103> Group moderator'''
|No
|<!--T:104> No
|No
|<!--T:105> No
|No
|<!--T:106> No
|No
|<!--T:107> No
|No
|<!--T:108> No
|✔️
|✔️
|✔️
|✔️
Line 254: Line 225:
|}
|}


<!--T:21-->
== Instance duration and automatic resets ==
== Instance duration and automatic resets ==
[[File:Instance shutdown notification.webp|alt=A notification on the VRChat Quick Menu notification pane, in the Other section. The notification reads: "Warning: This instance will be reset in 60 minutes due to its age."|thumb|The notification that appears when the instance is due to reset.]]
[[File:Instance shutdown notification.webp|alt=A notification on the VRChat Quick Menu notification pane, in the Other section. The notification reads: "Warning: This instance will be reset in 60 minutes due to its age."|thumb|The notification that appears when the instance is due to reset.]]
Instances that have been running for long periods will automatically reset to prevent potential issues. If an instance is populated, users will rejoin upon reset, otherwise, they are sent to their Home World. A 180- and 60-minute warning can be given, 5-minute warning is always given before a reset. Instances may run for up to 7 days but can reset sooner due to server-side updates.
Instances that have been running for long periods will automatically reset to prevent potential issues. If an instance is populated, users will rejoin upon reset, otherwise, they are sent to their Home World. A 180- and 60-minute warning can be given, 5-minute warning is always given before a reset. Instances may run for up to 7 days but can reset sooner due to server-side updates.


==References== <!--T:22-->
==References==


<!--T:33-->
<references />
<references />
</translate>
[[Category:Needs Images{{#translation:}}]]
[[Category:Needs Images{{#translation:}}]]

Revision as of 18:52, 26 September 2025

V · EThis is an official VRChat information page!
It is reviewed and approved by the VRCWiki Team. Learn how to contribute to this page by reading the Contribution Guide.
Create instance menu popup

Instances are unique sessions for a world. Users can create and join instances of a world, and users in the same instance can perceive and interact with each other in the shared world space, but not with users in other instances of the same world. Instances themselves can have specific properties that affect who is allowed to join, invite, or see who is in the instance. They also have a region, which correlates to a real world server that handles passing connection information between the users in the session.

Instance types

There are many public and private environments of all genres that the user can explore. Users may also create and join various community groups to meet other users with mutual interests. Users can choose to join a public instance, or create a private instance to be alone or invite friends after adding them. The type of privacy of created instances is up to the user, and follows under the various tiers:

Public A publicly listed instance to which anyone can join.
Friends+ Your friends, and their friends, and so on can join.
Friends Only your friends may join; friends of friends are excluded.
Invite+ Users and friends of users must request to join your instance, unless you or an invited user's social status is set to "Join Me".
Invite Users must send a join request to join you, unless your social status is set to "Join Me"; friends of friends are excluded.
Group An instance that only members of a group, or specific roles within that group can access.
Group+ An instance hosted by a group, in which friends of group members, friends of their friends, and so on, can join. Group+ instances may have appointed group moderators to manage an instance. Being a member of the hosting group is not required to join the instance.
Group Public A publicly listed instance, hosted by a group, to which anyone can join. Group Public instances may have appointed group moderators to manage an instance.


Who can join specific instance types
Anyone User

friends