A 2D pixel-art game for learning programming languages and the cloud. Start on an overworld of castles, pick a kingdom (Java, Cloud…), then a world, and work through it part by part (1-1, 1-2, 1-3) by solving short coding challenges.
Play it: https://leoglez10.github.io/code-kingdoms/ (game: https://leoglez10.github.io/code-kingdoms/play/)
Status: in development. Being built from two earlier standalone games, Java Quest and Cloud Quest.
| Feature | Description |
|---|---|
| Overworld | A map of castles, one per kingdom. Locked castles show what's coming next. |
| Worlds and parts | Each kingdom has worlds (1, 2, 3…) and each world is split into parts (1-1, 1-2, 1-3). Clear one to unlock the next. |
| Java kingdom | 3 worlds, 30 levels: Fundamentos (variables, loops, arrays, methods), Herramientas (Strings, switch, do-while, 2D arrays) and Objetos (classes, constructors, encapsulation, inheritance). |
| Cloud kingdom | Type simulated AWS CLI commands (S3, IAM, EC2). Nothing reaches AWS and nothing costs money. |
| Achievements | Unlocked for clearing parts, finishing kingdoms, and more. |
| Your character | Give it your name (Leo by default) and pick from 3 hair, 3 shirt, 3 pants and 3 shoe styles. |
| Saved progress | Everything is saved in your browser (localStorage). |
bun install
bun run dev # open the URL Vite prints
bun run test # run the engine and game-logic tests
bun run build:site # landing page + game in _site/ (game under /play/)| Topic | Decision |
|---|---|
| UI | React + Vite, as a static single-page app (no server) |
| Saving | localStorage behind a single save module, so it can move to a backend later |
| Hosting | GitHub Pages via .github/workflows/pages.yml: the landing page (landing/) at the root, the game at /play/ |
| Runtime | Bun (install and scripts) |
| Tests | Vitest, run with bun run test |
Each kingdom is one module in src/worlds/ that provides its levels, how they group into worlds (chapters) and parts (partSizes), and an engine that checks the player's answer. Register it and it shows up as a new castle on the overworld, with no other changes needed.
- Overworld, kingdoms and parts
- Java and Cloud kingdoms migrated
- Achievements
- Character customization
- Java with 3 worlds (30 levels)
- Deploy to GitHub Pages
- More worlds for Cloud
- Optional accounts and cloud saves to play with friends


