neoxu954/animal-world-cup

Animal Cup is a browser based football game where you pick your team from eight animal national squads, arrange a formation, and then either watch an AI simulate a 7 versus 7 match or take control yourself with a keyboard, touchscreen, or a phone used as a wireless gamepad. It draws inspiration from classic arcade football games, and it started as a remix of an existing project called Animal Cup on the HappySeeds platform before being rebuilt and open sourced with help from Claude Code. The game supports a few different ways to play. You can play locally by yourself, or set up a local area network match where the game runs on a shared big screen while friends' phones scan a QR code and become wireless controllers. There are also two invite only online modes for playing over the public internet: one where the host and opponent each control the match directly with keyboard or touch in their own browser, and another where both sides use a shared screen paired with a phone controller, similar to the LAN mode but working across the internet using six character room codes. Under the hood, the match simulation itself always runs on the browser of whoever created the room, described as host-authoritative, and the opponent's screen just receives a stream of match frames roughly 30 times per second rather than running its own simulation. The online room system is built on Cloudflare Workers using Durable Objects, while the web app itself is built with Next.js 15 and React 19, and the match rendering uses a pre-built Pixi.js runtime. Getting a local copy running is a matter of installing dependencies with pnpm and starting the dev server, which opens on port 13000. Separate commands exist for starting the LAN multiplayer mode or the online multiplayer mode locally, and deploying the online room service to Cloudflare requires setting an allowed origins value and pointing the built web app at the deployed Worker's URL. The README is explicit that the public online mode is meant for casual, invite only play and does not include user accounts, automatic matchmaking, leaderboards, or server-side anti-cheat protection. The project is licensed under the Apache License 2.0.