smueller/HexaHost-GameCloud
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
30 Commits 1 Branch 0 Tags
main
Go to file
Clone
Open with VS Code Open with VSCodium Open with Intellij IDEA
Download ZIP Download TAR.GZ Download BUNDLE
TheOnlyMace 50cd4b3ffd
Some checks failed
CI / Node — lint, typecheck, test, build (push) Failing after 12s
Details
CI / Go — node-agent tests (push) Failing after 9s
Details
CI / Go — edge-gateway build (push) Successful in 17s
Details
Enhance API with OIDC support, including login and callback endpoints. Update environment variables for OIDC configuration in .env.example. Add new features to the catalog service for listing software families, Minecraft versions, and deployment regions. Implement server management actions such as kill, delete, and update in the servers module. Integrate feature flags for maintenance mode in server operations. Update pnpm-lock.yaml with new dependencies and versions.
2026-07-05 18:39:53 +02:00
.github/workflows
initial commit
2026-06-26 10:45:08 +02:00
.turbo/cache
Add '@hexahost/contracts' dependency in package.json, export emailSchema from contracts, and update bootstrap-admin script to validate email input. Update README with example email. Enhance pnpm-lock.yaml for workspace integration.
2026-07-05 14:43:52 +02:00
apps
Enhance API with OIDC support, including login and callback endpoints. Update environment variables for OIDC configuration in .env.example. Add new features to the catalog service for listing software families, Minecraft versions, and deployment regions. Implement server management actions such as kill, delete, and update in the servers module. Integrate feature flags for maintenance mode in server operations. Update pnpm-lock.yaml with new dependencies and versions.
2026-07-05 18:39:53 +02:00
deploy
Enhance API with OIDC support, including login and callback endpoints. Update environment variables for OIDC configuration in .env.example. Add new features to the catalog service for listing software families, Minecraft versions, and deployment regions. Implement server management actions such as kill, delete, and update in the servers module. Integrate feature flags for maintenance mode in server operations. Update pnpm-lock.yaml with new dependencies and versions.
2026-07-05 18:39:53 +02:00
docs
Enhance API with OIDC support, including login and callback endpoints. Update environment variables for OIDC configuration in .env.example. Add new features to the catalog service for listing software families, Minecraft versions, and deployment regions. Implement server management actions such as kill, delete, and update in the servers module. Integrate feature flags for maintenance mode in server operations. Update pnpm-lock.yaml with new dependencies and versions.
2026-07-05 18:39:53 +02:00
integrations/whmcs
Enhance API with OIDC support, including login and callback endpoints. Update environment variables for OIDC configuration in .env.example. Add new features to the catalog service for listing software families, Minecraft versions, and deployment regions. Implement server management actions such as kill, delete, and update in the servers module. Integrate feature flags for maintenance mode in server operations. Update pnpm-lock.yaml with new dependencies and versions.
2026-07-05 18:39:53 +02:00
packages
Enhance API with OIDC support, including login and callback endpoints. Update environment variables for OIDC configuration in .env.example. Add new features to the catalog service for listing software families, Minecraft versions, and deployment regions. Implement server management actions such as kill, delete, and update in the servers module. Integrate feature flags for maintenance mode in server operations. Update pnpm-lock.yaml with new dependencies and versions.
2026-07-05 18:39:53 +02:00
scripts
Refactor environment variable handling in package.json scripts, update .env.example for consistency, and enhance Turbo configuration for environment variable passthrough. Modify API content type parsing and resolve circular dependencies in Auth and Billing modules. Add unique username generation logic in bootstrap-admin script.
2026-07-05 14:40:57 +02:00
.dockerignore
Update .gitignore to exclude TypeScript build info files and modify package.json to enhance the dev:infra script for improved local development environment setup.
2026-07-05 14:25:01 +02:00
.env.example
Enhance API with OIDC support, including login and callback endpoints. Update environment variables for OIDC configuration in .env.example. Add new features to the catalog service for listing software families, Minecraft versions, and deployment regions. Implement server management actions such as kill, delete, and update in the servers module. Integrate feature flags for maintenance mode in server operations. Update pnpm-lock.yaml with new dependencies and versions.
2026-07-05 18:39:53 +02:00
.gitignore
Refactor environment variable handling in package.json scripts, update .env.example for consistency, and enhance Turbo configuration for environment variable passthrough. Modify API content type parsing and resolve circular dependencies in Auth and Billing modules. Add unique username generation logic in bootstrap-admin script.
2026-07-05 14:40:57 +02:00
HexaHost_GameCloud_Cursor_Masterprompt.md
initial commit
2026-06-26 10:45:08 +02:00
package.json
Refactor environment variable handling in package.json scripts, update .env.example for consistency, and enhance Turbo configuration for environment variable passthrough. Modify API content type parsing and resolve circular dependencies in Auth and Billing modules. Add unique username generation logic in bootstrap-admin script.
2026-07-05 14:40:57 +02:00
pnpm-lock.yaml
Enhance API with OIDC support, including login and callback endpoints. Update environment variables for OIDC configuration in .env.example. Add new features to the catalog service for listing software families, Minecraft versions, and deployment regions. Implement server management actions such as kill, delete, and update in the servers module. Integrate feature flags for maintenance mode in server operations. Update pnpm-lock.yaml with new dependencies and versions.
2026-07-05 18:39:53 +02:00
pnpm-workspace.yaml
initial commit
2026-06-26 10:45:08 +02:00
README.md
Add '@hexahost/contracts' dependency in package.json, export emailSchema from contracts, and update bootstrap-admin script to validate email input. Update README with example email. Enhance pnpm-lock.yaml for workspace integration.
2026-07-05 14:43:52 +02:00
turbo.json
Refactor environment variable handling in package.json scripts, update .env.example for consistency, and enhance Turbo configuration for environment variable passthrough. Modify API content type parsing and resolve circular dependencies in Auth and Billing modules. Add unique username generation logic in bootstrap-admin script.
2026-07-05 14:40:57 +02:00

