RoInvites

RoInvites 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 RoInvites 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 and bot token in .env (as cookie and token 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

RoInvites 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