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
• Creates 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 (the other person is my alt account):

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 last_snapshot - 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 - Removes the runner of the command from the server's userlist
• /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

• /settings invites channel_id - Sets the invites channel to channel_id
• /settings announcements channel_id - Sets the announcements channel to channel_id

Sending Invite Cards

• /invite_user - Sends an invite card with your current game name and a link to join you