urth-inc · akriaueno · Feb 4, 2026 · Jan 26, 2026 · Jan 26, 2026 · Jan 26, 2026
diff --git a/CustomExitScreen/.gitignore b/CustomExitScreen/.gitignore
@@ -0,0 +1,32 @@
+# Build output
+dist/
+build/
+
+# Dependencies
+node_modules/
+
+# Environment
+.uuid.env
+
+# Module Federation temp
+.__mf__temp/
+__mf__temp/
+
+# Editor
+.vscode/
+.idea/
+*.iml
+*.sublime-project
+*.sublime-workspace
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+
+# Logs
+*.log*
+
+# Coverage
+coverage/
diff --git a/CustomExitScreen/README.md b/CustomExitScreen/README.md
@@ -0,0 +1,93 @@
+# CustomExitScreen
+
+A plugin template for customizing the metatell exit screen.
+
+## Requirements
+
+- Node 24+
+
+## Development
+
+```bash
+npm install
+npm run dev
+```
+
+The dev server runs at `http://localhost:5173`.
+
+## Build
+
+```bash
+npm run build
+```
+
+The Module Federation manifest is output to `dist/mf-manifest.json`.
+
+## Plugin type
+
+```
+CustomExitScreen
+```
+
+## Supported reasons
+
+| reason | description | trigger |
+|--------|-------------|---------|
+| `exited` | Exit (fallback) | Default value of `exitScene()` |
+| `left` | Exit | When `leave_room_requested` fires from the in-world UI |
+| `closed` | Room closed | When the host closes the room |
+| `denied` | Access denied | When the user has no entry permission |
+| `kicked` | Kicked | When the host kicks the user |
+| `connectError` | Connection error | When the server connection fails |
+| `sceneError` | Scene error | When the 3D scene fails to load |
+
+## Props
+
+```ts
+export type CustomExitScreenProps = {
+  reason:
+    | "exited"
+    | "closed"
+    | "denied"
+    | "kicked"
+    | "left"
+    | "connectError"
+    | "sceneError";
+  contentByReason: Record<
+    CustomExitScreenProps["reason"],
+    {
+      title: string;
+      message: string;
+      buttonLabel: string;
+      buttonUrl?: string;
+    }
+  >;
+  onPrimaryAction: () => void;
+  logoUrl?: string;
+};
+```
+
+## Module Federation metadata
+
+```ts
+export const mfMeta = {
+  type: "CustomExitScreen",
+  contractVersion: 1,
+  supportedReasons: [
+    "exited",
+    "closed",
+    "denied",
+    "kicked",
+    "left",
+    "connectError",
+    "sceneError"
+  ] as const
+};
+```
+
+## Notes
+
+- `.uuid.env` contains `VERSION_ID` and `VITE_VERSION_ID` generated by `npm run set-uuid`.
+- The host loads `CustomExitScreen` via the Module Federation runtime.
+- `exited` and `left` show the same message. `exited` is a fallback, and `left` is used in normal cases.
+- The 2D "Leave" button usually navigates to the root from `LeaveRoomModal`, so it does not go through `ExitedRoomScreen`.
diff --git a/CustomExitScreen/index.html b/CustomExitScreen/index.html
@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>CustomExitScreen</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>