https://github.com/schaoss/wall-go
Browser remake of “Wall Go” – the 7×7 wall-building strategy game from Devil’s Plan 2
https://github.com/schaoss/wall-go
board-game browser-game bun devils-plan game react strategy-game tailwindcss typescript vite vitest wall-go zustand
Last synced: 3 months ago
JSON representation
Browser remake of “Wall Go” – the 7×7 wall-building strategy game from Devil’s Plan 2
- Host: GitHub
- URL: https://github.com/schaoss/wall-go
- Owner: schaoss
- License: mit
- Created: 2025-05-22T03:14:48.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-06-01T08:03:05.000Z (4 months ago)
- Last Synced: 2025-06-01T16:43:32.438Z (4 months ago)
- Topics: board-game, browser-game, bun, devils-plan, game, react, strategy-game, tailwindcss, typescript, vite, vitest, wall-go, zustand
- Language: TypeScript
- Homepage: https://schaoss.github.io/wall-go/
- Size: 5.06 MB
- Stars: 17
- Watchers: 1
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Wall‑Go 🧱♟️
> Wall Go (牆壁圍棋) – Free, open-source online strategy board game inspired by Devil’s Plan 2. Supports 2–4 players, solo (AI) or with friends, territory scoring, undo/redo, and a modern UI. [Wall Go, Devil's Plan, React, TypeScript, GitHub, board game, browser game]
## Features
- 7×7 board, move and wall mechanics faithfully implemented
- 2–4 player support: solo (AI), two-player, three-player, or four-player
- Multi-language UI: English, 繁體中文, 简体中文, 日本語, 한국어, Español
- Modern, responsive UI (Tailwind CSS v4), mobile-friendly
- Robust undo/redo (Zustand snapshot time travel)
- All static text fully internationalized (i18next)
- SEO meta tags and social sharing optimized (react-helmet-async)
- All core logic covered by unit tests (Vitest)
- Static build, deployable to GitHub Pages or any static host
---
## Game Overview
- Supports 2–4 players (AI or human)
- **Placing phase**: players alternate placing stones (fixed start for 2P, special order for 3/4P)
- **Playing phase**: select a stone, move up to 2 steps (orthogonal only), then build a wall
- **Walls**: unlimited, color-coded; 2P walls cannot be removed, 3/4P each player has one wall-break per game
- **Time limit**: 90 seconds per turn (auto-wall if timeout)
- **End**: when all stones are in separate territories
- **Scoring**: each territory cell = 1pt; if tied, largest single territory wins; if still tied, draw
- Undo/redo at any time
- Rules dialog and accessibility labels fully localized
- AI difficulty and side selection
---
## Main File Structure
- `src/App.tsx`: Main UI and state flow
- `src/store/index.ts`: Core game state, undo/redo, all actions
- `src/agents/*`: AI logic
- `src/components/Board/Board.tsx`, `Cell.tsx`: Board and cell interaction
- `src/components/SeoHelmet.tsx`: SEO meta tags
- `src/locales/*`: Language files
- `src/utils/checkGameEnd.ts`, `territory.ts`: Territory and scoring logic
- `src/store/gameStore.test.ts`, `utils/checkGameEnd.test.ts`: Unit tests
---
## Tech Stack
- **React 19** / **TypeScript**
- **Zustand** (state, undo/redo)
- **Vite** (build)
- **Tailwind CSS v4** (UI)
- **Bun** (dev server, package management)
- **Vitest** (unit tests)
- **i18next / react-i18next** (internationalization)
- **react-helmet-async** (SEO)
---
## Quick Start
```bash
bun install
bun run dev
```
Open [http://localhost:5173](http://localhost:5173) to start playing!
---
## Tips
- Use the main menu to switch between single-player and two-player modes
- Click ☀️/🌙 to toggle dark/light mode
- Use Undo/Redo to revert or redo moves
- Play again after the game ends
- Switch language from the menu (EN/Han)
---
## Customization
- **Board size**: `BOARD_SIZE` in `src/lib/types.ts`
- **Player colors**: `playerColorClass()` in `src/lib/color.ts` + Tailwind safelist
- **Stones per player**: `STONES_PER_PLAYER` in `src/lib/types.ts`
- **Number of players**: Edit `PLAYER_LIST` in `src/lib/types.ts`
- **Add new language**: Add JSON to `src/locales/` and update `src/i18n.ts`
---
## Roadmap
- [x] 7×7 board, move & wall mechanics
- [x] Undo/redo (Zustand snapshot)
- [x] Multi-language UI (EN, 繁中, 简中, JA, KO, ES)
- [x] Modern, mobile-friendly UI
- [x] AI (basic random/minimax)
- [x] Rules dialog, accessibility
- [x] Territory scoring, auto end
- [x] Unit tests (core logic)
- [x] Static build & deploy
- [x] AI improvements (🚧 WIP)
- [x] Update territory evaluation
- [x] Strategy enhancements
- [ ] New strategies
- [x] 90-second turn timer
- [ ] Online multiplayer mode
- [ ] 3/4 player mode
and more!
---
## License
MIT © 2025 Gary Chu