blobl.io - Open Source Multiplayer Game

A complete, self-hostable implementation of the blobl.io multiplayer game, featuring server, client, obufscator, authentication, and load balancing components.

Overview

blobl.io is an open-source multiplayer IO game inspired by the original bloble.io. It is a real-time strategy game where players compete to capture bases, build and destroy structures, command units. The game features a distributed architecture designed for scalability and performance.

Key Features:

• Base Capturing: Strategize and capture enemy bases to expand your territory.
• Themes: Choose from a variety of visual themes to customize your gameplay experience.
• Building Mechanics: Upgrade, place, and destroy buildings to strengthen your position.
• Unit Commanding: Take control of units and lead them into battle.
• In-Game Chat: Communicate with other players in real-time.
• Accounts & Progression: Create an account, log in with Discord, unlock skins, and track your progress.
• Minimap: Navigate the battlefield with ease using the built-in minimap.
• Changelog: Stay updated with the latest features and fixes.

This repository contains everything you need to run your own instance of blobl.io, including:

• Server: The core game server written in Go.
• Client: Browser-based game interface (JavaScript, HTML, CSS) with built-in obfuscation.
• Authentication: Secure user management with Discord integration. Node.js
• Load Balancer: Traffic distribution for multi-server deployments. Node.js

Prerequisites

Component	Version	Purpose
Go	1.23+	Server runtime
Node.js	14.0+ LTS	Supporting services

Project Structure

blobl.io/
├── server/          # Go-based game server
│   └── main/        # Main server application
├── client/          # Browser game interface
│   └── blofuscator/ # Client-side code protection
├── auth-server/     # Authentication with Discord integration
├── loadbalancer/    # Traffic distribution service
├── nginx_default    # Web server configuration
└── README.md        # Documentation

Installation & Setup

Game Server

# Navigate to server directory
cd server/main

# Production build
GOOS=linux GOARCH=amd64 go build -o server

# Development build (with debugging symbols)
GOOS=linux GOARCH=amd64 go build -gcflags="all=-N -l" -o server

# Quick start (no build)
go run *.go

Client

# Navigate to client directory
cd client

# Install dependencies
npm install

# Development
# Open index.html in browser or use a live server

# Production build
npm run build
# Serve the resulting 'dist' directory with your preferred web server

Authentication Server

# Navigate to auth directory
cd auth-server

# Install dependencies
npm install

# Configure environment
cp .env.example .env
# Edit .env with your Discord credentials and other settings

# Start service
npm start

Load Balancer

# Navigate to load balancer directory
cd loadbalancer

# Install dependencies
npm install

# Configure server pool
# Edit config.js with your server information

# Start service
npm start

Network Architecture

Service Endpoints

Service	Port	Endpoint	Description
Authentication	3000	/api/*, /user, /check, /logout	User authentication and session management
Server Discovery	3002	/get-server	Returns available game servers in current region
Game Servers	8080-8085	/ffa1,/ffa2 ...	Standard game instances
Experimental Server	9090	/ffa99	Testing environment for new features

Deployment

Important Deployment Note: I strongly recommend using Nginx as a reverse proxy for production environments. This will help manage traffic efficiently and improve scalability by directing requests to the appropriate services. A sample Nginx configuration file (nginx_default) is included in this repository to help you get started.

The services within this project are designed to operate behind a reverse proxy. If you choose not to use a reverse proxy, you will need to implement request origin validation directly within the game server, load balancer, and other services to prevent unauthorized access and bot activity. This is crucial for maintaining the integrity and security of your game server.

Contributing

This project is no longer actively maintained and is considered abandoned. However, you are welcome to fork the repository and make your own modifications or improvements. If you do fork the project, please ensure that you adhere to the original AGPLv3 License terms and provide proper attribution to the original author.

Forking the Project

1. Click the "Fork" button at the top right of this repository to create your own copy.
2. Clone your forked repository to your local machine:

   git clone https://github.com/eric-io/blobl.io.git

License

This project is licensed under the GNU Affero General Public License v3.0 (AGPLv3). This means you are free to:

• Use the software for any purpose.
• Modify the software to suit your needs.
• Distribute the original or modified versions of the software.
• Run the software as a service, but you must provide access to the modified source code if you make any changes.

However, you must:

• Include the original license in any distributions or modifications.
• Disclose the source code of any modified versions.
• Use the same license for any derivative works.
• Ensure that users of a networked version of the software can obtain the full source code, including modifications.

For more details, refer to the full AGPLv3 License file in this repository.