Architecture overview

TGEBot2 Integration Suite

A high-performance synchronization and automation suite for Star Wars Coruscant Roleplay, bridging in-game Roblox data, Discord interactions, and a Nuxt 4 web dashboard through a FastAPI and Python backend.

Python 3.14FastAPIPymongo AsyncDiscord.pyNuxt 4NuxtUITypeScriptPendulumAnyioCustom Asynchronous Scheduler built for this projectCustom Webhook System built for this project

Overview

TGEBot2 is an enterprise-grade integration suite built for the Star Wars: Coruscant Roleplay Roblox ecosystem. This project modernizes community infrastructure by transitioning from a legacy JavaScript monolith to a high-performance asynchronous Python microservices architecture.

Architecture Evolution

This system replaces legacy ExpressJS/Discord.js implementations with a modern, modular stack optimized for speed and concurrency:

FeatureLegacy (API / Bot)Current (API2 / Bot2)
LanguageJavaScriptPython 3.14+
FrameworkExpressJSFastAPI (High Performance)
LibraryDiscord.js (Outdated)Discord.py
DatabaseMotor (Legacy)Pymongo Async

Core Components & Structure

⚡ API2 & Bot2 (Backend Core)

  • API2: A RESTful backend powered by FastAPI, handling real-time data exchange and webhooks directly from the Roblox game engine.
  • Bot2: An asynchronous Discord.py bot implementation providing administrative oversight, verification pipelines, and community engagement features.

🖥️ Dashboard (Nuxt 4) (Currently Down for Maintenance)

  • Frontend Stack: A modern web interface built with Nuxt 4, TypeScript, and NuxtUI designed for a game-themed administrative control panel.
  • Status: The dashboard frontend is currently offline undergoing scheduled maintenance and architecture upgrades.

🛠️ Utility Toolkit (misc/)

A collection of reusable, modular Python utilities designed for asynchronous scalability:

  • Custom Scheduler: Priority-based task execution utilizing anyio, pendulum, and heapq.
  • Webhook Queue: Manages high-traffic Discord webhooks safely to prevent rate-limiting.
  • Pymongo Async Wrapper: Modernized asynchronous MongoDB database interactions optimized for Python 3.14 performance.