Skip to main content
This guide will walk you through setting up DBR and removing your first badge.

​
Prerequisites

Before starting, make sure you have:
  • Python 3.11 or higher installed
  • A Roblox account with badges you want to remove

​
Step 1: Install DBR

If you haven’t already installed DBR, choose your preferred package manager: 
pip install git+https://github.com/exurd/dbr

​
Step 2: Get Your ROBLOSECURITY Token

Your ROBLOSECURITY token is extremely sensitive. Anyone with access to this token can control your Roblox account, steal Robux, upload bannable content, or delete your account.NEVER share your token with anyone, not even friends!
To authenticate with Roblox, you need to extract your ROBLOSECURITY token:
  1. Visit the ro.py guide for detailed instructions on how to safely export your token
  2. Copy the token value (it will be a long string starting with _|WARNING:)

​
Step 3: Set Up Authentication

There are two ways to provide your token to DBR. Using an .env file is recommended for security.

​
Step 4: Remove Your First Badge

Now you’re ready to remove badges! Here are some common usage examples:
Remove a specific badge by its ID:
dbr --env-file .env --badge 123456789
You can also use the short form:
dbr -e .env -b 123456789

​
Step 5: Download Spam Badge Lists (Optional)

DBR can download curated lists of spam badges to help you identify and remove them:
Download badge chain lists from the community repository:
dbr --download-badge-spam-lists
This downloads text files from exurd/badge-spam-lists containing place IDs from various Roblox badge chains.

​
Step 6: Scan Your Inventory (Optional)

Before removing badges, you can scan your inventory to see what spam badges you have: 
dbr --check-inventory YOUR_USER_ID
This will:
  • Scan your badge inventory for spam badges
  • Create two text files: one for places and one for badges
  • NOT delete any badges (scan only)
Make sure you’ve downloaded spam lists first using the commands in Step 5, as the scanner uses these lists to identify spam badges.
Always review the scan results before using them to remove badges, especially if you downloaded the MGS list.

​
Complete Example

Here’s a complete workflow from start to finish:
1

Install DBR

pipx install git+https://github.com/exurd/dbr
2

Create .env file

echo 'RBX_TOKEN="YOUR_ROBLOSECURITY_TOKEN"' > .env
echo 'USER_AGENT=""' >> .env
3

Download spam lists

dbr --download-badge-spam-lists
4

Scan your inventory

dbr --check-inventory 123456789
Replace 123456789 with your Roblox user ID.
5

Remove spam badges

dbr --env-file .env --file dbr_cache/places_found.txt
This removes all badges from the places identified in your scan.

​
Advanced Options

DBR provides several advanced options for power users:

​
Concurrent Deletion Threads

Speed up badge deletion by increasing the number of concurrent threads: 
dbr -e .env --delete-threads 5 -p 123456789

​
Custom Cache Directory

Specify a custom directory for cache data: 
dbr -e .env --cache-directory /path/to/cache -p 123456789

​
Use Badgers of Robloxia Database

Use the Badgers of Robloxia database to find disabled badges: 
dbr -e .env --use-bor-badge-database -p 123456789
Requests to the BOR API can take a long time. It’s recommended to use the inventory scanner instead for finding hidden badges.

​
Next Steps

​
Getting Help

If you need help or encounter issues:

Build docs developers (and LLMs) love

Get started for freeTalk to us