Muse Engine 32 WebGL2 release candidate

.gitattributes

@@ -34,3 +34,7 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
 assets/khronos-toy-car.glb filter=lfs diff=lfs merge=lfs -text
+assets/testpack/kenney-yard-zup-cm.fbx filter=lfs diff=lfs merge=lfs -text
+assets/testpack/swat-biped-max.fbx filter=lfs diff=lfs merge=lfs -text
+assets/testpack/swat-gltf.glb filter=lfs diff=lfs merge=lfs -text
+assets/testpack/swat-maya-zup-cm.fbx filter=lfs diff=lfs merge=lfs -text

assets/testpack/LICENSE-TESTPACK.md

@@ -0,0 +1,22 @@
+# Test pack licence (Phase 30–32)
+
+| File | What it is | Source | Licence |
+|---|---|---|---|
+| `kenney-yard.glb` | "Kenney Yard" test level: glTF 2.0 binary, **metres, +Y up**, no spawn node (tests automatic spawn search) | Built by Grok Bot (coach) in Blender 4.2 LTS with `build_yard.py` from Kenney **Starter Kit FPS** models: `platform-large-grass`, `platform`, `wall-high`, `wall-low`, `grass` (+ their embedded `colormap` texture) | **CC0-1.0** (Kenney's models are CC0; the arrangement is also released as CC0) |
+| `kenney-yard-zup-cm.fbx` | The same level as FBX 7.4 binary exported **Autodesk-style: Z-up, centimetres** (UnitScaleFactor 1 = cm, UpAxis = Z, objects ×100), texture embedded, `PlayerStart` empty at (-600, 600, 60) cm | Same as above | **CC0-1.0** |
+| `build_yard.py` | Blender script that rebuilds both files | Grok Bot (coach) | MIT (this repo) |
+| `swat-gltf.glb` | "SWAT" animated test character (Phase 31): glTF 2.0 binary, **metres, +Y up**, 62-bone skeleton, 4 skinned meshes, 11 clips with **Quaternius-style names** (`Rig|idle_relaxed`, `Rig|Walk_Forward`, `Rig|Jog_Fwd`, `Rig|FireWeapon`, `Rig|Die_Forward`, …) | Rebuilt by Grok Bot (coach) in Blender 4.2 LTS with `build_characters.py` from **Quaternius "SWAT"** (Ultimate Modular Men Pack), downloaded from Poly Pizza https://poly.pizza/m/Btfn3G5Xv4 (file `713f6535-f4f3-4367-a4c6-ced126ae0936.glb`, sha256 `a835107bac833eb916c494e10997ae1709e85957ea6f6c59ace3c9a66f6d1fec`). A subset of the 24 original clips is kept and renamed. | **CC0-1.0** (Poly Pizza page: "Licence: CC0 1.0"; the rebuild is also released as CC0) |
+| `swat-maya-zup-cm.fbx` | The same character as FBX 7.4 binary exported **Autodesk/Maya-style**: **Z-up, centimetres**, animation **baked at 30 fps**, bones in a `Character1:` namespace (`Character1:Hips` …, armature `Character1:Reference`), leaf bones added, **11 takes in one file** with *Mixamo-style names* (`Rifle Idle`, `Walking`, `Rifle Run`, `Firing Rifle`, `Knocked Out` …). "Knocked Out" is deliberately not auto-matched, to test the clip picker. It is only named like Mixamo clips; no Mixamo content is used. | Same as above | **CC0-1.0** |
+| `build_characters.py` | Blender script that rebuilds both character files from the Poly Pizza GLB | Grok Bot (coach) | MIT (this repo) |
+| `swat-biped-max.fbx` | The SWAT character with **3ds Max Biped bone names** (`Bip001`, `Bip001 Pelvis`, `Bip001 L Thigh`, `Bip001 Head`, `…Nub` bones): FBX 7.4 binary, Y-up, 79 bones (over the 60-bone limit on purpose), 5 takes named like a Max export (`Idle_Rifle`, `Walk`, `Run_Rifle`, `Fire_Rifle`, `Death_KnockDown`) | Built by Grok Bot (coach) with Blender 2.79b and `fbx6/build_fbx61.py` from `swat-maya-zup-cm.fbx` (not made in 3ds Max) | CC0-1.0 |
+| `fbx6/props-max-fbx61-ascii.fbx`, `fbx6/props-max-fbx61-bin.fbx`, `fbx6/colormap.png` | A few Kenney Yard props as **FBX 6.1** (version 6100, the 3ds Max 2006–2010 format), ASCII and binary, inches, texture as a side file. Engine 32 answers *Old FBX 6.x: re-export as FBX 2011+ or GLB* | Blender 2.79b FBX 6.1 exporter (`fbx6/build_fbx61.py`), binary by `fbx6/fbx6_ascii_to_binary.py`; texture from the Kenney Starter Kit FPS | CC0-1.0 |
+| `fbx6/build_fbx61.py`, `fbx6/fbx6_ascii_to_binary.py` | Build scripts for the files above | Grok Bot (coach) | MIT (this repo) |
+| `setup-yard-swat.json` | Example Muse Engine setup (Phase 32): Kenney Yard FBX as the level, SWAT FBX as the enemies, *Knocked Out* picked as the death clip. Load it with Tab › Setup › Load setup… or drop it on the game view | Grok Bot (coach) | CC0-1.0 |
+| `muse-engine-32-testpack-cc0.zip` | This whole pack in one download: the model files above (including `swat-biped-max.fbx` and `fbx6/`), `setup-yard-swat.json` and this licence file | Grok Bot (coach) | CC0-1.0 (contents as listed above) |
+
+Kenney Starter Kit FPS: https://github.com/KenneyNL/Starter-Kit-FPS (commit 185fd23, March 2026). Its README says: "Assets included in this package (2D sprites, 3D models and sound effects) are CC0 licensed" (https://creativecommons.org/publicdomain/zero/1.0/). The kit's *code* is MIT; no code from it is used here.
+Quaternius released the Ultimate Modular Men Pack (February 2022) as "Free to use in any project, even commercially! (CC0)" (Patreon post https://www.patreon.com/quaternius/posts/ultimate-modular-62873637; pack page https://quaternius.com/packs/ultimatemodularcharacters.html). Poly Pizza lists the pack as "Licence: Public Domain (CC0)" and the SWAT model as "Licence: CC0 1.0", Animated (checked 27 Sep 2026).
+Credit is not required under CC0, but thanks go to **Kenney (www.kenney.nl)** and **Quaternius (quaternius.com)**.
+
+
+No Autodesk sample files and no Mixamo content are used anywhere in this project.

assets/testpack/build_characters.py

@@ -0,0 +1,81 @@
+# [e31 coach] Builds the Phase 31 test characters from Quaternius "SWAT" (Ultimate Modular Men Pack, CC0 1.0) in Blender 4.2 (headless).
+# Source: https://poly.pizza/m/Btfn3G5Xv4  (GLB https://static.poly.pizza/713f6535-f4f3-4367-a4c6-ced126ae0936.glb)
+# Outputs:
+#   swat-gltf.glb        glTF: metres, Y-up, 24 fps, game-style clip names ("Rig|IDLE_RIFLE", "Rig|Jog_Fwd", ...)
+#   swat-maya-zup-cm.fbx FBX: centimetres, Z-up, 30 fps bake, Autodesk/Mixamo-style: bones namespaced "Character1:Hips",
+#                        several takes in one file ("Rifle Idle", "Walking", ...), death deliberately named "Knocked Out"
+#                        (not auto-mapped -> exercised through the panel clip picker).
+import bpy, sys, os
+args = sys.argv[sys.argv.index('--') + 1:]
+SRC, OUT = args[0], args[1]
+bpy.ops.wm.read_factory_settings(use_empty=True)
+bpy.ops.import_scene.gltf(filepath=SRC)
+arm = next(o for o in bpy.data.objects if o.type == 'ARMATURE')
+for o in list(bpy.data.objects):             # the glTF importer's bone-display icosphere (not part of the asset)
+    if o.type == 'MESH' and o.parent is None: bpy.data.objects.remove(o, do_unlink=True)
+KEEP = {  # source action stem -> (GLB name, FBX take name)
+    'Idle_Gun': ('Rig|IDLE_RIFLE', 'Rifle Idle'),
+    'Idle_Neutral': ('Rig|idle_relaxed', 'Neutral Idle'),
+    'Walk': ('Rig|Walk_Forward', 'Walking'),
+    'Run': ('Rig|Jog_Fwd', 'Rifle Run'),
+    'Run_Back': ('Rig|Jog_Back', 'Run Backwards'),
+    'Run_Left': ('Rig|Jog_Left', 'Strafe Left'),
+    'Gun_Shoot': ('Rig|FireWeapon', 'Firing Rifle'),
+    'Run_Shoot': ('Rig|Jog_Fire', 'Run And Shoot'),
+    'Death': ('Rig|Die_Forward', 'Knocked Out'),
+    'HitRecieve': ('Rig|HitReact', 'Hit Reaction'),
+    'Wave': ('Rig|Wave', 'Waving'),
+}
+acts = {}
+for a in list(bpy.data.actions):
+    stem = a.name.split('|', 1)[-1].replace('_CharacterArmature', '')
+    if stem in KEEP: acts[stem] = a; a.use_fake_user = True
+    else: bpy.data.actions.remove(a)
+assert len(acts) == len(KEEP), sorted(acts)
+arm.animation_data_create()
+def push_all(names):
+    ad = arm.animation_data
+    for t in list(ad.nla_tracks): ad.nla_tracks.remove(t)
+    ad.action = None
+    for stem, a in acts.items(): a.name = names[stem]
+os.makedirs(OUT, exist_ok=True)
+# ---- GLB (metres, Y-up, 24 fps) ----
+push_all({k: v[0] for k, v in KEEP.items()})
+bpy.context.scene.render.fps = 24
+bpy.ops.export_scene.gltf(filepath=os.path.join(OUT, 'swat-gltf.glb'), export_format='GLB', export_yup=True,
+                          export_animations=True, export_animation_mode='ACTIONS', export_force_sampling=True,
+                          export_skins=True, export_all_influences=False)
+print('GLB_DONE')
+# ---- FBX (cm, Z-up, 30 fps, Autodesk-style names) ----
+push_all({k: v[1] for k, v in KEEP.items()})
+NS = 'Character1:'
+old = [b.name for b in arm.data.bones]
+for a in acts.values():                       # rewrite fcurve paths for every take (not only the active one)
+    for fc in a.fcurves:
+        for n in old:
+            p = 'pose.bones["%s"]' % n
+            if fc.data_path.startswith(p): fc.data_path = fc.data_path.replace(p, 'pose.bones["%s%s"]' % (NS, n), 1); break
+        if fc.group and not fc.group.name.startswith(NS) and fc.group.name in old: fc.group.name = NS + fc.group.name
+for b in arm.data.bones: b.name = NS + b.name   # vertex groups follow the rename
+for o in bpy.data.objects:
+    if o.type == 'MESH':
+        for vg in o.vertex_groups:
+            if vg.name in old: vg.name = NS + vg.name
+        o.name = NS + o.name.replace('Swat_', '') + '_Geo'
+arm.name = 'Character1:Reference'
+f = 30.0 / 24.0                              # 24 fps source keys re-timed onto a 30 fps bake (same durations)
+for a in acts.values():
+    for fc in a.fcurves:
+        for k in fc.keyframe_points:
+            k.co.x *= f; k.handle_left.x *= f; k.handle_right.x *= f
+bpy.context.scene.render.fps = 30
+bpy.context.scene.unit_settings.system = 'METRIC'
+bpy.context.scene.unit_settings.scale_length = 0.01          # 1 Blender unit = 1 cm
+arm.scale = tuple(v * 100 for v in arm.scale)  # Autodesk-typical: rig in cm (the source rig already carries a x100 root scale)
+bpy.ops.export_scene.fbx(filepath=os.path.join(OUT, 'swat-maya-zup-cm.fbx'), axis_up='Z', axis_forward='Y',
+                         apply_unit_scale=True, apply_scale_options='FBX_SCALE_UNITS', global_scale=1.0, bake_space_transform=False,
+                         object_types={'ARMATURE', 'MESH'}, use_armature_deform_only=False, add_leaf_bones=True,
+                         bake_anim=True, bake_anim_use_all_actions=True, bake_anim_use_nla_strips=False, bake_anim_step=1.0,
+                         bake_anim_simplify_factor=0.0, bake_anim_force_startend_keying=True,
+                         path_mode='COPY', embed_textures=True)
+print('FBX_DONE', len(arm.data.bones), 'bones', len(acts), 'takes')

assets/testpack/build_yard.py

@@ -0,0 +1,62 @@
+# [e30 coach] Builds the Phase 30 test scene "Kenney Yard" from Kenney Starter Kit FPS models (CC0) in Blender 4.2 (headless).
+# Outputs: kenney-yard.glb (glTF: metres, Y-up) and kenney-yard-zup-cm.fbx (FBX: centimetres, Z-up, embedded texture)
+import bpy, math, sys, os
+M = os.path.join(os.environ.get('KENNEY_FPS_MODELS', 'Starter-Kit-FPS/models'), '')  # [e32] clone https://github.com/KenneyNL/Starter-Kit-FPS (models are CC0)
+OUT = sys.argv[sys.argv.index('--') + 1]
+bpy.ops.wm.read_factory_settings(use_empty=True)
+src = {}
+def load(name):
+    before = set(bpy.data.objects)
+    bpy.ops.import_scene.gltf(filepath=M + name + '.glb')
+    new = [o for o in bpy.data.objects if o not in before and o.type == 'MESH']
+    o = new[0]
+    for x in new[1:]: pass
+    o.name = 'SRC_' + name; o.hide_render = True
+    src[name] = o
+for n in ['platform-large-grass', 'platform', 'wall-high', 'wall-low', 'grass']: load(n)
+col = bpy.data.collections.new('Yard'); bpy.context.scene.collection.children.link(col)
+count = {}
+def put(name, x, y, z=0.0, rz=0.0, label=None):
+    s = src[name]; o = bpy.data.objects.new((label or name) + '_%d' % count.setdefault(name, 0), s.data)
+    count[name] += 1
+    o.location = (x, y, z); o.rotation_euler = (0, 0, math.radians(rz)); col.objects.link(o); return o
+# ground: 4x4 large grass tiles (5.2 m), top surface at z=0.5
+for i in range(4):
+    for j in range(4):
+        put('platform-large-grass', -7.8 + i * 5.2, -7.8 + j * 5.2, 0.0)
+# perimeter wall-high (1.5 m wide) along the four edges, standing on the ground
+edge = 10.1
+k = 0
+x = -9.6
+while x <= 9.7:
+    put('wall-high', x, -edge, 0.5, 0); put('wall-high', x, edge, 0.5, 180)
+    put('wall-high', -edge, x, 0.5, 90); put('wall-high', edge, x, 0.5, -90)
+    x += 1.5
+# stairs: platforms stacked, each rise 0.5 m (<= engine step 0.55)
+for s_, (px, py) in enumerate([(4.0, 2.0), (4.0, -0.2), (4.0, -2.4)]):
+    for h in range(s_ + 1):
+        put('platform', px, py, 0.5 + h * 0.5)
+# raised deck at the top of the stairs (top at 2.0 m)
+for (px, py) in [(6.2, -2.4), (6.2, -4.6), (4.0, -4.6)]:
+    for h in range(3):
+        put('platform', px, py, 0.5 + h * 0.5)
+# low walls (0.8 m: mantle height) and a high wall maze piece
+put('wall-low', -3.0, 3.0, 0.5, 0); put('wall-low', -5.2, 3.0, 0.5, 0)
+put('wall-high', -3.0, -3.0, 0.5, 90); put('wall-high', -3.0, -4.5, 0.5, 90); put('wall-high', -3.0, -6.0, 0.5, 90)
+for (gx, gy) in [(-6, 6), (-1, 7), (2, 5), (7, 7), (-7, -1), (1, -7)]:
+    put('grass', gx, gy, 0.5)
+for o in list(src.values()): bpy.data.objects.remove(o, do_unlink=True)
+os.makedirs(OUT, exist_ok=True)
+# GLB: metres, +Y up (glTF convention)
+bpy.ops.export_scene.gltf(filepath=os.path.join(OUT, 'kenney-yard.glb'), export_format='GLB', export_yup=True, export_apply=True)
+# FBX "Autodesk-style": centimetres + Z-up (3ds Max / Maya Z-up workflow), texture embedded
+bpy.context.scene.unit_settings.system = 'METRIC'
+bpy.context.scene.unit_settings.scale_length = 0.01          # 1 Blender unit = 1 cm
+for o in col.objects:
+    o.location = (o.location[0] * 100, o.location[1] * 100, o.location[2] * 100)
+    o.scale = (100, 100, 100)
+spawn = bpy.data.objects.new('PlayerStart', None); spawn.location = (-600, 600, 60); col.objects.link(spawn)
+bpy.ops.export_scene.fbx(filepath=os.path.join(OUT, 'kenney-yard-zup-cm.fbx'), axis_up='Z', axis_forward='Y',
+                         apply_unit_scale=True, apply_scale_options='FBX_SCALE_UNITS', global_scale=1.0, bake_space_transform=False,
+                         object_types={'MESH', 'EMPTY'}, path_mode='COPY', embed_textures=True, use_mesh_modifiers=True)
+print('YARD_DONE', len(col.objects), 'objects')

assets/testpack/kenney-yard-zup-cm.fbx

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:d63996d10efa30dd0d4fe44ab0af3e8f22b7b1b54693bca889c781ce4c474bd0
+size 133484

assets/testpack/muse-engine-32-testpack-cc0.zip

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:0d9e925e452c340530a3779d5cb5c5f48012c9c1953ed94e3944d7b6a8a7ad0e
+size 2660409

assets/testpack/setup-yard-swat.json

@@ -0,0 +1,30 @@
+{
+  "kind": "muse-engine-setup",
+  "version": 1,
+  "engine": "e32-rc-1",
+  "savedAt": "2026-09-27T05:00:00.000Z",
+  "look": "A",
+  "config": {
+    "importDog": true,
+    "stripRootMotion": true
+  },
+  "scene": {
+    "name": "kenney-yard-zup-cm.fbx",
+    "source": "url",
+    "url": "assets/testpack/kenney-yard-zup-cm.fbx",
+    "asLevel": true,
+    "units": "auto",
+    "up": "auto"
+  },
+  "character": {
+    "name": "swat-maya-zup-cm.fbx",
+    "source": "url",
+    "url": "assets/testpack/swat-maya-zup-cm.fbx",
+    "units": "auto",
+    "up": "auto",
+    "facing": "+z",
+    "clipPicks": {
+      "death": "Character1:Reference|Knocked Out"
+    }
+  }
+}

assets/testpack/swat-biped-max.fbx

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:61621dc5287f7f71435a28b113f70376024a4b0260a950ec84188e849dc3bbbb
+size 2831036

assets/testpack/swat-gltf.glb

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:bdf5bdd234d0e7450e470130570b8a23fd3bfd3636cf1d7212186d966f425e20
+size 1420392

assets/testpack/swat-maya-zup-cm.fbx

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:ac503490ba7b465ea69729af8581e33b4f964550e57d256aee60636477d3ed60
+size 5900428