Muse Engine 32 WebGL2 release candidate

game/muse-authored/phase32/harness/ref/fbx6-keys.ref.js

@@ -0,0 +1,37 @@
+// Coach reference (Grok Bot) for the Phase 32 part C spec: engine/import/fbx6-keys.js. Used only by the harness.
+(function (root) {
+  var KTIME = 46186158000, IM = { C: 'step', L: 'linear', U: 'cubic', T: 'cubic' };
+  function isN(v) { return typeof v === 'number'; }
+  function decode(tokens, keyCount) {
+    var r = { ok: true, error: '', count: 0, times: [], values: [], interp: [] };
+    if (!Array.isArray(tokens)) { r.ok = false; r.error = 'tokens must be an array'; return r; }
+    var errs = [], i = 0, n = tokens.length, stop = false;
+    while (i < n && !stop) {
+      if (!(isN(tokens[i]) && isN(tokens[i + 1]))) { errs.push('bad key at token ' + i); break; }
+      var t = tokens[i], v = tokens[i + 1], ip, j;
+      if (i + 2 >= n) { ip = 'linear'; j = n; }
+      else {
+        var c = tokens[i + 2];
+        if (typeof c !== 'string' || !IM[c]) { errs.push('unknown interpolation "' + c + '" at token ' + (i + 2)); break; }
+        ip = IM[c]; j = i + 3;
+        while (j < n && !((isN(tokens[j]) && isN(tokens[j + 1]) && (IM[tokens[j + 2]] !== undefined && typeof tokens[j + 2] === 'string' || j + 2 === n)))) j++;
+      }
+      r.times.push(t / KTIME); r.values.push(v); r.interp.push(ip); r.count++;
+      i = j;
+    }
+    if (typeof keyCount === 'number' && r.count !== keyCount) errs.push('expected ' + keyCount + ' keys, decoded ' + r.count);
+    for (var k = 1; k < r.times.length; k++) if (r.times[k] < r.times[k - 1]) { errs.push('times not ascending at key ' + k); break; }
+    if (errs.length) { r.ok = false; r.error = errs[0]; }
+    return r;
+  }
+  function stepToLinear(times, values, interp, eps) {
+    var e = typeof eps === 'number' && eps > 0 ? eps : 1e-4, T = [], V = [];
+    for (var i = 0; i < times.length; i++) {
+      T.push(times[i]); V.push(values[i]);
+      if (interp[i] === 'step' && i + 1 < times.length && values[i + 1] !== values[i] && times[i + 1] - times[i] > 2 * e) { T.push(times[i + 1] - e); V.push(values[i]); }
+    }
+    return { times: T, values: V };
+  }
+  root.MuseFbx6Keys = { KTIME: KTIME, decode: decode, stepToLinear: stepToLinear };
+  if (typeof module !== 'undefined' && module.exports) module.exports = root.MuseFbx6Keys;
+})(typeof window !== 'undefined' ? window : globalThis);

game/muse-authored/phase32/harness/ref/model-check.ref.js

