romdevtools 0.14.0 → 0.16.0

package/examples/snes/templates/sports-data.asm

@@ -5,10 +5,308 @@
 .section ".rodata1" superfree
 
 tilfont:
-.db 0, 0, 0, 0, 0, 0, 0, 0
+; 8x8 4bpp console font, 96 glyphs (ASCII 0x20-0x7F). consoleInitText
+; DMAs exactly 3072 bytes (96 tiles x 32 bytes, 4bpp) from here into
+; VRAM. Glyph index = (char - 0x20); only bitplane 0 carries pixels so
+; every set pixel uses palette colour 1. Public-domain font8x8 basic.
+;  0x20 '(space)'
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x21 '!'
+.db $18, $00, $3C, $00, $3C, $00, $18, $00, $18, $00, $00, $00, $18, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x22 '"'
+.db $6C, $00, $6C, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x23 '#'
+.db $6C, $00, $6C, $00, $FE, $00, $6C, $00, $FE, $00, $6C, $00, $6C, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x24 '$'
+.db $30, $00, $7C, $00, $C0, $00, $78, $00, $0C, $00, $F8, $00, $30, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x25 '%'
+.db $00, $00, $C6, $00, $CC, $00, $18, $00, $30, $00, $66, $00, $C6, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x26 '&'
+.db $38, $00, $6C, $00, $38, $00, $76, $00, $DC, $00, $CC, $00, $76, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x27 '''
+.db $60, $00, $60, $00, $C0, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x28 '('
+.db $18, $00, $30, $00, $60, $00, $60, $00, $60, $00, $30, $00, $18, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x29 ')'
+.db $60, $00, $30, $00, $18, $00, $18, $00, $18, $00, $30, $00, $60, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x2A '*'
+.db $00, $00, $66, $00, $3C, $00, $FF, $00, $3C, $00, $66, $00, $00, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x2B '+'
+.db $00, $00, $30, $00, $30, $00, $FC, $00, $30, $00, $30, $00, $00, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x2C ','
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $30, $00, $30, $00, $60, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x2D '-'
+.db $00, $00, $00, $00, $00, $00, $FC, $00, $00, $00, $00, $00, $00, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x2E '.'
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $30, $00, $30, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x2F '/'
+.db $06, $00, $0C, $00, $18, $00, $30, $00, $60, $00, $C0, $00, $80, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x30 '0'
+.db $7C, $00, $C6, $00, $CE, $00, $DE, $00, $F6, $00, $E6, $00, $7C, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x31 '1'
+.db $30, $00, $70, $00, $30, $00, $30, $00, $30, $00, $30, $00, $FC, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x32 '2'
+.db $78, $00, $CC, $00, $0C, $00, $38, $00, $60, $00, $CC, $00, $FC, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x33 '3'
+.db $78, $00, $CC, $00, $0C, $00, $38, $00, $0C, $00, $CC, $00, $78, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x34 '4'
+.db $1C, $00, $3C, $00, $6C, $00, $CC, $00, $FE, $00, $0C, $00, $1E, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x35 '5'
+.db $FC, $00, $C0, $00, $F8, $00, $0C, $00, $0C, $00, $CC, $00, $78, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x36 '6'
+.db $38, $00, $60, $00, $C0, $00, $F8, $00, $CC, $00, $CC, $00, $78, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x37 '7'
+.db $FC, $00, $CC, $00, $0C, $00, $18, $00, $30, $00, $30, $00, $30, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x38 '8'
+.db $78, $00, $CC, $00, $CC, $00, $78, $00, $CC, $00, $CC, $00, $78, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x39 '9'
+.db $78, $00, $CC, $00, $CC, $00, $7C, $00, $0C, $00, $18, $00, $70, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x3A ':'
+.db $00, $00, $30, $00, $30, $00, $00, $00, $00, $00, $30, $00, $30, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x3B ';'
+.db $00, $00, $30, $00, $30, $00, $00, $00, $00, $00, $30, $00, $30, $00, $60, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x3C '<'
+.db $18, $00, $30, $00, $60, $00, $C0, $00, $60, $00, $30, $00, $18, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x3D '='
+.db $00, $00, $00, $00, $FC, $00, $00, $00, $00, $00, $FC, $00, $00, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x3E '>'
+.db $60, $00, $30, $00, $18, $00, $0C, $00, $18, $00, $30, $00, $60, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x3F '?'
+.db $78, $00, $CC, $00, $0C, $00, $18, $00, $30, $00, $00, $00, $30, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x40 '@'
+.db $7C, $00, $C6, $00, $DE, $00, $DE, $00, $DE, $00, $C0, $00, $78, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x41 'A'
+.db $30, $00, $78, $00, $CC, $00, $CC, $00, $FC, $00, $CC, $00, $CC, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x42 'B'
+.db $FC, $00, $66, $00, $66, $00, $7C, $00, $66, $00, $66, $00, $FC, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x43 'C'
+.db $3C, $00, $66, $00, $C0, $00, $C0, $00, $C0, $00, $66, $00, $3C, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x44 'D'
+.db $F8, $00, $6C, $00, $66, $00, $66, $00, $66, $00, $6C, $00, $F8, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x45 'E'
+.db $FE, $00, $62, $00, $68, $00, $78, $00, $68, $00, $62, $00, $FE, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x46 'F'
+.db $FE, $00, $62, $00, $68, $00, $78, $00, $68, $00, $60, $00, $F0, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x47 'G'
+.db $3C, $00, $66, $00, $C0, $00, $C0, $00, $CE, $00, $66, $00, $3E, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x48 'H'
+.db $CC, $00, $CC, $00, $CC, $00, $FC, $00, $CC, $00, $CC, $00, $CC, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x49 'I'
+.db $78, $00, $30, $00, $30, $00, $30, $00, $30, $00, $30, $00, $78, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x4A 'J'
+.db $1E, $00, $0C, $00, $0C, $00, $0C, $00, $CC, $00, $CC, $00, $78, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x4B 'K'
+.db $E6, $00, $66, $00, $6C, $00, $78, $00, $6C, $00, $66, $00, $E6, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x4C 'L'
+.db $F0, $00, $60, $00, $60, $00, $60, $00, $62, $00, $66, $00, $FE, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x4D 'M'
+.db $C6, $00, $EE, $00, $FE, $00, $FE, $00, $D6, $00, $C6, $00, $C6, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x4E 'N'
+.db $C6, $00, $E6, $00, $F6, $00, $DE, $00, $CE, $00, $C6, $00, $C6, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x4F 'O'
+.db $38, $00, $6C, $00, $C6, $00, $C6, $00, $C6, $00, $6C, $00, $38, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x50 'P'
+.db $FC, $00, $66, $00, $66, $00, $7C, $00, $60, $00, $60, $00, $F0, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x51 'Q'
+.db $78, $00, $CC, $00, $CC, $00, $CC, $00, $DC, $00, $78, $00, $1C, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x52 'R'
+.db $FC, $00, $66, $00, $66, $00, $7C, $00, $6C, $00, $66, $00, $E6, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x53 'S'
+.db $78, $00, $CC, $00, $E0, $00, $70, $00, $1C, $00, $CC, $00, $78, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x54 'T'
+.db $FC, $00, $B4, $00, $30, $00, $30, $00, $30, $00, $30, $00, $78, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x55 'U'
+.db $CC, $00, $CC, $00, $CC, $00, $CC, $00, $CC, $00, $CC, $00, $FC, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x56 'V'
+.db $CC, $00, $CC, $00, $CC, $00, $CC, $00, $CC, $00, $78, $00, $30, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x57 'W'
+.db $C6, $00, $C6, $00, $C6, $00, $D6, $00, $FE, $00, $EE, $00, $C6, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x58 'X'
+.db $C6, $00, $C6, $00, $6C, $00, $38, $00, $38, $00, $6C, $00, $C6, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x59 'Y'
+.db $CC, $00, $CC, $00, $CC, $00, $78, $00, $30, $00, $30, $00, $78, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x5A 'Z'
+.db $FE, $00, $C6, $00, $8C, $00, $18, $00, $32, $00, $66, $00, $FE, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x5B '['
+.db $78, $00, $60, $00, $60, $00, $60, $00, $60, $00, $60, $00, $78, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x5C 'backslash'
+.db $C0, $00, $60, $00, $30, $00, $18, $00, $0C, $00, $06, $00, $02, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x5D ']'
+.db $78, $00, $18, $00, $18, $00, $18, $00, $18, $00, $18, $00, $78, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x5E '^'
+.db $10, $00, $38, $00, $6C, $00, $C6, $00, $00, $00, $00, $00, $00, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x5F '_'
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $FF, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x60 '`'
+.db $30, $00, $30, $00, $18, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x61 'a'
+.db $00, $00, $00, $00, $78, $00, $0C, $00, $7C, $00, $CC, $00, $76, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x62 'b'
+.db $E0, $00, $60, $00, $60, $00, $7C, $00, $66, $00, $66, $00, $DC, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x63 'c'
+.db $00, $00, $00, $00, $78, $00, $CC, $00, $C0, $00, $CC, $00, $78, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x64 'd'
+.db $1C, $00, $0C, $00, $0C, $00, $7C, $00, $CC, $00, $CC, $00, $76, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x65 'e'
+.db $00, $00, $00, $00, $78, $00, $CC, $00, $FC, $00, $C0, $00, $78, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x66 'f'
+.db $38, $00, $6C, $00, $60, $00, $F0, $00, $60, $00, $60, $00, $F0, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x67 'g'
+.db $00, $00, $00, $00, $76, $00, $CC, $00, $CC, $00, $7C, $00, $0C, $00, $F8, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x68 'h'
+.db $E0, $00, $60, $00, $6C, $00, $76, $00, $66, $00, $66, $00, $E6, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x69 'i'
+.db $30, $00, $00, $00, $70, $00, $30, $00, $30, $00, $30, $00, $78, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x6A 'j'
+.db $0C, $00, $00, $00, $0C, $00, $0C, $00, $0C, $00, $CC, $00, $CC, $00, $78, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x6B 'k'
+.db $E0, $00, $60, $00, $66, $00, $6C, $00, $78, $00, $6C, $00, $E6, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x6C 'l'
+.db $70, $00, $30, $00, $30, $00, $30, $00, $30, $00, $30, $00, $78, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x6D 'm'
+.db $00, $00, $00, $00, $CC, $00, $FE, $00, $FE, $00, $D6, $00, $C6, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x6E 'n'
+.db $00, $00, $00, $00, $F8, $00, $CC, $00, $CC, $00, $CC, $00, $CC, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x6F 'o'
+.db $00, $00, $00, $00, $78, $00, $CC, $00, $CC, $00, $CC, $00, $78, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x70 'p'
+.db $00, $00, $00, $00, $DC, $00, $66, $00, $66, $00, $7C, $00, $60, $00, $F0, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x71 'q'
+.db $00, $00, $00, $00, $76, $00, $CC, $00, $CC, $00, $7C, $00, $0C, $00, $1E, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x72 'r'
+.db $00, $00, $00, $00, $DC, $00, $76, $00, $66, $00, $60, $00, $F0, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x73 's'
+.db $00, $00, $00, $00, $7C, $00, $C0, $00, $78, $00, $0C, $00, $F8, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x74 't'
+.db $10, $00, $30, $00, $7C, $00, $30, $00, $30, $00, $34, $00, $18, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x75 'u'
+.db $00, $00, $00, $00, $CC, $00, $CC, $00, $CC, $00, $CC, $00, $76, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x76 'v'
+.db $00, $00, $00, $00, $CC, $00, $CC, $00, $CC, $00, $78, $00, $30, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x77 'w'
+.db $00, $00, $00, $00, $C6, $00, $D6, $00, $FE, $00, $FE, $00, $6C, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x78 'x'
+.db $00, $00, $00, $00, $C6, $00, $6C, $00, $38, $00, $6C, $00, $C6, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x79 'y'
+.db $00, $00, $00, $00, $CC, $00, $CC, $00, $CC, $00, $7C, $00, $0C, $00, $F8, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x7A 'z'
+.db $00, $00, $00, $00, $FC, $00, $98, $00, $30, $00, $64, $00, $FC, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x7B '{'
+.db $1C, $00, $30, $00, $30, $00, $E0, $00, $30, $00, $30, $00, $1C, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x7C '|'
+.db $18, $00, $18, $00, $18, $00, $00, $00, $18, $00, $18, $00, $18, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x7D '}'
+.db $E0, $00, $30, $00, $30, $00, $1C, $00, $30, $00, $30, $00, $E0, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x7E '~'
+.db $76, $00, $DC, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+;  0x7F 'del'
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00, $00
 
 palfont:
-.db 0, 0, 0, 0, 0, 0, 0, 0
+; 16-colour text palette (32 bytes, BGR555): colour 0 transparent
+; (backdrop shows through), colour 1 white (the text colour).
+.db $00, $00          ; 0 transparent
+.db $FF, $7F          ; 1 white
+.db $00, $00, $00, $00, $00, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00
+.db $00, $00, $00, $00, $00, $00, $00, $00
+.db $00, $00
 
 tilsprite:
 ; Tile 0 — solid 8×8 block, colour 1

package/examples/snes/templates/sports.c

@@ -16,6 +16,10 @@
 extern char tilfont, palfont;
 extern char tilsprite, palsprite;
 
+/* consoleVblank() copies the dirty text tilemap to VRAM during VBlank.
+ * No public prototype in console.h, so declare it; call once per frame. */
+extern void consoleVblank(void);
+
 #define COURT_TOP   16
 #define COURT_BOT   208
 #define PADDLE_H    24
@@ -23,6 +27,12 @@ extern char tilsprite, palsprite;
 #define PADDLE_X1   16
 #define PADDLE_X2   232
 
+/* oamSet's FIRST arg is a BYTE OFFSET into OAM, not a slot number: slot N lives
+ * at byte offset N*4. Passing the raw slot writes every sprite into OAM bytes
+ * 0-9, corrupting each other → black/garbled screen. (The shmup scaffold gets
+ * this right; sports/racing did not — SNES-1.) */
+#define SPR(slot) ((slot) << 2)
+
 static s16 p1y, p2y, bx, by;
 static s8  bdx, bdy;
 static u16 score_p1, score_p2;
@@ -53,6 +63,25 @@ static void render_scores(void) {
     consoleDrawText(24, 2, buf);
 }
 
+/* Draw a Pong court out of font glyphs on the text BG (no extra tile
+ * data needed): a dashed rail across the top and bottom of the playfield
+ * plus a dashed centre net. The text grid is 32x28 cells (8px each). */
+#define COURT_NET_COL  16
+#define COURT_ROW_TOP  4
+#define COURT_ROW_BOT  23
+static void draw_court(void) {
+    char rail[29];
+    u16 i;
+    for (i = 0; i < 28; i++) rail[i] = '-';
+    rail[28] = 0;
+    consoleDrawText(2, COURT_ROW_TOP, rail);
+    consoleDrawText(2, COURT_ROW_BOT, rail);
+    /* Dashed centre net: a ':' every other row between the rails. */
+    for (i = COURT_ROW_TOP + 1; i < COURT_ROW_BOT; i += 2) {
+        consoleDrawText(COURT_NET_COL, i, ":");
+    }
+}
+
 int main(void) {
     u16 p1, p2;
     u16 i, slot;
@@ -60,9 +89,13 @@ int main(void) {
 
     consoleSetTextMapPtr(0x6800);
     consoleSetTextGfxPtr(0x3000);
-    consoleSetTextOffset(0x0100);
+    consoleSetTextOffset(0x0000);   /* tile index = (char-0x20); font is at the BG char base */
     consoleInitText(0, 16 * 2, &tilfont, &palfont);
     setMode(BG_MODE1, 0);
+    /* consoleInitText DMAs the font but does NOT set the PPU BG base
+     * registers — point BG0 at the same font ($3000) + map ($6800). */
+    bgSetGfxPtr(0, 0x3000);
+    bgSetMapPtr(0, 0x6800, SC_32x32);
     bgSetDisable(1);
     bgSetDisable(2);
 
@@ -71,9 +104,10 @@ int main(void) {
     consoleDrawText(2, 1, "P1");
     consoleDrawText(28, 1, "P2");
     consoleDrawText(6, 26, "UP/DOWN MOVES YOUR PADDLE");
+    draw_court();   /* dashed rails + centre net (font glyphs, no extra tiles) */
 
     /* Hide all OAM slots initially. */
-    for (i = 0; i < 7; i++) oamSet(i, 0, 240, 3, 0, 0, 0, 0);
+    for (i = 0; i < 7; i++) oamSet(SPR(i), 0, 240, 3, 0, 0, 0, 0);
 
     setScreenOn();
     sfx_init();
@@ -83,15 +117,16 @@ int main(void) {
         slot = 0;
         /* Left paddle = 3 stacked 8×8 sprites */
         for (i = 0; i < PADDLE_H / 8; i++) {
-            oamSet(slot++, PADDLE_X1, (u16)(p1y + i * 8), 3, 0, 0, 0, 0);
+            oamSet(SPR(slot++), PADDLE_X1, (u16)(p1y + i * 8), 3, 0, 0, 0, 0);
         }
         for (i = 0; i < PADDLE_H / 8; i++) {
-            oamSet(slot++, PADDLE_X2, (u16)(p2y + i * 8), 3, 0, 0, 0, 0);
+            oamSet(SPR(slot++), PADDLE_X2, (u16)(p2y + i * 8), 3, 0, 0, 0, 0);
         }
-        oamSet(slot++, bx, by, 3, 0, 0, 0, 0);
+        oamSet(SPR(slot++), bx, by, 3, 0, 0, 0, 0);
         oamUpdate();
         render_scores();
         WaitForVBlank();
+        consoleVblank();
 
         p1 = padsCurrent(0);
         p2 = padsCurrent(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "romdevtools",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "description": "Tool server giving coding agents full control of homebrew ROM development AND reverse-engineering/romhacking across 14 retro platforms (NES, SNES, GB, Genesis, Atari, C64, PC Engine, MSX, ...) 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",

package/src/http/skill-doc.js

@@ -18,7 +18,7 @@ import { toolJsonSchema } from "./tool-registry.js";
  */
 export const mcpPreamble = [
   "romdev: homebrew retro game development + reverse-engineering for coding agents.",
-  "All ~34 tools register at session init — call any by name directly, no loading step. Each is a domain VERB with an operation axis: memory({op}), build({output}), breakpoint({on}), cpu({op}), sprites({op}), tiles({op}), disasm({target}), romPatch({op}), …",
+  "All ~32 tools register at session init — call any by name directly, no loading step. Each is a domain VERB with an operation axis: memory({op}), build({output}), breakpoint({on}), cpu({op}), sprites({op}), tiles({op}), disasm({target}), romPatch({op}), …",
   "catalog({op:'categories'}) maps the tools by purpose (a guide, not a gate); catalog({op:'status'}) is a session re-orient.",
 ].join("\n");
 

package/src/http/tool-registry.js

@@ -1,7 +1,7 @@
 // Tool registry harvester — the single source the HTTP route/skill/OpenAPI
 // surfaces build from.
 //
-// The MCP path registers 34 tools via registerTools(server, z, sessionKey),
+// The MCP path registers 32 tools via registerTools(server, z, sessionKey),
 // where `server` is an McpServer and each handler closes over `sessionKey` for
 // per-session host isolation. The HTTP surfaces (POST /tool/{name},
 // /skills/romdev/SKILL.md, /openapi.json, /documentation) want the EXACT same handlers,

package/src/mcp/tools/index.js

@@ -1,6 +1,6 @@
 // Register MCP tools on the server.
 //
-// The surface is ~34 consolidated domain tools (memory({op}), build({output}),
+// The surface is ~32 consolidated domain tools (memory({op}), build({output}),
 // breakpoint({on}), …) and EVERY one registers at session init. There is no
 // progressive-disclosure / lean mode anymore: the dynamic loadCategory dance
 // never propagated reliably to clients (they don't re-read tools/list after a
@@ -208,7 +208,7 @@ export function registerTools(server, z, sessionKey) {
   if (!sessionKey) sessionKey = randomUUID();
   // Clear validation errors for EVERY tool registered below: turns the SDK's
   // raw JSON validation dump into a plain sentence and catches unknown/misspelled
-  // params (which the SDK otherwise drops silently). One wrap, all 34 tools.
+  // params (which the SDK otherwise drops silently). One wrap, all 32 tools.
   // This is what lets the param descriptions stay terse — the guidance lives in
   // the error (paid only on a bad call), not in every agent's initial context.
   server = withClearToolErrors(server, z);
@@ -259,7 +259,7 @@ export function registerTools(server, z, sessionKey) {
   );
 
   // loadCategory + describeTool DELETED with the progressive-disclosure path:
-  // the whole surface is ~34 tools now and every one registers at session init,
+  // the whole surface is ~32 tools now and every one registers at session init,
   // so the dynamic lean-mode dance (which never worked reliably — clients don't
   // re-read tools/list after list_changed) has no reason to exist. `catalog`
   // still exposes the category map for orientation. (See the consolidation.)
@@ -293,7 +293,7 @@ export function registerTools(server, z, sessionKey) {
   // So by default we register EVERY category at session init. listCategories
   // / loadCategory still exist (idempotent, harmless) for clients that probe
   // Register EVERY category now — there is no lean/deferred mode anymore. The
-  // surface is small enough (~34 tools) that loading it all up front is the
+  // surface is small enough (~32 tools) that loading it all up front is the
   // right call (the dynamic loadCategory dance never propagated reliably to
   // clients). `disclosure.loadCategory("all")` is just the internal "register
   // all categories" helper here, not a user-facing tool.

package/src/mcp/tools/project.js

@@ -3,7 +3,7 @@
 // Policy (2026-05-25): no auto-injection at build time. createProject copies
 // every file the template depends on (runtime, headers, crt0, linker .cfg)
 // into the project directory. The project is then self-contained — any
-// `buildSource` / `runSource` call points at the project's own files via
+// `build({output:'run'})` call points at the project's own files via
 // sources/sourcesPaths/includePaths/crt0/linkerConfig args. If you take
 // the project elsewhere and rebuild with cc65/sdcc directly, every byte
 // that compiles is in the directory.
@@ -1086,7 +1086,7 @@ TEMPLATES.gba = {
     runtimeDirs: GBA_LIBTONC_RUNTIME_DIRS,
     lang: GBA_TONC_LANG,
     ext: ".gba",
-    describe: "Idiomatic Tonc-tutorial GBA C starter. #include <tonc.h>, TTE (Tonc Text Engine) draws 'Hello, Tonc!' on BG0 in MODE_0. Matches what every published GBA C tutorial at gbadev.net teaches. libtonc is compiled from its vendored source by the build (a fast prebuilt seed by default; pass rebuildSdk:true if you edit the SDK source) — the project gets the headers + gba_crt0 + linker script. Build with buildSource({platform:'gba', language:'c'}) — defaults to runtime:'libtonc'.",
+    describe: "Idiomatic Tonc-tutorial GBA C starter. #include <tonc.h>, TTE (Tonc Text Engine) draws 'Hello, Tonc!' on BG0 in MODE_0. Matches what every published GBA C tutorial at gbadev.net teaches. libtonc is compiled from its vendored source by the build (a fast prebuilt seed by default; pass rebuildSdk:true if you edit the SDK source) — the project gets the headers + gba_crt0 + linker script. Build with build({output:'run', platform:'gba', language:'c'}) — defaults to runtime:'libtonc'.",
   },
   tonc_hello_sprite: {
     main: "templates/tonc_hello_sprite.c",
@@ -1144,10 +1144,10 @@ TEMPLATES.gba = {
     runtimeDirs: GBA_LIBGBA_RUNTIME_DIRS,
     lang: GBA_LIBGBA_LANG,
     ext: ".gba",
-    describe: "Alternate GBA C starter using devkitPro's libgba SDK. MODE_3 framebuffer + red pixel. Pass runtime:'libgba' to buildSource — or just use the Tonc path (gba_hello_tonc) which is better aligned with what published tutorials teach.",
+    describe: "Alternate GBA C starter using devkitPro's libgba SDK. MODE_3 framebuffer + red pixel. Pass runtime:'libgba' to build({output:'run'}) — or just use the Tonc path (gba_hello_tonc) which is better aligned with what published tutorials teach.",
   },
   // R34: maxmod music demo. Ships a hand-authored CC0 chiptune.xm +
-  // its pre-built soundbank.bin. buildSource must be called with
+  // its pre-built soundbank.bin. build({output:'run'}) must be called with
   // `maxmod: true` AND binaryIncludes:{ "soundbank.bin": <bytes> } —
   // the buildGbaC layer auto-emits a `.incbin "soundbank.bin"` asm
   // stub exposing the soundbank under the global symbol soundbank_bin.
@@ -1173,7 +1173,7 @@ TEMPLATES.gba = {
     ext: ".gba",
     maxmod: true,
     binaryIncludes: ["soundbank.bin"],
-    describe: "Maxmod music demo (Tonc + libmm). Plays a CC0 chiptune.xm soundbank via mmInitDefault + mmStart + mmFrame, with START toggling pause. Pass `maxmod:true` AND `binaryIncludes:{\"soundbank.bin\": <bytes>}` to buildSource. The .xm source + generator script + pre-built soundbank.bin all ship in the project — edit and re-run mmutil to swap the tune.",
+    describe: "Maxmod music demo (Tonc + libmm). Plays a CC0 chiptune.xm soundbank via mmInitDefault + mmStart + mmFrame, with START toggling pause. Pass `maxmod:true` AND `binaryIncludes:{\"soundbank.bin\": <bytes>}` to build({output:'run'}). The .xm source + generator script + pre-built soundbank.bin all ship in the project — edit and re-run mmutil to swap the tune.",
   },
 };
 
@@ -1558,11 +1558,11 @@ Compiles **C89**, not C99/C11. Stick to:
     const incLines = runtimeHeaders.length > 0
       ? runtimeHeaders.map((h) => `    "${h.dst}":  "${h.dst}",`).join("\n")
       : "";
-    buildBlock = "```js\nrunSource({\n  platform: \"" + platform + "\",\n  sourcesPaths: {\n" + srcLines + "\n  },\n" + (incLines ? "  includePaths: {\n" + incLines + "\n  },\n" : "") + "  linkerConfig: /* contents of " + tmpl.linkerConfig.dst + " */,\n  frames: 60,\n})\n```";
+    buildBlock = "```js\nbuild({\n  output: \"run\",\n  platform: \"" + platform + "\",\n  sourcesPaths: {\n" + srcLines + "\n  },\n" + (incLines ? "  includePaths: {\n" + incLines + "\n  },\n" : "") + "  linkerConfig: /* contents of " + tmpl.linkerConfig.dst + " */,\n  frames: 240,\n})\n```";
   } else if (isSdccSm83) {
-    // GB / GBC (SDCC sm83). runSource BUILDS + RUNS + SCREENSHOTS in one
-    // call AND auto-fixes the cartridge header (Nintendo logo, header +
-    // global checksums, CGB flag on .gbc) — no manual patchGbHeader step.
+    // GB / GBC (SDCC sm83). build({output:'run'}) BUILDS + RUNS + SCREENSHOTS
+    // in one call AND auto-fixes the cartridge header (Nintendo logo, header +
+    // global checksums, CGB flag on .gbc) — no manual header-patch step.
     // Derive sources/includes from the template's runtime list so extra
     // .c files (e.g. music_demo's hUGEDriver) are listed too.
     const runtimeCs = (tmpl?.runtime ?? []).filter((r) => /\.c$/i.test(r.dst));
@@ -1573,7 +1573,7 @@ Compiles **C89**, not C99/C11. Stick to:
       ? runtimeHeaders.map((h) => `    "${h.dst}": "${h.dst}",`).join("\n")
       : "";
     buildBlock =
-      "```js\nrunSource({\n" +
+      "```js\nbuild({\n  output: \"run\",\n" +
       "  platform: \"" + platform + "\",\n" +
       "  sourcesPaths: {\n" + srcLines + "\n  },\n" +
       (incLines ? "  includePaths: {\n" + incLines + "\n  },\n" : "") +
@@ -1581,7 +1581,7 @@ Compiles **C89**, not C99/C11. Stick to:
       "  codeLoc: 0x150,\n" +
       "  frames: 60,\n" +
       "})\n```\n\n" +
-      "`runSource` auto-fixes the GB/GBC cartridge header (logo, checksums, " +
+      "`build({output:\"run\"})` auto-fixes the GB/GBC cartridge header (logo, checksums, " +
       "CGB flag) — you do **not** call a header patch for a freshly built " +
       "ROM. Use `romPatch({op:'gbHeader'})` only to fix up an existing/external " +
       "ROM on disk or to override header fields (title, cart type, ROM/RAM size).";
@@ -1589,12 +1589,12 @@ Compiles **C89**, not C99/C11. Stick to:
     const inc = runtimeHeaders.length > 0
       ? `\n  includePaths: { ${runtimeHeaders.map((h) => `"${h.dst}": "${h.dst}"`).join(", ")} },`
       : "";
-    buildBlock = "```js\nrunSource({\n  platform: \"" + platform + "\",\n  sourcePath: \"" + mainFilename + "\"," + inc + "\n  frames: 60,\n})\n```";
+    buildBlock = "```js\nbuild({\n  output: \"run\",\n  platform: \"" + platform + "\",\n  sourcePath: \"" + mainFilename + "\"," + inc + "\n  frames: 240,\n})\n```";
   } else if (platform === "c64") {
     const inc = runtimeHeaders.length > 0
       ? `\n  includePaths: { ${runtimeHeaders.map((h) => `"${h.dst}": "${h.dst}"`).join(", ")} },`
       : "";
-    buildBlock = "```js\nrunSource({\n  platform: \"c64\",\n  sourcePath: \"" + mainFilename + "\"," + inc + "\n  frames: 60,\n})\n```";
+    buildBlock = "```js\nbuild({\n  output: \"run\",\n  platform: \"c64\",\n  sourcePath: \"" + mainFilename + "\"," + inc + "\n  frames: 240,\n})\n```";
   } else if (platform === "snes" && /\.c$/i.test(mainFilename)) {
     // R19b: SNES C-mode template (PVSnesLib runtime auto-linked). Multi-file
     // build with sibling .asm providing data symbols (tilfont/palfont).
@@ -1631,7 +1631,7 @@ Compiles **C89**, not C99/C11. Stick to:
       .join("\n");
 
     buildBlock =
-      "```js\nrunSource({\n" +
+      "```js\nbuild({\n  output: \"run\",\n" +
       "  platform: \"snes\",\n" +
       "  language: \"c\",\n" +
       "  sourcesPaths: {\n" + sourceLines + "\n  },\n" +
@@ -1672,12 +1672,12 @@ Compiles **C89**, not C99/C11. Stick to:
       const incLine = runtimeHs.length > 0
         ? `\n  includePaths: {\n${runtimeHs.map((r) => `    "${r.dst}": "${r.dst}",`).join("\n")}\n  },`
         : "";
-      buildBlock = "```js\nrunSource({\n  platform: \"" + platform + "\",\n  language: \"c\",\n  sourcesPaths: {\n" + srcLines + "\n  }," + incLine + "\n  frames: 60,\n})\n```";
+      buildBlock = "```js\nbuild({\n  output: \"run\",\n  platform: \"" + platform + "\",\n  language: \"c\",\n  sourcesPaths: {\n" + srcLines + "\n  }," + incLine + "\n  frames: 240,\n})\n```";
     } else {
       const inc = runtimeAsmIncludes.length > 0
         ? `\n  includePaths: { ${runtimeAsmIncludes.map((r) => `"${r.dst}": "${r.dst}"`).join(", ")} },`
         : "";
-      buildBlock = "```js\nrunSource({\n  platform: \"" + platform + "\",\n  sourcePath: \"" + mainFilename + "\"," + inc + "\n  frames: 60,\n})\n```";
+      buildBlock = "```js\nbuild({\n  output: \"run\",\n  platform: \"" + platform + "\",\n  sourcePath: \"" + mainFilename + "\"," + inc + "\n  frames: 240,\n})\n```";
     }
   } else if (platform === "gba") {
     // GBA libtonc / libgba runtimes ship gba_sfx.{h,c} as a tiny DMG-APU
@@ -1692,12 +1692,12 @@ Compiles **C89**, not C99/C11. Stick to:
       const incLine = runtimeHs.length > 0
         ? `\n  includePaths: {\n${runtimeHs.map((r) => `    "${r.dst}": "${r.dst}",`).join("\n")}\n  },`
         : "";
-      buildBlock = "```js\nrunSource({\n  platform: \"gba\",\n  language: \"c\",\n  sourcesPaths: {\n" + srcLines + "\n  }," + incLine + "\n  frames: 60,\n})\n```";
+      buildBlock = "```js\nbuild({\n  output: \"run\",\n  platform: \"gba\",\n  language: \"c\",\n  sourcesPaths: {\n" + srcLines + "\n  }," + incLine + "\n  frames: 240,\n})\n```";
     } else {
-      buildBlock = "```js\nrunSource({ platform: \"gba\", language: \"c\", sourcePath: \"" + mainFilename + "\", frames: 60 })\n```";
+      buildBlock = "```js\nbuild({ output: \"run\", platform: \"gba\", language: \"c\", sourcePath: \"" + mainFilename + "\", frames: 240 })\n```";
     }
   } else {
-    buildBlock = "```js\nrunSource({ platform: \"" + platform + "\", sourcePath: \"" + mainFilename + "\", frames: 60 })\n```";
+    buildBlock = "```js\nbuild({ output: \"run\", platform: \"" + platform + "\", sourcePath: \"" + mainFilename + "\", frames: 240 })\n```";
   }
 
   let filesSection = `## Files\n\n- \`${mainFilename}\` — your game's entry point.\n`;
@@ -1714,7 +1714,7 @@ Compiles **C89**, not C99/C11. Stick to:
   }
   filesSection += `\nEvery byte that compiles into your ROM is in this directory. If you move the repo somewhere else, you don't need to install anything from romdev to rebuild it — the compiler binaries are the only external dependency.\n\n`;
 
-  const readme = `# ${title ?? name}\n\nA ${lang} project for ${platform}, scaffolded by romdev.\n\n${tmpl?.describe ? tmpl.describe + "\n\n" : ""}${filesSection}${c89Note}## Build + run with romdev\n\n${buildBlock}\n\n## Iterating\n\n- Edit \`${mainFilename}\` (or any of the runtime / crt0 / cfg files — they're yours).\n- Call \`runSource\` to see your changes. It builds + loads + runs + screenshots in one round trip.\n- Inspect at byte level: \`readMemory\`, \`inspectSprites\`, \`inspectPalette\`, \`inspectBackgroundMap({render:true})\`.\n- Open a playtest window for human eyes: \`loadCategory({category:"show"}); playtest({});\` — returns immediately, the window follows your rebuilds, and the emulator stays live for every other tool.\n`;
+  const readme = `# ${title ?? name}\n\nA ${lang} project for ${platform}, scaffolded by romdev.\n\n${tmpl?.describe ? tmpl.describe + "\n\n" : ""}${filesSection}${c89Note}## Build + run with romdev\n\n${buildBlock}\n\n## Iterating\n\n- Edit \`${mainFilename}\` (or any of the runtime / crt0 / cfg files — they're yours).\n- Call \`build({output:"run", ...})\` to see your changes. It builds + loads + runs + screenshots in one round trip.\n- Inspect at byte level: \`memory({op:"read"})\`, \`sprites({op:"inspect"})\`, \`palette({source:"live"})\`, \`background({view:"rendered"})\`.\n- Open a playtest window for human eyes: \`playtest({op:"open"})\` — returns immediately, the window follows your rebuilds, and the emulator stays live for every other tool.\n`;
   await fs.writeFile(path.join(projPath, "README.md"), readme, "utf-8");
   writtenFiles.push("README.md");
 
@@ -1783,7 +1783,7 @@ Compiles **C89**, not C99/C11. Stick to:
     snippetsCopied: withSnippets ? snippetFiles : null,
     sourceFile: path.join(projPath, mainFilename),
     toolchain: lang,
-    nextStep: `Edit ${path.join(projPath, mainFilename)} and call runSource with sourcesPaths/includePaths pointing at the project's files. Everything you need is in the directory — nothing is hidden.`,
+    nextStep: `Edit ${path.join(projPath, mainFilename)} and call build({output:"run", ...}) with sourcesPaths/includePaths pointing at the project's files (see the README's "Build + run" block for the exact call). Everything you need is in the directory — nothing is hidden.`,
   };
 }
 
@@ -1810,10 +1810,21 @@ async function createGameCore({ platform, genre, name, path: projPath, title, ov
         ? CANONICAL_GENRES.filter((g) => platformTemplates[g])
         : [];
       if (availableGenres.length === 0) {
+        // Point at the real, working project templates each genre-less
+        // platform actually ships, so the agent has a concrete next step
+        // instead of a bare "default".
+        const PROJECT_TEMPLATE_HINTS = {
+          msx: "default, sprite_move, music_sfx, catch_game",
+          pce: "default, sprite_move, music_sfx, catch_game",
+          atari2600: "default, single_screen, paddle, mini_invaders, music_demo",
+        };
+        const hint = PROJECT_TEMPLATE_HINTS[platform];
         throw new Error(
           `createGame: no genre scaffolds for platform '${platform}' yet. ` +
           `Supported platforms: ${genrePlatforms.join(", ") || "(none)"}. ` +
-          `For other platforms, use createProject({platform, template:"default"}) and build up from there.`
+          (hint
+            ? `For ${platform}, use createProject({platform:"${platform}", template:"..."}) with one of: ${hint}.`
+            : `For other platforms, use createProject({platform, template:"default"}) and build up from there.`)
         );
       }
       if (!availableGenres.includes(genre)) {