🔐 Private Rooms — Advanced Private Room System

Private Rooms is a complete room privacy and access-control system designed for social worlds, clubs, hangout areas, VIP rooms, staff rooms, private lounges, dating rooms, RP rooms, event spaces, and any world where users need controlled personal spaces.

This system lets each room dynamically switch between Open, Private, and Closed modes, while also supporting door knocking, room ownership, anonymous occupancy display, room messages, whitelist access, kick controls, video call UI control, optional VoiceZone integration, and clean synchronized room state behavior.

✨ Main Features

🚪 Room Modes

Private Rooms includes three main room states:

🟢 Open Mode

The room is open to everyone.

Anyone can enter freely without asking for permission. This is the default state and is also automatically restored when the room becomes empty.

🟡 Private Mode

The room becomes private, but users already inside are not kicked out.

Players outside the room must knock on the door. The current room owner can accept or decline the request. If accepted, the player is automatically allowed back inside.

🔴 Closed Mode

The room becomes fully closed and anonymous.

Nobody outside can enter, knock, or disturb the users inside. The room hides the real player names of the users inside and displays them as anonymous occupants instead, so people can still know the room is occupied without seeing who is inside.

👑 Room King System

The first player who enters the room becomes the Room King.

The Room King is the only player allowed to control important room actions:

• Change the room mode: Open, Private, or Closed
• Rename the room
• Publish room messages
• Accept or decline door knocks
• Toggle anonymous/unknown mode
• Kick players from the room
• Manage room access behavior during the session

If the Room King leaves, the next player inside automatically becomes the new Room King. This keeps the room functional without needing a fixed admin or manual reset.

The player list can also display a crown marker using the {king} format token, making it easy to see who currently owns the room.

👥 Player List, Whitelist & Kick System

Private Rooms includes a configurable player list system that can show users currently inside the room.

The display format is customizable and supports tokens such as:

• {king} — shows the crown/owner marker
• {device} — shows Desktop or VR label
• {id} — shows the player ID
• {username} — shows the player name
• {separator} — custom separator between values

Default example:

👑 [VR] | [1] | PlayerName

You can also configure the Desktop label, VR label, separator, and colors directly from the inspector.

The kick system works by synchronized player ID, not just username, so it is safer when multiple users have similar or identical display names.

✊ Door Knock System

When a room is in Private Mode, outside users can knock on the door.

The Room King receives the knock request and can choose to accept or decline it. If accepted, the user is automatically allowed into the room. If declined, the user remains outside.

This is useful for private conversations, small group rooms, VIP areas, and controlled-entry spaces.

💬 Room Message System

Each room can publish a synchronized custom message.

The Room King can write a message using a TextMeshPro input field and publish it to multiple TextMeshPro outputs at once. This can be used for room status, announcements, rules, availability messages, or anything the room owner wants to display.

The system includes a configurable cooldown, set to 60 seconds by default, to help prevent message spam.

When the room becomes empty, the room message can be automatically cleared and hidden.

📝 Room Name System

Rooms can have a custom synchronized name.

The room name can be configured from the inspector and can also be changed at runtime using an input field and publish button. Like the message system, the room name can update multiple TextMeshPro outputs at the same time.

A cooldown can be used to prevent users from rapidly changing the room name.

🕵️ Anonymous / Unknown Mode

Private Rooms includes an anonymous display mode.

When enabled, the room can hide real player identities from public display. This is especially useful for private social spaces where users want privacy while still showing that the room is occupied.

In Closed Mode, anonymous behavior is forced on, and the unknown toggle is locked so the room remains private.

📹 Video Call UI Support

The system includes configurable video call UI controls.

You can assign video-related buttons or tabs to the VideoChat Eyelash array. When the room is in Closed Mode, those buttons become non-interactable, preventing outside interaction with video call UI elements.

In Open and Private modes, those buttons can remain interactable.

🔊 Optional VoiceZone Integration

Private Rooms can optionally integrate with Parrot’s Conch VoiceZones.

When VoiceZones is installed, you can assign VoiceZone UdonBehaviours directly. The room can automatically enable or disable the assigned voice zones depending on the call/room state.

No VoiceCore reference is required on the RoomCore itself for normal VoiceZone toggling.

The editor also includes validation tools to help check whether a VoiceCore exists in the scene and can help instantiate the VoiceCore prefab when needed.

📋 Activity Log

The system includes a configurable TextMeshPro activity log.

You can display important room events such as:

• User changed the room to Open
• User changed the room to Private
• User changed the room to Closed
• User published a room message
• User changed the room name
• User knocked on the door
• User was accepted or declined
• User kicked another player
• Room reset because it became empty

Log messages are configurable, and colors can be adjusted for user names, targets, timestamps, and message text.

🔄 Automatic Room Reset

When the room becomes empty, the system automatically resets itself.

It returns to Open Mode, clears temporary states, resets the room owner, clears knock/kick data, resets room messages, disables temporary call states, and restores the room to a clean default state.

This keeps rooms reusable without needing manual cleanup.

🧩 Designed For

Private Rooms is great for:

• Private rooms
• Club VIP rooms
• Staff-only rooms
• Couple rooms
• RP rooms
• Event spaces
• Meeting rooms
• Interview rooms
• Chill zones
• Social world privacy systems
• Rooms that need controlled entry and anonymous occupancy

⚙️ Setup

Drag the included prefab into your world, assign the required TextMeshPro references, buttons, door colliders, room zone triggers, teleport points, and optional VoiceZone references.

After setup, the system can manage room state, access permissions, player lists, door knocking, room messages, and ownership flow automatically.

✅ What You Get

• Open / Private / Closed room modes
• Room King ownership system
• Door knock request system
• Accept / decline entry flow
• Anonymous room display
• Player list formatting
• Whitelist and kick controls
• Synchronized room name
• Synchronized room message
• Activity log output
• Door collider control
• Video call UI button control
• Optional VoiceZone support
• Auto reset when room is empty
• Configurable TextMeshPro outputs
• Configurable inspector messages and colors

🤖 AI-Assisted Content Disclaimer

This product was fully conceptualized and designed by Parrot’s Conch.

The original product idea, feature planning, permission structure, pseudocode, and core code matrix were created by the human developer behind Parrot’s Conch.

This product was developed in part with AI assistance. AI tools were used to assist with portions of coding, artwork, logos, promotional text, tutorials, documentation, and other development-related assets.

Testing, review, functionality checks, editing decisions, final configuration, product preparation, and packaging were completed by the human developer behind Parrot’s Conch.

Final files were reviewed, edited, configured, tested, and packaged by Parrot’s Conch.

🛠️ Notes

This system is designed for world-level room privacy, access flow, and social control features. It is ideal for creators who want polished private rooms without building a full custom permission system from scratch.

Private Rooms gives users a clear room experience: Your room. Your rules. Your privacy.