Groups: Difference between revisions

From VRChat Wiki
(added links, cleaned up header)
m (Remove <references/> from being translatable)
 
(41 intermediate revisions by 16 users not shown)
Line 1: Line 1:
Groups is a social feature aimed towards forming communities within VRChat. Creating a group allows other users to join it, typically to find like-minded people or participate in events within Group Instances. Members of a group may choose to represent it, advertising the group's banner on their nameplate and profile. The Groups feature was officially released on [https://hello.vrchat.com/blog/vrchat-groups November 30th, 2022].
<languages/>
{{Noticebox/Official}}
[[File:Groups Render.webp|thumb|<translate><!--T:1--> Official render of the "Groups" logo.</translate>]]
<translate>
<!--T:2-->
'''Groups''' is a social feature aimed towards forming and maintaining communities within VRChat. The purpose of creating a group allows other users to join them, typically to assimilate an audience such as a fanbase or [[Special:MyLanguage/Community:Culture|culture]], and optionally, to host and participate in events within group instances. Members of a group may choose to represent it, showcasing the group's banner on their nameplate and profile. The Groups feature was officially released on [https://hello.vrchat.com/blog/vrchat-groups November 30th, 2022].


== Joining a Group ==
==Joining a group== <!--T:3-->
To join a group, you must first navigate to the group's page. Users can be in up to 100 different Groups at a time, or up to 200 with an active [[Vrchat+|VRChat+]] subscription. To join a group, you can either find one through the Search tab or Group tab; join a group by looking at another user's list of groups they are publicly displaying on their profile or by clicking on specific promotional posters located in worlds.


Once you are in a group, you are able to join any active Group instances via the Instances tab on the group's page. All active Group instances for every joined group are amassed in the Group Activity tab. The Group Activity tab can also be found in the Main Menu's Social page.
<!--T:4-->
To join a group, you must first navigate to a group's page. Users can be in up to 100 different groups at a time, or up to 200 with an active [[Special:MyLanguage/VRChat+|VRChat+]] subscription. To join a group, you can either find one through the Search tab or Group tab in the [[Special:MyLanguage/Main Menu|Main Menu]]. It's also possible to join a group by browsing another user's list of groups they are representing on their profile, or by clicking on specific promotional posters located in worlds. Once you are in a group, you are able to join any active group instances via the '''Instances tab''' on the group's page, or the '''Group Activity''' row in the Social tab.


=== Representing ===
===Representing=== <!--T:5-->
Representing a group displays the group's name and banner on the user's nameplate and profile. Users may represent one group at a time.


=== Membership Visibility ===
<!--T:6-->
A member of a group may choose to prevent their membership from showing on their profile in the list of joined groups. Do note that this setting can be bypassed by mutual group members if their group permissions allow for viewing members of the group.
Representing a group displays the group's name and banner on the user's nameplate and profile. A user may represent a group by going to the group's page on the main menu and clicking the button labeled: "Represent Group", on the top right corner. A single group may be represented at a time.


'''''TODO''': this last bit about bypassing visibility may need fact checking. I'm pretty sure this is the case but I can't say with 100% certainty.'' ''big 2024/05/31 11:15 UTC''
===Membership visibility=== <!--T:7-->
 
<!--T:8-->
A member of a group may choose to obscure affiliation from displaying on their profile in the list of joined groups. However, a user will '''still''' be able to see if you're in the group under the following conditions:
 
<!--T:9-->
*They mutually share the group with you.
*The user has the "View All Members" permission.
 
<!--T:45-->
[[File:VRChat 1FSHUeX5jS.png|thumb|150x150px|Group visibility options]]
 
<!--T:11-->
You can hide visibility by going to the '''Group tab''' within the VRChat client, selecting the group, and clicking the cog icon at the top right on the menu. This will open a '''Group Settings''' submenu, to which you can change visibility at will.
 
<!--T:48-->
It is also possible to change visibility from the VRChat website by going to the Group tab in the sidebar, selecting the group, clicking "'''Settings"''', and then choosing the '''Visibility''' setting right for you beneath '''"My Membership"'''.
{| class="wikitable"
{| class="wikitable"
!Visible
!Visible
Line 18: Line 38:
|-
|-
!Friends Only
!Friends Only
|The group is only shown on your profile to your friends.
|The group is only shown on your profile to your friends.  
|-
|-
!Hidden
!Hidden
|The group is hidden from your profile
|The group is hidden from your profile.
|}
|}


