Roblox Invites

Roblox Invites is a bot that connects your Discord server members to their activity on Roblox.

Features

Sends invites to a dedicated invite channel when a player joins a Roblox game

Notifies your server if a player transfers servers or leaves a Roblox game

Tracks your players' playtimes across Roblox games

Create overall/weekly leaderboards

Add some personal touches to each game with Custom Titles

Images

See Roblox Invites in action!

Joining a game (no Custom Title):

Joining a game (w/ Custom Title):

Joining other server members in a game (other person's information has been redacted for privacy):

Leaving a game:

How to Use

1. Clone this repository anywhere on your PC, but preferably in a place you can easily access.

2. Manually input your .ROBLOSECURITY cookie, your bot token, and guild ID (development purposes, this is optional) in .env (as cookie, token, and guild respectively)

3. Setup a PostgreSQL database named "roblox_invites"

4. Run main.py using Python 3.14+ (older versions can be used) with the modules in requirements.txt. For accurate playtime tracking, keep the bot running for as long as possible!

Commands

Roblox Invites offers a variety of commands!
You can generate playtime leaderboards (weekly/overall), game leaderboards, and user profile cards.

Leaderboards

/leaderboard all - Generates an all-time playtime leaderboard for your server

/leaderboard weekly - Generates a playtime leaderboard for your server from the last saved snapshot to now

/leadebroard save - Saves a snapshot of user data

/leaderboard remove - Removes the last saved saved snapshot

Example of a leaderboard generated by the bot:
(The information of other users has been redacted.)

Example of a game leaderboard generated by the bot:
(The information of other users has been redacted.)

Managing Users

user_id is autocompleted in these commands.

/user add username - Adds a user with username username

/user remove user_id - Removes a user with ID user_id

/user stats user_id - Generates a user statistics card for user user_id

Managing Custom Titles

place_id is autocompleted in these commands.

/custom_title add title place_id hex_color - Adds a Custom Title for place ID place_id with message title and embed color hex_color

/custom_title remove place_id - Removes a Custom Title with place ID place_id

Managing Blacklisted IDs

blacklisted_id is autocompleted in these commands.

/blacklist add place_id game_name - Adds place ID place_id with game name game_name to the blacklist.

/blacklist remove blacklisted_id - Removes blacklisted place ID blacklisted_id from the blacklist.

Managing Channels

/channel invites channel_id - Sets the invites channel to channel_id

/channel announcements channel_id - Sets the announcements channel to channel_id

Sending Invite Cards

/invite_user user_id - Sends an invite card in the context of ID user_id