Rooms & Scheduling
Configure your escape rooms, set up recurring schedules, and manage availability. Everything here can be done via the admin panel or through MCP with your AI assistant.
Rooms
Rooms are the core entity in HyperXI. Each room represents a single escape room experience with its own theme, difficulty, pricing, and player limits. Manage rooms at /admin/rooms.
Creating a room
When creating a room, you configure the following fields:
- Name -- Displayed to customers on the booking page
- Description -- Theme, storyline, and what to expect
- Difficulty -- One of: easy, medium, hard, expert
- Duration -- Length of the experience in minutes (e.g., 60, 75, 90)
- Min/Max players -- The allowed range of participants per booking
- Active status -- Inactive rooms are hidden from the booking page
Pricing models
HyperXI supports three pricing models per room:
Flat rate
One price for the whole group regardless of size. Example: $120 per session.
Per-person
Price multiplied by number of players. Example: $30 per person.
Tiered
Different prices based on group size. Example: $35/person for 2-4 players, $30/person for 5-8 players.
MCP Prompt
"Create a new room called "Wizard's Tower". It's a hard difficulty room, 75 minutes, 2-6 players, per-person pricing at $35."
Schedule Templates
Schedule templates define recurring weekly patterns for when rooms are available. Instead of manually creating individual time slots, you define templates and HyperXI generates the concrete bookable slots automatically.
How templates work
Each template specifies:
- Room -- Which room this schedule applies to
- Day of week -- Monday through Sunday
- Start time -- When the session begins (in the location's timezone)
- Capacity -- Number of concurrent bookings for this slot (typically 1 for escape rooms)
A typical escape room might have 3-5 templates per day: morning, midday, and afternoon sessions on weekdays, with additional evening sessions on weekends.
Monday-Friday:
10:00 AM - Wizard's Tower (capacity: 1)
12:00 PM - Wizard's Tower (capacity: 1)
2:00 PM - Wizard's Tower (capacity: 1)
4:00 PM - Wizard's Tower (capacity: 1)
Saturday-Sunday:
10:00 AM - Wizard's Tower (capacity: 1)
12:00 PM - Wizard's Tower (capacity: 1)
2:00 PM - Wizard's Tower (capacity: 1)
4:00 PM - Wizard's Tower (capacity: 1)
6:00 PM - Wizard's Tower (capacity: 1)
8:00 PM - Wizard's Tower (capacity: 1)MCP Prompt
"Create schedule templates for Wizard's Tower: weekdays at 10am, 12pm, 2pm, and 4pm. Weekends add 6pm and 8pm sessions."
Slot Generation
Templates are patterns -- they don't directly create bookable inventory. HyperXI generates concrete time slots from your templates using a 30-day rolling window.
Automatic generation
Every day at 2:00 AM (in your location's timezone), HyperXI automatically generates slots for the 30th day out. This ensures your booking calendar always has 30 days of availability without manual intervention.
Manual generation
You can trigger slot generation manually via the admin panel at /admin/schedule or through MCP. This is useful when you first set up templates or make changes to existing ones.
MCP Prompt
"Generate schedule slots for the next 30 days for all rooms."
Schedule Overrides
Overrides let you modify the auto-generated schedule for specific dates without changing the underlying templates. There are four types:
Blackout (Holiday closures)
Block all slots for a room on a specific date. Existing bookings are not automatically cancelled -- you must handle those separately.
Modify (Special events)
Change the time or capacity of a specific slot. Useful for private events where you want to change the available capacity.
Add (Extra sessions)
Create additional slots on dates that are not part of the regular template. Useful for adding a late-night session on a holiday or running a special weekend event.
Remove (Individual cancellations)
Remove a specific slot on a specific date. Unlike a blackout, this only affects a single time slot rather than the entire day.
MCP Prompt
"Block all slots for Christmas Day (December 25) across all rooms."
MCP Prompt
"Add a late-night session for Prison Break on New Year's Eve at 10pm with capacity 1."
DST Handling
Daylight Saving Time transitions are handled automatically based on your location's timezone. No manual intervention is required.
Spring forward
When clocks jump from 2:00 AM to 3:00 AM, any slot scheduled during the skipped hour (e.g., 2:30 AM) is automatically omitted. No gap or broken slot is created.
Fall back
When clocks fall back from 2:00 AM to 1:00 AM, slots during the ambiguous hour use the first occurrence (before the transition). Only one slot is generated, not two.
Managing via MCP
Every operation in this guide can be performed through natural language with your AI assistant. Here are common prompts:
MCP Prompt
"List all my rooms with their current pricing."
MCP Prompt
"Update Prison Break to per-person pricing at $28 and change max players to 10."
MCP Prompt
"Show me the schedule templates for Wizard's Tower."
MCP Prompt
"What slots are available for this Saturday across all rooms?"
MCP Prompt
"Remove the 4pm slot for Wizard's Tower next Tuesday -- we have a private event."