Discord to Roblox presence bridge

Kiba Bot
Documentation

Kiba Bot links Discord users to Roblox players with short private codes, then gives the game a live activity snapshot API for in-world display, trusted event reporting, and staff operations.

Public callbacks Roblox polls activity snapshots without needing an API key.
Protected writes Bind and log endpoints require Bearer token authentication.
SQLite backed Codes, binds, audit history, safety records, and settings persist locally.

How It Works

  1. A Discord user runs /code and receives a unique 4-character alphanumeric code via DM.
  2. The user enters this code in the Roblox game.
  3. The game calls POST /api/v1/bind to link the code to the Roblox player.
  4. The game periodically calls GET /api/v1/callbacks/{codes} with all active player codes.
  5. The bot takes a real-time snapshot of each linked Discord user's activities (Spotify, games, etc.) and returns them in a single response.

Base URLs

ServiceURL
APIhttps://api.kiba-is-a.top
Documentationhttps://docs.kiba-is-a.top
Landing Pagehttps://kiba-is-a.top

Authentication

Protected endpoints require an API key passed via the Authorization header:

Authorization: Bearer YOUR_API_KEY

The callback endpoint (GET /callbacks) and GET /health are public and do not require authentication.

Quick Links

Callback API

Plain-text response blocks consumed by the Roblox game loop.

Read endpoint

Bind API

How game clients attach a Discord code to a Roblox user.

Read endpoint

Admin Commands

Ban, rotate, rebind, inspect, and maintain user codes.

Read commands

User Commands

Generate, pause, and resume personal activity detection.

Read commands

Response Format

The exact callback block grammar and delimiter rules.

Read format

Database Schema

Tables for users, history, audit records, safety events, and private settings.

Read schema