import { Badge } from "@/components/ui/badge"; import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card"; import { Button } from "@/components/ui/button"; import { Gamepad2, Code2, Rocket, ExternalLink, CheckCircle2, AlertTriangle, Package } from "lucide-react"; import { CodeBlock } from "@/components/dev-platform/ui/CodeBlock"; export default function RecRoomIntegration() { return (
RecRoom Integration

Build RecRoom Experiences with AeThex

Create cross-platform social games for RecRoom's 3M+ monthly active users. Use AeThex's unified API with RecRoom Circuits for visual scripting, data persistence, and multi-platform deployment.

{/* Quick Stats */}
3M+
Monthly Active Users
12M+
Created Rooms
VR + Mobile
Cross-Platform
{/* Features */}

What You Can Build

Persistent Game State Save player inventory, room configurations, and game progress that persists across VR and mobile sessions Unified Leaderboards Track scores across RecRoom, Roblox, and web platforms with AeThex's cross-platform leaderboard API Circuit Automation Connect RecRoom Circuits to AeThex webhooks for real-time events, triggers, and automated game logic Social Features Link RecRoom profiles to AeThex Passport for friend lists, parties, and social features across platforms
{/* Quick Start */}

Quick Start Guide

1. Install AeThex Circuits Plugin Add AeThex API chips to your RecRoom Circuits palette

In RecRoom's Maker Pen, search for AeThex in the Circuits V2 palette to find pre-built API chips.

Available Chips:

  • AeThex API Call - Make HTTP requests to AeThex endpoints
  • AeThex Auth - Authenticate RecRoom players
  • AeThex Save Data - Persist player data
  • AeThex Leaderboard - Fetch/update leaderboard scores
2. Configure API Credentials Get your API key from the AeThex Developer Dashboard
  1. 1. Visit AeThex Developer Dashboard
  2. 2. Create new API key with recroom:read and recroom:write scopes
  3. 3. Copy API key to your RecRoom room's configuration chip

Security: Never display your API key in-room. Use the AeThex Config chip which stores credentials securely.

3. Build Your First Circuit Create a persistent leaderboard that syncs across platforms

Connect the following chips in RecRoom Circuits V2:

Button
AeThex Auth
AeThex Auth
Player ID
Player ID
Get Score
Get Score
Text Screen

This circuit fetches a player's score from AeThex when they press a button, displaying it on a text screen. Scores are shared across RecRoom, Roblox, VRChat, and web platforms.

{/* Code Examples */}

API Integration Examples

Save Player Progress Persist inventory and game state across sessions { const { playerId, inventory, level, checkpoint } = req.body; // Save to AeThex backend await aethex.users.update(playerId, { recroom_inventory: inventory, recroom_level: level, recroom_checkpoint: checkpoint, last_played_recroom: new Date().toISOString() }); res.json({ success: true, saved_at: new Date() }); }); // Load player progress when they join app.get('/api/recroom/load-progress/:playerId', async (req, res) => { const { playerId } = req.params; const userData = await aethex.users.get(playerId); res.json({ inventory: userData.recroom_inventory || [], level: userData.recroom_level || 1, checkpoint: userData.recroom_checkpoint || 'start' }); });`} language="javascript" showLineNumbers={true} /> Cross-Platform Leaderboard Update scores that sync across RecRoom, Roblox, and web entry.userId === playerId) + 1, topPlayers: leaderboard }); } catch (error) { res.status(500).json({ error: error.message }); } }`} language="typescript" showLineNumbers={true} />
{/* Authentication Flow */}

Player Authentication

Link RecRoom players to AeThex Passport for cross-platform identity.

3-Step Auth Flow
1

Player Enters Room

Use RecRoom Circuits to detect player join event

2

Generate Auth Code

AeThex API Call chip requests 6-digit code, displays it on a text board in-room

POST /api/auth/generate-code
→ Returns: {`{ code: "ABC123", expires: "2026-01-10T21:00:00Z" }`}
3

Player Links Account

Player visits aethex.dev/link, enters code, RecRoom receives webhook with Passport ID

{/* Best Practices */}

Best Practices & Limitations

RecRoom Circuits Limitations

No native HTTP chips: Use AeThex middleware webhooks instead of direct API calls

Response delays: Webhook roundtrips take 1-3 seconds, design UX accordingly

Circuit complexity: Max 200 chips per room, optimize with cloud functions

Mobile performance: Keep API payloads under 50KB for mobile players

Performance Optimization

Cache results: Store API responses in room variables for 5-10 minutes

Batch operations: Group multiple player updates into single API call

Lazy loading: Only fetch data when players interact with features

Offline mode: Implement fallback gameplay when webhooks fail

{/* Resources */}

Resources & Examples

Example Rooms Documentation
{/* Next Steps */}

Ready to Build?

Start building cross-platform social games with AeThex. Deploy to RecRoom, VRChat, Roblox, and web simultaneously with one unified API.

); }