Features
Comprehensive tooling for building production-ready Roblox applications.
System Architecture
How robase fits into a modern Roblox stack as the API-facing core of your service.
Request Flow
Your code → RobaseClient → Rate limiter (TokenBucket) → Cache (TTLCache) → requests.Session → Roblox API → JSON → Typed dataclass → Returned to you.
Sub-API Architecture
Client attaches 16+ sub-APIs: users, games, catalog, groups, friends, thumbnails, badges, economy, presence, avatar, trades, messages, chat, inventory, develop, events.
Local Persistence
SessionDatabase (SQLite) with 4 tables: users, games, sessions (KV store), log (command history). Opt-in persistence via save_user(), save_game(), set(), log_command().
Open Cloud Layer
RobaseCloudClient with API key auth. Sub-APIs: datastores, ordered_datastores, messaging, instances, users. Targets Roblox-hosted storage and cross-server messaging.
Why Teams Choose robase
Beyond Lua — External Python Tooling
Roblox games run Lua inside the platform. robase lets you build external Python systems that interact with Roblox data: bots, dashboards, analytics, moderation tools, and automation services.
Real Persistence with SessionDatabase
The built-in SQLite database stores users, games, and arbitrary key-value data locally. Unlike in-memory caches, this survives restarts and enables offline analysis.
Open Cloud for Live Game Data
RobaseCloudClient connects to Roblox Open Cloud APIs. Read/write DataStores, send cross-server messages, manage bans — all from external Python code with API keys.
Event-Driven Architecture
EventPoller enables reactive systems. Watch for friend activity, messages, milestones, and trigger webhooks, notifications, or automated responses in real-time.
Use Cases
robase lets you fetch, store, compare, enrich, automate, and expose Roblox data through dashboards or bots.
Discord Bots & Notifications
Build bots that monitor friend activity, game joins, group changes, or trade requests. EventPoller + Discord webhooks = real-time Roblox notifications.
Group Management Dashboards
Create admin panels for rank management, join request handling, audit logs, payouts, and moderation. The groups API covers everything you need.
Analytics & Data Collection
Fetch game stats, user data, catalog items, and persist them to SessionDatabase or your own storage. Build historical analytics Roblox doesn't provide.
Trading & Economy Tools
Track RAP with RAPTracker, monitor resellers, analyze trade history, calculate profit with ResaleProfit. The economy APIs enable serious trading infrastructure.
Why databases make robase more powerful
The built-in SQLite database handles caching, history, and persistence out of the box.