@@ -0,0 +1,74 @@
+// [e32 coach] Reference implementation of the p32a model-check spec (harness oracle, Grok Bot). Not shipped.
+(function (root) {
+  var LIMITS = { sceneTrisWarn: 300000, sceneTrisError: 1000000, charTrisWarn: 100000, charTrisError: 400000, partsWarn: 400,
+    maxBonesDefault: 60, rootMotionMinM: 0.10, rootMotionFrac: 0.05, charHeightMin: 0.5, charHeightMax: 3.0,
+    sceneExtentMin: 2, sceneExtentMax: 5000, fpsLow: 15 };
+  var S = [12, 15, 23.976, 24, 25, 29.97, 30, 48, 50, 59.94, 60, 100, 120];
+  function estimateFps(times) {
+    var t = Array.prototype.slice.call(times || []), d = [];
+    for (var i = 1; i < t.length; i++) { var x = t[i] - t[i - 1]; if (x >= 1e-6) d.push(x); }
+    if (!d.length) return { fps: 0, frames: t.length, standard: false };
+    d.sort(function (a, b) { return a - b; });
+    var dt = d[(d.length - 1) >> 1], raw = 1 / dt, best = S[0];
+    for (var k = 1; k < S.length; k++) if (Math.abs(raw - S[k]) < Math.abs(raw - best)) best = S[k];
+    var fps, std;
+    if (Math.abs(raw - best) <= 0.02 * best) { fps = best; std = true; } else { fps = Math.round(raw * 100) / 100; std = false; }
+    return { fps: fps, frames: Math.round((t[t.length - 1] - t[0]) * fps) + 1, standard: std };
+  }
+  function num(v) { return typeof v === 'number' && isFinite(v) ? v : 0; }
+  function arr(v) { return Array.isArray(v) ? v : []; }
+  function obj(v) { return v && typeof v === 'object' && !Array.isArray(v) ? v : {}; }
+  function analyze(facts) {
+    var f = obj(facts), W = [];
+    function add(code, level, msg, fix) { W.push({ code: code, level: level, msg: msg, fix: fix }); }
+    var rig = obj(f.rig), units = obj(f.units), up = obj(f.up), tex = obj(f.textures), sc = obj(f.scene);
+    var clips = arr(rig.clips);
+    if (f.kind === 'character') {
+      if (rig.skinned !== true) add('NO_SKIN', 'warn', 'No skinned mesh / skeleton: drawn as a static model scaled into the enemy box (no animation).', 'Export with Skin/Skinning and Deformations enabled, bind the mesh to the skeleton.');
+      else {
+        var maxB = num(rig.maxBones) || LIMITS.maxBonesDefault, merged = arr(rig.merged), bones = num(rig.bones);
+        if (bones > maxB) add('BONES_OVER_LIMIT', 'warn', bones + ' bones > ' + maxB + ' GPU slots: ' + merged.length + ' minor leaf bones merged into their parents' + (merged.length ? ' (' + merged.slice(0, 8).join(', ') + (merged.length > 8 ? ', …' : '') + ')' : '') + '.', 'Remove or skip fingers/twist/helper bones on export, or accept the merge.');
+        if (clips.length === 0) add('NO_CLIPS', 'warn', 'Skinned but no animation takes: the character stands in its bind pose.', 'Bake animation on export (Maya: Bake Animation; Max: Bake Animation) and include the takes.');
+        var th = Math.max(LIMITS.rootMotionMinM, LIMITS.rootMotionFrac * (num(rig.heightM) || 1.8));
+        var moving = clips.filter(function (c) { return num(c.rootMotionM) > th; });
+        if (moving.length) {
+          var lv = moving.every(function (c) { return c.stripped; }) ? 'info' : 'warn';
+          add('ROOT_MOTION', lv, 'Root motion in ' + moving.length + ' clip(s): ' + moving.map(function (c) { return c.name + ' ' + num(c.rootMotionM).toFixed(2) + ' m'; }).join(', ') + (lv === 'info' ? ' (stripped: played in place).' : ' (not stripped: the character slides away from its capsule).'), 'Keep the toggle "Strip root motion" on, or export in-place animations.');
+        }
+        if (clips.length > 0) {
+          var roles = obj(rig.roles);
+          var miss = ['idle', 'walk', 'run', 'shoot', 'death'].filter(function (r) { return !(typeof roles[r] === 'number' && roles[r] >= 0); });
+          if (miss.length) add('UNMAPPED_ROLES', 'info', 'No clip found for: ' + miss.join(', ') + ' (pick one in the clip picker, or name takes e.g. Idle, Walk, Run, Shoot, Death).', 'Rename the takes or pick clips in the panel.');
+        }
+        var low = [], odd = [];
+        clips.forEach(function (c) { var e = estimateFps(c.times); if (e.fps > 0 && e.fps < LIMITS.fpsLow) low.push([c, e]); if (e.fps > 0 && !e.standard) odd.push([c, e]); });
+        function lst(a) { return a.map(function (x) { return x[0].name + ' ' + x[1].fps + ' fps'; }).join(', '); }
+        if (low.length) add('LOW_FPS', 'warn', 'Low key rate in: ' + lst(low) + '.', 'Bake at 30 fps (every frame).');
+        else if (odd.length) add('ODD_FPS', 'info', 'Unusual key rate in: ' + lst(odd) + '.', 'Bake every frame at the scene frame rate (24/25/30/60).');
+      }
+      var h = num(rig.heightM);
+      if (h > 0 && (h < LIMITS.charHeightMin || h > LIMITS.charHeightMax)) add('ODD_SIZE', 'warn', 'Character is ' + h.toFixed(2) + ' m tall after unit conversion: check the units / scale.', 'Set the units in the panel (Units) or export in centimetres with unit metadata.');
+    }
+    if (f.kind === 'scene') {
+      var ext = Math.max.apply(null, arr(f.sizeM).map(num).concat([0]));
+      if (ext > 0 && (ext < LIMITS.sceneExtentMin || ext > LIMITS.sceneExtentMax)) add('ODD_SIZE', 'warn', 'Scene is ' + ext.toFixed(1) + ' m across after unit conversion: check the units / scale.', 'Set the units in the panel (Units) or export in centimetres with unit metadata.');
+    }
+    if (units.source === 'guess') add('NO_UNITS_INFO', 'warn', 'No unit information in the file: guessed ' + units.value + ' from the size.', 'FBX: keep the file units (Maya: Preferences > Settings > Working units; export with Automatic units). glTF is always metres.');
+    if (up.source === 'guess') add('NO_UP_INFO', 'warn', 'No up-axis information in the file: assumed ' + String(up.value).toUpperCase() + '-up.', 'FBX: export with Up Axis set (Y or Z); the engine converts Z-up to Y-up.');
+    var miss2 = arr(tex.missing);
+    if (miss2.length) add('MISSING_TEXTURES', 'warn', miss2.length + ' texture(s) not found: ' + miss2.slice(0, 6).join(', ') + (miss2.length > 6 ? ', …' : '') + '. Material colours used instead.', 'Embed media in the FBX (Embed Media) or select the texture files together with the model; for .gltf select the .bin and images too.');
+    var tris = num(f.triangles), isS = f.kind === 'scene';
+    var wAt = isS ? LIMITS.sceneTrisWarn : LIMITS.charTrisWarn, eAt = isS ? LIMITS.sceneTrisError : LIMITS.charTrisError;
+    if (tris >= eAt || tris >= wAt) { var er = tris >= eAt; add('HEAVY_MESH', er ? 'error' : 'warn', tris.toLocaleString('en-US') + ' triangles: ' + (er ? 'very heavy for WebGL1, expect low frame rates.' : 'heavy, frame rate may drop on laptops.'), 'Reduce polygons (Maya: Mesh > Reduce; Max: ProOptimizer) or remove hidden detail.'); }
+    if (num(f.parts) > LIMITS.partsWarn) add('MANY_PARTS', 'info', num(f.parts) + ' draw parts (meshes x materials): the engine batches parts that share a material.', 'Combine meshes that share a material before export.');
+    if (isS && sc.mode === 'level') {
+      if (num(sc.walkableTris) === 0) add('NO_FLOOR', 'error', 'No walkable floor found (no upward-facing collision triangles): you will fall.', 'Check the up axis / units, and that floors are not named _nocol.');
+      if (sc.spawn !== 'node') add('NO_SPAWN', 'info', 'No PlayerStart node: spawning on the nearest open floor.', 'Add an empty/dummy named PlayerStart where the player should start.');
+    }
+    var rank = { error: 0, warn: 1, info: 2 };
+    var sorted = W.map(function (w, i) { return [w, i]; }).sort(function (a, b) { return (rank[a[0].level] - rank[b[0].level]) || (a[1] - b[1]); }).map(function (x) { return x[0]; });
+    var e = sorted.filter(function (w) { return w.level === 'error'; }).length, wn = sorted.filter(function (w) { return w.level === 'warn'; }).length;
+    return { level: e ? 'error' : wn ? 'warn' : 'ok', warnings: sorted, summary: { errors: e, warns: wn, infos: sorted.length - e - wn, codes: sorted.map(function (w) { return w.code; }) } };
+  }
+  root.MuseModelCheck = { analyze: analyze, estimateFps: estimateFps, LIMITS: LIMITS };
+})(typeof window !== 'undefined' ? window : globalThis);

