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): four more starters, so New Project is a choice

yhhf755c2f0918f
diff --git a/desktop/templates/2d-platformer/.gitignore b/desktop/templates/2d-platformer/.gitignore
new file mode 100644
index 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.esprefab
new file mode 100644
index 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.meta
new file mode 100644
index 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.esscene
new file mode 100644
index 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.meta
new file mode 100644
index 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.ktx2
new file mode 100644
index 000000000..b58b817c0
Binary files /dev/null and b/desktop/templates/2d-platformer/assets/textures/block-guard.ktx2 differ
diff --git a/desktop/templates/2d-platformer/assets/textures/block-guard.ktx2.meta b/desktop/templates/2d-platformer/assets/textures/block-guard.ktx2.meta
new file mode 100644
index 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.png
new file mode 100644
index 000000000..e63c689a0
Binary files /dev/null and b/desktop/templates/2d-platformer/assets/textures/coin.png differ
diff --git a/desktop/templates/2d-platformer/assets/textures/coin.png.meta b/desktop/templates/2d-platformer/assets/textures/coin.png.meta
new file mode 100644
index 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 file
diff --git a/desktop/templates/2d-platformer/assets/textures/ground.png b/desktop/templates/2d-platformer/assets/textures/ground.png
new file mode 100644
index 000000000..035addae8
Binary files /dev/null and b/desktop/templates/2d-platformer/assets/textures/ground.png differ
diff --git a/desktop/templates/2d-platformer/assets/textures/ground.png.meta b/desktop/templates/2d-platformer/assets/textures/ground.png.meta
new file mode 100644
index 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 file
diff --git a/desktop/templates/2d-platformer/assets/textures/platform.png b/desktop/templates/2d-platformer/assets/textures/platform.png
new file mode 100644
index 000000000..035addae8
Binary files /dev/null and b/desktop/templates/2d-platformer/assets/textures/platform.png differ
diff --git a/desktop/templates/2d-platformer/assets/textures/platform.png.meta b/desktop/templates/2d-platformer/assets/textures/platform.png.meta
new file mode 100644
index 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 file
diff --git a/desktop/templates/2d-platformer/assets/textures/player.png b/desktop/templates/2d-platformer/assets/textures/player.png
new file mode 100644
index 000000000..e7613ad5d
Binary files /dev/null and b/desktop/templates/2d-platformer/assets/textures/player.png differ
diff --git a/desktop/templates/2d-platformer/assets/textures/player.png.meta b/desktop/templates/2d-platformer/assets/textures/player.png.meta
new file mode 100644
index 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 file
diff --git a/desktop/templates/2d-platformer/assets/textures/sky.png b/desktop/templates/2d-platformer/assets/textures/sky.png
new file mode 100644
index 000000000..1d2adce36
Binary files /dev/null and b/desktop/templates/2d-platformer/assets/textures/sky.png differ
diff --git a/desktop/templates/2d-platformer/assets/textures/sky.png.meta b/desktop/templates/2d-platformer/assets/textures/sky.png.meta
new file mode 100644
index 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 file
diff --git a/desktop/templates/2d-platformer/project.esproject b/desktop/templates/2d-platformer/project.esproject
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.json
new file mode 100644
index 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.esproject
index 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.esscene
new file mode 100644
index 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.meta
new file mode 100644
index 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.esproject
new file mode 100644
index 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.ts
new file mode 100644
index 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.json
new file mode 100644
index 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.esscene
new file mode 100644
index 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.meta
new file mode 100644
index 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.png
new file mode 100644
index 000000000..e7613ad5d
Binary files /dev/null and b/desktop/templates/top-down/assets/textures/player.png differ
diff --git a/desktop/templates/top-down/assets/textures/player.png.meta b/desktop/templates/top-down/assets/textures/player.png.meta
new file mode 100644
index 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 file
diff --git a/desktop/templates/top-down/project.esproject b/desktop/templates/top-down/project.esproject
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.json
new file mode 100644
index 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.esscene
new file mode 100644
index 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.meta
new file mode 100644
index 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.esproject
new file mode 100644
index 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.ts
new file mode 100644
index 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.json
new file mode 100644
index 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"]
+}