Skip to content

SLorant/Mage-Terra

Repository files navigation

Mage Terra

Mage Terra is a multiplayer real-time board game, where players place down dominoes to create their own kingdom. The objective is to connect the dominoes creating areas to earn points. At the start of each round, based on a scoring system, players take turns choosing a domino to place. The player with the highest score at the end of the game wins.

Features

  • Open & private rooms: You can engage in games with randomly matched opponents or create your own room to play with friends
  • Choose your avatar and name: There are several unique avatars to play as
  • Core gameplay: Connect the dominoes, create the largest areas, and earn the highest score
  • Arcane system: Keep track of arcanes as they decide who gets to pick the best dominoes first
  • Score tracking & mini-boards: You can see each player's score and their kingdoms throughout the game
  • Responsive: Play on either mobile or desktop

Technologies Used

  • React
  • Next.js
  • Tailwind CSS
  • Firebase: Realtime Database, Functions and Hosting
  • React-dnd: This essential library provides the game's core mechanic, the drag and drop of the dominoes.

Getting Started

To run Mage Terra locally, follow these steps:

  1. Clone the repository:

    git clone https://github.com/SLorant/mage-terra.git
  2. Navigate to the project directory:

    cd mage-terra
  3. Install dependencies:

    npm install
  4. Set up Firebase:

    • Create a Firebase project and configure it for web.
    • Copy your Firebase configuration (apiKey, authDomain, projectId, etc.) and replace it in the Firebase config file.
  5. Start the development server:

    npm run dev
  6. Open your browser and navigate to http://localhost:3000 to experience Mage Terra!

Contact & Credits

License

This project is licensed under the MIT License.