game/muse-authored/phase32/harness/ref/root-motion.ref.js

@@ -0,0 +1,47 @@
+// [e32 coach] Reference implementation of the p32a root-motion spec (harness oracle, Grok Bot). Not shipped.
+(function (root) {
+  function trk(clip, node) { var t = clip && clip.tracks || []; for (var i = 0; i < t.length; i++) if (t[i].node === node && t[i].path === 'translation') return t[i]; return null; }
+  function dot(a, b) { return a[0] * b[0] + a[1] * b[1] + a[2] * b[2]; }
+  function h(v, up) { var d = dot(v, up); return [v[0] - d * up[0], v[1] - d * up[1], v[2] - d * up[2]]; }
+  function len(v) { return Math.hypot(v[0], v[1], v[2]); }
+  function key(t, i) { return [t.values[3 * i], t.values[3 * i + 1], t.values[3 * i + 2]]; }
+  function measure(clip, node, up) {
+    var t = trk(clip, node); if (!t) return null;
+    var n = t.times.length, first = key(t, 0), last = key(t, n - 1);
+    var net = [last[0] - first[0], last[1] - first[1], last[2] - first[2]], mh = 0;
+    for (var i = 0; i < n; i++) { var k = key(t, i); mh = Math.max(mh, len(h([k[0] - first[0], k[1] - first[1], k[2] - first[2]], up))); }
+    var hz = len(h(net, up));
+    return { keys: n, first: first, last: last, net: net, horiz: hz, vert: Math.abs(dot(net, up)), maxHoriz: mh, speed: clip.duration > 0 ? hz / clip.duration : 0 };
+  }
+  function strip(clip, node, up, opts) {
+    var mode = opts && opts.mode === 'lock' ? 'lock' : 'drift';
+    var t = trk(clip, node); if (!t) return { clip: clip, removed: [0, 0, 0], mode: mode };
+    var n = t.times.length, first = key(t, 0), last = key(t, n - 1);
+    var hn = h([last[0] - first[0], last[1] - first[1], last[2] - first[2]], up);
+    var v = new Float32Array(t.values.length), t0 = t.times[0], t1 = t.times[n - 1];
+    for (var i = 0; i < n; i++) {
+      var k = key(t, i), o;
+      if (mode === 'drift') { var u = t1 === t0 ? 0 : (t.times[i] - t0) / (t1 - t0); o = [u * hn[0], u * hn[1], u * hn[2]]; }
+      else o = h([k[0] - first[0], k[1] - first[1], k[2] - first[2]], up);
+      v[3 * i] = k[0] - o[0]; v[3 * i + 1] = k[1] - o[1]; v[3 * i + 2] = k[2] - o[2];
+    }
+    var nt = Object.assign({}, t, { values: v });
+    return { clip: { name: clip.name, duration: clip.duration, tracks: clip.tracks.map(function (x) { return x === t ? nt : x; }) }, removed: hn, mode: mode };
+  }
+  function moves(clips, node) {
+    for (var c = 0; c < clips.length; c++) { var t = trk(clips[c], node); if (!t) continue; var k0 = key(t, 0);
+      for (var i = 1; i < t.times.length; i++) { var k = key(t, i); if (len([k[0] - k0[0], k[1] - k0[1], k[2] - k0[2]]) > 1e-6) return true; } }
+    return false;
+  }
+  function pickRoot(skel, clips, hips) {
+    var nodes = skel && skel.nodes || [], cand = {};
+    (clips || []).forEach(function (c) { (c.tracks || []).forEach(function (t) { if (t.path === 'translation') cand[t.node] = true; }); });
+    if (hips >= 0) for (var n = hips, guard = 0; n >= 0 && guard < 10000; n = nodes[n] ? nodes[n].parent : -1, guard++) if (cand[n] && moves(clips, n)) return n;
+    var best = -1, bd = Infinity;
+    Object.keys(cand).map(Number).sort(function (a, b) { return a - b; }).forEach(function (i) {
+      if (!moves(clips, i)) return; var d = 0; for (var p = nodes[i] ? nodes[i].parent : -1; p >= 0 && d < 10000; p = nodes[p] ? nodes[p].parent : -1) d++;
+      if (d < bd) { bd = d; best = i; } });
+    return best;
+  }
+  root.MuseRootMotion = { measure: measure, strip: strip, pickRoot: pickRoot };
+})(typeof window !== 'undefined' ? window : globalThis);

