mirror of
https://github.com/imjasonh/nescript
synced 2026-07-08 17:06:04 +00:00
8ababdcec4
A complete, playable port of the card game War: title screen with 0/1/2 player menu, animated deal, sliding cards, deck-count HUD, a "WAR!" tie-break with buried cards, and a victory screen with a fanfare. Source split across examples/war/*.ne (constants, assets, audio, deck/queue logic, RNG, render helpers, and one state file per game state) and pulled in via examples/war.ne. Drives nearly every NEScript subsystem at once: custom 88-tile sprite sheet (card frames, ranks, suits, font, BIG WAR letters); felt background nametable; pulse-1 / pulse-2 / noise sfx; looping march on pulse 2; an 8-bit Galois LFSR PRNG; queue-based decks that conserve cards across rounds; a phase machine inside the Playing state that handles draw/reveal/win/war/check; and an autopilot that boots straight into 0-PLAYERS mode so the headless jsnes harness captures real gameplay at frame 180. While building this I uncovered five compiler bugs / limitations in the v0.1 implementation; each is documented with a minimal reproduction, root cause, current workaround, and proposed fix in examples/war/COMPILER_BUGS.md. The most painful was the parameter-VarId aliasing one (#1b) — two functions sharing a parameter NAME end up sharing a single zero-page slot mapping across the whole program. Once those compiler bugs are fixed, the workarounds in war/*.ne should be reverted in the same PR. https://claude.ai/code/session_0143dTgh3UeRrtfHgQwzcv5z
57 lines
2.4 KiB
Text
57 lines
2.4 KiB
Text
// war/background.ne — the static 32×30 nametable loaded at reset.
|
||
//
|
||
// NEScript loads the *first* declared `background` into nametable 0
|
||
// before rendering is enabled, so whatever this file declares is
|
||
// visible on frame 0 of the ROM. We use a single felt-table
|
||
// background: a solid dark-green field for the play area. All UI
|
||
// (title banner, "PRESS A", win banners, etc.) is drawn on top via
|
||
// sprites so we never pay the cost of a full mid-frame nametable
|
||
// swap.
|
||
//
|
||
// Tile 0 is the linker's builtin smiley — we don't want that in the
|
||
// game, but it's safe to leave in the top-left corner because the
|
||
// whole nametable is painted with a blank tile. Use the legend's
|
||
// `.` entry to map every visible cell to tile 0 then rely on
|
||
// sub-palette 0 (forest/green/mint) making it look like felt.
|
||
//
|
||
// The `palette_map:` field is omitted on purpose: every attribute
|
||
// byte defaults to 0, which selects bg sub-palette 0 for every
|
||
// metatile. That's the felt palette.
|
||
|
||
background Felt {
|
||
legend {
|
||
".": 75 // TILE_FELT_BG — sparse mint flecks on dk_green
|
||
}
|
||
map: [
|
||
"................................",
|
||
"................................",
|
||
"................................",
|
||
"................................",
|
||
"................................",
|
||
"................................",
|
||
"................................",
|
||
"................................",
|
||
"................................",
|
||
"................................",
|
||
"................................",
|
||
"................................",
|
||
"................................",
|
||
"................................",
|
||
"................................",
|
||
"................................",
|
||
"................................",
|
||
"................................",
|
||
"................................",
|
||
"................................",
|
||
"................................",
|
||
"................................",
|
||
"................................",
|
||
"................................",
|
||
"................................",
|
||
"................................",
|
||
"................................",
|
||
"................................",
|
||
"................................",
|
||
"................................"
|
||
]
|
||
}
|