https://github.com/leonid1095/plgames-booster-up
Game network booster with custom PLG Protocol — reduce ping, eliminate jitter, optimize routes for online games
https://github.com/leonid1095/plgames-booster-up
docker fastapi game-booster networking nextjs ping-optimizer rust udp
Last synced: 2 months ago
JSON representation
Game network booster with custom PLG Protocol — reduce ping, eliminate jitter, optimize routes for online games
- Host: GitHub
- URL: https://github.com/leonid1095/plgames-booster-up
- Owner: Leonid1095
- Created: 2026-02-28T08:36:59.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-02-28T16:24:42.000Z (4 months ago)
- Last Synced: 2026-02-28T17:46:01.756Z (4 months ago)
- Topics: docker, fastapi, game-booster, networking, nextjs, ping-optimizer, rust, udp
- Language: Python
- Homepage: https://plgames-boost.duckdns.org
- Size: 328 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# PLGames Booster UP
Game network booster with custom PLG Protocol. Reduces ping, eliminates jitter, and optimizes routes for online games.
**Live:** [plgames-boost.duckdns.org](https://plgames-boost.duckdns.org)
## Architecture
```
┌──────────┐ ┌──────────────┐ ┌─────────────┐
│ Client │────▶│ PLG Relay │────▶│ Game Server │
│ (Windows) │◀────│ (Rust/UDP) │◀────│ │
└──────────┘ └──────────────┘ └─────────────┘
│ │
▼ ▼
┌──────────────────────────┐
│ API (FastAPI) │
│ + PostgreSQL + Redis │
└──────────────────────────┘
│
▼
┌──────────────────────────┐
│ Web (Next.js 14) │
│ Landing + Dashboard │
└──────────────────────────┘
```
## Stack
| Component | Tech | Port |
|-----------|------|------|
| **API** | Python 3.12, FastAPI, SQLAlchemy 2, Alembic | 8000 |
| **Relay** | Rust, Tokio, custom PLG Protocol (UDP) | 443 (UDP), 8443 (API), 9090 (metrics) |
| **Web** | Next.js 14, React 18, Tailwind CSS, TypeScript | 3000 |
| **DB** | PostgreSQL 16 | 5432 |
| **Cache** | Redis 7 | 6379 |
| **Monitoring** | Prometheus + Grafana | 9090, 3000 |
## Key Features
- **PLG Protocol** — custom UDP protocol optimized for game traffic, minimal overhead
- **Adaptive Routing** — automatic selection of the lowest-latency route
- **Multipath** — traffic duplication across multiple paths, instant failover
- **Game Auto-Detection** — client detects running game and applies optimal settings
- **50+ Games** — CS2, Dota 2, Valorant, Apex, Fortnite, LoL, and more
- **Billing** — DonatePay integration, promo codes, trial period
## Quick Start
```bash
# 1. Clone and configure
git clone https://github.com/Leonid1095/PLGames-Booster-Up.git
cd PLGames-Booster-Up
cp .env.example .env
# Edit .env with your values
# 2. Start infrastructure
cd infra
docker compose up -d db redis
# 3. Run API
cd ../api
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
alembic upgrade head
uvicorn app.main:app --host 0.0.0.0 --port 8000
# 4. Run Web
cd ../web
npm install
npm run dev -- --port 3000
```
### Docker (production)
```bash
cd infra
docker compose up -d
```
## Project Structure
```
├── api/ # Backend API (FastAPI)
│ ├── app/
│ │ ├── models/ # SQLAlchemy models
│ │ ├── routers/ # API endpoints
│ │ ├── schemas/ # Pydantic schemas
│ │ ├── services/ # Business logic
│ │ └── utils/ # Middleware, rate limiting, metrics
│ ├── alembic/ # Database migrations
│ └── tests/ # 64 tests
├── relay/ # PLG Relay Server (Rust)
│ └── src/ # UDP relay, management API, metrics
├── web/ # Landing + Dashboard (Next.js 14)
│ └── src/
│ ├── app/ # Pages (landing, auth, dashboard)
│ ├── components/ # UI components
│ └── lib/ # API client, auth, utils
├── client/ # Windows client (WIP)
├── gateway-agent/ # Node agent
├── infra/ # Docker, Prometheus, Grafana
│ ├── grafana/ # Dashboards and provisioning
│ └── prometheus/ # Scrape config
└── docs/ # Specs and roadmap
```
## Tests
```bash
# API tests (64 total)
cd api && source .venv/bin/activate
pytest -v
# Relay E2E tests
cd relay && cargo test
./tests/run_e2e.sh
```
## Roadmap
See [docs/03-roadmap.md](docs/03-roadmap.md) for the full 16-phase roadmap.
**Completed:** Phases 0-3, 5-9 (Infrastructure, API, Relay, Web, Monitoring, Billing, Admin, Multipath)
**Next:** Phase 4 (Windows Client), Phase 10+ (Android, iOS, Router support)
## License
All rights reserved.