LevelXStudios/gatewanderers-client
3
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
GateWanderers MMO — Open-Source CLI Agent Client (TypeScript/Bun) https://github.com/GateWanderers
9 commits 4 branches 0 tags 4.7 MiB
  • TypeScript 100%
Find a file
Exact
DrSkyfaR 262b33964a feat: Terminal-Dashboard mit Live-Stats (client #4) 
- dashboard.ts: Dashboard-Klasse mit ANSI-Box-Rendering (keine Deps)
  - Unicode box-drawing + ANSI-Farben
  - In-place Update via cursor-up/clear nach jedem Tick
  - Zeigt: Agent/Faction/Credits/XP, Ship-Name/Hull-Bar, System/Planet,
    letzte 5 Aktionen (✓/✗/•), letzte LLM-Entscheidung, WS-Status
- index.ts: Agent-Loop nutzt Dashboard statt roher console.log-Ausgaben
  - DashboardState wird inkrementell nach jedem Schritt aktualisiert
  - Fehlerfälle (State-Fetch, LLM, Submit) erscheinen als ✗-Aktionen

Co-Authored-By: claude-flow <ruv@ruv.net>
2026-03-25 21:42:13 +01:00
.github/workflows ci: GitHub Actions CI für server (Go) und client (Bun/tsc) 2026-03-25 11:55:34 +01:00
src feat: Terminal-Dashboard mit Live-Stats (client #4) 2026-03-25 21:42:13 +01:00
.gitignore feat: Clans/Guilds system 2026-03-24 16:52:12 +01:00
bun.lock Initial commit: GateWanderers v1.0 — vollständiges Stargate MMO Backend 2026-03-23 23:58:57 +01:00
config.example.json fix: LLM-Provider-Abstraktion, MINE/SURVEY Actions, Agent-Profil-API 2026-03-25 11:47:02 +01:00
package.json Initial commit: GateWanderers v1.0 — vollständiges Stargate MMO Backend 2026-03-23 23:58:57 +01:00
README.md docs: update READMEs for GateWanderers org repos 2026-03-24 16:32:07 +01:00
tsconfig.json Initial commit: GateWanderers v1.0 — vollständiges Stargate MMO Backend 2026-03-23 23:58:57 +01:00

README.md

GateWanderers Client

Open-source CLI agent client for the GateWanderers MMO — an AI-driven persistent game set in the Stargate universe.

License: MIT TypeScript Bun

Your AI agent explores galaxies, gathers resources, trades, researches technology, and fights battles — fully autonomously. The server's tick system gives every agent the same number of actions per time period, so a laptop is as competitive as a high-end gaming PC.

Requirements

  • Bun >= 1.0
  • A running LLM: Ollama (local) or any OpenAI-compatible API
  • A GateWanderers account (register via the client)

Quick Start

git clone https://github.com/GateWanderers/client.git
cd client
bun install
cp config.example.json config.json
# Edit config.json with your server URL and LLM settings
bun run start

Configuration

Edit config.json:

{
  "server_url": "https://play.gatewanderers.io",
  "token": "",
  "ollama_url": "http://localhost:11434",
  "ollama_model": "llama3.1:8b"
}

The token field is written automatically after register or login.

Commands

bun run register   # Create a new account (faction, playstyle, language)
bun run login      # Log in and save token to config.json
bun run state      # Show current agent status (ship, credits, XP, location)
bun run start      # Start the autonomous agent loop

Supported LLM Providers

Provider Status
Ollama (local) ✅ Supported
OpenAI-compatible 🚧 Planned (#1)
Anthropic Claude 🚧 Planned (#1)

Any 7B–8B local model runs the agent effectively. Larger models make smarter decisions but are not required.

Factions

Faction Playstyle Starting System
Tau'ri Expedition Balanced Earth (Milky Way)
Free Jaffa Clan Combat Chulak
Gate Nomads Exploration Dakara
Lucian Alliance Trade Langara
Wraith Hive Aggression Pegasus
Travelers Stealth Pegasus Fringe

Contributing

Contributions welcome! See open issues for ideas.

  • good first issue — great starting points for new contributors
  • help wanted — community support appreciated

Please open an issue before submitting large PRs.

License

MIT — see LICENSE

GateWanderers is a fan project and is not affiliated with MGM or the Stargate franchise.