🏠 Room Management Guide

Complete guide to creating, managing, and using rooms

📋 Room Types and Capacities

👥 Room Capacity

  • Minimum: 2 users per room
  • Maximum: 5,000 users per room
  • Recommended: 10-50 users for optimal performance

🖥️ Server Capacity

  • Total Users: Up to 1,000 concurrent users per server
  • Multiple Rooms: Users distributed across rooms
  • Load Balancing: Automatic optimization

🔗 Connection Limits

  • Per IP: 2-5 simultaneous connections
  • Configurable: Server admins can adjust limits
  • Abuse Prevention: Automatic rate limiting

🌐 Public Rooms

Open to anyone with the room ID

  • No password required
  • Visible in server room list
  • Easy to join and share
  • Great for community gatherings

Example: Use a public room for a lobby, music room, or weekly event where you want new visitors to find it quickly.

🔒 Private Rooms

Password-protected for invited users only

  • Requires password to join
  • Hidden from public room lists
  • Enhanced security
  • Perfect for team meetings

Example: Use a private room for moderator review, server-owner planning, or a support call where only invited people should enter.

⏰ Timed Rooms

Automatically expire after set duration

  • 1 hour, 2 hours, 6 hours
  • 30 days, 69 days
  • Lifetime (permanent)
  • Auto-cleanup for temporary events

Example: Use a timed room for a one-night radio show, a study session, or a temporary event support channel.

🎭 Persistent Rooms

Rooms that users can return to later

  • Retain room settings
  • Remember user positions
  • Bookmark for easy return
  • Great for ongoing projects

Example: Use a persistent room for your regular Chill Zone, a staff room, or a long-running community hangout that people expect to see every day.

🔐 Locking, Recording, and Access

Rooms can stay open, be locked temporarily, or require a password or PIN depending on how much control you need.

  • Lock a room when you want current listeners to stay but you do not want new people joining. Example: lock a room after a support session starts so late arrivals do not interrupt.
  • Use a PIN or password when you still want people to join, but only if they know the room secret. Example: give event staff a PIN for a backstage room.
  • Allow or disable recording per room when the room purpose changes. Example: allow recording for a training session, but disable it in a casual community room.
  • Use allow and deny lists when a room should only be visible to certain members. Example: keep a project room available to one team without showing it to guests.

✨ Creating Rooms

Step-by-Step Room Creation

1

Access Creation Menu

  • Click "Create New Room" from main menu
  • Or use keyboard shortcut: Ctrl+N (Cmd+N on Mac)
2

Basic Room Information

  • Room Name: Choose a descriptive name (max 50 characters)
  • Description: Optional details about the room purpose
  • Room ID: Automatically generated 6-character code
3

Privacy Settings

🌐 Public Room
  • Leave password field empty
  • Room appears in server listing
  • Anyone can join with room ID
🔒 Private Room
  • Set a strong password (8+ characters)
  • Hidden from public listings
  • Share password with invited users
4

Capacity Configuration

Maximum Users
Room Size Max Users Best For
Small 2-10 Private conversations, team meetings
Medium 11-50 Group discussions, small events
Large 51-250 Community gatherings, presentations
Massive 251-1000 Conferences, large events
Maximum 1001-5000 Major broadcasts, conventions
5

Duration Settings

⚡ Quick Sessions
  • 1 Hour: Short meetings, quick chats
  • 2 Hours: Extended discussions
  • 6 Hours: Workshops, study sessions
📅 Extended Periods
  • 30 Days: Monthly projects, events
  • 69 Days: Semester-long activities
  • Lifetime: Permanent community spaces
6

Advanced Settings

Audio Configuration
  • 3D Audio: Enable spatial positioning
  • Audio Quality: Choose bitrate (64kbps - 320kbps)
  • Noise Gate: Automatic background noise removal
  • Echo Cancellation: Prevent audio feedback
Moderation Settings
  • Host Privileges: Room creator gets admin rights
  • Moderator Assignment: Delegate management to trusted users
  • Auto-moderation: Enable spam and abuse filters
  • Join Approval: Manually approve new participants
Media Features
  • Media Sharing: Allow users to stream music
  • Jellyfin Integration: Connect to media servers
  • PA System: Enable announcements
  • Recording: Allow session recording (if supported)

💡 Creation Tips

🎯 Choose Appropriate Capacity

Set max users based on expected attendance. Smaller limits improve performance.

🔐 Security Best Practices

Use strong passwords for private rooms. Consider who you share room IDs with.

⏰ Duration Planning

Choose duration based on room purpose. Use timed rooms for temporary events.

📝 Clear Naming

Use descriptive room names that indicate purpose and expected duration.

🚪 Joining and Leaving Rooms

Ways to Join Rooms

🆔 Direct Room ID Entry

  1. Click "Join Existing Room"
  2. Enter the 6-character Room ID
  3. Enter your display name for this room
  4. Enter password if required
  5. Click "Join Room"
Example Room ID: ABC123

