BallBrawl — ball battle
Play: https://ballbrawl-5gr.pages.dev (mirror: https://ballbrawl-silk.vercel.app)
A browser game where balls with superpowers fight in an arena. You build a squad of 3 balls, aim and launch. During a fight you tap the arena to dash (2 charges), and when the meter fills up you hit SUPER: every ball has its own super move.
15 balls: Basic, Leech, Cell, Spider, Ninja, Train, Magnet, Bomb, Turtle, Lightning, Hedgehog, Ice, Spike, Shackles, Forge. Each has its own ability and super. Every round starts with an 8-second aim phase: ability cards for both balls, and the opponent's aim arrow is shown too.
Arenas, Clash Royale style: Night Arena, Canyon, Frost Peak, Jungle, Lava Crater and Space unlock at 0, 120, 350, 700, 1200 and 1900 best trophies. Each arena repaints the battle floor and walls and the whole menu, and the first visit gets a celebration.
Glory Road from the main menu: wins earn trophies, and the road (to 3000 trophies) unlocks balls, skins, coins and chests. Rewards are kept forever, even if your trophies drop. Chests are earned only, every 3 wins and on the road. They are never sold, and the chest screen shows the real odds for the player. There are skins (cosmetic only), 3 daily quests, a 7-day login reward and achievements.
Brawl Stars style progression: every ball has its own path with ranks 1–10 (coins, chests, the Gold skin at rank 7, a Master title at rank 10). Leagues from Bronze I to Masters by trophies, titles under your nickname, the Silver skin for coins.
Emotes in battle (six preset stickers, the computer answers). 8 languages: Russian, English, Kazakh, Uzbek, Turkish, Spanish, Portuguese, Indonesian, with a picker in the profile.
Modes and maps: Classic (squads take turns, trophies), 2 vs 2 and a co-op Boss fight. Every arena has its own map: canyon rocks, frost ice crystals, jungle bouncy mushrooms, lava pools, space portals, each with its own scenery. Player level from XP; levels pay coins and gems.
Shop and gems: auras, banners and decorations for your name card, 15 character emotes (some animated), arena maps, daily deals and skins. Gems come from chests, the Glory Road, ball paths, day 7 and rewarded ads; buying gems with money is not built yet.
Chests: wins put chests into 4 slots in a fixed order; each unlocks on a timer (gems or an ad skip it). Chests give coins and sometimes skin fragments (20 make a skin), gems, an emote, a new ball or a boss ticket, with the odds shown. A boss beaten while holding a ticket gives a big chest; a lost fight never uses one.
Clans: create (500 coins), join, leave; names from the nickname word lists, 8 emblems, members and clan trophies. No chat, for kids' safety.
Inbox and settings: messages and gifts from the team (posted with SQL, see below), sound, opponent emotes and language in settings.
Email account (optional): turns the anonymous player into an account that can sign in on another device, and gives the Rainbow skin as a thank-you.
Challenge a friend by link: the squad, seed, nickname and level live right in the link, no server needed. Your friend plays with the same squad and can send back a reply challenge with their result.
Nicknames are built only from preset words ("Fast Hedgehog 482"), never free text. The game is made for kids, so ads run in child-safe mode (non-personalized). Works offline (service worker).
Revenue comes from Google AdSense ads (H5 Games Ads); haram categories are blocked in the AdSense dashboard.
Plain JavaScript and Canvas, no dependencies and no build step. The folder is the website.
The game UI is in 8 languages (src/i18n.js for Russian and English, src/lang/ for the rest). The browser language picks one; the player can change it in the profile.
Run locally
npm run dev
Open http://localhost:5173. Python is required (tools/dev.py is a plain static server that only tells the browser not to cache files). Double-clicking index.html won't work because of ES modules.
On localhost Google shows test ads ("Rewarded ad example"), so every ad button can be checked.
On localhost the game does not connect to the live server by default, so test profiles never reach the leaderboard. To test online mode, open http://localhost:5173/?online.
Tests and balance
npm test
npm run balance
balance runs thousands of computer-vs-computer fights, with dashes and supers, and prints a win table: row vs column, in percent.
Rule: keep every ball's average win rate roughly within 35–65%. Right now all 15 balls are within 43–57%, and there are counter-picks (e.g. Leech beats Basic, Ninja beats Leech).
This is the beginning of the README. Read the rest at the original. Read the full README ↗
