romdevtools 0.85.0 → 0.87.1

package/examples/pico8/templates/shmup.p8

@@ -0,0 +1,165 @@
+pico-8 cartridge // http://www.pico-8.com
+version 18
+__lua__
+-- star sweeper — a shmup scaffold
+-- genre example for romdev/pico8. real sprites (see __gfx__), looping
+-- music (__music__), sfx, title/play/gameover states, projectile pool,
+-- wave spawner, aabb collision, score + hi-score, thruster animation.
+-- fork it and reshape one thing at a time.
+
+-- sprite ids in __gfx__:
+--  1 ship, 2 ship-thrust, 3 shot, 4 foe-a, 5 foe-b, 6 explosion
+
+function _init()
+ hi=0
+ make_stars()
+ state="title"
+ boot=0
+ reset_game()
+
+ music(0)
+end
+
+function make_stars()
+ stars={}
+ for i=1,40 do add(stars,{x=rnd(128),y=rnd(128),s=rnd(2)+.4}) end
+end
+
+function reset_game()
+ player={x=60,y=100,cool=0,inv=0}
+ shots={}
+ foes={}
+ boom={}
+ score=0
+ lives=3
+ spawn=0
+ t=0
+end
+
+function _update()
+ t+=1
+ for s in all(stars) do s.y+=s.s if s.y>128 then s.y=0 s.x=rnd(128) end end
+
+ if state=="title" then
+  boot+=1
+  if boot>10 and (btnp(4) or btnp(5)) then state="play" reset_game() music(-1) end
+  return
+ end
+ if state=="over" then
+  if btnp(4) or btnp(5) then state="title" end
+  return
+ end
+
+ -- move
+ local mv=false
+ if btn(0) then player.x-=2 mv=true end
+ if btn(1) then player.x+=2 mv=true end
+ if btn(2) then player.y-=2 end
+ if btn(3) then player.y+=2 end
+ player.x=mid(4,player.x,116)
+ player.y=mid(4,player.y,120)
+ player.inv=max(0,player.inv-1)
+
+ -- fire
+ player.cool=max(0,player.cool-1)
+ if (btn(4) or btn(5)) and player.cool==0 then
+  add(shots,{x=player.x+3,y=player.y-2})
+  player.cool=7 sfx(3)
+ end
+ for s in all(shots) do s.y-=4 if s.y<-4 then del(shots,s) end end
+
+ -- spawn foes (ramping)
+ spawn-=1
+ if spawn<=0 then
+  add(foes,{x=rnd(104)+12,y=-8,vy=rnd(1)+1,vx=rnd(1)-.5,ty=flr(rnd(2))})
+  spawn=max(10,38-flr(t/90))
+ end
+ for f in all(foes) do
+  f.y+=f.vy f.x+=f.vx
+  if f.x<8 or f.x>116 then f.vx=-f.vx end
+  if f.y>134 then del(foes,f) end
+  if player.inv==0 and abs(f.x-player.x)<6 and abs(f.y-player.y)<6 then
+   del(foes,f) hurt()
+  end
+ end
+
+ -- shot vs foe
+ for s in all(shots) do
+  for f in all(foes) do
+   if abs(f.x-s.x)<5 and abs(f.y-s.y)<5 then
+    del(shots,s) del(foes,f)
+    add(boom,{x=f.x,y=f.y,f=0})
+    score+=10 sfx(4)
+    break
+   end
+  end
+ end
+ for b in all(boom) do b.f+=1 if b.f>8 then del(boom,b) end end
+end
+
+function hurt()
+ lives-=1 sfx(5)
+ add(boom,{x=player.x,y=player.y,f=0})
+ player.inv=60
+ if lives<=0 then
+  hi=max(hi,score) state="over"
+ end
+end
+
+function _draw()
+ cls(0)
+ for s in all(stars) do pset(s.x,s.y,s.s>1.6 and 7 or (s.s>1 and 6 or 5)) end
+
+ if state=="title" then
+  print("star sweeper",34,44,12)
+  print("★",26,44,10) print("★",96,44,10)
+  spr(1,60,62)
+  print("z/x  start",40,84,7)
+  print("hi "..hi,50,98,6)
+  print("arrows move · z/x fire",18,116,5)
+  return
+ end
+
+ for f in all(foes) do spr(f.ty==0 and 4 or 5,f.x-4,f.y-4) end
+ for s in all(shots) do spr(3,s.x-4,s.y-4) end
+ for b in all(boom) do spr(6,b.x-4,b.y-4) end
+ -- ship (blink when invulnerable)
+ if not (player.inv>0 and player.inv%4<2) then
+  spr((t%8<4) and 2 or 1,player.x-4,player.y-4)
+ end
+
+ rectfill(0,0,127,7,1)
+ print("score "..score,2,1,7)
+ print("hi "..hi,54,1,6)
+ for i=1,lives do spr(1,96+i*8,0) end
+
+ if state=="over" then
+  rectfill(28,52,100,80,0) rect(28,52,100,80,8)
+  print("game over",44,56,8)
+  print("score "..score,42,66,7)
+  print("z/x  title",40,74,6)
+ end
+end
+
+__gfx__
+00000000000c000000000c00000aa000000880000088880000000000000000000000000000000000000000000000000000000000000000000000000000000000
+0000000000ccc00000ccc0000aaaa000008888000899998000000000000000000000000000000000000000000000000000000000000000000000000000000000
+0070070000ccc00000ccc0000a00a000088888000988889000000000000000000000000000000000000000000000000000000000000000000000000000000000
+000770000cccccc00cc7cc00aa00aa008899988089aaaa9800000000000000000000000000000000000000000000000000000000000000000000000000000000
+000770000c7cc7c00c7cc7c0a0a00a0a0899998008aaaa8000000000000000000000000000000000000000000000000000000000000000000000000000000000
+0070070000c00c0000cccc00a000000a088888000899998000000000000000000000000000000000000000000000000000000000000000000000000000000000
+00000000000000000090900000a00a00008888000089980000000000000000000000000000000000000000000000000000000000000000000000000000000000
+00000000000000000090000000000000000880000008800000000000000000000000000000000000000000000000000000000000000000000000000000000000
+__sfx__
+010c00000c6530e6530c6530000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+010c00001805518055180551805518055180551305513055130551305511055110550e0550e0550e0550e0550c0550c0550c0550c055000000000000000000000000000000000000000000000000000000000000
+011c00002465524655216551d65500000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+000200003065528655236551e6551a655166551265510655000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+00030000186550f6550c6550a65508655066550465502655006550065500000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+010500000c6530a653086530565303653016530000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+0012000024250242502b2502b2502d2502d2502b2500000029250292502825028250262502625024250000002b2502b2502925029250282502825026250000002b2502b250292502925028250282502625000000
+00120000182300000018230000001d230000001d230000001a230000001a23000000182300000018230000001d230000001d230000001a230000001a230000001d230000001d2300000018230000001823000000
+__music__
+03 08094040