== Creating a Group ==
==Creating a group== <!--T:12-->
To create a group, a user must first have an active [[VRChat+]] subscription. Maintaining the [[VRChat+]] subscription is not necessary for retaining group ownership. An active [[VRChat+]] subscription is required to change icons, banners and edit the group's gallery using the [[VRChat+]] Gallery, as well as transferring ownership of the group to another user. Currently, creating a group must be done via the [https://vrchat.com/home/groups VRChat website]. A user can own a maximum of 5 groups, of which a maximum of 100,000 members can join each group.
 
<!--T:13-->
To create a group, a user must first have an active [[Special:MyLanguage/VRChat+|VRChat+]] subscription. Maintaining the VRChat+ subscription is not necessary for retaining group ownership. An active VRChat+ subscription is required to change icons, banners and edit the group's gallery using the VRChat+ Gallery, as well as transferring ownership of the group to another user. Currently, creating a group must be done via the {{VRC link|https://vrchat.com/home/groups|VRChat website}}. A user can own a maximum of 5 groups, of which a maximum of 100,000 members can join each group.


=== Joinability and Visibility ===
===Joinability and visibility=== <!--T:14-->
When creating a group, an onboarding process presents the creator with a few privacy options.


The '''joinability''' of a group determines any given user's ability to join the group. This setting can be changed later.
<!--T:15-->
When creating a group, an onboarding process presents the creator with a few privacy options. The '''joinability''' of a group determines any given user's ability to join the group. This setting can be changed later.
{| class="wikitable"
{| class="wikitable"
!Free Join
!Free Join
Line 36: Line 58:
|-
|-
!Request to Join
!Request to Join
|New members must request to join the group.
|New members must request to join the group.  
|-
|-
!Invite-Only
!Invite-Only  
|Those with the right permissions may invite new members to the group.
|Those with the right permissions may invite new members to the group.
|}
|}
The '''visibility''' of a group determines whether or not the group can be represented or displayed on a member's profile. This setting cannot be changed later.
The '''visibility''' of a group determines whether or not the group can be represented or displayed on a member's profile. This setting '''cannot''' be changed later.
{| class="wikitable"
{| class="wikitable"
!Public
!Public
Line 49: Line 71:
|The group cannot be advertised or displayed by members.
|The group cannot be advertised or displayed by members.
|}
|}
As mentioned, any user can manually obscure of any public group from displaying on their profile via Visibility settings.
<!--T:49-->
===Group banner===
A banner can be uploaded by using the options on the website. The image that is uploaded is not showing entirely above those who represent it only a part of it shows. When the menu is opened up it will show a larger part of the banner.
==Group roles and permissions== <!--T:16-->
===Viewing your roles=== <!--T:17-->
<!--T:18-->
While it is not currently possible to select or change roles within the VRChat client, you can view all current roles applied to your account by opening the [[Special:MyLanguage/Main Menu|Main Menu]], and clicking on the Group tab, click on a group that you wish to view your roles for. There is a 'cog' icon towards the top right of the menu, which expands a rightwards '''Group Settings''' submenu. The very top of the submenu will let you browse the roles currently applied.
===Default roles=== <!--T:19-->
<!--T:46-->
[[File:Groups default roles.png|thumb|253x253px|Role overview]]
<!--T:21-->
Groups have three different tiers for roles: '''Management Roles''', '''Member Roles''', and '''Default Role'''. Automatically, groups will have three roles when the group is created: '''Everyone''', which is listed under 'Default Role', '''Member''', which is listed under 'Member Role', and '''Group Owner''', which is listed under 'Management Role'. The role names for 'Group Owner' and 'Member' can be changed, but 'Everyone' cannot be changed or deleted.
<!--T:22-->
Group Owner permissions cannot be changed or deleted in any way, since by default, they should always have all permissions. The Group owner, however, can be transferred to another willing group member as long as both parties are subscribed to VRChat+. This should be deliberated heavily before transfer, since all transfers are final. Read more about Group Transferring below.
===Creating roles=== <!--T:23-->
<!--T:24-->
Roles can be added, renamed, or deleted at any time by a group's management. Each role can be given a description, and a custom set of permissions. Permissions are either toggled on, or off for a group. Roles can optionally be set to be '''Assigned On Join''', be '''Self Assignable''', or '''Require 2FA'''. Self Assignable roles are optional, and users can sign into the VRChat website to apply roles to themselves, if available. However, users on platform accounts, such as Steam or Meta accounts, are unable to log in and do so, since logging into their account on the VRChat website requires the [[Special:MyLanguage/Getting Started#Account Creation|creation of a VRChat account]]. Group management can manually apply roles to any user at will.
{| class="wikitable"
|+
!Function
!Description
|-
|Assign On Join
|<small>If enabled, new members will be assigned this role when they join the group. This will not affect existing members.</small>
|-
|Self Assignable
|<small>Allows members of the group to assign this role to themselves.</small>
|-
|Require 2FA
|<small>Requires members to have 2FA before permissions apply.</small>
|}
<!--T:47-->
[[File:Groups permissions overview.png|thumb|Some of the available permissions that may be assigned, as seen in the Group Management Options]]
===Assigning permissions=== <!--T:26-->
<!--T:27-->
To assign permissions for a role, a group manager must sign in on the VRChat website, and navigate to the Permissions tab.
<!--T:28-->
* Step 1: Click '''Groups''' on the left sidebar of the website.
<!--T:29-->
* Step 2: Click on a group that you can manage or change permissions for.
<!--T:30-->
* Step 3: There are different tabs a group manager can access, such as Overview, Posts, etc. Click on the tab titled '''Settings'''.
<!--T:31-->
* Step 4: Click on '''Roles''', below that tab.


=== Group Roles ===
<!--T:32-->
'''TODO:''' roles text describing the 'role presets' provided as well as other group moderation things? — ''big 2024/05/31 19:42 UTC''
* Step 5: Click on the role that you wish to edit permissions for, and click '''Permissions''' with the lock icon.


== Group Instances ==
<!--T:33-->
The owner of a group and those with the correct permissions may create Group instances. There are three tiers of Group instances.
* Step 6: Apply the permissions found below, scroll down to the bottom of the page, and '''click Save'''.
{| class="wikitable"
|+
!Permission
!Function
|-
|Manage Group Member Data
|<small>Allows role to view, filter by role, and sort all members and edit data about them.</small>
|-
|Manage Group Data
|<small>Allows role to edit group details (name, description, joinState, etc).</small>
|-
|View Audit log
|<small>Allows role to view the full group audit log.</small>
|-
|Manage Group Roles
|<small>Allows role to create roles, modify roles, and delete roles.</small>
|-
|Manage Group Default Role
|<small>Allows role to manage the permissions for the default role (aka Everyone role). Requires “Manage Group Roles”.</small>
|-
|Assign Group Roles
|<small>Allows role to assign/unassign roles to users. Requires “Manage Group Member Data”.</small>
|-
|Manage Group Ban
|<small>Allows role to ban/unban users and view all banned users. Requires “Manage Group Member Data”.</small>
|-
|Remove Group members
|<small>Allows role to remove someone from the group. Requires “Manage Group Member Data”.</small>
|-
|View All Members
|<small>Allows role to view all members in a group, not just friends.</small>
|-
|Manage Group Announcement
|<small>Allows role to set/clear group announcement and send it as a notification.</small>
|-
|Manage Group Galleries
|<small>Allows role to create, reorder, edit, and delete group galleries. Can always submit to galleries, and can approve images.</small>
|-
|Manage Group Invites
|<small>Allows role to create/cancel invites, as well as accept/decline/block join requests.</small>
|-
|Moderate Group Instance
|<small>Allows role to moderate within a group instance.</small>
|-
|Manage Group Instances
|<small>Allows role to close an group instance.</small>
|-
|Group Instance Queue Priority
|<small>Gives role priority for group instance queues.</small>
|-
|Create Group Public Instances
|<small>Allows role to create group instances that are open to all, member or not. NOTE: Private groups cannot create public instances.</small>
|-
|Create Group+ Instances
|<small>Allows role to create group instances that friends of people present can also join.</small>
|-
|Create Members-Only Group Instances
|<small>Allows role to create members-only instances.</small>
|-
|Role-Restrict Members-Only Instances
|<small>Allows role to add/remove/modify role restrictions on members-only instances. Requires “Create Members-Only Group Instances”.</small>
|-
|Portal to Group+ Instances
|<small>Allows role to open locked portals to Group+ instances. Members, friends of people there, and friends of the portal dropper may enter unless group-banned.</small>
|-
|Unlocked Portal to Group+ Instances
|<small>Allows role to open unlocked portals to Group+ instances. Everyone except group-banned people may enter. Requires “Portal to Group+ Instances”.</small>
|-
|Join Group Instances
|<small>Allows role to join group instances.</small>
|}
 
==Group instances== <!--T:34-->
 
<!--T:35-->
The owner of a group, and those with the correct permissions may create group instances. There are three types of group instances.
{| class="wikitable"
{| class="wikitable"
!Group
!Group
Line 65: Line 225:
|A publicly listed instance hosted by a group to which anyone can join. Group membership is not required to join the instance.
|A publicly listed instance hosted by a group to which anyone can join. Group membership is not required to join the instance.
|}
|}
Group instances are often '''moderated by the group hosting the instance'''. The group's owner and those given moderation powers through role permissions may warn, mute, kick or ban a user within the instance. Banning a user from a group permanently prevents them from joining any Group instances made by the group, as well as joining the group itself.
Group instances are often '''moderated by the group hosting the instance'''. The group's owner and those given moderation permissions through their role may warn, mute, kick or ban a user within the instance. Banning a user from a group permanently prevents them from joining any Instances made by the group, as well as joining the group itself.
 
===Group instance queues=== <!--T:36-->
 
<!--T:37-->
Group Instances are also great for managing events with a high amount of people. For that situation, the '''VRChat Group Queues''' option will setup a waiting queue to process joining requests when the instance max capacity is reached. When you join the queue for an instance, you will be placed in and will receive a invite request when a slot becomes available. Once the request is received on your side, you have one minute to join the instance before your slot is given to the next person.
 
==Transferring a group == <!--T:38-->
 
<!--T:39-->
As of March 27, 2024<ref>https://ask.vrchat.com/t/developer-update-28-march-2024/23676</ref>, owners of groups could choose to transfer the ownership of a group to another willing group member as long as both parties are subscribed to VRChat+, and have available space. This should be taken under consideration, as all transfers are final.
 
<!--T:40-->
'''You can transfer your group ownership to another member of the group; the target member and the group must meet the requirements below.'''
*The target member has verified their email address (check the Email section via account settings)
* The target member has an active VRC+ subscription
*The target member can still own more groups (each user can own up to 5 groups)
*The group is not monetized
 
==Official resources== <!--T:41-->
 
<!--T:42-->
* [https://www.youtube.com/watch?v=b6c_kDRJG2A Developer Update - Groups] on ''YouTube'', uploaded November 30, 2022.
*{{VRC link|https://hello.vrchat.com/blog/vrchat-groups|Groups is Now Live!}} on ''hello.vrchat.com''
*{{VRC link|https://help.vrchat.com/hc/en-us/sections/11719560642963-VRChat-Groups|VRChat Groups FAQ}} on ''help.vrchat.com''
 
== Reference list== <!--T:43-->
 
</translate>
[[Category:Features{{#translation:}}]]


=== Group Instance Queues ===
<references />
Group instances are also great for managing events with a high amount of people. For that situation, the '''VRChat Group Queues''' option will setup a waiting queue to process joining requests when the instance max capacity is reached. When you join the queue for an instance, you will be placed in and will receive a invite request when a slot becomes available. Once the request is received on your side, you have one minute to join the instance before your slot is given to the next person.

Latest revision as of 23:56, 29 October 2024

VRLogo.png
V · EThis is an official VRChat information page!
It is written and maintained by VRCWiki Team.
Official render of the "Groups" logo.

Groups is a social feature aimed towards forming and maintaining communities within VRChat. The purpose of creating a group allows other users to join them, typically to assimilate an audience such as a fanbase or culture, and optionally, to host and participate in events within group instances. Members of a group may choose to represent it, showcasing the group's banner on their nameplate and profile. The Groups feature was officially released on November 30th, 2022.

Joining a group

To join a group, you must first navigate to a group's page. Users can be in up to 100 different groups at a time, or up to 200 with an active VRChat+ subscription. To join a group, you can either find one through the Search tab or Group tab in the Main Menu. It's also possible to join a group by browsing another user's list of groups they are representing on their profile, or by clicking on specific promotional posters located in worlds. Once you are in a group, you are able to join any active group instances via the Instances tab on the group's page, or the Group Activity row in the Social tab.

Representing

Representing a group displays the group's name and banner on the user's nameplate and profile. A user may represent a group by going to the group's page on the main menu and clicking the button labeled: "Represent Group", on the top right corner. A single group may be represented at a time.

Membership visibility

A member of a group may choose to obscure affiliation from displaying on their profile in the list of joined groups. However, a user will still be able to see if you're in the group under the following conditions:

  • They mutually share the group with you.
  • The user has the "View All Members" permission.
Group visibility options

You can hide visibility by going to the Group tab within the VRChat client, selecting the group, and clicking the cog icon at the top right on the menu. This will open a Group Settings submenu, to which you can change visibility at will.

It is also possible to change visibility from the VRChat website by going to the Group tab in the sidebar, selecting the group, clicking "Settings", and then choosing the Visibility setting right for you beneath "My Membership".

Visible The group is shown on your profile for everyone.
Friends Only The group is only shown on your profile to your friends.
Hidden The group is hidden from your profile.

Creating a group

To create a group, a user must first have an active VRChat+ subscription. Maintaining the VRChat+ subscription is not necessary for retaining group ownership. An active VRChat+ subscription is required to change icons, banners and edit the group's gallery using the VRChat+ Gallery, as well as transferring ownership of the group to another user. Currently, creating a group must be done via the Official VRChat source VRChat website. A user can own a maximum of 5 groups, of which a maximum of 100,000 members can join each group.

Joinability and visibility

When creating a group, an onboarding process presents the creator with a few privacy options. The joinability of a group determines any given user's ability to join the group. This setting can be changed later.

Free Join Anyone can join the group freely.
Request to Join New members must request to join the group.
Invite-Only Those with the right permissions may invite new members to the group.

The visibility of a group determines whether or not the group can be represented or displayed on a member's profile. This setting cannot be changed later.

Public Members can choose to advertise the group on their profile.
Private The group cannot be advertised or displayed by members.

As mentioned, any user can manually obscure of any public group from displaying on their profile via Visibility settings.

Group banner

A banner can be uploaded by using the options on the website. The image that is uploaded is not showing entirely above those who represent it only a part of it shows. When the menu is opened up it will show a larger part of the banner.

Group roles and permissions

Viewing your roles

While it is not currently possible to select or change roles within the VRChat client, you can view all current roles applied to your account by opening the Main Menu, and clicking on the Group tab, click on a group that you wish to view your roles for. There is a 'cog' icon towards the top right of the menu, which expands a rightwards Group Settings submenu. The very top of the submenu will let you browse the roles currently applied.

Default roles

Role overview

Groups have three different tiers for roles: Management Roles, Member Roles, and Default Role. Automatically, groups will have three roles when the group is created: Everyone, which is listed under 'Default Role', Member, which is listed under 'Member Role', and Group Owner, which is listed under 'Management Role'. The role names for 'Group Owner' and 'Member' can be changed, but 'Everyone' cannot be changed or deleted.

Group Owner permissions cannot be changed or deleted in any way, since by default, they should always have all permissions. The Group owner, however, can be transferred to another willing group member as long as both parties are subscribed to VRChat+. This should be deliberated heavily before transfer, since all transfers are final. Read more about Group Transferring below.

Creating roles

Roles can be added, renamed, or deleted at any time by a group's management. Each role can be given a description, and a custom set of permissions. Permissions are either toggled on, or off for a group. Roles can optionally be set to be Assigned On Join, be Self Assignable, or Require 2FA. Self Assignable roles are optional, and users can sign into the VRChat website to apply roles to themselves, if available. However, users on platform accounts, such as Steam or Meta accounts, are unable to log in and do so, since logging into their account on the VRChat website requires the creation of a VRChat account. Group management can manually apply roles to any user at will.

Function Description
Assign On Join If enabled, new members will be assigned this role when they join the group. This will not affect existing members.
Self Assignable Allows members of the group to assign this role to themselves.
Require 2FA Requires members to have 2FA before permissions apply.
Some of the available permissions that may be assigned, as seen in the Group Management Options

Assigning permissions

To assign permissions for a role, a group manager must sign in on the VRChat website, and navigate to the Permissions tab.

  • Step 1: Click Groups on the left sidebar of the website.
  • Step 2: Click on a group that you can manage or change permissions for.
  • Step 3: There are different tabs a group manager can access, such as Overview, Posts, etc. Click on the tab titled Settings.
  • Step 4: Click on Roles, below that tab.
  • Step 5: Click on the role that you wish to edit permissions for, and click Permissions with the lock icon.
  • Step 6: Apply the permissions found below, scroll down to the bottom of the page, and click Save.
Permission Function
Manage Group Member Data Allows role to view, filter by role, and sort all members and edit data about them.
Manage Group Data Allows role to edit group details (name, description, joinState, etc).
View Audit log Allows role to view the full group audit log.
Manage Group Roles Allows role to create roles, modify roles, and delete roles.
Manage Group Default Role Allows role to manage the permissions for the default role (aka Everyone role). Requires “Manage Group Roles”.
Assign Group Roles Allows role to assign/unassign roles to users. Requires “Manage Group Member Data”.
Manage Group Ban Allows role to ban/unban users and view all banned users. Requires “Manage Group Member Data”.
Remove Group members Allows role to remove someone from the group. Requires “Manage Group Member Data”.
View All Members Allows role to view all members in a group, not just friends.
Manage Group Announcement Allows role to set/clear group announcement and send it as a notification.
Manage Group Galleries Allows role to create, reorder, edit, and delete group galleries. Can always submit to galleries, and can approve images.
Manage Group Invites Allows role to create/cancel invites, as well as accept/decline/block join requests.
Moderate Group Instance Allows role to moderate within a group instance.
Manage Group Instances Allows role to close an group instance.
Group Instance Queue Priority Gives role priority for group instance queues.
Create Group Public Instances Allows role to create group instances that are open to all, member or not. NOTE: Private groups cannot create public instances.
Create Group+ Instances Allows role to create group instances that friends of people present can also join.
Create Members-Only Group Instances Allows role to create members-only instances.
Role-Restrict Members-Only Instances Allows role to add/remove/modify role restrictions on members-only instances. Requires “Create Members-Only Group Instances”.
Portal to Group+ Instances Allows role to open locked portals to Group+ instances. Members, friends of people there, and friends of the portal dropper may enter unless group-banned.
Unlocked Portal to Group+ Instances Allows role to open unlocked portals to Group+ instances. Everyone except group-banned people may enter. Requires “Portal to Group+ Instances”.
Join Group Instances Allows role to join group instances.

Group instances

The owner of a group, and those with the correct permissions may create group instances. There are three types of group instances.

Group Only members of a group (or certain roles within the group if specified) can join the instance.
Group+ Any friend of a user in the instance can join. Group membership is not required to join the instance.
Group Public A publicly listed instance hosted by a group to which anyone can join. Group membership is not required to join the instance.

Group instances are often moderated by the group hosting the instance. The group's owner and those given moderation permissions through their role may warn, mute, kick or ban a user within the instance. Banning a user from a group permanently prevents them from joining any Instances made by the group, as well as joining the group itself.

Group instance queues

Group Instances are also great for managing events with a high amount of people. For that situation, the VRChat Group Queues option will setup a waiting queue to process joining requests when the instance max capacity is reached. When you join the queue for an instance, you will be placed in and will receive a invite request when a slot becomes available. Once the request is received on your side, you have one minute to join the instance before your slot is given to the next person.

Transferring a group

As of March 27, 2024[1], owners of groups could choose to transfer the ownership of a group to another willing group member as long as both parties are subscribed to VRChat+, and have available space. This should be taken under consideration, as all transfers are final.

You can transfer your group ownership to another member of the group; the target member and the group must meet the requirements below.

  • The target member has verified their email address (check the Email section via account settings)
  • The target member has an active VRC+ subscription
  • The target member can still own more groups (each user can own up to 5 groups)
  • The group is not monetized

Official resources

Reference list