README.md

HexaHost GameCloud

Selbstgehostete, mandantenfähige Plattform für On-Demand-Minecraft-Server.

Der Projektname HexaHost GameCloud ist ein Arbeitstitel und zentral über APP_NAME / NEXT_PUBLIC_APP_NAME konfigurierbar.

Voraussetzungen

Tool Version
Node.js ≥ 22
pnpm 9.15.x (corepack enable)
Docker für lokale Infrastruktur
Go 1.23+ (Node Agent)

Schnellstart (lokal)

# Abhängigkeiten installieren
corepack enable
pnpm install

# Umgebung vorbereiten
cp .env.example .env
# SESSION_SECRET und ENCRYPTION_KEY auf mindestens 32 Zeichen setzen

# Infrastruktur (PostgreSQL, Redis, MinIO, Mailpit)
pnpm dev:infra

# Datenbankschema anwenden
pnpm db:push

# Entwicklungsserver (API, Worker, Web parallel)
pnpm dev

Dienste (Entwicklung)

Dienst URL
Web http://localhost:3000
API http://localhost:3001/api/v1
OpenAPI http://localhost:3001/api/v1/docs
Worker Health http://localhost:3002/health
Mailpit http://localhost:8025
MinIO Console http://localhost:9001

Optional für Docker Compose mit Traefik-Netzwerk:

docker network create traefik-network

Monorepo-Struktur

apps/
  web/           Next.js Weboberfläche
  api/           NestJS API (Fastify)
  worker/        BullMQ Hintergrundjobs
  node-agent/    Go-Daemon auf Game-Nodes
  edge-gateway/  Go TCP/UDP Gateway (Phase 8)
packages/
  database/      Prisma Schema & Client
  contracts/     Zod-Schemas & API-Verträge
  config/        Typisierte Konfiguration
  auth/          Authentifizierungslogik
  ui/            Gemeinsame UI-Komponenten
deploy/          Docker Compose, systemd, Ansible
docs/            Architektur, ADR, Betrieb
integrations/    WHMCS-Modul (`hexagamecloud`)

Befehle

pnpm build          # Alle Pakete bauen
pnpm lint           # Linting
pnpm typecheck      # TypeScript-Prüfung
pnpm test           # Unit-Tests
pnpm db:generate    # Prisma Client generieren
pnpm db:migrate     # Migrationen ausführen

Go Node Agent:

cd apps/node-agent
make test
make build

Aktueller Stand

Phase 9 (WHMCS & Produktion) — abgeschlossen.

Siehe docs/IMPLEMENTATION_STATUS.md für Details.

Server-Verwaltung im Panel

Tab Funktion
Übersicht Status, Start/Stop/Restart, Verbindungsadresse
Konsole Live-Logs, RCON-Befehle
Dateien Verzeichnisliste, Dateien bearbeiten
Eigenschaften server.properties
Spieler Online-Spieler, Whitelist
Welten Welten anzeigen, Upload/Download (Server gestoppt)
Backups Manuell/geplant, Restore, Retention
Add-ons Modrinth-Suche, Paper-Plugins / Fabric-Mods installieren

Minecraft-Server lokal testen

pnpm dev:infra
pnpm db:migrate    # oder db:push bei frischer DB
pnpm db:seed       # Free-Plan + Dev-Node
pnpm dev

# Separates Terminal — Node Agent (Go 1.23 + Docker Desktop)
cd apps/node-agent
# NODE_ID, NODE_TOKEN, NODE_AGENT_PUBLIC_URL aus .env.example setzen
make run
  1. Registrieren / einloggen unter http://localhost:3000
  2. Server erstellen unter /servers/new
  3. Starten — Adresse localhost:<port> im Panel
  4. Minecraft: Multiplayer → localhost:<port>

Auth lokal testen

cp .env.example .env
pnpm dev:infra
pnpm db:migrate
pnpm dev

# Admin anlegen (keine Default-Zugangsdaten)
pnpm bootstrap:admin -- --email admin@example.com --password 'min-12-chars-here'
Flow URL
Registrierung http://localhost:3000/register
Login http://localhost:3000/login
E-Mails (Dev) http://localhost:8025 (Mailpit)

Lizenz

Proprietär — siehe Repository-Eigentümer.

Reference in New Issue View Git Blame Copy Permalink
Description
No description provided
Readme 21 MiB
Languages
TypeScript 79.2%
Go 9.9%
PHP 7.1%
JavaScript 1.9%
Smarty 0.9%
Other 0.9%