package/examples/pico8/templates/sports.p8

@@ -0,0 +1,140 @@
+pico-8 cartridge // http://www.pico-8.com
+version 18
+__lua__
+-- rally volley — a 2-player paddle sports scaffold
+-- genre example for romdev/pico8. paddle + ball sprites (see __gfx__),
+-- looping music, bounce sfx, angle-off-paddle physics, speed-up on rally,
+-- 1p-vs-cpu or 2p couch mode, first to 5. fork it.
+
+function _init()
+ state="title"
+ boot=0
+ ai=true
+ reset_match()
+
+ music(0)
+end
+
+function reset_match()
+ lp={y=64,score=0} rp={y=64,score=0}
+ rally=0
+ serve(pick_dir())
+end
+
+function pick_dir() return (rnd(1)<.5) and -1 or 1 end
+
+function serve(dir)
+ ball={x=64,y=64,dx=dir*1.4,dy=(rnd(2)-1)*1.1}
+ wait=36
+end
+
+function _update()
+ if state=="title" then
+  boot+=1
+  if btnp(2) or btnp(3) then ai=not ai sfx(3) end
+  if boot>10 and (btnp(4) or btnp(5)) then state="play" reset_match() music(-1) end
+  return
+ end
+ if state=="over" then
+  if btnp(4) or btnp(5) then state="title" end
+  return
+ end
+
+ if btn(2) then lp.y-=2 end
+ if btn(3) then lp.y+=2 end
+ lp.y=mid(12,lp.y,116)
+
+ if ai then
+  if ball.dx>0 then rp.y+=mid(-2,(ball.y-rp.y)*.11,2) end
+ else
+  if btn(4) then rp.y-=2 end
+  if btn(5) then rp.y+=2 end
+ end
+ rp.y=mid(12,rp.y,116)
+
+ if wait>0 then wait-=1 return end
+
+ ball.x+=ball.dx ball.y+=ball.dy
+ if ball.y<4 or ball.y>123 then ball.dy=-ball.dy sfx(0) end
+
+ if ball.dx<0 and ball.x<9 and abs(ball.y-lp.y)<11 then
+  ball.dx=abs(ball.dx)+.12 ball.dy+=(ball.y-lp.y)*.07 rally+=1 sfx(1)
+ end
+ if ball.dx>0 and ball.x>119 and abs(ball.y-rp.y)<11 then
+  ball.dx=-abs(ball.dx)-.12 ball.dy+=(ball.y-rp.y)*.07 rally+=1 sfx(1)
+ end
+ ball.dy=mid(-3,ball.dy,3)
+
+ if ball.x<0 then rp.score+=1 point() end
+ if ball.x>128 then lp.score+=1 point() end
+end
+
+function point()
+ sfx(2) rally=0
+ if lp.score>=5 or rp.score>=5 then
+  winner=lp.score>rp.score and "left" or "right"
+  state="over"
+ else
+  serve(pick_dir())
+ end
+end
+
+-- a tall paddle bar (10 tall, 3 wide) with a lighter core so it reads clearly
+function paddle(x,y,col)
+ rectfill(x,y-9,x+2,y+9,col)
+ rectfill(x+1,y-8,x+1,y+8,7)  -- white core stripe
+end
+
+function _draw()
+ cls(0)
+ -- dashed center net
+ for y=2,124,8 do rectfill(63,y,64,y+4,5) end
+
+ if state=="title" then
+  print("rally volley",38,36,12)
+  paddle(24,64,12) paddle(102,64,8)
+  rectfill(62,62,65,65,7)  -- ball
+  print("mode: "..(ai and "1p vs cpu" or "2 player"),34,80,7)
+  print("up/down  toggle",30,90,6)
+  print("z/x  start",40,102,7)
+  return
+ end
+
+ paddle(4,lp.y,12)      -- left paddle (blue, player 1)
+ paddle(121,rp.y,8)     -- right paddle (red, cpu/p2)
+ rectfill(ball.x-1,ball.y-1,ball.x+1,ball.y+1,7)  -- ball
+
+ rectfill(0,0,127,8,0)
+ print(lp.score,40,2,12)
+ print(rp.score,84,2,8)
+ if rally>2 then print("rally "..rally,52,2,10) end
+
+ if state=="over" then
+  rectfill(24,52,104,78,0) rect(24,52,104,78,11)
+  print(winner.." wins!",38,58,11)
+  print(lp.score.." - "..rp.score,52,68,7)
+ end
+end
+
+__gfx__
+0000000000cccc000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+000000000cccccc0000cc00000cc0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+000000000c7777c000cccc00cccc0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+000000000c7777c000cccc00cccc0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+000000000c7777c000cccc00cccc0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+000000000cccccc000cccc00cccc0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+0000000000cccc00000cc00000cc0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+__sfx__
+010800001505015050000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+010400001f05524055000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+011000000c05508055050550000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+010400001c0551c055000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+00100000183501c3501d3501f35000000183501c3501d3501f35000000183501c3501d3501f3501c350183501c3501a350000001a3501c3501f3501f3501c3501f3501d3501c3501a35018350000000000000000
+00100000182300000000000000001f230000000000000000182300000000000000001f230000000000000000182300000000000000001d2300000000000000001f23000000000000000018230000000000000000
+__music__
+03 08094040

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "romdevtools",
-  "version": "0.85.0",
+  "version": "0.87.1",
   "description": "Tool server giving coding agents full control of homebrew ROM development AND reverse-engineering/romhacking across 17 retro platforms (NES, SNES, GB, Genesis, Atari, C64, PC Engine, MSX, PlayStation, N64, Dreamcast, ...) via WASM toolchains + emulator cores. Use over plain HTTP, as an Agent Skill, or as an MCP server.",
   "type": "module",
   "main": "src/mcp/server.js",
