alexvilelabah/age-of-ai

Age of AI is a browser based multiplayer real time strategy game inspired by classics like Age of Empires and Age of Mythology. Players gather resources, build a base, advance through ages, train units, and fight other players, all running entirely in the browser on a 2D canvas with no downloads or plugins needed. All the art and music were generated with AI, while the game logic and balancing were written by the project's author, and the whole thing is open source. The game supports English, Portuguese, and Spanish, detected automatically from the player's region and switchable from the options menu. To run it locally, a player needs Node.js 20 or newer. One terminal runs the WebSocket game server, and a second runs the web client through Vite. At least two browser tabs or machines are needed to play against another human, or a player can add a bot to play solo. For sharing the game outside a local network, the project includes scripts that use a Cloudflare Tunnel to generate a temporary public link, or to serve the game on a fixed domain if configured. The game is structured as three parts sharing one codebase: a shared package defining the game's types and network protocol, a Node.js server that is the single source of truth for what is actually happening in the match, and a browser client that renders the game and sends player actions to the server. The server runs the simulation ten times per second, using pathfinding and state machines for tasks like gathering and combat, and validates every command a player sends so a modified client cannot cheat. Code comments are written in Portuguese, though all variable and function names, plus the documentation, are in English. The project is released under the MIT License and welcomes outside contributions.