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.

examples: modernize with Kenney CC0 art + framework cleanup

yhh2b3532fdfa8c
diff --git a/.gitignore b/.gitignore
index a70b1a038..7bb913310 100644
--- a/.gitignore
+++ b/.gitignore
@@ -102,3 +102,10 @@ docs/REARCH_*.md
# Editor-local workspace cache (last scene, panel layout) — never commit
**/.esengine/workspace.json
+
+# Generated per-project engine artifacts (cache, play realm, staged SDK) — never commit.
+# Tracked config such as .esengine/asset-export.json is kept.
+**/.esengine/cache/
+**/.esengine/play/
+**/.esengine/sdk/
+**/.esengine/editor/
diff --git a/examples/ARCHITECTURE.md b/examples/ARCHITECTURE.md
new file mode 100644
index 000000000..63fe5fb69
--- /dev/null
+++ b/examples/ARCHITECTURE.md
@@ -0,0 +1,88 @@
+# Example architecture & conventions
+
+Every example is a real Estella project, so it exercises the same loader, scene format
+and build pipeline as a game a user would ship. Keep new examples consistent with the
+layout below.
+
+## Directory layout
+
+```
+<example>/
+├── project.esproject # manifest — how the launcher discovers & labels it
+├── tsconfig.json # standard TS config (paths → ./.esengine/sdk)
+├── .gitignore # ignores node_modules, dist, .esengine/cache
+├── thumbnail.png # launcher gallery thumbnail (optional)
+├── assets/
+│ ├── scenes/main.esscene # the default scene (entities + components)
+│ ├── textures/*.png(+.meta) # bitmap assets; each PNG has a .png.meta sidecar
+│ ├── prefabs/*.esprefab # reusable entity templates (optional)
+│ ├── animations/*.esanim # sprite-animation clips (optional)
+│ └── audio/*.wav # audio clips (optional)
+└── src/
+ ├── main.ts # entry point — registers systems / startup logic
+ ├── components.ts # component definitions (defineComponent)
+ └── systems/*.ts # one system (or a small group) per file
+```
+
+`.esengine/` is **generated** (script cache, play realm, staged SDK) and is gitignored.
+The one exception is `.esengine/asset-export.json`, a small committed config that marks
+folders for always-export (see space-shooter).
+
+## The manifest (`project.esproject`)
+
+```jsonc
+{
+ "formatVersion": "1",
+ "name": "Space Shooter", // launcher title
+ "description": "…one line…", // launcher card subtitle
+ "tag": "Game", // launcher category (Basics/ECS/Physics/UI/…)
+ "version": "0.1.0",
+ "defaultScene": "assets/scenes/main.esscene",
+ "designResolution": { "width": 600, "height": 1080 },
+ "spineVersion": "none"
+}
+```
+
+`name`, `description` and `tag` drive how the example appears in *New Project →
+Templates*. Every example should set all three.
+
+## How work is placed: scene vs prefab vs code
+
+- **Static entities → the scene.** Cameras, backgrounds, the player, UI, and any fixed
+ level geometry live in `main.esscene` as entities with components.
+- **Runtime-spawned, repeated entities → prefabs.** Bullets, enemies, pickups that are
+ instantiated many times are authored once as `.esprefab` and spawned via `Prefabs`
+ (see `space-shooter`). Per-spawn differences use prefab overrides.
+- **Behaviour → systems.** Logic goes in `src/systems/*.ts`, registered in `main.ts`
+ via `addStartupSystem` / `addSystemToSchedule`. Constants and shared resources go in a
+ `resources.ts` (see `space-shooter`) so magic numbers aren't scattered.
+
+Startup entities that must exist before the first frame use an `addStartupSystem`;
+per-frame logic uses `Schedule.Update`.
+
+## Asset references
+
+- **Scenes/prefabs reference assets by stable UUID** — e.g. a Sprite's
+ `"texture": "@uuid:…"`, resolved from the sidecar `assets/textures/foo.png.meta`.
+ To replace art without touching the scene, **overwrite the PNG bytes under the same
+ filename** — the `.meta` UUID is unchanged, so every reference stays valid. (Adjust the
+ Sprite `size` if the new art's aspect ratio differs.)
+- **Code references assets by project-relative path** — e.g.
+ `insert(Sprite, { texture: 'assets/textures/gem.png' })`. No UUID needed; the loader
+ resolves the path.
+
+## Art policy
+
+- Examples that use bitmap art use **Kenney CC0** assets (see [ASSETS.md](./ASSETS.md)) —
+ public-domain, one cohesive style, safe to ship and reuse commercially.
+- Concept demos (ECS, events, tweens, collision) render **colored primitives** on
+ purpose: a plain square makes the system's behaviour legible in a way decorated art
+ would obscure. Don't add textures to these just for polish.
+- UI examples use the engine's built-in UI theme.
+
+## Verifying an example
+
+`node build-tools/tasks/check-examples.js` symlinks the built SDK into each example and
+runs `tsc --noEmit` across all of them — run it after changing example source or the SDK
+types. Visual/gameplay correctness (rendering, camera framing, tilemap tiles) should be
+confirmed by opening the example in the editor and pressing Play.
diff --git a/examples/ASSETS.md b/examples/ASSETS.md
new file mode 100644
index 000000000..6d448fbc9
--- /dev/null
+++ b/examples/ASSETS.md
@@ -0,0 +1,29 @@
+# Example art credits
+
+All bitmap art in these examples comes from **[Kenney](https://kenney.nl)** and is
+released under **Creative Commons CC0 1.0 (public domain)**. CC0 requires no attribution
+and permits commercial reuse, so these examples — art included — are free to use as the
+starting point for a real game. This credit is a courtesy, not an obligation.
+
+## Packs used
+
+| Pack | License | Used by |
+| --- | --- | --- |
+| [Platformer Art Deluxe](https://kenney.nl/assets/platformer-art-deluxe) | CC0 | platformer, sprite-animation (walk/idle frames), hello-world (gem), physics-playground (crate) |
+| [Space Shooter Remastered](https://kenney.nl/assets/space-shooter-remastered) | CC0 | space-shooter (ships, lasers, enemies, life icon, starfield), input-demo (cursor), sprite-rendering (star) |
+| [Simple Space](https://kenney.nl/assets/simple-space) | CC0 | input-demo (player ship) |
+| [Particle Pack](https://kenney.nl/assets/particle-pack) | CC0 | particle-demo, space-shooter (explosion) |
+| [Physics Assets](https://kenney.nl/assets/physics-assets) | CC0 | physics-playground (ball) |
+| [UI Pack](https://kenney.nl/assets/ui-pack) | CC0 | sprite-rendering (arrow) |
+| [Pixel Platformer](https://kenney.nl/assets/pixel-platformer) | CC0 | tilemap-demo (tileset atlas) |
+
+## Audio
+
+`audio-demo` uses short synthesized drum one-shots (`assets/audio/*.wav`) generated for
+this repo; they are dedicated to the public domain along with the rest of the examples.
+
+## Replacing or adding art
+
+The pixel/vector PNGs are dropped in under each example's `assets/textures/`. To swap
+art for an existing sprite, overwrite the PNG under the same filename so the scene's
+UUID reference stays valid (see [ARCHITECTURE.md](./ARCHITECTURE.md#asset-references)).
diff --git a/examples/README.md b/examples/README.md
new file mode 100644
index 000000000..a2b84d352
--- /dev/null
+++ b/examples/README.md
@@ -0,0 +1,50 @@
+# Estella Examples
+
+Each folder here is a **complete, self-contained Estella project** — the same format
+the editor creates for a new game. The launcher discovers them automatically (any
+folder with a `project.esproject` shows up in *New Project → Templates*), so these
+double as the starter templates.
+
+To try one: open the folder in the Estella editor, or copy it as the starting point
+for your own game.
+
+## Catalog
+
+| Example | Tag | What it shows |
+| --- | --- | --- |
+| **hello-world** | Basics | The smallest project — one rotating, color-pulsing sprite. |
+| **ecs-basics** | ECS | Spawn, move, bounce and expire entities: the core ECS loop. |
+| **event-system** | ECS | Decoupled gameplay with typed events — collect, score, react. |
+| **sprite-rendering** | Rendering | Draw sprites with rotation, tint and flipping. |
+| **sprite-animation** | Animation | Frame animation via `.esanim` clips with an idle/walk switcher. |
+| **tween-animation** | Animation | Ease positions, scales and colors over time. |
+| **input-demo** | Input | Keyboard, mouse and pointer input with a motion trail. |
+| **audio-demo** | Audio | One-shot SFX and a beat visualizer driven by playback. |
+| **collision-layers** | Physics | Layer-based collision filtering between groups of bodies. |
+| **physics-playground** | Physics | Drop balls and crates into a rigid-body sandbox. |
+| **physics-spinner** | Physics | Revolute joints and continuous rotation. |
+| **particle-demo** | Effects | A configurable particle emitter with additive blending. |
+| **postprocess-effects** | Effects | Full-screen post-processing: bloom, vignette, color grading. |
+| **tilemap-demo** | Tilemap | A tile level painted from a tileset atlas, drawn by the tilemap layer. |
+| **ui-controls** | UI | Buttons, sliders, toggles and progress bars. |
+| **ui-interaction** | UI | Dragging, focus and pointer interaction. |
+| **ui-layout** | UI | Flexbox-style responsive UI layout. |
+| **platformer** | Game | A tiny platformer — run, jump and collect coins. |
+| **space-shooter** | Game | A vertical shmup with prefabs, a HUD and a difficulty ramp. |
+
+## Art & assets
+
+Examples that render bitmap art use **[Kenney](https://kenney.nl) CC0 (public-domain)
+assets** — see [ASSETS.md](./ASSETS.md) for the exact packs. CC0 means no attribution
+is required and you may reuse these examples (art included) in commercial games, which
+keeps them consistent with Estella's Apache-2.0 license.
+
+The concept demos (ECS, events, tweens, collision, spinner) intentionally render with
+**colored primitives** rather than art — a plain colored square is the clearest way to
+show *what the system is doing*, and it's the same convention most engine examples use.
+The UI examples use the engine's built-in UI theme.
+
+## Structure & conventions
+
+See [ARCHITECTURE.md](./ARCHITECTURE.md) for the layout every example follows and the
+conventions to keep them consistent.
diff --git a/examples/audio-demo/project.esproject b/examples/audio-demo/project.esproject
index 42112a7a6..5f01b557e 100644
--- a/examples/audio-demo/project.esproject
+++ b/examples/audio-demo/project.esproject
@@ -1,6 +1,8 @@
{
"formatVersion": "1",
"name": "Audio Demo",
+ "description": "Trigger one-shot SFX and drive a beat visualizer from playback.",
+ "tag": "Audio",
"version": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
"designResolution": {
diff --git a/examples/collision-layers/project.esproject b/examples/collision-layers/project.esproject
index f303ddc39..6e6444db9 100644
--- a/examples/collision-layers/project.esproject
+++ b/examples/collision-layers/project.esproject
@@ -1,6 +1,8 @@
{
"formatVersion": "1",
"name": "Collision Layers",
+ "description": "Layer-based collision filtering between groups of bodies.",
+ "tag": "Physics",
"version": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
"designResolution": {
diff --git a/examples/ecs-basics/project.esproject b/examples/ecs-basics/project.esproject
index 6c583f900..7f90cd8a3 100644
--- a/examples/ecs-basics/project.esproject
+++ b/examples/ecs-basics/project.esproject
@@ -1,6 +1,8 @@
{
"formatVersion": "1",
"name": "ECS Basics",
+ "description": "Spawn, move, bounce and expire entities to learn the core ECS loop.",
+ "tag": "ECS",
"version": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
"designResolution": {
diff --git a/examples/event-system/project.esproject b/examples/event-system/project.esproject
index 581016c0f..807edc9cf 100644
--- a/examples/event-system/project.esproject
+++ b/examples/event-system/project.esproject
@@ -1,6 +1,8 @@
{
"formatVersion": "1",
"name": "Event System",
+ "description": "Decoupled gameplay with typed events: collect, score and react.",
+ "tag": "ECS",
"version": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
"designResolution": {
diff --git a/examples/hello-world/assets/textures/logo.png b/examples/hello-world/assets/textures/logo.png
index 3855998d0..8beef0cfd 100644
Binary files a/examples/hello-world/assets/textures/logo.png and b/examples/hello-world/assets/textures/logo.png differ
diff --git a/examples/hello-world/project.esproject b/examples/hello-world/project.esproject
index 740b64d99..5194e2868 100644
--- a/examples/hello-world/project.esproject
+++ b/examples/hello-world/project.esproject
@@ -1,6 +1,8 @@
{
"formatVersion": "1",
"name": "Hello World",
+ "description": "A rotating, color-pulsing sprite — the smallest possible Estella project.",
+ "tag": "Basics",
"version": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
"designResolution": {
diff --git a/examples/input-demo/assets/textures/cursor.png b/examples/input-demo/assets/textures/cursor.png
index 6ebca04d2..9a5c5c2b8 100644
Binary files a/examples/input-demo/assets/textures/cursor.png and b/examples/input-demo/assets/textures/cursor.png differ
diff --git a/examples/input-demo/assets/textures/player.png b/examples/input-demo/assets/textures/player.png
index 763889178..4f5e49370 100644
Binary files a/examples/input-demo/assets/textures/player.png and b/examples/input-demo/assets/textures/player.png differ
diff --git a/examples/input-demo/project.esproject b/examples/input-demo/project.esproject
index 98418896e..1581b34b4 100644
--- a/examples/input-demo/project.esproject
+++ b/examples/input-demo/project.esproject
@@ -1,6 +1,8 @@
{
"formatVersion": "1",
"name": "Input Demo",
+ "description": "Keyboard, mouse and pointer input driving a ship with a motion trail.",
+ "tag": "Input",
"version": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
"designResolution": {
diff --git a/examples/particle-demo/assets/textures/particle.png b/examples/particle-demo/assets/textures/particle.png
index a8962624f..8de3f69a7 100644
Binary files a/examples/particle-demo/assets/textures/particle.png and b/examples/particle-demo/assets/textures/particle.png differ
diff --git a/examples/particle-demo/project.esproject b/examples/particle-demo/project.esproject
index c1d861c7d..86d5eb360 100644
--- a/examples/particle-demo/project.esproject
+++ b/examples/particle-demo/project.esproject
@@ -1,6 +1,8 @@
{
"formatVersion": "1",
"name": "Particle Effects",
+ "description": "A configurable particle emitter with additive blending.",
+ "tag": "Effects",
"version": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
"designResolution": {
diff --git a/examples/physics-playground/assets/textures/ball.png b/examples/physics-playground/assets/textures/ball.png
index 6c55f15c5..e9f6db0e2 100644
Binary files a/examples/physics-playground/assets/textures/ball.png and b/examples/physics-playground/assets/textures/ball.png differ
diff --git a/examples/physics-playground/assets/textures/crate.png b/examples/physics-playground/assets/textures/crate.png
index b742a0eaf..7471ed717 100644
Binary files a/examples/physics-playground/assets/textures/crate.png and b/examples/physics-playground/assets/textures/crate.png differ
diff --git a/examples/physics-playground/project.esproject b/examples/physics-playground/project.esproject
index fa0e5221d..4f0644492 100644
--- a/examples/physics-playground/project.esproject
+++ b/examples/physics-playground/project.esproject
@@ -1,6 +1,8 @@
{
"formatVersion": "1",
"name": "Physics Playground",
+ "description": "Drop balls and crates into a rigid-body sandbox.",
+ "tag": "Physics",
"version": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
"designResolution": {
diff --git a/examples/physics-spinner/project.esproject b/examples/physics-spinner/project.esproject
index 95f81b923..34ac34c12 100644
--- a/examples/physics-spinner/project.esproject
+++ b/examples/physics-spinner/project.esproject
@@ -1,6 +1,8 @@
{
"formatVersion": "1",
"name": "Physics Spinner",
+ "description": "Revolute joints and continuous rotation with the physics engine.",
+ "tag": "Physics",
"version": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
"designResolution": {
diff --git a/examples/platformer/assets/textures/coin.png b/examples/platformer/assets/textures/coin.png
index 9cc6916d8..e63c689a0 100644
Binary files a/examples/platformer/assets/textures/coin.png and b/examples/platformer/assets/textures/coin.png differ
diff --git a/examples/platformer/assets/textures/ground.png b/examples/platformer/assets/textures/ground.png
index a62b67fd5..035addae8 100644
Binary files a/examples/platformer/assets/textures/ground.png and b/examples/platformer/assets/textures/ground.png differ
diff --git a/examples/platformer/assets/textures/platform.png b/examples/platformer/assets/textures/platform.png
index 83620ed53..035addae8 100644
Binary files a/examples/platformer/assets/textures/platform.png and b/examples/platformer/assets/textures/platform.png differ
diff --git a/examples/platformer/assets/textures/player.png b/examples/platformer/assets/textures/player.png
index 85bf73b7f..e7613ad5d 100644
Binary files a/examples/platformer/assets/textures/player.png and b/examples/platformer/assets/textures/player.png differ
diff --git a/examples/platformer/assets/textures/sky.png b/examples/platformer/assets/textures/sky.png
index d164855ac..1d2adce36 100644
Binary files a/examples/platformer/assets/textures/sky.png and b/examples/platformer/assets/textures/sky.png differ
diff --git a/examples/platformer/project.esproject b/examples/platformer/project.esproject
index c31d3dcd8..0f2e135ec 100644
--- a/examples/platformer/project.esproject
+++ b/examples/platformer/project.esproject
@@ -1,6 +1,8 @@
{
"formatVersion": "1",
"name": "Platformer",
+ "description": "A tiny platformer — run, jump and collect coins.",
+ "tag": "Game",
"version": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
"designResolution": {
diff --git a/examples/postprocess-effects/project.esproject b/examples/postprocess-effects/project.esproject
index 1202742fe..0572ec32e 100644
--- a/examples/postprocess-effects/project.esproject
+++ b/examples/postprocess-effects/project.esproject
@@ -1,6 +1,8 @@
{
"formatVersion": "1",
"name": "Post-Processing",
+ "description": "Full-screen post-processing: bloom, vignette and color grading.",
+ "tag": "Effects",
"version": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
"designResolution": {
diff --git a/examples/space-shooter/assets/prefabs/EnemyA.esprefab b/examples/space-shooter/assets/prefabs/EnemyA.esprefab
index caa7b3c44..eed448434 100644
--- a/examples/space-shooter/assets/prefabs/EnemyA.esprefab
+++ b/examples/space-shooter/assets/prefabs/EnemyA.esprefab
@@ -17,7 +17,7 @@
"type": "Sprite",
"data": {
"texture": "@uuid:25e60610-c126-48bf-9b14-85c4699dc912",
- "size": { "x": 48, "y": 48 }
+ "size": { "x": 52, "y": 47 }
}
},
{
diff --git a/examples/space-shooter/assets/prefabs/EnemyB.esprefab b/examples/space-shooter/assets/prefabs/EnemyB.esprefab
index 31176b373..2b5348833 100644
--- a/examples/space-shooter/assets/prefabs/EnemyB.esprefab
+++ b/examples/space-shooter/assets/prefabs/EnemyB.esprefab
@@ -17,7 +17,7 @@
"type": "Sprite",
"data": {
"texture": "@uuid:d429cf7d-d52c-42eb-823e-9b775b6249b6",
- "size": { "x": 56, "y": 56 }
+ "size": { "x": 58, "y": 47 }
}
},
{
diff --git a/examples/space-shooter/assets/prefabs/EnemyBullet.esprefab b/examples/space-shooter/assets/prefabs/EnemyBullet.esprefab
index 2ac2d27dd..62be9b922 100644
--- a/examples/space-shooter/assets/prefabs/EnemyBullet.esprefab
+++ b/examples/space-shooter/assets/prefabs/EnemyBullet.esprefab
@@ -17,7 +17,7 @@
"type": "Sprite",
"data": {
"texture": "@uuid:97a221a6-85bd-49e7-9af5-2880960fecda",
- "size": { "x": 8, "y": 20 }
+ "size": { "x": 8, "y": 30 }
}
},
{
diff --git a/examples/space-shooter/assets/prefabs/Explosion.esprefab b/examples/space-shooter/assets/prefabs/Explosion.esprefab
index 7836650ef..675b5af6d 100644
--- a/examples/space-shooter/assets/prefabs/Explosion.esprefab
+++ b/examples/space-shooter/assets/prefabs/Explosion.esprefab
@@ -17,7 +17,7 @@
"type": "Sprite",
"data": {
"texture": "@uuid:4e16b7e8-3ba1-455b-ab3c-1cfbf5a97e0c",
- "size": { "x": 64, "y": 64 }
+ "size": { "x": 76, "y": 76 }
}
},
{
diff --git a/examples/space-shooter/assets/prefabs/PlayerBullet.esprefab b/examples/space-shooter/assets/prefabs/PlayerBullet.esprefab
index f774b255c..77dd58df5 100644
--- a/examples/space-shooter/assets/prefabs/PlayerBullet.esprefab
+++ b/examples/space-shooter/assets/prefabs/PlayerBullet.esprefab
@@ -17,7 +17,7 @@
"type": "Sprite",
"data": {
"texture": "@uuid:c643c566-1859-460a-8029-4568951787f8",
- "size": { "x": 8, "y": 24 }
+ "size": { "x": 8, "y": 40 }
}
},
{
diff --git a/examples/space-shooter/assets/prefabs/Star.esprefab b/examples/space-shooter/assets/prefabs/Star.esprefab
index 2a2ae664b..c0a67d178 100644
--- a/examples/space-shooter/assets/prefabs/Star.esprefab
+++ b/examples/space-shooter/assets/prefabs/Star.esprefab
@@ -10,7 +10,7 @@
"children": [],
"components": [
{ "type": "Transform", "data": { "position": { "x": 0, "y": 0, "z": -0.5 } } },
- { "type": "Sprite", "data": { "texture": "@uuid:8f56c884-0439-47f1-86d9-05839abfa6e0", "size": { "x": 4, "y": 4 }, "color": { "r": 1, "g": 1, "b": 1, "a": 0.5 }, "layer": -1 } },
+ { "type": "Sprite", "data": { "texture": "@uuid:8f56c884-0439-47f1-86d9-05839abfa6e0", "size": { "x": 9, "y": 9 }, "color": { "r": 1, "g": 1, "b": 1, "a": 0.7 }, "layer": -1 } },
{ "type": "Star", "data": { "speed": 30, "layer": 0 } }
],
"visible": true
diff --git a/examples/space-shooter/assets/scenes/main.esscene b/examples/space-shooter/assets/scenes/main.esscene
index 1eb3eb79a..25e032826 100644
--- a/examples/space-shooter/assets/scenes/main.esscene
+++ b/examples/space-shooter/assets/scenes/main.esscene
@@ -81,8 +81,8 @@
"data": {
"texture": "@uuid:92f1ab5f-28f4-4b95-bb82-7182fdb33494",
"size": {
- "x": 64,
- "y": 64
+ "x": 66,
+ "y": 50
}
}
},
diff --git a/examples/space-shooter/assets/textures/background.png b/examples/space-shooter/assets/textures/background.png
index f468f83ce..82ddab992 100644
Binary files a/examples/space-shooter/assets/textures/background.png and b/examples/space-shooter/assets/textures/background.png differ
diff --git a/examples/space-shooter/assets/textures/bullet-enemy.png b/examples/space-shooter/assets/textures/bullet-enemy.png
index 993e082a3..5e467b65b 100644
Binary files a/examples/space-shooter/assets/textures/bullet-enemy.png and b/examples/space-shooter/assets/textures/bullet-enemy.png differ
diff --git a/examples/space-shooter/assets/textures/bullet-player.png b/examples/space-shooter/assets/textures/bullet-player.png
index c931613b9..b76aaf7a0 100644
Binary files a/examples/space-shooter/assets/textures/bullet-player.png and b/examples/space-shooter/assets/textures/bullet-player.png differ
diff --git a/examples/space-shooter/assets/textures/enemy-a.png b/examples/space-shooter/assets/textures/enemy-a.png
index 37c576426..fb0c0a2ca 100644
Binary files a/examples/space-shooter/assets/textures/enemy-a.png and b/examples/space-shooter/assets/textures/enemy-a.png differ
diff --git a/examples/space-shooter/assets/textures/enemy-b.png b/examples/space-shooter/assets/textures/enemy-b.png
index 0c2b9b32f..74e2bca68 100644
Binary files a/examples/space-shooter/assets/textures/enemy-b.png and b/examples/space-shooter/assets/textures/enemy-b.png differ
diff --git a/examples/space-shooter/assets/textures/explosion.png b/examples/space-shooter/assets/textures/explosion.png
index 960964004..f23303b95 100644
Binary files a/examples/space-shooter/assets/textures/explosion.png and b/examples/space-shooter/assets/textures/explosion.png differ
diff --git a/examples/space-shooter/assets/textures/heart.png b/examples/space-shooter/assets/textures/heart.png
index 2066e09d7..6375095d9 100644
Binary files a/examples/space-shooter/assets/textures/heart.png and b/examples/space-shooter/assets/textures/heart.png differ
diff --git a/examples/space-shooter/assets/textures/player.png b/examples/space-shooter/assets/textures/player.png
index 31118d46a..cecbbed97 100644
Binary files a/examples/space-shooter/assets/textures/player.png and b/examples/space-shooter/assets/textures/player.png differ
diff --git a/examples/space-shooter/assets/textures/star.png b/examples/space-shooter/assets/textures/star.png
index d4f590653..67551ae78 100644
Binary files a/examples/space-shooter/assets/textures/star.png and b/examples/space-shooter/assets/textures/star.png differ
diff --git a/examples/space-shooter/project.esproject b/examples/space-shooter/project.esproject
index f244aa526..3e033f24e 100644
--- a/examples/space-shooter/project.esproject
+++ b/examples/space-shooter/project.esproject
@@ -1,6 +1,8 @@
{
"formatVersion": "1",
"name": "Space Shooter",
+ "description": "A vertical shmup with prefabs, a HUD and a difficulty ramp.",
+ "tag": "Game",
"version": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
"designResolution": {
diff --git a/examples/sprite-animation/assets/scenes/main.esscene b/examples/sprite-animation/assets/scenes/main.esscene
index 9faacdbfc..63138af2e 100644
--- a/examples/sprite-animation/assets/scenes/main.esscene
+++ b/examples/sprite-animation/assets/scenes/main.esscene
@@ -20,7 +20,7 @@
"children": [],
"components": [
{ "type": "Transform", "data": { "position": { "x": -240, "y": 0, "z": 0 } } },
- { "type": "Sprite", "data": { "size": { "x": 80, "y": 80 } } },
+ { "type": "Sprite", "data": { "size": { "x": 72, "y": 98 } } },
{ "type": "SpriteAnimator", "data": {
"clip": "assets/animations/walk.esanim",
"speed": 0.8
@@ -36,7 +36,7 @@
"children": [],
"components": [
{ "type": "Transform", "data": { "position": { "x": -120, "y": 0, "z": 0 } } },
- { "type": "Sprite", "data": { "size": { "x": 80, "y": 80 } } },
+ { "type": "Sprite", "data": { "size": { "x": 72, "y": 98 } } },
{ "type": "SpriteAnimator", "data": {
"clip": "assets/animations/idle.esanim"
}},
@@ -51,7 +51,7 @@
"children": [],
"components": [
{ "type": "Transform", "data": { "position": { "x": 0, "y": 0, "z": 0 } } },
- { "type": "Sprite", "data": { "size": { "x": 80, "y": 80 } } },
+ { "type": "Sprite", "data": { "size": { "x": 72, "y": 98 } } },
{ "type": "SpriteAnimator", "data": {
"clip": "assets/animations/walk.esanim",
"speed": 1.2
@@ -67,7 +67,7 @@
"children": [],
"components": [
{ "type": "Transform", "data": { "position": { "x": 120, "y": 0, "z": 0 } } },
- { "type": "Sprite", "data": { "size": { "x": 80, "y": 80 } } },
+ { "type": "Sprite", "data": { "size": { "x": 72, "y": 98 } } },
{ "type": "SpriteAnimator", "data": {
"clip": "assets/animations/idle.esanim",
"speed": 1.4
@@ -83,7 +83,7 @@
"children": [],
"components": [
{ "type": "Transform", "data": { "position": { "x": 240, "y": 0, "z": 0 } } },
- { "type": "Sprite", "data": { "size": { "x": 80, "y": 80 } } },
+ { "type": "Sprite", "data": { "size": { "x": 72, "y": 98 } } },
{ "type": "SpriteAnimator", "data": {
"clip": "assets/animations/walk.esanim",
"speed": 1.6
diff --git a/examples/sprite-animation/assets/textures/idle_0.png b/examples/sprite-animation/assets/textures/idle_0.png
index 8113fa6cf..e7613ad5d 100644
Binary files a/examples/sprite-animation/assets/textures/idle_0.png and b/examples/sprite-animation/assets/textures/idle_0.png differ
diff --git a/examples/sprite-animation/assets/textures/idle_1.png b/examples/sprite-animation/assets/textures/idle_1.png
index 1305ad4eb..1dbe260de 100644
Binary files a/examples/sprite-animation/assets/textures/idle_1.png and b/examples/sprite-animation/assets/textures/idle_1.png differ
diff --git a/examples/sprite-animation/assets/textures/idle_2.png b/examples/sprite-animation/assets/textures/idle_2.png
index 26dba57a2..e7613ad5d 100644
Binary files a/examples/sprite-animation/assets/textures/idle_2.png and b/examples/sprite-animation/assets/textures/idle_2.png differ
diff --git a/examples/sprite-animation/assets/textures/idle_3.png b/examples/sprite-animation/assets/textures/idle_3.png
index 5c0469d74..1dbe260de 100644
Binary files a/examples/sprite-animation/assets/textures/idle_3.png and b/examples/sprite-animation/assets/textures/idle_3.png differ
diff --git a/examples/sprite-animation/assets/textures/walk_0.png b/examples/sprite-animation/assets/textures/walk_0.png
index 6f4b1b23a..047061635 100644
Binary files a/examples/sprite-animation/assets/textures/walk_0.png and b/examples/sprite-animation/assets/textures/walk_0.png differ
diff --git a/examples/sprite-animation/assets/textures/walk_1.png b/examples/sprite-animation/assets/textures/walk_1.png
index 1f327b78f..f14817819 100644
Binary files a/examples/sprite-animation/assets/textures/walk_1.png and b/examples/sprite-animation/assets/textures/walk_1.png differ
diff --git a/examples/sprite-animation/assets/textures/walk_2.png b/examples/sprite-animation/assets/textures/walk_2.png
index 6f4b1b23a..0a80b03ea 100644
Binary files a/examples/sprite-animation/assets/textures/walk_2.png and b/examples/sprite-animation/assets/textures/walk_2.png differ
diff --git a/examples/sprite-animation/assets/textures/walk_3.png b/examples/sprite-animation/assets/textures/walk_3.png
index 6e9c80576..d57448c60 100644
Binary files a/examples/sprite-animation/assets/textures/walk_3.png and b/examples/sprite-animation/assets/textures/walk_3.png differ
diff --git a/examples/sprite-animation/project.esproject b/examples/sprite-animation/project.esproject
index 3020a17d6..1f5426bc3 100644
--- a/examples/sprite-animation/project.esproject
+++ b/examples/sprite-animation/project.esproject
@@ -1,6 +1,8 @@
{
"formatVersion": "1",
"name": "Sprite Animation",
+ "description": "Frame-based sprite animation driven by .esanim clips and a state switcher.",
+ "tag": "Animation",
"version": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
"designResolution": {
diff --git a/examples/sprite-rendering/assets/textures/arrow.png b/examples/sprite-rendering/assets/textures/arrow.png
index 0c6bd28f6..72e66cc6d 100644
Binary files a/examples/sprite-rendering/assets/textures/arrow.png and b/examples/sprite-rendering/assets/textures/arrow.png differ
diff --git a/examples/sprite-rendering/assets/textures/star.png b/examples/sprite-rendering/assets/textures/star.png
index 070cd68d3..4f048ef7c 100644
Binary files a/examples/sprite-rendering/assets/textures/star.png and b/examples/sprite-rendering/assets/textures/star.png differ
diff --git a/examples/sprite-rendering/project.esproject b/examples/sprite-rendering/project.esproject
index 1d28abb67..6f4d4528f 100644
--- a/examples/sprite-rendering/project.esproject
+++ b/examples/sprite-rendering/project.esproject
@@ -1,6 +1,8 @@
{
"formatVersion": "1",
"name": "Sprite Rendering",
+ "description": "Draw sprites with rotation, tint and flipping.",
+ "tag": "Rendering",
"version": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
"designResolution": {
diff --git a/examples/tilemap-demo/.gitignore b/examples/tilemap-demo/.gitignore
new file mode 100644
index 000000000..359472ac2
--- /dev/null
+++ b/examples/tilemap-demo/.gitignore
@@ -0,0 +1,7 @@
+node_modules/
+dist/
+.vscode/
+.idea/
+.DS_Store
+Thumbs.db
+.esengine/cache/
diff --git a/examples/tilemap-demo/assets/scenes/main.esscene b/examples/tilemap-demo/assets/scenes/main.esscene
new file mode 100644
index 000000000..46059e1f8
--- /dev/null
+++ b/examples/tilemap-demo/assets/scenes/main.esscene
@@ -0,0 +1,40 @@
+{
+ "version": "1.0",
+ "name": "Main",
+ "entities": [
+ {
+ "id": 0,
+ "name": "Camera",
+ "parent": null,
+ "children": [],
+ "components": [
+ { "type": "Transform", "data": { "position": { "x": 144, "y": -144, "z": 10 } } },
+ { "type": "Camera", "data": { "projectionType": 1, "orthoSize": 160, "isActive": true, "priority": 0 } }
+ ],
+ "visible": true
+ },
+ {
+ "id": 1,
+ "name": "Tilemap",
+ "parent": null,
+ "children": [],
+ "components": [
+ { "type": "Transform", "data": { "position": { "x": 0, "y": 0, "z": 0 } } },
+ {
+ "type": "TilemapLayer",
+ "data": {
+ "cellSize": { "x": 18, "y": 18 },
+ "tileset": "@uuid:11111111-2222-3333-4444-555555555555",
+ "tilesetColumns": 20,
+ "tilesetRows": 9,
+ "renderLayer": 0,
+ "opacity": 1,
+ "visible": true,
+ "chunks": "RVNUTQEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQACAAMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAIAAwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQACAAIAAgACAAIAAgACAAIAAgACAAIAAgACAAIAAwAWABYAFgAWABYAFgAWABYAFgAWABYAFgAWABYAFgAWABYAFgAWABYAFgAWABYAFgAWABYAFgAWABYAFgAWABYA"
+ }
+ }
+ ],
+ "visible": true
+ }
+ ]
+}
diff --git a/examples/tilemap-demo/assets/textures/tileset.png b/examples/tilemap-demo/assets/textures/tileset.png
new file mode 100644
index 000000000..901a78562
Binary files /dev/null and b/examples/tilemap-demo/assets/textures/tileset.png differ
diff --git a/examples/tilemap-demo/assets/textures/tileset.png.meta b/examples/tilemap-demo/assets/textures/tileset.png.meta
new file mode 100644
index 000000000..97ae1ebba
--- /dev/null
+++ b/examples/tilemap-demo/assets/textures/tileset.png.meta
@@ -0,0 +1,17 @@
+{
+ "uuid": "11111111-2222-3333-4444-555555555555",
+ "version": "2.0",
+ "type": "texture",
+ "importer": {
+ "maxSize": 2048,
+ "filterMode": "nearest",
+ "wrapMode": "clamp",
+ "premultiplyAlpha": false,
+ "sliceBorder": {
+ "left": 0,
+ "right": 0,
+ "top": 0,
+ "bottom": 0
+ }
+ }
+}
diff --git a/examples/tilemap-demo/project.esproject b/examples/tilemap-demo/project.esproject
new file mode 100644
index 000000000..714ed7182
--- /dev/null
+++ b/examples/tilemap-demo/project.esproject
@@ -0,0 +1,13 @@
+{
+ "formatVersion": "1",
+ "name": "Tilemap Demo",
+ "description": "A tile-based level painted from a Kenney tileset atlas and rendered by the tilemap layer.",
+ "tag": "Tilemap",
+ "version": "0.1.0",
+ "defaultScene": "assets/scenes/main.esscene",
+ "designResolution": {
+ "width": 800,
+ "height": 600
+ },
+ "spineVersion": "none"
+}
diff --git a/examples/tilemap-demo/src/main.ts b/examples/tilemap-demo/src/main.ts
new file mode 100644
index 000000000..75fc8090d
--- /dev/null
+++ b/examples/tilemap-demo/src/main.ts
@@ -0,0 +1,5 @@
+// Tilemap Demo — the level is authored in the scene (assets/scenes/main.esscene)
+// as a TilemapLayer that references the Kenney tileset atlas, and it is rendered by
+// the engine's built-in tilemap plugin. Displaying it needs no gameplay systems, so
+// this entry point is intentionally empty; add systems here to make the map interactive.
+export {};
diff --git a/examples/tilemap-demo/tsconfig.json b/examples/tilemap-demo/tsconfig.json
new file mode 100644
index 000000000..0a8528b29
--- /dev/null
+++ b/examples/tilemap-demo/tsconfig.json
@@ -0,0 +1,22 @@
+{
+ "compilerOptions": {
+ "target": "ES2020",
+ "module": "ESNext",
+ "moduleResolution": "bundler",
+ "strict": true,
+ "esModuleInterop": true,
+ "skipLibCheck": true,
+ "forceConsistentCasingInFileNames": true,
+ "declaration": false,
+ "outDir": "./dist",
+ "rootDir": ".",
+ "baseUrl": ".",
+ "paths": {
+ "esengine": ["./.esengine/sdk/index.d.ts"],
+ "esengine/wasm": ["./.esengine/sdk/wasm.d.ts"],
+ "@esengine/editor": ["./.esengine/editor/index.d.ts"]
+ }
+ },
+ "include": ["src/**/*"],
+ "exclude": ["node_modules"]
+}
diff --git a/examples/tween-animation/project.esproject b/examples/tween-animation/project.esproject
index 22b5d4af2..d47a786b0 100644
--- a/examples/tween-animation/project.esproject
+++ b/examples/tween-animation/project.esproject
@@ -1,6 +1,8 @@
{
"formatVersion": "1",
"name": "Tween Animation",
+ "description": "Ease positions, scales and colors over time with the tween system.",
+ "tag": "Animation",
"version": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
"designResolution": {
diff --git a/examples/ui-controls/project.esproject b/examples/ui-controls/project.esproject
index 0bbe0a4ad..7bf8c1cb9 100644
--- a/examples/ui-controls/project.esproject
+++ b/examples/ui-controls/project.esproject
@@ -1,6 +1,8 @@
{
"formatVersion": "1",
"name": "UI Controls",
+ "description": "Buttons, sliders, toggles and other interactive widgets.",
+ "tag": "UI",
"version": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
"designResolution": {
diff --git a/examples/ui-interaction/project.esproject b/examples/ui-interaction/project.esproject
index f1d6bca70..870ead37e 100644
--- a/examples/ui-interaction/project.esproject
+++ b/examples/ui-interaction/project.esproject
@@ -1,6 +1,8 @@
{
"formatVersion": "1",
"name": "UI Interaction",
+ "description": "Dragging, focus and pointer interaction in the UI system.",
+ "tag": "UI",
"version": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
"designResolution": {
diff --git a/examples/ui-layout/project.esproject b/examples/ui-layout/project.esproject
index 39258e199..8c7a055bf 100644
--- a/examples/ui-layout/project.esproject
+++ b/examples/ui-layout/project.esproject
@@ -1,6 +1,8 @@
{
"formatVersion": "1",
"name": "UI Layout",
+ "description": "Flexbox-style responsive UI layout.",
+ "tag": "UI",
"version": "0.1.0",
"defaultScene": "assets/scenes/main.esscene",
"designResolution": {