🚜 game-juggernaut 🤖

Backend API service for Juggernaut Games (Bramblenook Farm, Serenity Plaza, etc.) PlayStation Home spaces and minigames.

---

🌟 Authors

• @zeph (everything else)
• @Knight (Serenity Plaza & Minibot City)

🚧 Supported Spaces & Games

• Bramblenook Farm
  • Remodel layout management & slots
  • Resources (Wood, Gold, Weather, Level, XP)
  • Furniture crafting & trading
  • Animal management (Purchases, feeding, leveling, renewal, sales)
  • Plant management (Purchases, watering, leveling, XP)
  • Custom map & layout upload/download XML support
• Serenity / Minibot City
  • Space join & matchmaking sessions
  • Global arcade scoreboard
  • Customization loadout sync (body tints, leg tints, visor, decals, head, gadget, titles)
  • Player statistics tracking (kills, deaths, XP)
  • Controller camera & sensitivity settings
  • Level builder map upload & download

🌠 Features

• ⚡ Bun & Hono: Ultra-fast HTTP engine written in TypeScript.
• 💾 SQLite Persistence: Powered by Drizzle ORM and bun:sqlite with auto-migration.
• 📜 Fast XML Builders: Robust XML generation via fast-xml-parser with structured responses (no hardcoded XML templates).
• 🪵 Observability: LogLayer, Pino pretty logging, and OpenTelemetry OTLP tracing / log exporting.

---

🧰 Getting Started

Quick Local Run

1. Install dependencies:

   bun install

2. Start the development server:

   bun run dev

3. Run unit tests & linting:

   bun test
   bun run lint

---

Docker Deployment

Run with Docker Compose:

docker compose up -d

The service will start listening on port 30082.