Skip to main content

Elemental Battlecards

A strategic multiplayer card game combining elemental combat, card fusion mechanics, and real-time LAN gameplay. Master six elemental types and build winning strategies.

Get StartedLearn Game Mechanics
🎮
Strategic Card Battles
6 Elements • Real-time Combat • Card Fusion

Quick start

Get up and running with Elemental Battlecards in minutes

1

Install dependencies

Clone the repository and install dependencies for both backend and frontend:
git clone https://github.com/Jrangel42/elemental-battlecards.git
cd elemental-battlecards
Backend
cd Backend
npm install
Frontend
cd Frontend
npm install
2

Configure the backend

Create a .env file in the Backend directory based on .env.example:
PORT=3001
NODE_ENV=development
DB_DIALECT=sqlite
JWT_SECRET=your_jwt_secret_key_here
CORS_ORIGIN=*
Start the backend server:
cd Backend
npm start
The server will listen on http://0.0.0.0:3001
3

Start the frontend

In a new terminal, start the frontend development server:
cd Frontend
npm run dev
The game will be available at http://localhost:5173
4

Create or join a game

Open the game in your browser, register or login, then:
  • Host: Click “Create Room” to generate a 6-digit code
  • Guest: Enter the host’s code and click “Join Room”
The game starts automatically when both players are connected. The host always takes the first turn.

Explore by topic

Learn about the game mechanics and features

Card Types

Learn about the six elemental types: Fire, Water, Plant, Light, Shadow, and Spirit

Combat System

Master type advantages and level-based combat mechanics

Card Fusion

Combine cards of the same type and level to create powerful upgrades

Winning Conditions

Understand the victory conditions and strategic objectives

Setup and configuration

Configure your game for LAN play and development

LAN Setup

Set up multiplayer games on your local network

Backend Config

Configure database, authentication, and Socket.IO

Frontend Config

Configure Phaser, Vite, and game client settings

Developer resources

Technical documentation and API references

Architecture

Understand the frontend and backend architecture

Socket Events

Learn about real-time multiplayer communication

API Reference

Complete API documentation for backend and game objects

Contributing

Contribute to the project and development workflow

Ready to start playing?

Follow the quickstart guide to set up your first multiplayer game in minutes.

Get Started Now