⚔️ Starblast Duels

Starblast Duels is a completed web project made to help Starblast.io players find each other and start 1v1 duels more easily.

The project uses the Starblast modding API to automatically create a custom duel room when two players are ready. Instead of manually sharing links or searching for someone to duel, players can join the queue, wait for another player, and get matched into a duel.

🎯 Goal

The goal of this project was to make duels easier for the Starblast community.

Players can:

• enter their name
• verify an ECP key if they have one
• join a matchmaking queue
• get matched with another player
• receive a Starblast duel room link
• follow duel stats in real time

📦 Technologies

• JavaScript
• Node.js
• Express
• WebSockets
• Starblast modding API
• starblast-modding
• HTML
• CSS

✨ Features

• ⚔️ 1v1 duel matchmaking: the server waits for two players, then creates a duel room for them.
• 🔑 ECP verification: players can verify an ECP key so the server can create a modded Starblast room.
• 🕹️ Automatic room creation: when two players are ready, the server creates a Starblast modded duel game.
• 🔗 Duel link sharing: players receive the generated Starblast room link and can join the game directly.
• 📡 Live server data: the website shows active games, players currently playing, and players waiting in queue.
• 📊 Live duel stats: the server tracks useful duel data and sends it back to the website.
• 👥 Queue system: players are stored in a waiting list until they can be matched.
• 🧹 Room cleanup: when a player disconnects or a room stops, the server closes the mod and removes the room.

📊 Tracked Duel Data

The project tracks and displays duel information such as:

• player names
• ship IDs
• damage taken
• laser hits
• current life
• life regeneration
• kills
• deaths

🧩 How It Works

1. A player opens the website and enters a username.
2. If the player has an ECP key, they can verify it.
3. The player joins the queue.
4. The server waits until two players are available.
5. The server creates a custom Starblast duel room using the modding API.
6. Both players receive the game link.
7. A tracker connects to the game as a spectator.
8. The server reads game packets and updates duel stats.
9. The website displays the duel information in real time.

📁 Project Structure

Starblast-Duels/
├── public/
│   ├── index.html
│   ├── main.js
│   └── style.css
├── duelModeCode.js
├── findGame.js
├── rooms.js
├── server.js
├── tracker.js
├── package.json
└── package-lock.json

⚙️ Installation

Clone the repository:

git clone https://github.com/Senko74/Starblast-Duels.git
cd Starblast-Duels

Install the dependencies:

npm install

▶️ Running The Project

Start the server:

npm start

Or run it in development mode:

npm run dev

Then open:

http://localhost:9000

🔑 ECP Key

An ECP key is needed to create a modded Starblast game with the modding API.

The website includes an ECP verification system before using the key for room creation.

Do not share ECP keys publicly. Only use this project in a trusted environment.

✅ Project Status

This project is completed.

It was built for a specific goal: making it easier for Starblast players to find each other and start duels using the Starblast modding API.

The main features are implemented:

• queue system
• duel room creation
• ECP verification
• live room data
• live player stats
• cleanup when a duel ends

🛠️ Possible Improvements

Even if the project is completed, some improvements could still be added later:

• better UI polish
• public leaderboard
• match history
• custom duel settings
• better mobile layout
• more detailed stats
• player profiles

⚠️ Disclaimer

This project is a fan-made tool for Starblast.io players.

It uses the Starblast modding API, but it is not affiliated with Starblast.io.

Use it responsibly and respect the rules of the game and the modding API.

👤 Author

Created by Senko74.

📄 License

No license has been specified yet.