Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

feat(editor): surface play-realm status in-viewport + UE5 play-mode dropdown

esengine9a42aabb5ec7
diff --git a/desktop/src/layout/Toolbar.tsx b/desktop/src/layout/Toolbar.tsx
index 055c40bed..21402db6c 100644
--- a/desktop/src/layout/Toolbar.tsx
+++ b/desktop/src/layout/Toolbar.tsx
@@ -1,4 +1,4 @@
-import { useSyncExternalStore } from 'react';
+import { useState, useSyncExternalStore } from 'react';
import {
Save,
Undo2,
@@ -16,9 +16,11 @@ import {
Hammer,
Monitor,
AppWindow,
+ ChevronDown,
type LucideIcon,
} from 'lucide-react';
import { useEditorStore } from '@/store/editorStore';
+import { ContextMenu } from '@/components/Menu';
import { EditorHistory } from '@/engine/EditorHistory';
import { commands, formatKeybinding } from '@/commands';
import type { ToolMode } from '@/types';
@@ -69,6 +71,7 @@ export function Toolbar() {
// command registry so menu, toolbar, and keyboard share one implementation.
const playTarget = useEditorStore((s) => s.playTarget);
const setPlayTarget = useEditorStore((s) => s.setPlayTarget);
+ const [modeMenu, setModeMenu] = useState<{ x: number; y: number } | null>(null);
const { tool, snapping, showGrid, showGizmos, isPlaying, isPaused, togglePause, stop } =
useEditorStore();
@@ -147,13 +150,28 @@ export function Toolbar() {
<button
type="button"
className="play-side play-mode"
- title={`Play in ${playTarget === 'viewport' ? 'Viewport' : 'New Window'} — click to switch`}
+ title={`Play in ${playTarget === 'viewport' ? 'Viewport' : 'New Window'}`}
disabled={isPlaying}
- onClick={() => setPlayTarget(playTarget === 'viewport' ? 'window' : 'viewport')}
+ onClick={(e) => {
+ const r = e.currentTarget.getBoundingClientRect();
+ setModeMenu((m) => (m ? null : { x: r.left, y: r.bottom + 4 }));
+ }}
>
{playTarget === 'viewport' ? <Monitor size={13} strokeWidth={1.9} /> : <AppWindow size={13} strokeWidth={1.9} />}
+ <ChevronDown size={11} strokeWidth={2} className="play-mode-cv" />
</button>
</div>
+ {modeMenu && (
+ <ContextMenu
+ x={modeMenu.x}
+ y={modeMenu.y}
+ onClose={() => setModeMenu(null)}
+ items={[
+ { label: 'Play In Viewport', checked: playTarget === 'viewport', onClick: () => setPlayTarget('viewport') },
+ { label: 'Play In New Window', checked: playTarget === 'window', onClick: () => setPlayTarget('window') },
+ ]}
+ />
+ )}
<span className="tspacer" />
diff --git a/desktop/src/panels/Viewport.tsx b/desktop/src/panels/Viewport.tsx
index e13fc91f4..4fc00648a 100644
--- a/desktop/src/panels/Viewport.tsx
+++ b/desktop/src/panels/Viewport.tsx
@@ -135,6 +135,7 @@ export function Viewport() {
const dragRef = useRef<Drag | null>(null);
const [zoomPct, setZoomPct] = useState(100);
const engine = useSyncExternalStore(EngineHost.subscribe, EngineHost.getSnapshot);
+ const realm = useSyncExternalStore(PlayRealm.subscribe, PlayRealm.getSnapshot);
// Sampled a few times a second (not per frame) — drives the corner HUD.
const stats = useSyncExternalStore(StatsStore.subscribe, StatsStore.getSnapshot);
@@ -415,6 +416,11 @@ export function Viewport() {
{playInViewport && (
<div className="viewport__play">
<div className="viewport__play-host" ref={playHostRef} />
+ {(!realm.ready || realm.error) && (
+ <div className={`viewport__play-status${realm.error ? ' error' : ''}`}>
+ {realm.error ? `Play failed: ${realm.error}` : 'Starting game…'}
+ </div>
+ )}
<button
type="button"
className="viewport__play-stop"
diff --git a/desktop/src/theme/chrome.css b/desktop/src/theme/chrome.css
index c2116c135..78b731944 100644
--- a/desktop/src/theme/chrome.css
+++ b/desktop/src/theme/chrome.css
@@ -95,6 +95,8 @@
.play-side { width: 28px; display: grid; place-items: center; background: var(--acc); color: rgba(255, 255, 255, 0.85); border-left: 1px solid rgba(0, 0, 0, 0.25); transition: background var(--t-fast); }
.play-side:hover { background: var(--acc-hi); }
.play-side:disabled { opacity: 0.45; pointer-events: none; }
+.play-mode { width: auto; padding: 0 6px; display: inline-flex; align-items: center; gap: 2px; }
+.play-mode .play-mode-cv { opacity: 0.6; }
.play-wrap.playing .play-main, .play-wrap.playing .play-side { background: var(--error); }
.play-wrap.playing .play-main:hover { background: #e36a6a; }
.play-wrap.paused .play-main, .play-wrap.paused .play-side { background: var(--warn); }
diff --git a/desktop/src/theme/viewport.css b/desktop/src/theme/viewport.css
index e32fd7ea1..b3529b88b 100644
--- a/desktop/src/theme/viewport.css
+++ b/desktop/src/theme/viewport.css
@@ -111,6 +111,18 @@
.viewport__play { position: absolute; inset: 0; z-index: 6; background: #0e121b; }
.viewport__play-host { position: absolute; inset: 0; }
.viewport__play-host iframe { width: 100%; height: 100%; border: 0; display: block; }
+.viewport__play-status {
+ position: absolute;
+ inset: 0;
+ display: grid;
+ place-items: center;
+ padding: 24px;
+ text-align: center;
+ font-size: var(--fs-sm);
+ color: var(--text-mute);
+ pointer-events: none;
+}
+.viewport__play-status.error { color: var(--error); font-family: var(--mono); font-size: var(--fs-xs); }
.viewport__play-stop {
position: absolute;
top: 10px;