@@ -13,8 +13,7 @@
     "postinstall": "node src/install/postinstall.mjs",
     "smoke": "node --enable-source-maps src/cli/smoke.js",
     "mcp": "node --enable-source-maps src/mcp/server.js",
-    "test": "node --test 'src/**/*.test.js' 'test/**/*.test.js'",
-    "test:jsgame": "node --experimental-vm-modules --test-force-exit --test test/jsgame-host.test.js"
+    "test": "node --test 'src/**/*.test.js' 'test/**/*.test.js'"
   },
   "keywords": [
     "mcp",
@@ -56,10 +55,11 @@
     "romdev-audio-resampler": "0.1.0",
     "romdev-core-beetle-psx-hw": "0.2.0",
     "romdev-core-bluemsx": "0.7.0",
+    "romdev-core-fake08": "0.1.0",
     "romdev-core-fceumm": "0.11.0",
     "romdev-core-flycast": "0.2.0",
     "romdev-core-gambatte": "0.10.0",
-    "romdev-core-gametank": "0.1.0",
+    "romdev-core-gametank": "0.2.0",
     "romdev-core-geargrafx": "0.8.0",
     "romdev-core-gpgx": "0.13.0",
     "romdev-core-handy": "0.8.0",
@@ -111,5 +111,8 @@
   "homepage": "https://github.com/monteslu/romdev#readme",
   "bugs": {
     "url": "https://github.com/monteslu/romdev/issues"
+  },
+  "devDependencies": {
+    "rawr": "^1.0.1"
   }
 }

