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.
TypeScript 2d-game-engine3d3d-game-engineandroidcppecsgame-editorgame-enginegamedeviostypescriptwebassemblywebglwebgpuwechat-minigame
feat(editor): four more starters, so New Project is a choice
yhhf755c2f0918f
diff --git a/desktop/templates/2d-platformer/.gitignore b/desktop/templates/2d-platformer/.gitignorenew file mode 100644index 000000000..359472ac2--- /dev/null+++ b/desktop/templates/2d-platformer/.gitignore@@ -0,0 +1,7 @@+node_modules/+dist/+.vscode/+.idea/+.DS_Store+Thumbs.db+.esengine/cache/diff --git a/desktop/templates/2d-platformer/assets/prefabs/Coin.esprefab b/desktop/templates/2d-platformer/assets/prefabs/Coin.esprefabnew file mode 100644index 000000000..41f4104c0--- /dev/null+++ b/desktop/templates/2d-platformer/assets/prefabs/Coin.esprefab@@ -0,0 +1,21 @@+{+ "version": "2",+ "name": "Coin",+ "rootEntityId": "0",+ "entities": [+ {+ "prefabEntityId": "0",+ "name": "Coin",+ "parent": null,+ "children": [],+ "components": [+ { "type": "Transform", "data": { "position": { "x": 0, "y": 0, "z": 0 } } },+ { "type": "Sprite", "data": { "size": { "x": 24, "y": 24 }, "color": { "r": 1, "g": 0.85, "b": 0, "a": 1 }, "texture": "@uuid:c18959bd-f6be-49d3-945b-3d6ecf8ef14f" } },+ { "type": "Coin", "data": { "baseY": 0, "bobTimer": 0 } },+ { "type": "RigidBody", "data": { "bodyType": 0 } },+ { "type": "BoxCollider", "data": { "halfExtents": { "x": 0.12, "y": 0.12 }, "isSensor": true, "categoryBits": 2, "maskBits": 65535 } }+ ],+ "visible": true+ }+ ]+}diff --git a/desktop/templates/2d-platformer/assets/prefabs/Coin.esprefab.meta b/desktop/templates/2d-platformer/assets/prefabs/Coin.esprefab.metanew file mode 100644index 000000000..06d23ca6a--- /dev/null+++ b/desktop/templates/2d-platformer/assets/prefabs/Coin.esprefab.meta@@ -0,0 +1,8 @@+{+ "uuid": "57ad3eb0-4a0c-49b5-bfba-c98418989915",+ "version": "2.0",+ "type": "prefab",+ "importer": {+ "autoMigrate": true+ }+}diff --git a/desktop/templates/2d-platformer/assets/scenes/main.esscene b/desktop/templates/2d-platformer/assets/scenes/main.esscenenew file mode 100644index 000000000..458a22eba--- /dev/null+++ b/desktop/templates/2d-platformer/assets/scenes/main.esscene@@ -0,0 +1,743 @@+{+ "version": "1.0",+ "name": "Main",+ "folders": [+ "Environment",+ "Platforms",+ "Coins",+ "UI"+ ],+ "entities": [+ {+ "id": 0,+ "name": "Camera",+ "parent": null,+ "children": [],+ "components": [+ {+ "type": "Transform",+ "data": {+ "position": {+ "x": 0,+ "y": 0,+ "z": 10+ }+ }+ },+ {+ "type": "Camera",+ "data": {+ "projectionType": 1,+ "orthoSize": 350,+ "isActive": true,+ "priority": 0+ }+ }+ ],+ "visible": true+ },+ {+ "id": 13,+ "name": "Sky",+ "parent": null,+ "children": [],+ "folder": "Environment",+ "components": [+ {+ "type": "Transform",+ "data": {+ "position": {+ "x": 0,+ "y": 0,+ "z": 0+ }+ }+ },+ {+ "type": "Sprite",+ "data": {+ "size": {+ "x": 800,+ "y": 700+ },+ "texture": "@uuid:74b832b1-40ae-4095-a620-c027735cb482",+ "layer": -10+ }+ }+ ],+ "visible": true+ },+ {+ "id": 1,+ "name": "Ground",+ "parent": null,+ "children": [],+ "folder": "Environment",+ "components": [+ {+ "type": "Transform",+ "data": {+ "position": {+ "x": 0,+ "y": -250,+ "z": 0+ }+ }+ },+ {+ "type": "Sprite",+ "data": {+ "size": {+ "x": 800,+ "y": 40+ },+ "color": {+ "r": 0.4,+ "g": 0.7,+ "b": 0.3,+ "a": 1+ },+ "texture": "@uuid:931ebe66-cded-4b32-8444-0737da446c0d"+ }+ },+ {+ "type": "RigidBody",+ "data": {+ "bodyType": 0+ }+ },+ {+ "type": "BoxCollider",+ "data": {+ "halfExtents": {+ "x": 4,+ "y": 0.2+ },+ "categoryBits": 1,+ "maskBits": 65535+ }+ }+ ],+ "visible": true+ },+ {+ "id": 2,+ "name": "Platform1",+ "parent": null,+ "children": [],+ "folder": "Platforms",+ "components": [+ {+ "type": "Transform",+ "data": {+ "position": {+ "x": -200,+ "y": -120,+ "z": 0+ }+ }+ },+ {+ "type": "Sprite",+ "data": {+ "size": {+ "x": 160,+ "y": 24+ },+ "color": {+ "r": 0.6,+ "g": 0.5,+ "b": 0.3,+ "a": 1+ },+ "texture": "@uuid:0258e55e-9aa0-47eb-8092-7386e03f97c7"+ }+ },+ {+ "type": "RigidBody",+ "data": {+ "bodyType": 0+ }+ },+ {+ "type": "BoxCollider",+ "data": {+ "halfExtents": {+ "x": 0.8,+ "y": 0.12+ },+ "categoryBits": 1,+ "maskBits": 65535+ }+ }+ ],+ "visible": true+ },+ {+ "id": 3,+ "name": "Platform2",+ "parent": null,+ "children": [],+ "folder": "Platforms",+ "components": [+ {+ "type": "Transform",+ "data": {+ "position": {+ "x": 100,+ "y": -20,+ "z": 0+ }+ }+ },+ {+ "type": "Sprite",+ "data": {+ "size": {+ "x": 160,+ "y": 24+ },+ "color": {+ "r": 0.6,+ "g": 0.5,+ "b": 0.3,+ "a": 1+ },+ "texture": "@uuid:0258e55e-9aa0-47eb-8092-7386e03f97c7"+ }+ },+ {+ "type": "RigidBody",+ "data": {+ "bodyType": 0+ }+ },+ {+ "type": "BoxCollider",+ "data": {+ "halfExtents": {+ "x": 0.8,+ "y": 0.12+ },+ "categoryBits": 1,+ "maskBits": 65535+ }+ }+ ],+ "visible": true+ },+ {+ "id": 4,+ "name": "Platform3",+ "parent": null,+ "children": [],+ "folder": "Platforms",+ "components": [+ {+ "type": "Transform",+ "data": {+ "position": {+ "x": -80,+ "y": 100,+ "z": 0+ }+ }+ },+ {+ "type": "Sprite",+ "data": {+ "size": {+ "x": 200,+ "y": 24+ },+ "color": {+ "r": 0.6,+ "g": 0.5,+ "b": 0.3,+ "a": 1+ },+ "texture": "@uuid:0258e55e-9aa0-47eb-8092-7386e03f97c7"+ }+ },+ {+ "type": "RigidBody",+ "data": {+ "bodyType": 0+ }+ },+ {+ "type": "BoxCollider",+ "data": {+ "halfExtents": {+ "x": 1,+ "y": 0.12+ },+ "categoryBits": 1,+ "maskBits": 65535+ }+ }+ ],+ "visible": true+ },+ {+ "id": 5,+ "name": "Platform4",+ "parent": null,+ "children": [],+ "folder": "Platforms",+ "components": [+ {+ "type": "Transform",+ "data": {+ "position": {+ "x": 220,+ "y": 180,+ "z": 0+ }+ }+ },+ {+ "type": "Sprite",+ "data": {+ "size": {+ "x": 140,+ "y": 24+ },+ "color": {+ "r": 0.6,+ "g": 0.5,+ "b": 0.3,+ "a": 1+ },+ "texture": "@uuid:0258e55e-9aa0-47eb-8092-7386e03f97c7"+ }+ },+ {+ "type": "RigidBody",+ "data": {+ "bodyType": 0+ }+ },+ {+ "type": "BoxCollider",+ "data": {+ "halfExtents": {+ "x": 0.7,+ "y": 0.12+ },+ "categoryBits": 1,+ "maskBits": 65535+ }+ }+ ],+ "visible": true+ },+ {+ "id": 16,+ "name": "LeftWall",+ "parent": null,+ "children": [],+ "folder": "Environment",+ "components": [+ {+ "type": "Transform",+ "data": {+ "position": {+ "x": -420,+ "y": 0,+ "z": 0+ }+ }+ },+ {+ "type": "RigidBody",+ "data": {+ "bodyType": 0+ }+ },+ {+ "type": "BoxCollider",+ "data": {+ "halfExtents": {+ "x": 0.1,+ "y": 4+ },+ "categoryBits": 1,+ "maskBits": 65535+ }+ }+ ],+ "visible": true+ },+ {+ "id": 17,+ "name": "RightWall",+ "parent": null,+ "children": [],+ "folder": "Environment",+ "components": [+ {+ "type": "Transform",+ "data": {+ "position": {+ "x": 420,+ "y": 0,+ "z": 0+ }+ }+ },+ {+ "type": "RigidBody",+ "data": {+ "bodyType": 0+ }+ },+ {+ "type": "BoxCollider",+ "data": {+ "halfExtents": {+ "x": 0.1,+ "y": 4+ },+ "categoryBits": 1,+ "maskBits": 65535+ }+ }+ ],+ "visible": true+ },+ {+ "id": 6,+ "name": "Player",+ "parent": null,+ "children": [],+ "components": [+ {+ "type": "Transform",+ "data": {+ "position": {+ "x": -200,+ "y": -180,+ "z": 0+ }+ }+ },+ {+ "type": "Sprite",+ "data": {+ "size": {+ "x": 32,+ "y": 48+ },+ "color": {+ "r": 0.2,+ "g": 0.6,+ "b": 1,+ "a": 1+ },+ "texture": "@uuid:2bde6b7d-0dbe-4434-9e30-ed1cd8e3fe82",+ "layer": 1+ }+ },+ {+ "type": "Player",+ "data": {}+ },+ {+ "type": "RigidBody",+ "data": {+ "bodyType": 1+ }+ },+ {+ "type": "BoxCollider",+ "data": {+ "halfExtents": {+ "x": 0.16,+ "y": 0.24+ },+ "categoryBits": 1,+ "maskBits": 65535+ }+ },+ {+ "type": "CharacterController",+ "data": {+ "maskBits": 65533+ }+ }+ ],+ "visible": true+ },+ {+ "id": 7,+ "name": "Coin1",+ "parent": null,+ "folder": "Coins",+ "prefab": "@uuid:57ad3eb0-4a0c-49b5-bfba-c98418989915",+ "overrides": [+ {+ "prefabEntityId": "0",+ "type": "property",+ "componentType": "Transform",+ "propertyName": "position",+ "value": {+ "x": -200,+ "y": -80,+ "z": 0+ }+ },+ {+ "prefabEntityId": "0",+ "type": "property",+ "componentType": "Coin",+ "propertyName": "baseY",+ "value": -80+ }+ ],+ "added": [],+ "removed": []+ },+ {+ "id": 8,+ "name": "Coin2",+ "parent": null,+ "folder": "Coins",+ "prefab": "@uuid:57ad3eb0-4a0c-49b5-bfba-c98418989915",+ "overrides": [+ {+ "prefabEntityId": "0",+ "type": "property",+ "componentType": "Transform",+ "propertyName": "position",+ "value": {+ "x": 100,+ "y": 20,+ "z": 0+ }+ },+ {+ "prefabEntityId": "0",+ "type": "property",+ "componentType": "Coin",+ "propertyName": "baseY",+ "value": 20+ }+ ],+ "added": [],+ "removed": []+ },+ {+ "id": 9,+ "name": "Coin3",+ "parent": null,+ "folder": "Coins",+ "prefab": "@uuid:57ad3eb0-4a0c-49b5-bfba-c98418989915",+ "overrides": [+ {+ "prefabEntityId": "0",+ "type": "property",+ "componentType": "Transform",+ "propertyName": "position",+ "value": {+ "x": -80,+ "y": 140,+ "z": 0+ }+ },+ {+ "prefabEntityId": "0",+ "type": "property",+ "componentType": "Coin",+ "propertyName": "baseY",+ "value": 140+ }+ ],+ "added": [],+ "removed": []+ },+ {+ "id": 10,+ "name": "Coin4",+ "parent": null,+ "folder": "Coins",+ "prefab": "@uuid:57ad3eb0-4a0c-49b5-bfba-c98418989915",+ "overrides": [+ {+ "prefabEntityId": "0",+ "type": "property",+ "componentType": "Transform",+ "propertyName": "position",+ "value": {+ "x": 220,+ "y": 220,+ "z": 0+ }+ },+ {+ "prefabEntityId": "0",+ "type": "property",+ "componentType": "Coin",+ "propertyName": "baseY",+ "value": 220+ }+ ],+ "added": [],+ "removed": []+ },+ {+ "id": 11,+ "name": "Coin5",+ "parent": null,+ "folder": "Coins",+ "prefab": "@uuid:57ad3eb0-4a0c-49b5-bfba-c98418989915",+ "overrides": [+ {+ "prefabEntityId": "0",+ "type": "property",+ "componentType": "Transform",+ "propertyName": "position",+ "value": {+ "x": 0,+ "y": -200,+ "z": 0+ }+ },+ {+ "prefabEntityId": "0",+ "type": "property",+ "componentType": "Coin",+ "propertyName": "baseY",+ "value": -200+ }+ ],+ "added": [],+ "removed": []+ },+ {+ "id": 12,+ "name": "UICanvas",+ "parent": null,+ "children": [+ 14+ ],+ "folder": "UI",+ "components": [+ {+ "type": "Transform",+ "data": {}+ },+ {+ "type": "Canvas",+ "data": {+ "designResolution": {+ "x": 800,+ "y": 600+ },+ "scaleMode": 2+ }+ },+ {+ "type": "UINode",+ "data": {}+ }+ ],+ "visible": true+ },+ {+ "id": 14,+ "name": "ScoreText",+ "parent": 12,+ "children": [],+ "components": [+ {+ "type": "Transform",+ "data": {}+ },+ {+ "type": "UINode",+ "data": {+ "position": 1,+ "width": {+ "value": 300,+ "unit": 0+ },+ "height": {+ "value": 40,+ "unit": 0+ },+ "insetLeft": {+ "value": 0,+ "unit": 1+ },+ "marginLeft": {+ "value": 24,+ "unit": 0+ },+ "insetTop": {+ "value": 0,+ "unit": 1+ },+ "marginTop": {+ "value": 20,+ "unit": 0+ }+ }+ },+ {+ "type": "Text",+ "data": {+ "content": "Score: 0",+ "fontSize": 28,+ "color": {+ "r": 1,+ "g": 1,+ "b": 1,+ "a": 1+ },+ "align": 0,+ "verticalAlign": 1+ }+ },+ {+ "type": "ScoreDisplay",+ "data": {+ "score": 0+ }+ }+ ],+ "visible": true+ },+ {+ "id": 18,+ "name": "BlockGuard",+ "parent": null,+ "children": [],+ "folder": "Environment",+ "components": [+ {+ "type": "Transform",+ "data": {+ "position": {+ "x": -380,+ "y": 280,+ "z": 0+ }+ }+ },+ {+ "type": "Sprite",+ "data": {+ "size": {+ "x": 24,+ "y": 24+ },+ "texture": "@uuid:b10c6a11-0000-4000-8000-000000000001",+ "layer": 10+ }+ }+ ],+ "visible": true+ }+ ]+}diff --git a/desktop/templates/2d-platformer/assets/scenes/main.esscene.meta b/desktop/templates/2d-platformer/assets/scenes/main.esscene.metanew file mode 100644index 000000000..9a2e8f7aa--- /dev/null+++ b/desktop/templates/2d-platformer/assets/scenes/main.esscene.meta@@ -0,0 +1,8 @@+{+ "uuid": "1ef4ddaa-5868-4e7b-a68d-10fc54a54590",+ "version": "2.0",+ "type": "scene",+ "importer": {+ "autoMigrate": true+ }+}diff --git a/desktop/templates/2d-platformer/assets/textures/block-guard.ktx2 b/desktop/templates/2d-platformer/assets/textures/block-guard.ktx2new file mode 100644index 000000000..b58b817c0Binary files /dev/null and b/desktop/templates/2d-platformer/assets/textures/block-guard.ktx2 differdiff --git a/desktop/templates/2d-platformer/assets/textures/block-guard.ktx2.meta b/desktop/templates/2d-platformer/assets/textures/block-guard.ktx2.metanew file mode 100644index 000000000..394664f53--- /dev/null+++ b/desktop/templates/2d-platformer/assets/textures/block-guard.ktx2.meta@@ -0,0 +1,6 @@+{+ "uuid": "b10c6a11-0000-4000-8000-000000000001",+ "version": "2.0",+ "type": "texture",+ "importer": {}+}diff --git a/desktop/templates/2d-platformer/assets/textures/coin.png b/desktop/templates/2d-platformer/assets/textures/coin.pngnew file mode 100644index 000000000..e63c689a0Binary files /dev/null and b/desktop/templates/2d-platformer/assets/textures/coin.png differdiff --git a/desktop/templates/2d-platformer/assets/textures/coin.png.meta b/desktop/templates/2d-platformer/assets/textures/coin.png.metanew file mode 100644index 000000000..b1c5b79c1--- /dev/null+++ b/desktop/templates/2d-platformer/assets/textures/coin.png.meta@@ -0,0 +1,17 @@+{+ "uuid": "c18959bd-f6be-49d3-945b-3d6ecf8ef14f",+ "version": "2.0",+ "type": "texture",+ "importer": {+ "maxSize": 2048,+ "filterMode": "linear",+ "wrapMode": "repeat",+ "premultiplyAlpha": false,+ "sliceBorder": {+ "left": 0,+ "right": 0,+ "top": 0,+ "bottom": 0+ }+ }+}\ No newline at end of filediff --git a/desktop/templates/2d-platformer/assets/textures/ground.png b/desktop/templates/2d-platformer/assets/textures/ground.pngnew file mode 100644index 000000000..035addae8Binary files /dev/null and b/desktop/templates/2d-platformer/assets/textures/ground.png differdiff --git a/desktop/templates/2d-platformer/assets/textures/ground.png.meta b/desktop/templates/2d-platformer/assets/textures/ground.png.metanew file mode 100644index 000000000..ef477a419--- /dev/null+++ b/desktop/templates/2d-platformer/assets/textures/ground.png.meta@@ -0,0 +1,17 @@+{+ "uuid": "931ebe66-cded-4b32-8444-0737da446c0d",+ "version": "2.0",+ "type": "texture",+ "importer": {+ "maxSize": 2048,+ "filterMode": "linear",+ "wrapMode": "repeat",+ "premultiplyAlpha": false,+ "sliceBorder": {+ "left": 0,+ "right": 0,+ "top": 0,+ "bottom": 0+ }+ }+}\ No newline at end of filediff --git a/desktop/templates/2d-platformer/assets/textures/platform.png b/desktop/templates/2d-platformer/assets/textures/platform.pngnew file mode 100644index 000000000..035addae8Binary files /dev/null and b/desktop/templates/2d-platformer/assets/textures/platform.png differdiff --git a/desktop/templates/2d-platformer/assets/textures/platform.png.meta b/desktop/templates/2d-platformer/assets/textures/platform.png.metanew file mode 100644index 000000000..57e82d172--- /dev/null+++ b/desktop/templates/2d-platformer/assets/textures/platform.png.meta@@ -0,0 +1,17 @@+{+ "uuid": "0258e55e-9aa0-47eb-8092-7386e03f97c7",+ "version": "2.0",+ "type": "texture",+ "importer": {+ "maxSize": 2048,+ "filterMode": "linear",+ "wrapMode": "repeat",+ "premultiplyAlpha": false,+ "sliceBorder": {+ "left": 0,+ "right": 0,+ "top": 0,+ "bottom": 0+ }+ }+}\ No newline at end of filediff --git a/desktop/templates/2d-platformer/assets/textures/player.png b/desktop/templates/2d-platformer/assets/textures/player.pngnew file mode 100644index 000000000..e7613ad5dBinary files /dev/null and b/desktop/templates/2d-platformer/assets/textures/player.png differdiff --git a/desktop/templates/2d-platformer/assets/textures/player.png.meta b/desktop/templates/2d-platformer/assets/textures/player.png.metanew file mode 100644index 000000000..83cc1a4c7--- /dev/null+++ b/desktop/templates/2d-platformer/assets/textures/player.png.meta@@ -0,0 +1,17 @@+{+ "uuid": "2bde6b7d-0dbe-4434-9e30-ed1cd8e3fe82",+ "version": "2.0",+ "type": "texture",+ "importer": {+ "maxSize": 2048,+ "filterMode": "linear",+ "wrapMode": "repeat",+ "premultiplyAlpha": false,+ "sliceBorder": {+ "left": 0,+ "right": 0,+ "top": 0,+ "bottom": 0+ }+ }+}\ No newline at end of filediff --git a/desktop/templates/2d-platformer/assets/textures/sky.png b/desktop/templates/2d-platformer/assets/textures/sky.pngnew file mode 100644index 000000000..1d2adce36Binary files /dev/null and b/desktop/templates/2d-platformer/assets/textures/sky.png differdiff --git a/desktop/templates/2d-platformer/assets/textures/sky.png.meta b/desktop/templates/2d-platformer/assets/textures/sky.png.metanew file mode 100644index 000000000..47ff18ddc--- /dev/null+++ b/desktop/templates/2d-platformer/assets/textures/sky.png.meta@@ -0,0 +1,17 @@+{+ "uuid": "74b832b1-40ae-4095-a620-c027735cb482",+ "version": "2.0",+ "type": "texture",+ "importer": {+ "maxSize": 2048,+ "filterMode": "linear",+ "wrapMode": "repeat",+ "premultiplyAlpha": false,+ "sliceBorder": {+ "left": 0,+ "right": 0,+ "top": 0,+ "bottom": 0+ }+ }+}\ No newline at end of filediff --git a/desktop/templates/2d-platformer/project.esproject b/desktop/templates/2d-platformer/project.esprojectnew file mode 100644index 000000000..359f140e6--- /dev/null+++ b/desktop/templates/2d-platformer/project.esproject@@ -0,0 +1,18 @@+{+ "formatVersion": "1",+ "name": "2D Platformer",+ "description": "Run, jump and collect: a character controller on solid ground, a prefab pickup, and a score that counts them.",+ "tag": "Starter",+ "version": "1.0.0",+ "defaultScene": "assets/scenes/main.esscene",+ "designResolution": {+ "width": 800,+ "height": 600+ },+ "spineVersion": "none",+ "features": {+ "physics": {+ "enabled": true+ }+ }+}diff --git a/desktop/templates/2d-platformer/src/components.ts b/desktop/templates/2d-platformer/src/components.tsnew file mode 100644index 000000000..8724fd70b--- /dev/null+++ b/desktop/templates/2d-platformer/src/components.ts@@ -0,0 +1,15 @@+import { defineComponent } from 'esengine';++export const Player = defineComponent('Player', {+ speed: 320,+ jumpForce: 640,+});++export const Coin = defineComponent('Coin', {+ baseY: 0,+ bobTimer: 0,+});++export const ScoreDisplay = defineComponent('ScoreDisplay', {+ score: 0,+});diff --git a/desktop/templates/2d-platformer/src/main.ts b/desktop/templates/2d-platformer/src/main.tsnew file mode 100644index 000000000..6ddca396f--- /dev/null+++ b/desktop/templates/2d-platformer/src/main.ts@@ -0,0 +1,11 @@+import { addSystemToSchedule, Schedule } from 'esengine';++import './components';+import { playerSystem } from './systems/player';+import { coinBobSystem, coinPickupSystem } from './systems/coin';+import { scoreSystem } from './systems/score';++addSystemToSchedule(Schedule.FixedPreUpdate, playerSystem);+addSystemToSchedule(Schedule.Update, coinPickupSystem);+addSystemToSchedule(Schedule.Update, coinBobSystem);+addSystemToSchedule(Schedule.Update, scoreSystem);diff --git a/desktop/templates/2d-platformer/src/systems/coin.ts b/desktop/templates/2d-platformer/src/systems/coin.tsnew file mode 100644index 000000000..1daf24d8f--- /dev/null+++ b/desktop/templates/2d-platformer/src/systems/coin.ts@@ -0,0 +1,36 @@+import {+ defineSystem, Query, Mut, Res, Time, Transform, Commands,+ PhysicsEvents,+} from 'esengine';+import { Coin, ScoreDisplay } from '../components';++const BOB_SPEED = 3;+const BOB_AMOUNT = 6;++export const coinBobSystem = defineSystem(+ [Query(Mut(Transform), Mut(Coin)), Res(Time)],+ (coins, time) => {+ for (const [_entity, transform, coin] of coins) {+ coin.bobTimer += time.delta * BOB_SPEED;+ transform.position.y = coin.baseY + Math.sin(coin.bobTimer) * BOB_AMOUNT;+ }+ },+ { name: 'CoinBobSystem' }+);++export const coinPickupSystem = defineSystem(+ [Res(PhysicsEvents), Query(Coin), Query(Mut(ScoreDisplay)), Commands()],+ (events, coins, scores, cmds) => {+ for (const ev of events.sensorEnters) {+ let isCoin = false;+ for (const [coinEntity] of coins) {+ if (coinEntity === ev.sensorEntity) { isCoin = true; break; }+ }+ if (!isCoin) continue;++ cmds.despawn(ev.sensorEntity);+ for (const [_entity, score] of scores) score.score += 1;+ }+ },+ { name: 'CoinPickupSystem' }+);diff --git a/desktop/templates/2d-platformer/src/systems/player.ts b/desktop/templates/2d-platformer/src/systems/player.tsnew file mode 100644index 000000000..4d4a9bc93--- /dev/null+++ b/desktop/templates/2d-platformer/src/systems/player.ts@@ -0,0 +1,27 @@+import {+ defineSystem, Query, Mut, Res, Time, Input,+ CharacterController,+} from 'esengine';+import { Player } from '../components';++const GRAVITY = -1600;++export const playerSystem = defineSystem(+ [Query(Mut(CharacterController), Player), Res(Time), Res(Input)],+ (players, time, input) => {+ for (const [_entity, cc, player] of players) {+ let moveX = 0;+ if (input.isKeyDown('ArrowLeft') || input.isKeyDown('KeyA')) moveX -= 1;+ if (input.isKeyDown('ArrowRight') || input.isKeyDown('KeyD')) moveX += 1;+ cc.velocity.x = moveX * player.speed;++ cc.velocity.y += GRAVITY * time.fixedDelta;++ const jump = input.isKeyPressed('Space')+ || input.isKeyPressed('ArrowUp')+ || input.isKeyPressed('KeyW');+ if (cc.isOnFloor && jump) cc.velocity.y = player.jumpForce;+ }+ },+ { name: 'PlayerSystem' }+);diff --git a/desktop/templates/2d-platformer/src/systems/score.ts b/desktop/templates/2d-platformer/src/systems/score.tsnew file mode 100644index 000000000..6c14e8152--- /dev/null+++ b/desktop/templates/2d-platformer/src/systems/score.ts@@ -0,0 +1,12 @@+import { defineSystem, Query, Mut, Text } from 'esengine';+import { ScoreDisplay } from '../components';++export const scoreSystem = defineSystem(+ [Query(ScoreDisplay, Mut(Text))],+ (query) => {+ for (const [_entity, score, text] of query) {+ text.content = `Score: ${score.score}`;+ }+ },+ { name: 'ScoreSystem' }+);diff --git a/desktop/templates/2d-platformer/tsconfig.json b/desktop/templates/2d-platformer/tsconfig.jsonnew file mode 100644index 000000000..1f11ff310--- /dev/null+++ b/desktop/templates/2d-platformer/tsconfig.json@@ -0,0 +1,20 @@+{+ "compilerOptions": {+ "target": "ES2020",+ "module": "ESNext",+ "moduleResolution": "bundler",+ "strict": true,+ "esModuleInterop": true,+ "skipLibCheck": true,+ "forceConsistentCasingInFileNames": true,+ "declaration": false,+ "outDir": "./dist",+ "rootDir": ".",+ "paths": {+ "esengine": ["./.esengine/sdk/index.d.ts"],+ "esengine/wasm": ["./.esengine/sdk/wasm.d.ts"]+ }+ },+ "include": ["src/**/*"],+ "exclude": ["node_modules"]+}diff --git a/desktop/templates/blank/project.esproject b/desktop/templates/blank/project.esprojectindex e0ff2a017..d628a204c 100644--- a/desktop/templates/blank/project.esproject+++ b/desktop/templates/blank/project.esproject@@ -1,6 +1,7 @@{"formatVersion": "1","name": "Blank",+ "tag": "Starter","description": "An empty scene with a camera — start from nothing.","version": "0.1.0","defaultScene": "assets/scenes/main.esscene",diff --git a/desktop/templates/playable-ad/assets/scenes/main.esscene b/desktop/templates/playable-ad/assets/scenes/main.esscenenew file mode 100644index 000000000..11a69d7c2--- /dev/null+++ b/desktop/templates/playable-ad/assets/scenes/main.esscene@@ -0,0 +1,202 @@+{+ "version": "1.0",+ "name": "Main",+ "entities": [+ {+ "id": 0,+ "name": "Camera",+ "parent": null,+ "children": [],+ "components": [+ {+ "type": "Transform",+ "data": {+ "position": {+ "x": 0,+ "y": 0,+ "z": 10+ }+ }+ },+ {+ "type": "Camera",+ "data": {+ "projectionType": 1,+ "orthoSize": 640.0,+ "isActive": true,+ "priority": 0,+ "clearColor": {+ "r": 0.07,+ "g": 0.08,+ "b": 0.11,+ "a": 1+ }+ }+ }+ ],+ "visible": true+ },+ {+ "id": 1,+ "name": "Canvas",+ "parent": null,+ "children": [+ 2+ ],+ "components": [+ {+ "type": "Transform",+ "data": {}+ },+ {+ "type": "Canvas",+ "data": {+ "designResolution": {+ "x": 720,+ "y": 1280+ },+ "scaleMode": 2+ }+ },+ {+ "type": "UINode",+ "data": {}+ }+ ],+ "visible": true+ },+ {+ "id": 2,+ "name": "Center",+ "parent": 1,+ "children": [+ 3,+ 4+ ],+ "components": [+ {+ "type": "Transform",+ "data": {}+ },+ {+ "type": "UINode",+ "data": {+ "position": 1,+ "width": {+ "value": 80,+ "unit": 1+ },+ "height": {+ "value": 200,+ "unit": 0+ },+ "insetLeft": {+ "value": 50,+ "unit": 1+ },+ "insetTop": {+ "value": 50,+ "unit": 1+ },+ "marginLeft": {+ "value": -40,+ "unit": 1+ },+ "marginTop": {+ "value": -100,+ "unit": 0+ }+ }+ },+ {+ "type": "FlexContainer",+ "data": {+ "direction": 1,+ "justifyContent": 1,+ "alignItems": 1,+ "gap": {+ "x": 0,+ "y": 18+ }+ }+ }+ ],+ "visible": true+ },+ {+ "id": 3,+ "name": "Title",+ "parent": 2,+ "children": [],+ "components": [+ {+ "type": "Transform",+ "data": {}+ },+ {+ "type": "UINode",+ "data": {+ "height": {+ "value": 48,+ "unit": 0+ }+ }+ },+ {+ "type": "Text",+ "data": {+ "content": "Tap to play",+ "fontSize": 40,+ "bold": true,+ "color": {+ "r": 1,+ "g": 1,+ "b": 1,+ "a": 1+ },+ "align": 1,+ "verticalAlign": 1+ }+ }+ ],+ "visible": true+ },+ {+ "id": 4,+ "name": "Hint",+ "parent": 2,+ "children": [],+ "components": [+ {+ "type": "Transform",+ "data": {}+ },+ {+ "type": "UINode",+ "data": {+ "height": {+ "value": 28,+ "unit": 0+ }+ }+ },+ {+ "type": "Text",+ "data": {+ "content": "One scene, one tap, one call to action.",+ "fontSize": 22,+ "color": {+ "r": 0.65,+ "g": 0.7,+ "b": 0.78,+ "a": 1+ },+ "align": 1,+ "verticalAlign": 1+ }+ }+ ],+ "visible": true+ }+ ]+}diff --git a/desktop/templates/playable-ad/assets/scenes/main.esscene.meta b/desktop/templates/playable-ad/assets/scenes/main.esscene.metanew file mode 100644index 000000000..2ba514059--- /dev/null+++ b/desktop/templates/playable-ad/assets/scenes/main.esscene.meta@@ -0,0 +1,8 @@+{+ "uuid": "9d9b6178-75e7-4ae5-8cc4-1c435f7056e3",+ "version": "2.0",+ "type": "scene",+ "importer": {+ "autoMigrate": true+ }+}diff --git a/desktop/templates/playable-ad/project.esproject b/desktop/templates/playable-ad/project.esprojectnew file mode 100644index 000000000..23cae35d2--- /dev/null+++ b/desktop/templates/playable-ad/project.esproject@@ -0,0 +1,13 @@+{+ "formatVersion": "1",+ "name": "Playable Ad",+ "description": "One portrait scene sized for a playable: a tap anywhere calls the CTA, and there is nothing to load.",+ "tag": "Starter",+ "version": "1.0.0",+ "defaultScene": "assets/scenes/main.esscene",+ "designResolution": {+ "width": 720,+ "height": 1280+ },+ "spineVersion": "none"+}diff --git a/desktop/templates/playable-ad/src/main.ts b/desktop/templates/playable-ad/src/main.tsnew file mode 100644index 000000000..4806da4ef--- /dev/null+++ b/desktop/templates/playable-ad/src/main.ts@@ -0,0 +1,23 @@+import { addSystemToSchedule, Schedule, defineSystem, Res, Input } from 'esengine';++/**+ * The call to action. Every ad network injects its own — MRAID's `mraid.open`,+ * or a global the host defines — so this is the ONE place to wire it, and it+ * says out loud when there is nothing to call rather than failing silently.+ */+function callToAction(): void {+ const open = (globalThis as { mraid?: { open?: (url: string) => void } }).mraid?.open;+ if (open) open('https://example.com/your-app');+ else console.log('[playable] CTA tapped — no network host, so nothing opened.');+}++// A playable is one gesture. Anywhere on the screen, any pointer.+const tapSystem = defineSystem(+ [Res(Input)],+ (input) => {+ if (input.isMouseButtonPressed(0)) callToAction();+ },+ { name: 'TapSystem' },+);++addSystemToSchedule(Schedule.Update, tapSystem);diff --git a/desktop/templates/playable-ad/tsconfig.json b/desktop/templates/playable-ad/tsconfig.jsonnew file mode 100644index 000000000..1f11ff310--- /dev/null+++ b/desktop/templates/playable-ad/tsconfig.json@@ -0,0 +1,20 @@+{+ "compilerOptions": {+ "target": "ES2020",+ "module": "ESNext",+ "moduleResolution": "bundler",+ "strict": true,+ "esModuleInterop": true,+ "skipLibCheck": true,+ "forceConsistentCasingInFileNames": true,+ "declaration": false,+ "outDir": "./dist",+ "rootDir": ".",+ "paths": {+ "esengine": ["./.esengine/sdk/index.d.ts"],+ "esengine/wasm": ["./.esengine/sdk/wasm.d.ts"]+ }+ },+ "include": ["src/**/*"],+ "exclude": ["node_modules"]+}diff --git a/desktop/templates/top-down/assets/scenes/main.esscene b/desktop/templates/top-down/assets/scenes/main.esscenenew file mode 100644index 000000000..d9ff06827--- /dev/null+++ b/desktop/templates/top-down/assets/scenes/main.esscene@@ -0,0 +1,529 @@+{+ "version": "1.0",+ "name": "Main",+ "folders": [+ "Level"+ ],+ "entities": [+ {+ "id": 0,+ "name": "Camera",+ "parent": null,+ "children": [],+ "components": [+ {+ "type": "Transform",+ "data": {+ "position": {+ "x": 0,+ "y": 0,+ "z": 10+ }+ }+ },+ {+ "type": "Camera",+ "data": {+ "projectionType": 1,+ "orthoSize": 300,+ "isActive": true,+ "priority": 0,+ "clearColor": {+ "r": 0.09,+ "g": 0.1,+ "b": 0.12,+ "a": 1+ }+ }+ }+ ],+ "visible": true+ },+ {+ "id": 1,+ "name": "Floor",+ "parent": null,+ "children": [],+ "components": [+ {+ "type": "Transform",+ "data": {+ "position": {+ "x": 0,+ "y": 0,+ "z": 0+ }+ }+ },+ {+ "type": "ShapeRenderer",+ "data": {+ "shapeType": 2,+ "cornerRadius": 0,+ "size": {+ "x": 1160,+ "y": 680+ },+ "color": {+ "r": 0.16,+ "g": 0.18,+ "b": 0.22,+ "a": 1+ },+ "layer": -10+ }+ }+ ],+ "visible": true,+ "folder": "Level"+ },+ {+ "id": 2,+ "name": "WallTop",+ "parent": null,+ "children": [],+ "components": [+ {+ "type": "Transform",+ "data": {+ "position": {+ "x": 0,+ "y": 340,+ "z": 0+ }+ }+ },+ {+ "type": "ShapeRenderer",+ "data": {+ "shapeType": 2,+ "cornerRadius": 0,+ "size": {+ "x": 1200,+ "y": 40+ },+ "color": {+ "r": 0.27,+ "g": 0.3,+ "b": 0.36,+ "a": 1+ },+ "layer": 0+ }+ },+ {+ "type": "RigidBody",+ "data": {+ "bodyType": 0+ }+ },+ {+ "type": "BoxCollider",+ "data": {+ "halfExtents": {+ "x": 6.0,+ "y": 0.2+ },+ "categoryBits": 1,+ "maskBits": 65535+ }+ }+ ],+ "visible": true,+ "folder": "Level"+ },+ {+ "id": 3,+ "name": "WallBottom",+ "parent": null,+ "children": [],+ "components": [+ {+ "type": "Transform",+ "data": {+ "position": {+ "x": 0,+ "y": -340,+ "z": 0+ }+ }+ },+ {+ "type": "ShapeRenderer",+ "data": {+ "shapeType": 2,+ "cornerRadius": 0,+ "size": {+ "x": 1200,+ "y": 40+ },+ "color": {+ "r": 0.27,+ "g": 0.3,+ "b": 0.36,+ "a": 1+ },+ "layer": 0+ }+ },+ {+ "type": "RigidBody",+ "data": {+ "bodyType": 0+ }+ },+ {+ "type": "BoxCollider",+ "data": {+ "halfExtents": {+ "x": 6.0,+ "y": 0.2+ },+ "categoryBits": 1,+ "maskBits": 65535+ }+ }+ ],+ "visible": true,+ "folder": "Level"+ },+ {+ "id": 4,+ "name": "WallLeft",+ "parent": null,+ "children": [],+ "components": [+ {+ "type": "Transform",+ "data": {+ "position": {+ "x": -580,+ "y": 0,+ "z": 0+ }+ }+ },+ {+ "type": "ShapeRenderer",+ "data": {+ "shapeType": 2,+ "cornerRadius": 0,+ "size": {+ "x": 40,+ "y": 640+ },+ "color": {+ "r": 0.27,+ "g": 0.3,+ "b": 0.36,+ "a": 1+ },+ "layer": 0+ }+ },+ {+ "type": "RigidBody",+ "data": {+ "bodyType": 0+ }+ },+ {+ "type": "BoxCollider",+ "data": {+ "halfExtents": {+ "x": 0.2,+ "y": 3.2+ },+ "categoryBits": 1,+ "maskBits": 65535+ }+ }+ ],+ "visible": true,+ "folder": "Level"+ },+ {+ "id": 5,+ "name": "WallRight",+ "parent": null,+ "children": [],+ "components": [+ {+ "type": "Transform",+ "data": {+ "position": {+ "x": 580,+ "y": 0,+ "z": 0+ }+ }+ },+ {+ "type": "ShapeRenderer",+ "data": {+ "shapeType": 2,+ "cornerRadius": 0,+ "size": {+ "x": 40,+ "y": 640+ },+ "color": {+ "r": 0.27,+ "g": 0.3,+ "b": 0.36,+ "a": 1+ },+ "layer": 0+ }+ },+ {+ "type": "RigidBody",+ "data": {+ "bodyType": 0+ }+ },+ {+ "type": "BoxCollider",+ "data": {+ "halfExtents": {+ "x": 0.2,+ "y": 3.2+ },+ "categoryBits": 1,+ "maskBits": 65535+ }+ }+ ],+ "visible": true,+ "folder": "Level"+ },+ {+ "id": 6,+ "name": "Crate1",+ "parent": null,+ "children": [],+ "components": [+ {+ "type": "Transform",+ "data": {+ "position": {+ "x": -180,+ "y": 120,+ "z": 0+ }+ }+ },+ {+ "type": "ShapeRenderer",+ "data": {+ "shapeType": 2,+ "cornerRadius": 0,+ "size": {+ "x": 72,+ "y": 72+ },+ "color": {+ "r": 0.62,+ "g": 0.47,+ "b": 0.27,+ "a": 1+ },+ "layer": 0+ }+ },+ {+ "type": "RigidBody",+ "data": {+ "bodyType": 0+ }+ },+ {+ "type": "BoxCollider",+ "data": {+ "halfExtents": {+ "x": 0.36,+ "y": 0.36+ },+ "categoryBits": 1,+ "maskBits": 65535+ }+ }+ ],+ "visible": true,+ "folder": "Level"+ },+ {+ "id": 7,+ "name": "Crate2",+ "parent": null,+ "children": [],+ "components": [+ {+ "type": "Transform",+ "data": {+ "position": {+ "x": 160,+ "y": -60,+ "z": 0+ }+ }+ },+ {+ "type": "ShapeRenderer",+ "data": {+ "shapeType": 2,+ "cornerRadius": 0,+ "size": {+ "x": 72,+ "y": 72+ },+ "color": {+ "r": 0.62,+ "g": 0.47,+ "b": 0.27,+ "a": 1+ },+ "layer": 0+ }+ },+ {+ "type": "RigidBody",+ "data": {+ "bodyType": 0+ }+ },+ {+ "type": "BoxCollider",+ "data": {+ "halfExtents": {+ "x": 0.36,+ "y": 0.36+ },+ "categoryBits": 1,+ "maskBits": 65535+ }+ }+ ],+ "visible": true,+ "folder": "Level"+ },+ {+ "id": 8,+ "name": "Crate3",+ "parent": null,+ "children": [],+ "components": [+ {+ "type": "Transform",+ "data": {+ "position": {+ "x": 240,+ "y": 190,+ "z": 0+ }+ }+ },+ {+ "type": "ShapeRenderer",+ "data": {+ "shapeType": 2,+ "cornerRadius": 0,+ "size": {+ "x": 72,+ "y": 72+ },+ "color": {+ "r": 0.62,+ "g": 0.47,+ "b": 0.27,+ "a": 1+ },+ "layer": 0+ }+ },+ {+ "type": "RigidBody",+ "data": {+ "bodyType": 0+ }+ },+ {+ "type": "BoxCollider",+ "data": {+ "halfExtents": {+ "x": 0.36,+ "y": 0.36+ },+ "categoryBits": 1,+ "maskBits": 65535+ }+ }+ ],+ "visible": true,+ "folder": "Level"+ },+ {+ "id": 9,+ "name": "Player",+ "parent": null,+ "children": [],+ "components": [+ {+ "type": "Transform",+ "data": {+ "position": {+ "x": -320,+ "y": -200,+ "z": 0+ }+ }+ },+ {+ "type": "Sprite",+ "data": {+ "size": {+ "x": 36,+ "y": 36+ },+ "texture": "@uuid:2bde6b7d-0dbe-4434-9e30-ed1cd8e3fe82",+ "color": {+ "r": 0.35,+ "g": 0.78,+ "b": 1.0,+ "a": 1+ },+ "layer": 1+ }+ },+ {+ "type": "Player",+ "data": {}+ },+ {+ "type": "RigidBody",+ "data": {+ "bodyType": 1+ }+ },+ {+ "type": "BoxCollider",+ "data": {+ "halfExtents": {+ "x": 0.18,+ "y": 0.18+ },+ "categoryBits": 1,+ "maskBits": 65535+ }+ },+ {+ "type": "CharacterController",+ "data": {+ "maskBits": 65533+ }+ }+ ],+ "visible": true+ }+ ]+}diff --git a/desktop/templates/top-down/assets/scenes/main.esscene.meta b/desktop/templates/top-down/assets/scenes/main.esscene.metanew file mode 100644index 000000000..9a2e8f7aa--- /dev/null+++ b/desktop/templates/top-down/assets/scenes/main.esscene.meta@@ -0,0 +1,8 @@+{+ "uuid": "1ef4ddaa-5868-4e7b-a68d-10fc54a54590",+ "version": "2.0",+ "type": "scene",+ "importer": {+ "autoMigrate": true+ }+}diff --git a/desktop/templates/top-down/assets/textures/player.png b/desktop/templates/top-down/assets/textures/player.pngnew file mode 100644index 000000000..e7613ad5dBinary files /dev/null and b/desktop/templates/top-down/assets/textures/player.png differdiff --git a/desktop/templates/top-down/assets/textures/player.png.meta b/desktop/templates/top-down/assets/textures/player.png.metanew file mode 100644index 000000000..83cc1a4c7--- /dev/null+++ b/desktop/templates/top-down/assets/textures/player.png.meta@@ -0,0 +1,17 @@+{+ "uuid": "2bde6b7d-0dbe-4434-9e30-ed1cd8e3fe82",+ "version": "2.0",+ "type": "texture",+ "importer": {+ "maxSize": 2048,+ "filterMode": "linear",+ "wrapMode": "repeat",+ "premultiplyAlpha": false,+ "sliceBorder": {+ "left": 0,+ "right": 0,+ "top": 0,+ "bottom": 0+ }+ }+}\ No newline at end of filediff --git a/desktop/templates/top-down/project.esproject b/desktop/templates/top-down/project.esprojectnew file mode 100644index 000000000..eca88d60b--- /dev/null+++ b/desktop/templates/top-down/project.esproject@@ -0,0 +1,18 @@+{+ "formatVersion": "1",+ "name": "Top-down",+ "description": "Eight-way movement with a camera that follows: a walled field, a few obstacles, and a character controller that slides along them.",+ "tag": "Starter",+ "version": "1.0.0",+ "defaultScene": "assets/scenes/main.esscene",+ "designResolution": {+ "width": 800,+ "height": 600+ },+ "spineVersion": "none",+ "features": {+ "physics": {+ "enabled": true+ }+ }+}diff --git a/desktop/templates/top-down/src/components.ts b/desktop/templates/top-down/src/components.tsnew file mode 100644index 000000000..eed417108--- /dev/null+++ b/desktop/templates/top-down/src/components.ts@@ -0,0 +1,6 @@+import { defineComponent } from 'esengine';++/** The one entity the input drives. `speed` is world units per second. */+export const Player = defineComponent('Player', {+ speed: 260,+});diff --git a/desktop/templates/top-down/src/main.ts b/desktop/templates/top-down/src/main.tsnew file mode 100644index 000000000..84126d12c--- /dev/null+++ b/desktop/templates/top-down/src/main.ts@@ -0,0 +1,11 @@+import { addSystemToSchedule, Schedule } from 'esengine';++import './components';+import { moveSystem } from './systems/move';+import { followSystem } from './systems/follow';++// Movement runs in the FIXED step, with the physics the character controller+// resolves against; the camera follows in the render step, so it is smooth at+// whatever rate the display runs.+addSystemToSchedule(Schedule.FixedPreUpdate, moveSystem);+addSystemToSchedule(Schedule.PostUpdate, followSystem);diff --git a/desktop/templates/top-down/src/systems/follow.ts b/desktop/templates/top-down/src/systems/follow.tsnew file mode 100644index 000000000..fd9dd38e6--- /dev/null+++ b/desktop/templates/top-down/src/systems/follow.ts@@ -0,0 +1,27 @@+import {+ defineSystem, Query, Mut, Res, Time,+ Transform, Camera,+} from 'esengine';+import { Player } from '../components';++/** How fast the camera closes the gap, per second. */+const FOLLOW = 6;++/**+ * The camera eases toward the player rather than snapping to it: a camera that+ * is exactly on the player makes every step look like the world jerking.+ */+export const followSystem = defineSystem(+ [Query(Mut(Transform), Camera), Query(Transform, Player), Res(Time)],+ (cameras, players, time) => {+ const target = [...players][0];+ if (!target) return;+ const [, to] = target;+ const k = Math.min(1, FOLLOW * time.delta);+ for (const [, camera] of cameras) {+ camera.position.x += (to.position.x - camera.position.x) * k;+ camera.position.y += (to.position.y - camera.position.y) * k;+ }+ },+ { name: 'FollowSystem' },+);diff --git a/desktop/templates/top-down/src/systems/move.ts b/desktop/templates/top-down/src/systems/move.tsnew file mode 100644index 000000000..838b21d60--- /dev/null+++ b/desktop/templates/top-down/src/systems/move.ts@@ -0,0 +1,27 @@+import {+ defineSystem, Query, Mut, Res, Input,+ CharacterController,+} from 'esengine';+import { Player } from '../components';++/**+ * Eight-way movement. The diagonal is normalised, or holding two keys would be+ * ~1.4× faster than holding one — the oldest bug in top-down movement.+ */+export const moveSystem = defineSystem(+ [Query(Mut(CharacterController), Player), Res(Input)],+ (players, input) => {+ let x = 0;+ let y = 0;+ if (input.isKeyDown('ArrowLeft') || input.isKeyDown('KeyA')) x -= 1;+ if (input.isKeyDown('ArrowRight') || input.isKeyDown('KeyD')) x += 1;+ if (input.isKeyDown('ArrowDown') || input.isKeyDown('KeyS')) y -= 1;+ if (input.isKeyDown('ArrowUp') || input.isKeyDown('KeyW')) y += 1;+ const length = Math.hypot(x, y);+ for (const [, cc, player] of players) {+ cc.velocity.x = length === 0 ? 0 : (x / length) * player.speed;+ cc.velocity.y = length === 0 ? 0 : (y / length) * player.speed;+ }+ },+ { name: 'MoveSystem' },+);diff --git a/desktop/templates/top-down/tsconfig.json b/desktop/templates/top-down/tsconfig.jsonnew file mode 100644index 000000000..1f11ff310--- /dev/null+++ b/desktop/templates/top-down/tsconfig.json@@ -0,0 +1,20 @@+{+ "compilerOptions": {+ "target": "ES2020",+ "module": "ESNext",+ "moduleResolution": "bundler",+ "strict": true,+ "esModuleInterop": true,+ "skipLibCheck": true,+ "forceConsistentCasingInFileNames": true,+ "declaration": false,+ "outDir": "./dist",+ "rootDir": ".",+ "paths": {+ "esengine": ["./.esengine/sdk/index.d.ts"],+ "esengine/wasm": ["./.esengine/sdk/wasm.d.ts"]+ }+ },+ "include": ["src/**/*"],+ "exclude": ["node_modules"]+}diff --git a/desktop/templates/wechat-minigame/assets/scenes/main.esscene b/desktop/templates/wechat-minigame/assets/scenes/main.esscenenew file mode 100644index 000000000..d260956f4--- /dev/null+++ b/desktop/templates/wechat-minigame/assets/scenes/main.esscene@@ -0,0 +1,202 @@+{+ "version": "1.0",+ "name": "Main",+ "entities": [+ {+ "id": 0,+ "name": "Camera",+ "parent": null,+ "children": [],+ "components": [+ {+ "type": "Transform",+ "data": {+ "position": {+ "x": 0,+ "y": 0,+ "z": 10+ }+ }+ },+ {+ "type": "Camera",+ "data": {+ "projectionType": 1,+ "orthoSize": 667.0,+ "isActive": true,+ "priority": 0,+ "clearColor": {+ "r": 0.07,+ "g": 0.08,+ "b": 0.11,+ "a": 1+ }+ }+ }+ ],+ "visible": true+ },+ {+ "id": 1,+ "name": "Canvas",+ "parent": null,+ "children": [+ 2+ ],+ "components": [+ {+ "type": "Transform",+ "data": {}+ },+ {+ "type": "Canvas",+ "data": {+ "designResolution": {+ "x": 750,+ "y": 1334+ },+ "scaleMode": 2+ }+ },+ {+ "type": "UINode",+ "data": {}+ }+ ],+ "visible": true+ },+ {+ "id": 2,+ "name": "Center",+ "parent": 1,+ "children": [+ 3,+ 4+ ],+ "components": [+ {+ "type": "Transform",+ "data": {}+ },+ {+ "type": "UINode",+ "data": {+ "position": 1,+ "width": {+ "value": 80,+ "unit": 1+ },+ "height": {+ "value": 200,+ "unit": 0+ },+ "insetLeft": {+ "value": 50,+ "unit": 1+ },+ "insetTop": {+ "value": 50,+ "unit": 1+ },+ "marginLeft": {+ "value": -40,+ "unit": 1+ },+ "marginTop": {+ "value": -100,+ "unit": 0+ }+ }+ },+ {+ "type": "FlexContainer",+ "data": {+ "direction": 1,+ "justifyContent": 1,+ "alignItems": 1,+ "gap": {+ "x": 0,+ "y": 18+ }+ }+ }+ ],+ "visible": true+ },+ {+ "id": 3,+ "name": "Title",+ "parent": 2,+ "children": [],+ "components": [+ {+ "type": "Transform",+ "data": {}+ },+ {+ "type": "UINode",+ "data": {+ "height": {+ "value": 48,+ "unit": 0+ }+ }+ },+ {+ "type": "Text",+ "data": {+ "content": "WeChat Mini Game",+ "fontSize": 40,+ "bold": true,+ "color": {+ "r": 1,+ "g": 1,+ "b": 1,+ "a": 1+ },+ "align": 1,+ "verticalAlign": 1+ }+ }+ ],+ "visible": true+ },+ {+ "id": 4,+ "name": "Hint",+ "parent": 2,+ "children": [],+ "components": [+ {+ "type": "Transform",+ "data": {}+ },+ {+ "type": "UINode",+ "data": {+ "height": {+ "value": 28,+ "unit": 0+ }+ }+ },+ {+ "type": "Text",+ "data": {+ "content": "Portrait, 750×1334, packaged for the host.",+ "fontSize": 22,+ "color": {+ "r": 0.65,+ "g": 0.7,+ "b": 0.78,+ "a": 1+ },+ "align": 1,+ "verticalAlign": 1+ }+ }+ ],+ "visible": true+ }+ ]+}diff --git a/desktop/templates/wechat-minigame/assets/scenes/main.esscene.meta b/desktop/templates/wechat-minigame/assets/scenes/main.esscene.metanew file mode 100644index 000000000..2ba514059--- /dev/null+++ b/desktop/templates/wechat-minigame/assets/scenes/main.esscene.meta@@ -0,0 +1,8 @@+{+ "uuid": "9d9b6178-75e7-4ae5-8cc4-1c435f7056e3",+ "version": "2.0",+ "type": "scene",+ "importer": {+ "autoMigrate": true+ }+}diff --git a/desktop/templates/wechat-minigame/project.esproject b/desktop/templates/wechat-minigame/project.esprojectnew file mode 100644index 000000000..b05a034f2--- /dev/null+++ b/desktop/templates/wechat-minigame/project.esproject@@ -0,0 +1,13 @@+{+ "formatVersion": "1",+ "name": "WeChat Mini Game",+ "description": "A portrait project sized and configured for the WeChat host — Build ▸ Package targets the mini-game platform.",+ "tag": "Starter",+ "version": "1.0.0",+ "defaultScene": "assets/scenes/main.esscene",+ "designResolution": {+ "width": 750,+ "height": 1334+ },+ "spineVersion": "none"+}diff --git a/desktop/templates/wechat-minigame/src/main.ts b/desktop/templates/wechat-minigame/src/main.tsnew file mode 100644index 000000000..4718ff2e8--- /dev/null+++ b/desktop/templates/wechat-minigame/src/main.ts@@ -0,0 +1,16 @@+import { addStartupSystem, defineSystem, GetWorld } from 'esengine';++/**+ * A mini-game host starts the game inside its own shell: no window to size, no+ * URL to read, and a launch payload instead of a query string. Nothing here+ * needs it yet — this is where it lands when it does.+ */+const bootSystem = defineSystem(+ [GetWorld()],+ () => {+ console.log('[wechat] booted — Build > Package builds the mini-game bundle.');+ },+ { name: 'BootSystem' },+);++addStartupSystem(bootSystem);diff --git a/desktop/templates/wechat-minigame/tsconfig.json b/desktop/templates/wechat-minigame/tsconfig.jsonnew file mode 100644index 000000000..1f11ff310--- /dev/null+++ b/desktop/templates/wechat-minigame/tsconfig.json@@ -0,0 +1,20 @@+{+ "compilerOptions": {+ "target": "ES2020",+ "module": "ESNext",+ "moduleResolution": "bundler",+ "strict": true,+ "esModuleInterop": true,+ "skipLibCheck": true,+ "forceConsistentCasingInFileNames": true,+ "declaration": false,+ "outDir": "./dist",+ "rootDir": ".",+ "paths": {+ "esengine": ["./.esengine/sdk/index.d.ts"],+ "esengine/wasm": ["./.esengine/sdk/wasm.d.ts"]+ }+ },+ "include": ["src/**/*"],+ "exclude": ["node_modules"]+}