game/muse-authored/phase32/harness/ref/setup-schema.ref.js

@@ -0,0 +1,128 @@
+// [e32 coach] Reference implementation of the p32b setup-schema spec (harness oracle, Grok Bot). Not shipped.
+// Revised after the Muse review: the 'loaded from a file' warning now names a non-string name as String(name || '') like make() (was '').
+(function (root) {
+  var KIND = 'muse-engine-setup', VERSION = 1;
+  var UNITS = ['auto', 'm', 'cm', 'mm', 'in', 'ft'], UP = ['auto', 'y', 'z'], FACING = ['+z', '-z', '+x', '-x'], ROLES = ['idle', 'walk', 'run', 'shoot', 'death'], SOURCES = ['url', 'file'];
+  function isObj(v) { return v !== null && typeof v === 'object' && !Array.isArray(v); }
+  function slot(s, which) {
+    if (s === null || s === undefined) return null;
+    var source = s.source === 'file' ? 'file' : 'url';
+    var o = { name: String(s.name || ''), source: source, url: source === 'url' ? String(s.url || '') : null };
+    if (which === 'scene') o.asLevel = s.asLevel !== false;
+    o.units = UNITS.indexOf(s.units) >= 0 ? s.units : 'auto';
+    o.up = UP.indexOf(s.up) >= 0 ? s.up : 'auto';
+    if (which === 'character') {
+      o.facing = FACING.indexOf(s.facing) >= 0 ? s.facing : '+z';
+      var cp = {}, src = isObj(s.clipPicks) ? s.clipPicks : {};
+      ROLES.forEach(function (r) { if (Object.prototype.hasOwnProperty.call(src, r) && (typeof src[r] === 'string' || src[r] === null)) cp[r] = src[r]; });
+      o.clipPicks = cp;
+    }
+    return o;
+  }
+  function make(st) {
+    st = st || {};
+    var cfg = {}, c = isObj(st.config) ? st.config : {};
+    Object.keys(c).sort().forEach(function (k) { if (typeof c[k] === 'boolean') cfg[k] = c[k]; });
+    return { kind: KIND, version: VERSION, engine: String(st.engine || ''), savedAt: String(st.savedAt || ''), look: String(st.look || 'A'), config: cfg,
+      scene: slot(st.scene, 'scene'), character: slot(st.character, 'character') };
+  }
+  function urlOk(u) {
+    var t = u.trim(); if (t.length > 2048) return false;
+    if (/^https?:\/\//.test(t)) return true;
+    var slash = t.indexOf('/'), colon = t.indexOf(':');
+    return colon < 0 || (slash >= 0 && colon > slash);
+  }
+  var TOP = ['kind', 'version', 'engine', 'savedAt', 'look', 'config', 'scene', 'character'];
+  function validate(o, opts) {
+    opts = opts || {};
+    var E = [], W = [];
+    if (!isObj(o)) return { ok: false, errors: ['not a JSON object'], warnings: [], value: null };
+    if (o.kind !== KIND) E.push('kind must be "muse-engine-setup"');
+    var v = o.version;
+    if (typeof v !== 'number' || !Number.isInteger(v) || v < 1) E.push('version must be a positive integer');
+    else if (v > VERSION) E.push('version ' + v + ' is newer than this engine (' + VERSION + ')');
+    Object.keys(o).forEach(function (k) { if (TOP.indexOf(k) < 0) W.push('unknown key "' + k + '" ignored'); });
+    var cfg = {};
+    if (o.config !== undefined) {
+      if (!isObj(o.config)) W.push('config ignored (not an object)');
+      else Object.keys(o.config).forEach(function (k) {
+        if (typeof o.config[k] !== 'boolean') W.push('config.' + k + ' ignored (not true/false)');
+        else if (opts.configKeys && opts.configKeys.indexOf(k) < 0) W.push('config.' + k + ' ignored (unknown toggle)');
+        else cfg[k] = o.config[k];
+      });
+    }
+    var look = o.look === undefined ? 'A' : String(o.look);
+    if (o.look !== undefined && opts.looks && opts.looks.indexOf(look) < 0) { W.push('look "' + look + '" unknown, using ' + opts.looks[0]); look = opts.looks[0]; }
+    var slots = {};
+    ['scene', 'character'].forEach(function (sn) {
+      var s = o[sn];
+      if (s === undefined || s === null) { slots[sn] = null; return; }
+      if (!isObj(s)) { E.push(sn + ' must be an object or null'); return; }
+      if (s.source !== undefined && SOURCES.indexOf(s.source) < 0) E.push(sn + '.source must be url or file');
+      if ((s.source === 'url' || s.source === undefined) && !(typeof s.url === 'string' && s.url.length > 0)) E.push(sn + '.url is required for source url');
+      if (typeof s.url === 'string' && !urlOk(s.url)) E.push(sn + '.url is not allowed: ' + s.url);
+      if (s.name !== undefined && typeof s.name !== 'string') E.push(sn + '.name must be a string');
+      var fields = sn === 'scene' ? ['units', 'up'] : ['units', 'up', 'facing'];
+      fields.forEach(function (fd) {
+        var en = fd === 'units' ? UNITS : fd === 'up' ? UP : FACING;
+        if (s[fd] !== undefined && en.indexOf(s[fd]) < 0) W.push(sn + '.' + fd + ' "' + s[fd] + '" invalid, using ' + (fd === 'facing' ? '+z' : 'auto'));
+      });
+      if (sn === 'character' && isObj(s.clipPicks)) Object.keys(s.clipPicks).forEach(function (k) {
+        if (ROLES.indexOf(k) < 0) W.push(sn + '.clipPicks.' + k + ' ignored');
+        else if (!(typeof s.clipPicks[k] === 'string' || s.clipPicks[k] === null)) W.push(sn + '.clipPicks.' + k + ' ignored (not a clip name)');
+      });
+      var c2 = Object.assign({}, s);
+      if (typeof c2.name === 'string' && c2.name.length > 260) { c2.name = c2.name.slice(0, 260); W.push(sn + '.name truncated'); }
+      if (s.source === 'file') W.push(sn + ' "' + String(c2.name || '') + '" was loaded from a file: drop that file on the game view to load it');
+      slots[sn] = c2;
+    });
+    if (E.length) return { ok: false, errors: E, warnings: W, value: null };
+    return { ok: true, errors: [], warnings: W, value: make({ engine: o.engine, savedAt: o.savedAt, look: look, config: cfg, scene: slots.scene, character: slots.character }) };
+  }
+  function parse(text, opts) {
+    if (typeof text === 'string' && text.length > 262144) return { ok: false, errors: ['file too large (max 256 KB)'], warnings: [], value: null };
+    var o; try { o = JSON.parse(text); } catch (e) { return { ok: false, errors: ['not valid JSON: ' + e.message], warnings: [], value: null }; }
+    return validate(o, opts);
+  }
+  var MODEL = ['glb', 'gltf', 'fbx'], TAKES = ['gltf', 'fbx'], UNSUP = ['obj', 'blend', 'max', 'mb', 'ma', '3ds', 'dae', 'usd', 'usdz', 'stl', 'c4d', 'skp'], EXTRA = ['bin', 'png', 'jpg', 'jpeg', 'webp', 'tga', 'ktx2'];
+  function ext(n) { var i = String(n).lastIndexOf('.'); return i < 0 ? '' : String(n).slice(i + 1).toLowerCase(); }
+  function planDrop(files, setup, target) {
+    files = files || [];
+    var r = { setup: -1, scene: { main: -1, extras: [] }, character: { main: -1, extras: [] }, ignored: [], errors: [] };
+    var models = [], extras = [];
+    files.forEach(function (f, i) {
+      var e = ext(f.name);
+      if (e === 'json') { if (r.setup < 0) r.setup = i; else r.ignored.push(i); }
+      else if (MODEL.indexOf(e) >= 0) models.push(i);
+      else if (UNSUP.indexOf(e) >= 0) { r.ignored.push(i); r.errors.push(f.name + ': .' + e + ' is not supported, export FBX or glTF (.glb) instead'); }
+      else if (EXTRA.indexOf(e) >= 0) extras.push(i);
+      else { r.ignored.push(i); r.errors.push(f.name + ': unknown file type'); }
+    });
+    var rest = [];
+    models.forEach(function (i) {
+      var n = String(files[i].name).toLowerCase();
+      if (setup && setup.scene && r.scene.main < 0 && n === String(setup.scene.name).toLowerCase()) r.scene.main = i;
+      else if (setup && setup.character && r.character.main < 0 && n === String(setup.character.name).toLowerCase()) r.character.main = i;
+      else rest.push(i);
+    });
+    var unassigned = [];
+    rest.forEach(function (i) {
+      if ((target === 'scene' || target === 'character') && r[target].main < 0) r[target].main = i;
+      else if (r.setup < 0 && target == null && r.scene.main < 0) r.scene.main = i;
+      else if (r.setup < 0 && target == null && r.character.main < 0) r.character.main = i;
+      else unassigned.push(i);
+    });
+    // error messages for unassigned models are emitted in file order, after the type errors collected above
+    unassigned.forEach(function (i) { r.ignored.push(i); r.errors.push(files[i].name + ': dropped with no free slot (drop one model on each half of the game view)'); });
+    var takes = ['scene', 'character'].filter(function (s) { var m = r[s].main; return m >= 0 && TAKES.indexOf(ext(files[m].name)) >= 0; }); // [scope change P32-9] registered extensions may take extras
+    extras.forEach(function (i) { if (takes.length) takes.forEach(function (s) { r[s].extras.push(i); }); else r.ignored.push(i); });
+    r.ignored.sort(function (a, b) { return a - b; });
+    return r;
+  }
+  function registerModelExt(e, o) { // [scope change P32-9]
+    e = String(e == null ? '' : e).toLowerCase().replace(/^\./, '');
+    if (!/^[a-z0-9]+$/.test(e) || e === 'json' || EXTRA.indexOf(e) >= 0 || MODEL.indexOf(e) >= 0) return false;
+    MODEL.push(e); if (UNSUP.indexOf(e) >= 0) UNSUP.splice(UNSUP.indexOf(e), 1); if (o && o.extras) TAKES.push(e); return true;
+  }
+  root.MuseSetup = { KIND: KIND, VERSION: VERSION, make: make, validate: validate, parse: parse, planDrop: planDrop, registerModelExt: registerModelExt };
+})(typeof window !== 'undefined' ? window : globalThis);

game/muse-authored/phase32/harness/ref/texture-budget.ref.js

@@ -0,0 +1,27 @@
+// Coach reference (Grok Bot) for the Phase 32 part C spec: engine/check/texture-budget.js. Used only by the harness.
+(function (root) {
+  var LIMITS = { uploadMax: 1024, largeWarn: 2048, memWarnMB: 256 };
+  function pot(x) { return Math.pow(2, Math.round(Math.log2(Math.max(1, x)))); }
+  function isPot(x) { return x > 0 && (x & (x - 1)) === 0; }
+  function num(v) { return typeof v === 'number' && v > 0; }
+  function analyze(textures, opts) {
+    var o = {}; for (var k in LIMITS) o[k] = opts && num(opts[k]) ? opts[k] : LIMITS[k];
+    var list = (Array.isArray(textures) ? textures : []).filter(function (t) { return t && typeof t === 'object' && num(t.width) && num(t.height); });
+    var dec = 0, up = 0, largest = null, over = [], npot = [], L = null, firstNpot = null;
+    list.forEach(function (t) {
+      dec += t.width * t.height * 4 / 1048576;
+      up += Math.min(o.uploadMax, pot(t.width)) * Math.min(o.uploadMax, pot(t.height)) * 4 * 4 / 3 / 1048576;
+      if (!largest || t.width * t.height > largest.width * largest.height) largest = t;
+      if (Math.max(t.width, t.height) > o.largeWarn) { over.push(t.name); if (!L || t.width * t.height > L.width * L.height) L = t; }
+      if (!isPot(t.width) || !isPot(t.height)) { npot.push(t.name); if (!firstNpot) firstNpot = t; }
+    });
+    var w = [];
+    if (over.length) w.push({ code: 'LARGE_TEXTURES', level: 'warn', msg: over.length + ' texture(s) larger than ' + o.largeWarn + ' px (largest: ' + L.name + ' ' + L.width + 'x' + L.height + '): the engine shrinks every texture to ' + o.uploadMax + ' px, so the extra size only costs memory and loading time.', fix: 'Export 1024 or 2048 px maps (3ds Max: Render to Texture / resize the bitmaps; Maya: resize the file textures) before exporting.' });
+    if (dec > o.memWarnMB) w.push({ code: 'TEXTURE_MEMORY', level: 'warn', msg: 'Textures need about ' + Math.round(dec) + ' MB of memory while loading (' + list.length + ' images).', fix: 'Use fewer or smaller textures, or share one atlas between parts.' });
+    if (npot.length) w.push({ code: 'NPOT_TEXTURES', level: 'info', msg: npot.length + ' texture(s) are not a power of two (e.g. ' + firstNpot.name + ' ' + firstNpot.width + 'x' + firstNpot.height + '): they are resized on upload and may blur slightly.', fix: 'Use power-of-two sizes such as 512, 1024 or 2048.' });
+    return { count: list.length, totalDecodedMB: Math.round(dec * 10) / 10, totalUploadMB: Math.round(up * 10) / 10,
+      largest: largest ? { name: largest.name, width: largest.width, height: largest.height } : null, over: over, npot: npot, warnings: w };
+  }
+  root.MuseTextureBudget = { analyze: analyze, LIMITS: LIMITS };
+  if (typeof module !== 'undefined' && module.exports) module.exports = root.MuseTextureBudget;
+})(typeof window !== 'undefined' ? window : globalThis);