package/src/cheats/gamegenie.js

@@ -277,6 +277,98 @@ export function decodeSnesGameGenie(code) {
   return { address, value };
 }
 
+// ── GameTank Game Genie ─────────────────────────────────────────────────
+// A NEW format for Clyde Shaffer's open GameTank console — no prior art exists
+// (nobody has made GameTank cheat codes before). The GameTank CPU (W65C02S) sees a
+// flat 16-bit address space, so a code encodes a 16-bit READ address + an 8-bit
+// substitute value, plus an optional 8-bit compare byte (the compare form survives
+// the cart's flash bank switching, exactly like NES/GB compare codes). The device
+// intercepts the CPU's bus read and substitutes the value — identical behaviour to
+// a hardware Game Genie you could build for the console's open cart bus.
+//
+// Encoding: a distinct 16-letter wheel (so codes read as GameTank, not NES). The
+// payload nibbles are laid out and lightly scrambled so a small address change moves
+// several letters (the GG "feel"), then a 1-nibble checksum guards typos.
+//   plain:   6 payload nibbles (addr16 + val8) + 1 checksum = 7 letters, shown "XXX-XXXX"
+//   compare: 8 payload nibbles (addr16 + val8 + cmp8) + 1 checksum = 9 letters, "XXXX-XXXXX"
+const GT_GG_LETTERS = "KLMNPQRSTVWXYZ23"; // 16 distinct glyphs, no vowels/0-1-O-I ambiguity
+
+function gtNibblesToLetters(nibs) {
+  return nibs.map((x) => GT_GG_LETTERS[x & 0xF]).join("");
+}
+function gtLettersToNibbles(code) {
+  const clean = code.replace(/-/g, "").toUpperCase();
+  const n = [];
+  for (const ch of clean) {
+    const v = GT_GG_LETTERS.indexOf(ch);
+    if (v < 0) return null;
+    n.push(v);
+  }
+  return n;
+}
+// Simple nibble checksum: XOR of all payload nibbles, folded to 4 bits.
+function gtChecksum(payloadNibs) {
+  let c = 0;
+  for (const x of payloadNibs) c ^= x & 0xF;
+  return c & 0xF;
+}
+// Scramble/unscramble the payload-nibble ORDER (a fixed permutation) so a code
+// doesn't read as plain hex. Self-inverse pairs keep decode trivial.
+const GT_PERM6 = [3, 0, 5, 1, 4, 2];      // plain: 6 nibbles
+const GT_PERM8 = [5, 2, 7, 0, 4, 1, 6, 3]; // compare: 8 nibbles
+function applyPerm(arr, perm) { return perm.map((i) => arr[i]); }
+function invertPerm(perm) {
+  const inv = new Array(perm.length);
+  perm.forEach((p, i) => { inv[p] = i; });
+  return inv;
+}
+
+/** ENCODE → GameTank Game Genie. `address` 0..0xFFFF, `value` 0..0xFF, optional
+ *  `compare` 0..0xFF. Returns the dashed letter code, or null if out of range. */
+export function encodeGameTankGameGenie({ address, value, compare }) {
+  if (address == null || value == null) return null;
+  const a = address & 0xFFFF, v = value & 0xFF;
+  if (address < 0 || address > 0xFFFF || value < 0 || value > 0xFF) return null;
+
+  // payload nibbles, MSB-first: addr[15:12],addr[11:8],addr[7:4],addr[3:0],val[7:4],val[3:0]
+  let payload = [(a >> 12) & 0xF, (a >> 8) & 0xF, (a >> 4) & 0xF, a & 0xF, (v >> 4) & 0xF, v & 0xF];
+  let perm = GT_PERM6;
+  if (compare != null) {
+    if (compare < 0 || compare > 0xFF) return null;
+    const c = compare & 0xFF;
+    payload = payload.concat([(c >> 4) & 0xF, c & 0xF]);
+    perm = GT_PERM8;
+  }
+  const scrambled = applyPerm(payload, perm);
+  const sum = gtChecksum(payload);
+  const nibs = scrambled.concat([sum]);
+  const letters = gtNibblesToLetters(nibs);
+  // dash after the first 3 (plain) / 4 (compare) letters for readability
+  const cut = compare != null ? 4 : 3;
+  return letters.slice(0, cut) + "-" + letters.slice(cut);
+}
+
+/** Decode a GameTank Game Genie code → { address, value, compare? } or null. */
+export function decodeGameTankGameGenie(code) {
+  const n = gtLettersToNibbles(code);
+  if (!n) return null;
+  let perm, payloadLen;
+  if (n.length === 7) { perm = GT_PERM6; payloadLen = 6; }
+  else if (n.length === 9) { perm = GT_PERM8; payloadLen = 8; }
+  else return null;
+
+  const scrambled = n.slice(0, payloadLen);
+  const sum = n[payloadLen];
+  const payload = applyPerm(scrambled, invertPerm(perm));
+  if (gtChecksum(payload) !== sum) return null; // typo / not a valid GameTank code
+
+  const address = ((payload[0] << 12) | (payload[1] << 8) | (payload[2] << 4) | payload[3]) & 0xFFFF;
+  const value = ((payload[4] << 4) | payload[5]) & 0xFF;
+  if (payloadLen === 6) return { address, value };
+  const compare = ((payload[6] << 4) | payload[7]) & 0xFF;
+  return { address, value, compare };
+}
+
 // ── Game Boy GameShark ──────────────────────────────────────────────────
 // 8 hex digits "TTVVAAAA": TT = type/RAM-bank byte, VV = replacement value,
 // AAAA = the RAM address in LITTLE-ENDIAN order. (Distinct from GB Game Genie,
