3D documentation refresh for 20.0: WebGPU parity, retained meshes, Light3d point/spot, custom mesh shaders
- Working-in-3D: new Retained-rendering and Lighting (Light3d) sections,
mipmaps/anisotropy under Texture filtering, GPU-backend framing,
Camera2d mesh projection corrected, split-screen camera note
- glTF/GLB scenes: point/spot lights now supported (+ examples), lights /
lightIntensityScale load options, authored light names, getGLTF fields
- Supported assets: GPU-backend framing, point/spot moved to supported
- Rendering-API: capability-flags table, retained drawMesh contract,
multi-material OBJ + MTL Ke corrected, WebGPU in renderer selection
- Shader-Effects: dual-language intro, fixed broken drawMesh example
(mesh.shader is the API), wgsl program assets, custom mesh shader section
- Upgrade-Guide: WebGPU/AUTO ladder, WebGLBatcher rename, Light3dBlock
layout change, model-space mesh shader contract
- Home: refreshed 3D/shader blurbs
obiot
committed
Aug 5, 2026
Shader Effects: 19.9 additions (screen_texture/screen_uv/noise_uv builtins, setTexture, setTime, shader assets + {vertex,fragment} pairs, shared flag)
obiot
committed
Jul 13, 2026
Split "Working in 3D" into a hub + focused subpages
Working in 3D had grown into one long page. Split it into a landing hub
(general concepts: opt-in, conventions, camera, meshes, follow) plus
dedicated pages, and link them from Home:
- 3D Loading and Supported Assets (OBJ/MTL + support/limitations matrices)
- 3D Loading glTF and GLB Scenes (Blender-authored scene import)
- 3D Spatial Queries (sphere / ray / frustum)
- 2.5D Games (Paper Mario-style recipe)
obiot
committed
Jun 17, 2026
docs: add Working in 3D page for the 19.7 Camera3d surface
Covers the dev-facing 3D feature set: Camera3d opt-in (cameraClass +
Stage cameras: …), Y-down + +Z forward conventions, perspective
camera fields (fov / aspect / pitch / yaw / setClipPlanes), Mesh +
multi-material OBJ rendering, the depth-sort scene graph, the 3D
spatial-query surface on the physics adapter (Sphere primitive,
adapter.querySphere with both call shapes, adapter.raycast3d,
Camera3d.queryVisible bulk frustum cull), the math.damp /
Vector*.damp frame-rate-independent smoothing helpers, plus a
pointer to the AfterBurner showcase as the worked reference.
Stays user-facing — opt-in code, API shapes, common gotchas
(Sprite.isKinematic default skipping the broadphase). Implementation
details (broadphase swap mechanics, Octree internals) are left to
the API docs / source.
Lead on Home.md updated from "2D games" → "2D and 3D games" and a
"Working in 3D" link section added between Rendering and Physics.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
obiot
committed
May 31, 2026
docs(home): link Migrating-to-the-Physics-Adapter-API and BuiltinAdapter-Quirks under Physics & Collision
obiot
committed
May 15, 2026
Add Switching Physics Adapters page
obiot
committed
May 14, 2026
Add Cordova wiki page under Platform Deployment
Mirrors the Capacitor page structure but shorter. Prominent banner
notes that Cordova is in low-maintenance mode and points new
projects at Capacitor instead. FAQ updated to link the internal
Cordova page (was external link to cordova.apache.org) and to note
the maintenance status.
obiot
committed
May 11, 2026
Rename Platform Deployment pages to short titles + refresh headings
- Facebook-Instant-Games.md (renamed from the long How-to-deploy-... path)
- WeChat-Mini-Games.md (renamed from the long How-to-deploy-... path)
- H1 of each page now matches the file title.
- Home.md links updated to the new filenames.
obiot
committed
May 11, 2026
Move Capacitor link from Third-Party Tools to Platform Deployment
Capacitor wraps a built melonJS game as a native iOS/Android app —
it's a deployment target, not a content-authoring tool. Lists it
alongside the existing Facebook Instant Games and WeChat Mini Games
entries.
obiot
committed
May 11, 2026
Add Capacitor wiki page under Third-Party Tools
Documents the manual setup for wrapping a melonJS game as a native
iOS / Android app via Capacitor, plus the @melonjs/capacitor-plugin
ergonomics layer for lifecycle and hardware back-button handling.
obiot
committed
May 10, 2026
Add 'Using SpriteIlluminator for Per-pixel Lighting' page
Walks through the full SpriteIlluminator + TexturePacker + melonJS
workflow for per-pixel normal-map lighting:
- Generating normal maps with SpriteIlluminator (Bevel/Emboss)
- Packing color + normal sheets together with TexturePacker
("Pack with same layout")
- Loading both into a paired `TextureAtlas` in melonJS
- Driving the lighting with a `Light2d` (`illuminationOnly` for
invisible logical sources, `lightHeight` for grazing/head-on look,
ambient floor color, etc.)
- Sidecar pattern for non-atlas sprites
- Live example pointer
Linked from Home.md under Third-Party Tools, between TexturePacker
and PhysicsEditor (the SpriteIlluminator workflow naturally follows
TexturePacker's atlas-with-same-layout output).
obiot
committed
May 5, 2026
Redesign wiki home page: better structure, getting started, horizontal rules
obiot
committed
Apr 5, 2026
Add Rendering API reference page with Canvas 2D comparison
obiot
committed
Apr 4, 2026
Clean up wiki: remove dead pages, modernize Home page
Removed:
- Roadmap (covered versions 0.9.5-2.1.0, 11 years outdated)
- Code snippets (2013, ancient APIs)
- Building for production with the Boilerplate (self-deprecated)
- How to build for tvOS using Ejecta (Ejecta abandoned)
- Making your game into a mobile hybrid app (CocoonJS/PhoneGap dead)
Home page:
- Removed dead links (html5gamedevs.com, old boilerplate, Cian Games)
- Removed outdated external tutorials (melonJS 1.x/2.x era)
- Simplified structure into clear sections
- Updated documentation URL
- Added Discord link
obiot
committed
Apr 1, 2026