📋 Room List Browser

  1. View "Available Rooms" on main menu
  2. Browse public rooms on the server
  3. Click on a room to see details
  4. Click "Join" to enter

🔗 Direct Links

Room creators can generate shareable links:

https://your-server.com/join/ABC123
voicelink://join/ABC123 (desktop app)

🔖 Bookmarked Rooms

  1. Save frequently visited rooms as bookmarks
  2. Access from "My Bookmarks" menu
  3. One-click rejoining

Room States and Persistence

🟢 Active Rooms

  • Currently has users present
  • All features fully available
  • Real-time communication active

🟡 Dormant Rooms

  • No users currently present
  • Settings and history preserved
  • Can be rejoined anytime

🔴 Expired Rooms

  • Duration limit reached
  • No longer accessible
  • Data automatically cleaned up

💾 Persistent Rooms

  • Permanent or very long duration
  • Maintain user preferences
  • Remember 3D positions

Leaving and Returning to Rooms

🚪 Ways to Leave

  • Leave Button: Click door icon in room header
  • Keyboard Shortcut: Ctrl+Q or Cmd+Q
  • Close App: Automatically leaves all rooms
  • Network Disconnect: Automatic graceful disconnect

🔄 Returning to Rooms

Same Session Return
  • Room ID remains in recent history
  • Rejoin with saved settings
  • Restore previous 3D position
Later Date Return
  • Use bookmarked rooms for easy access
  • Room must not have expired
  • Settings preserved for persistent rooms
Different Device Return
  • Sign in with same account
  • Bookmarks sync across devices
  • User settings carried over

⚙️ Managing Your Rooms

🎩 Host Controls

As the room creator, you have additional management capabilities:

👥 User Management

  • Kick Users: Remove disruptive participants
  • Ban Users: Prevent rejoining
  • Mute Users: Temporarily silence someone
  • Assign Moderators: Delegate management tasks
  • Transfer Host: Pass room ownership

🔧 Room Settings

  • Change Password: Update room security
  • Modify Capacity: Increase or decrease max users
  • Update Duration: Extend or shorten room lifetime
  • Toggle Features: Enable/disable media sharing, etc.

📊 Room Statistics

  • User Count: Current and peak participants
  • Connection Quality: Network performance metrics
  • Duration Stats: Time remaining, uptime
  • Activity Log: Join/leave events

🎵 Media Control

  • Global Audio: Control room-wide audio
  • Stream Permissions: Who can share media
  • Volume Limits: Set maximum volume levels
  • Audio Quality: Adjust streaming bitrates

🛡️ Moderation Tools

User Actions

Action Effect Duration Access
Warn Send warning message Instant Host, Moderator
Mute Disable microphone Temporary Host, Moderator
Kick Remove from room Can rejoin Host, Moderator
Ban Permanent removal Cannot rejoin Host only

🤖 Automated Moderation

  • Spam Detection: Automatic filtering of repetitive messages
  • Volume Limiting: Prevent extremely loud audio
  • Connection Monitoring: Detect and handle poor connections
  • Abuse Prevention: Rate limiting and behavior analysis

🌟 Best Practices

🏗️ Room Planning

  • Purpose-Driven Design: Set capacity and duration based on intended use
  • Clear Expectations: Communicate room rules and purpose to participants
  • Backup Plans: Have alternative rooms ready for large events
  • Testing: Test room settings before important meetings

🔐 Security Guidelines

  • Strong Passwords: Use complex passwords for private rooms
  • Limited Sharing: Only share room details with intended participants
  • Regular Updates: Change passwords periodically for long-term rooms
  • Moderation: Assign trusted moderators for large rooms

⚡ Performance Tips

  • Appropriate Sizing: Don't over-provision room capacity
  • Quality Settings: Balance audio quality with performance
  • Feature Management: Disable unused features for better performance
  • Network Considerations: Monitor bandwidth usage in large rooms

👥 Community Building

  • Welcoming Environment: Greet new participants
  • Clear Communication: Establish speaking order and etiquette
  • Inclusive Design: Consider accessibility needs
  • Feedback Collection: Gather input on room improvements

🔧 Common Issues and Solutions

❌ Cannot Create Room

Possible Causes:

  • Server at capacity (1000 user limit reached)
  • IP connection limit exceeded
  • Insufficient permissions
  • Network connectivity issues

Solutions:

  • Try again later when server load is lower
  • Check internet connection
  • Contact server administrator
  • Try a different server

🚫 Room Not Found

Possible Causes:

  • Incorrect room ID entered
  • Room has expired
  • Room is on different server
  • Private room with wrong password

Solutions:

  • Double-check room ID spelling
  • Verify you're on correct server
  • Contact room creator for current details
  • Check if room duration has expired

⏰ Room Expired Unexpectedly

Possible Causes:

  • Duration limit reached
  • Server maintenance
  • Host deleted room
  • System cleanup performed

Solutions:

  • Create new room with longer duration
  • Contact server administrator
  • Use lifetime rooms for permanent spaces
  • Set up automatic room recreation