@@ -340,6 +432,11 @@ export function detectDevice(code, platform) {
       if (hex8 || hyphenHex) return "action-replay"; // SMS/GG Action Replay
       if (/^[0-9A-F]{3}-[0-9A-F]{3}/i.test(c)) return "game-genie";
       return "unknown";
+    case "gametank":
+      // 7-letter (XXX-XXXX) or 9-letter (XXXX-XXXXX) GameTank wheel code.
+      if (/^[KLMNPQRSTVWXYZ23]{3}-[KLMNPQRSTVWXYZ23]{4}$/i.test(c) ||
+          /^[KLMNPQRSTVWXYZ23]{4}-[KLMNPQRSTVWXYZ23]{5}$/i.test(c)) return "game-genie";
+      return "unknown";
     default:
       return "unknown";
   }
@@ -370,6 +467,8 @@ export function decodeCode(code, platform) {
     case "gg":
       // SMS/GG Action Replay raw-hex (addr/val, no scramble).
       return decodeProActionReplay(c, platform);
+    case "gametank":
+      return decodeGameTankGameGenie(c);
     default:
       return null;
   }
@@ -476,6 +575,7 @@ export function nativeDevicesFor(platform) {
     case "snes": return ["pro-action-replay", "game-genie"];
     case "gb": case "gbc": return ["game-genie", "gameshark"];
     case "sms": case "gg": return ["action-replay"];
+    case "gametank": return ["game-genie"];
     default: return ["raw"];
   }
 }
