Voro

Voro is a simple yet strategic multiplayer web game. The rules are easy to learn, but mastering it takes time and clever tactics.

🎮 How to Play

• Click on a circle to increase its count by one.
• When a circle reaches 4, it explodes and sends one unit to each of its four neighboring circles.
• These chain reactions can lead to strategic captures and dynamic shifts on the board.
• Anyone of any age can learn the game in minutes — but mastering strategies can take a lifetime.

---

🧱 Tech Stack

⚙️ Backend

• Django (core web framework)
• Django Channels + Daphne (WebSockets for real-time gameplay)
• PostgreSQL (database)
• NGINX (reverse proxy for deployment)

🖥️ Frontend

• Pure HTML/CSS with a bit of Bootstrap
• Background music and user customization (profile pic and colors)

🚢 Deployment

• Docker & Docker Compose

---

🗂️ Project Structure

The Django project includes one main app: base

• game_logic.py: Contains the rules and mechanics of the game.
• consumer.py: Handles WebSocket communication using Django Channels.
• Other Django files handle users, views, models, and routing.

---

🚀 Getting Started

🧪 Development

1. Clone the repository:

   git clone https://github.com/seyed0123/Voro
   cd Voro
   cd begholplay

2. Create a .env file and fill in your settings:

   POSTGRES_DB=
   POSTGRES_USER=
   POSTGRES_PASSWORD=
   DB_HOST=
   DB_PORT=
   ADMIN_USER=
   ADMIN_EMAIL=
   ADMIN_PASSWORD=

3. Run migrations:

   python manage.py makemigrations
   python manage.py migrate

4. Run the development server:

   python manage.py runserver

---

🐳 Production with Docker

1. Build and start the containers:

   docker-compose up

2. Access the game at http://localhost

---

📸 Screenshots

Home	Profile	Join Lobby

Lobby	Game Page	Win Ceremony

---

📌 Notes

• Designed for quick fun and replayability.
• Built as a lightweight, real-time multiplayer game using only essential tools.

---