Leafsteroids

This repository contains the MongoDB Leafsteroids demo. A game developed by the MongoDB team, featuring a 2D arcade-style space shooter. Built with Unity3D and .NET, it includes a game client, an ASP.NET Web API, and a website using Blazor pages. Players aim to destroy bricks (asteroids) and achieve the highest score within 60 seconds by collecting power-ups and destroying targets quickly, while competing against each other within the concept of an event (tournament). The backend uses MongoDB Atlas for data storage, including Atlas Vector Search to match players based on gameplay style, score, and speed. The game is playable on tablets, mobiles, and desktop/laptop, with real-time scoreboards for competitive play.

Follow the instructions in this README to run a clone of your own to get your MongoDB development jump started.

You can also register and create your own event to share with your friends and play live anywhere here.

Architecture

The demo and repository consist of the following parts:

• Game Client (Unity3D, .NET, C#)
• Game Server (ASP.NET Web API, .NET, C#)
• Website (Blazor Server Application, .NET, C#)

Running your own clone

Requirements

• Install the .NET SDK 7

Prepare the database (MongoDB Atlas)

• Create a new Atlas project
• Create a new cluster (M0)
• Create a new database Leafsteroids:
  • Create a collection config and add the deployment/templates/config.template document to it.
  • Create a collection events and add the deployment/templates/event.template document to it.

You can adjust the config to change how the game behaves and add more events to have several to choose from.
To get started, it is recommended to use those default documents.

Run the REST service

• Switch into the rest_service folder.
• Make a copy of the .env.template file and call it .env.
• Grab the connection string for your Atlas cluster and exchange it in the .env file in the rest_service folder.
• Also replace the DATABASE_NAME in the .env file with the database name you created earlier.

dotnet run --urls "http://0.0.0.0:8000"

Open http://127.0.0.1:8000/ to verify the REST service is running.

Run the Website

• Switch into the website folder.
• Make a copy of the .env.template file and call it .env.
• Grab the connection string for your Atlas cluster and exchange it in the .env file in the website folder.
• Also replace the DATABASE_NAME in the .env file with the database name you created earlier.

dotnet run --urls "http://0.0.0.0:8001"

Open http://127.0.0.1:8001/ to verify the website is running.

Run the Game Client

• Switch into the game_client folder.
• In the Assets folder, make a copy of the .env.template file and call it .env.
• Adjust the REST_SERVICE_IP in the .env folder to your rest_service. Leave as is when running locally.
• Adjust the EVENT_ID to the event you want to use (from the events collection).
• Adjust the WEBSITE_URL to your local website with port (don't add a trailing /).
• Run the game.

Contributors

• Sig Narváez
• Carlos Castro
• Ángel Martínez
• Hubert Nguyen
• Nic Raboy
• Dominic Frei