Skip to main content

Configuration

The core settings for the Room System are managed inside the RS_Config script. This file stores the global constants that define the capacities and limits for your rooms, UI queues, and the world itself.

If you need to adjust the maximum number of players allowed in a room, or increase the world capacity limit to match your VRChat instance settings, you will modify these values directly within the RS_Config script.

Constants Overview​

  • WORLD_MAX_CAPACITY (Default: 12): Defines the maximum number of players your VRChat world can hold.

    Important: You must ensure this number matches your world's maximum instance capacity (including extra capacity) to prevent synchronization errors across clients.

  • ROOM_MAX_CAPACITY (Default: 8): The maximum number of players that can be tracked, invited, or granted access to a single room at any given time.

  • ROOM_MAX_NOTIFICATIONS (Default: 6): The maximum number of intercom rings that a room's queue can hold before it stops accepting new ones.

  • ROOM_SETTINGS (Default: 2): The number of custom toggleable settings tracked by the room system's state. Increase this if you plan to add more custom toggles (like adjusting lights, mirrors, or media players) to the room's UI.

Room Positioning​

To ensure players are teleported and managed correctly when entering or exiting from a room, you must configure the teleport targets on the room's parent GameObject.

Select the main RoomSystem GameObject in your hierarchy and adjust these two Transforms in the Inspector:

  • insideRoomPositiom: Move this Transform to the exact location inside the room where you want players to appear.
  • outsideRoomPositiom: Move this Transform to a location outside the room (such as a hallway or lobby). This is where unauthorized players will be teleported if they are kicked or fail an access check.

Sound Effects​

If you want to swap out the default audio clips to better match the atmosphere of your world, you can change the sound effects directly on their respective GameObjects:

  • Intercom Sounds: Locate and select the _intercom GameObject in your room's hierarchy to change the ringing or notification audio.
  • Camera Sounds: Locate and select the _selfieCamera GameObject to adjust the sound effects triggered by the room's security camera.

Customizing Notification Alerts​

You can fully customize the look and text of these alerts directly on the RoomsManagement GameObject. Look for the RS_NotificationConfig script in the Inspector to modify the following settings:

Deny User Notification​

This alert is sent to a player when the room owner explicitly denies their intercom request.

  • Deny User Text: The main header text for the alert (default is NOT ACCEPTED).
  • Deny User Text Color: The color of the main header text.
  • Deny User Sub Text Color: The color of the secondary text (which typically displays the room owner's name).
  • Deny User Sprite: The icon displayed next to the message.
  • Deny User Sprite Color: The color tint applied to the icon.

Intercom Ring Notification​

This alert is sent to the room owner(s) when someone rings their room from the outside.

  • Intercom Ring Text: The main header text for the alert (default is INTERCOM RING).
  • Intercom Ring Text Color: The color of the main header text.
  • Intercom Ring Sub Text Color: The color of the secondary text (which typically displays the caller's name).
  • Intercom Ring Sprite: The icon displayed next to the message.
  • Intercom Ring Sprite Color: The color tint applied to the icon.

⚠️ Important Audio Note:
We recommend disabling the Sound Effects option on your Notification System prefab. If left enabled, the default notification alert sound will play simultaneously with the Room System's custom intercom ring audio, causing overlapping sounds.

Need sound effects for other systems? If your world uses the notification system for other assets and requires audio alerts, simply place a second Notification System prefab in your hierarchy and assign it exclusively to the Room System with sound effects disabled.