https://github.com/jbcom/a-good-old-fashioned-adventure
A 16-bit action RPG with a fully data-driven content pipeline — Koota ECS, React, anime.js pixel sprites, Capacitor Android
https://github.com/jbcom/a-good-old-fashioned-adventure
Last synced: 7 days ago
JSON representation
A 16-bit action RPG with a fully data-driven content pipeline — Koota ECS, React, anime.js pixel sprites, Capacitor Android
- Host: GitHub
- URL: https://github.com/jbcom/a-good-old-fashioned-adventure
- Owner: jbcom
- License: mit
- Created: 2026-06-10T21:55:47.000Z (8 days ago)
- Default Branch: main
- Last Pushed: 2026-06-11T07:50:49.000Z (8 days ago)
- Last Synced: 2026-06-11T08:08:33.340Z (8 days ago)
- Language: TypeScript
- Size: 1.56 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# A Good Old-Fashioned Adventure
A storybook action RPG for web and Android. The game presents 16-bit pixel
designs inside an HD-2D/r3f diorama stage, with React DOM UI, ToneJS audio,
AnimeJS motion, Yuka enemy behaviors, and Capacitor Android packaging.
The original single-file prototype remains at `kingdom_quest_rpg.tsx` as
reference-only history. The current game is data-driven:
| Directory | What lives there |
| --- | --- |
| `src/config/` | Numeric tunables: movement, combat, progression, AI, audio, UI |
| `src/content/` | Tiles, props, sprites, palettes, animations, maps, story, dialogue |
| `schemas/` | JSON Schema for config and content files |
| `src/sim/` | Pure Koota/Yuka simulation systems |
| `src/render/` | r3f/three.js world stage and pixel atlas pipeline |
| `src/persistence/` | Drizzle schema, Capacitor SQLite saves, Preferences settings |
| `docs/` | Pillar docs for architecture, design, world, platform, testing |
## Commands
- `pnpm dev` - Vite dev server.
- `pnpm lint` - Biome check.
- `pnpm typecheck` - TypeScript check.
- `pnpm test` - unit/content/sim/platform tests.
- `pnpm test:browser` - headed Vitest browser suite with GPU flags locally.
- `pnpm build` - production Vite build.
- `pnpm cap:sync` - build web assets and sync Capacitor Android.
- `cd android && ./gradlew :app:assembleDebug` - native debug APK build.
## Core Docs
Start with:
- `docs/ARCHITECTURE.md`
- `docs/CONTENT-ARCHITECTURE.md`
- `docs/DESIGN.md`
- `docs/WORLD.md`
- `docs/PLATFORM.md`
- `TESTING.md`
The active long-running build directive is `.agent-state/directive.md`.
## License
[MIT](LICENSE)