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.

Register reflection reference and OpenPaaS runtime infrastructure

yhh7fdb84f362c6
diff --git a/desktop b/desktop
index e69f4b736..447a077b5 160000
--- a/desktop
+++ b/desktop
@@ -1 +1 @@
-Subproject commit e69f4b736529099cd50b3294c9f38b7919feae51
+Subproject commit 447a077b58c0f86f36eda78a5530791674695d03
diff --git a/docs/astro/src/data/componentDocs.ts b/docs/astro/src/data/componentDocs.ts
index 99180ff67..30596d03c 100644
--- a/docs/astro/src/data/componentDocs.ts
+++ b/docs/astro/src/data/componentDocs.ts
@@ -86,6 +86,7 @@ export const COMPONENT_DOCS: Record<string, ComponentDoc> = {
SortingGroup: { category: 'graphics', summary: 'Makes an entity and its whole subtree sort as one unit — the group states the layer and order, members state their place inside it.', doc: 'graphics/sprites', anchor: 'sorting-groups', anchorZh: '排序组' },
LODGroup: { category: 'graphics', summary: 'Cheaper stand-in meshes for a MeshRenderer, chosen by how much of the screen the object covers.', doc: 'performance/level-of-detail', anchor: 'the-lodgroup-component', anchorZh: 'lodgroup-组件' },
ReflectionProbe: { category: 'graphics', summary: 'A box inside which reflections come from a bake rather than from the sky — the specular half of what a light probe volume answers.', doc: 'graphics/lighting', anchor: 'baked-light', anchorZh: '烘焙光照' },
+ PlanarReflection: { category: 'graphics', summary: 'Captures a mirrored view for flat lit surfaces, with layer filtering, capture quality and update controls.', doc: 'graphics/lighting' },
Occluder: { category: 'graphics', summary: 'A box sight does not pass through — what stands behind it is not collected, and the picture is unchanged.', doc: 'performance/occlusion-culling', anchor: 'the-box-is-authored-and-it-belongs-inside-the-wall', anchorZh: '盒子是创作出来的而且它要在墙的里面' },
Video: { category: 'graphics', summary: 'Plays a video stream onto a surface in the world or the UI.', doc: 'graphics/video', anchor: 'the-video-component', anchorZh: 'video-组件' },
diff --git a/docs/astro/src/data/components.generated.json b/docs/astro/src/data/components.generated.json
index 8f5980dae..051a2cb58 100644
--- a/docs/astro/src/data/components.generated.json
+++ b/docs/astro/src/data/components.generated.json
@@ -3370,6 +3370,85 @@
"fields": [],
"tag": true
},
+ {
+ "name": "PlanarReflection",
+ "source": "cpp",
+ "fields": [
+ {
+ "key": "axis",
+ "type": "enum",
+ "default": "Y",
+ "doc": "Local normal axis, transformed with the entity. Y for a floor, Z for a mirror.",
+ "values": [
+ "X",
+ "Y",
+ "Z"
+ ]
+ },
+ {
+ "key": "clipOffset",
+ "type": "number",
+ "default": "0.02",
+ "doc": "Clip offset in world units; excludes geometry behind the reflecting plane.",
+ "range": "≥ 0, step 0.005"
+ },
+ {
+ "key": "cullingMask",
+ "type": "number",
+ "default": "4294967295",
+ "doc": "Sorting-layer bits captured by the reflection. The receiving surface and screen UI are excluded."
+ },
+ {
+ "key": "quality",
+ "type": "enum",
+ "default": "Project",
+ "values": [
+ "Project",
+ "Custom"
+ ]
+ },
+ {
+ "key": "resolutionScale",
+ "type": "number",
+ "default": "0.5",
+ "range": "0.125–1, step 0.125"
+ },
+ {
+ "key": "maxSize",
+ "type": "number",
+ "default": "1024",
+ "range": "64–4096, step 64"
+ },
+ {
+ "key": "update",
+ "type": "enum",
+ "default": "EveryFrame",
+ "doc": "Only the reflection capture; never limits the main scene frame rate.",
+ "values": [
+ "EveryFrame",
+ "FixedRate",
+ "OnDemand"
+ ]
+ },
+ {
+ "key": "updatesPerSecond",
+ "type": "number",
+ "default": "30",
+ "range": "1–120"
+ },
+ {
+ "key": "revision",
+ "type": "number",
+ "default": "0",
+ "advanced": true
+ },
+ {
+ "key": "enabled",
+ "type": "boolean",
+ "default": "true"
+ }
+ ]
+ },
{
"name": "PointJoint3D",
"source": "ts",
diff --git a/tools/apiSubsystems.mjs b/tools/apiSubsystems.mjs
index a0b13be78..96c7d6bdb 100644
--- a/tools/apiSubsystems.mjs
+++ b/tools/apiSubsystems.mjs
@@ -30,6 +30,7 @@ export const INFRASTRUCTURE = {
diagnostics: 'the engine reporting on itself — a census and a stats overlay, read by tooling',
document: 'document-model diagnostics shared with the editor, not part of a game',
platform: 'the PlatformAdapter implementations; a game meets these through the subsystems above',
+ openpaas: 'the SUD runtime-profile entry used by the exported boot script; game systems use the shared subsystems',
runtime: 'how an exported project boots — the loader and app factory the pipeline emits',
sideModules: 'fetching and caching the optional wasm modules the subsystems above sit on',
util: 'small shared helpers with no subsystem of their own',