@@ -494,6 +594,7 @@ export function encodeForDevice({ address, value, compare }, platform, device) {
       else if (["genesis", "megadrive", "md"].includes(platform)) code = encodeGenesisGameGenie({ address, value });
       else if (["gb", "gbc"].includes(platform)) code = encodeGbGameGenie({ address, value, compare });
       else if (platform === "snes") code = encodeSnesGameGenie({ address, value });
+      else if (platform === "gametank") code = encodeGameTankGameGenie({ address, value, compare });
       return code ? { code, device: "game-genie" } : null;
     }
     case "pro-action-replay": {

package/src/cores/capabilities.js

@@ -198,6 +198,33 @@ export const CAPABILITIES = {
       cart: true, disasm: true, decompile: true,
     },
   },
+  pico8: {
+    // FAKE-08 (MIT) runs PICO-8 carts. PICO-8 is a Lua VM, not a real CPU — so there's
+    // no machine code to disassemble/decompile and no CPU register file (cpuState N/A).
+    // But: build=PACKAGE a .p8 cart (Lua + gfx/sfx/map sections); run/screenshot work;
+    // memory works — the romdev patch exposes the full 64KB PICO-8 address space as
+    // system_ram (sprite sheet, map, flags, music, sfx, general RAM, screen buffer).
+    // disasm here is target:'source' — the cart IS Lua source, so we return the Lua
+    // itself (the honest "understand this cart" path), not a machine-code listing.
+    // It renders to a 128×128 framebuffer (poke to screen memory), so the inspect-*
+    // tile/sprite-table tools are N/A like gametank/the disc platforms.
+    // tier:"fantasy" — a fantasy console (Lua VM), not a CPU emulator. Held to its OWN
+    // conformance, NOT the canonical-14 cross-checks (which assume CPU disasm/decompile/
+    // cpuState/tile inspectors every real console has). Excluded from CONTRACT_PLATFORMS
+    // via NEXTGEN_TIER_PLATFORMS.
+    tier: "fantasy",
+    cpuFamily: "lua", decompileQuality: "n/a",
+    cpus: { main: "", secondary: [] }, // Lua VM — no CPU register file
+    audioChips: [], // audioDebug not wired (PICO-8's synth isn't a fixed-register chip we decode)
+    memoryRegions: [...GENERIC_REGIONS],
+    renderingKind: "framebuffer", introspection: "shallow",
+    ops: {
+      build: true, run: true, screenshot: true,
+      inspectSprites: false, inspectPalette: false, inspectBackground: false,
+      renderingContext: false, cpuState: false, audioDebug: false,
+      cart: false, disasm: true, decompile: false,
+    },
+  },
   pce: {
     cpuFamily: "huc6280", decompileQuality: "medium",
     cpus: { main: "", secondary: [] }, // getCPUState main NOT wired for pce
@@ -316,7 +343,7 @@ export const MIPS_TIER_PLATFORMS = Object.entries(CAPABILITIES)
  *  is held to its OWN conformance, not the "all 14" cross-checks; a new platform
  *  starts here (analysis-first) and graduates as run/build/etc. land. */
 export const NEXTGEN_TIER_PLATFORMS = Object.entries(CAPABILITIES)
-  .filter(([, c]) => c.tier === "mips" || c.tier === "sh")
+  .filter(([, c]) => c.tier === "mips" || c.tier === "sh" || c.tier === "fantasy")
   .map(([p]) => p);
 
 /** Back-compat: the analysis-only set is now empty (PS1/N64 gained run/screenshot

package/src/cores/registry.js

@@ -54,6 +54,11 @@ export const CORES = {
   pce: { platform: "pce", coreName: "geargrafx", pkg: "romdev-core-geargrafx", displayName: "PC Engine / TurboGrafx-16 (Geargrafx)", aka: "turbografx,tg16,pcengine" },
   msx: { platform: "msx", coreName: "bluemsx", pkg: "romdev-core-bluemsx", displayName: "MSX / MSX2 (blueMSX)", aka: "msx2" },
   gametank: { platform: "gametank", coreName: "gametank", pkg: "romdev-core-gametank", displayName: "GameTank (Clyde Shaffer)", aka: "gtr" },
+  // FAKE-08 = open-source (MIT) PICO-8 player, NOT Lexaloffle's PICO-8, no BIOS. Runs
+  // .p8 (Lua source) + .p8.png carts at 128×128. It's a Lua VM, not a real CPU — the
+  // capability descriptor marks cpuState/disasm/memory-region tools not-applicable; the
+  // .p8 Lua source IS the readable "disassembly".
+  pico8: { platform: "pico8", coreName: "fake08", pkg: "romdev-core-fake08", displayName: "PICO-8 (FAKE-08)", aka: "p8,fake08" },
   // 32-bit MIPS tier. These cores HW-render (GL): the host lazy-loads the OPTIONAL
   // webgl-node bridge only when one of these boots (hwRender:true). The other 14 are
   // software-rendered and never touch GL, so a headless user without the GPU module

package/src/host/LibretroHost.js

@@ -212,8 +212,14 @@ export const PLATFORM_VIRTUAL_EXT = {
   atari7800:  ".a78",
   pce:        ".pce",
   msx:        ".rom",
+  pico8:      ".p8",
 };
 import { RETRO_DEVICE_JOYPAD, ROMDEV_PIXEL_FORMAT_RGBA8888 } from "./retroConstants.js";
+import { decodeCode as decodeCheatCode } from "../cheats/gamegenie.js";
+
+// Platforms whose core stubs retro_cheat_set but ships romdev's value-override cheat
+// device (romdev_cheat_set) — cheats route through that read-substitution instead.
+const CHEAT_PREFER_ROMDEV_DEVICE = new Set(["gametank"]);
 
 // C64 controller→keyboard map (the Batocera/RetroDeck model: a CONTROLLER alone
 // plays C64 — no physical keyboard needed — by mapping spare buttons/stick to
@@ -1536,7 +1542,18 @@ export class LibretroHost {
    *  (Older bundled cores predate the cheat-export build flag.) */
   cheatsSupported() {
     const mod = this.mod;
-    return !!(mod && typeof mod._retro_cheat_set === "function");
+    // Real cheat support = EITHER the core's retro_cheat_set actually applies codes,
+    // OR romdev's value-override cheat device (romdev_cheat_set) is present. Some cores
+    // (GameTank) stub retro_cheat_set but ship the romdev_cheat_* read-substitution
+    // device — that's the working path for them.
+    return !!(mod && (typeof mod._romdev_cheat_set === "function" || typeof mod._retro_cheat_set === "function"));
+  }
+
+  /** True if this core applies cheats via romdev's value-override device (romdev_cheat_set)
+   *  rather than the libretro retro_cheat_set (which is a stub on some cores). */
+  _usesRomdevCheatDevice() {
+    return !!(this.mod && typeof this.mod._romdev_cheat_set === "function" &&
+      CHEAT_PREFER_ROMDEV_DEVICE.has(this.status.platform));
   }
 
   /**
@@ -1553,6 +1570,32 @@ export class LibretroHost {
    */
   setCheat(index, code, enabled = true) {
     const mod = this._needMod();
+
+    // romdev value-override device (GameTank etc.): the core's retro_cheat_set is a
+    // stub, but romdev_cheat_set installs a hardware-faithful read substitution. Decode
+    // the code to {address,value,compare} and hand it to the device.
+    if (this._usesRomdevCheatDevice()) {
+      const decoded = decodeCheatCode(String(code), this.status.platform);
+      if (!decoded || decoded.address == null || decoded.value == null) {
+        throw new Error(
+          `setCheat: could not decode '${code}' for ${this.status.platform}. ` +
+          `Provide a GameTank Game Genie code or a raw ADDR:VAL[:COMPARE].`,
+        );
+      }
+      mod._romdev_cheat_set(
+        index >>> 0,
+        decoded.address & 0xFFFF,
+        decoded.value & 0xFF,
+        (decoded.compare ?? 0) & 0xFF,
+        decoded.compare != null ? 1 : 0,
+        enabled ? 1 : 0,
+      );
+      if (!this._activeCheats) this._activeCheats = new Map();
+      if (enabled) this._activeCheats.set(index, code);
+      else this._activeCheats.delete(index);
+      return;
+    }
+
     if (typeof mod._retro_cheat_set !== "function") {
       throw new Error(
         "this core build does not expose the cheat interface (retro_cheat_set). " +

package/src/mcp/tools/cheats.js

@@ -18,6 +18,9 @@ const GG_ADDR_RANGE = {
   snes: [0x008000, 0xFFFFFF], // mapped ROM ($xx:8000-$xx:FFFF); the Game Genie
                               // ROM device patches here. (Pro Action Replay is
                               // a RAM poke — for a ROM patch we pick GG below.)
+  gametank: [0x0000, 0xFFFF], // flat 16-bit CPU space. GameTank's Game Genie is a
+                              // READ substitution on the bus, so any read address is
+                              // valid (RAM or cart ROM). A NEW format — see gamegenie.js.
 };
 
 // The native ROM-PATCH device per platform (installs a read-intercept), as
@@ -94,6 +97,7 @@ const SUPPORTED = new Set([
 const MAKE_CHEAT_PLATFORMS = [
   "nes", "gb", "gbc", "snes", "genesis", "sms", "gg",
   "atari2600", "atari7800", "lynx", "gba", "c64", "pce", "msx",
+  "gametank", // NEW: GameTank Game Genie (read-substitution device) — see gamegenie.js
 ];
 
 // gameCheats indexes whose codes are predominantly ENCRYPTED at the source