Skip to content

About

2D pixel-art game to learn programming languages and the cloud, kingdom by kingdom

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Code Kingdoms

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/)

Screenshots

Code Kingdoms — desktop

Code Kingdoms — mobile

🇪🇸 Leer en español

Status: in development. Being built from two earlier standalone games, Java Quest and Cloud Quest.

What you will be able to do

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).

Quick path

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/)

Stack

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

Adding a new kingdom

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.

Roadmap

  • 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

Built with

Built with Gentle-AI

About

2D pixel-art game to learn programming languages and the cloud, kingdom by kingdom

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages