Skip to main content
DBR provides multiple commands for removing badges and scanning your Roblox inventory. All commands require authentication with a .ROBLOSECURITY token.

​
Available Commands

Badge Removal

Remove badges by ID, place, user, group, or file

Inventory Scanning

Scan a user’s inventory for spam badges

Download Lists

Download MetaGamerScore and badge spam lists

Configuration

Configure DBR with environment variables and settings

​
Authentication

All removal commands require Roblox authentication using one of these methods: 
dbr --env-file .env --badge 123456789
Create a .env file with:
RBX_TOKEN=your_roblosecurity_token_here
USER_AGENT=DBR/1.0.0
Never share your .ROBLOSECURITY token with anyone! This token provides full access to your Roblox account.

​
Global Options

These options work with all commands:
​
--version
flag
Show DBR version and exit
​
--env-file
string
default:"none"
Path to .env file containing RBX_TOKEN and other settings
​
--rbx-token
string
default:"none"
Your .ROBLOSECURITY token for authentication
​
--cache-directory
string
default:"./dbr_cache"
Directory where cache data is stored
​
--delete-threads
integer
default:"2"
Number of concurrent threads for badge deletion (increases speed)
​
--user-agent
string
default:"DBR/{version}"
Custom user agent for HTTP requests
​
--use-bor-badge-database
flag
Use Badgers of Robloxia’s database to find disabled badges. Note: Requests can be very slow.

​
Quick Start

1

Install DBR

pip install dbr
2

Create Environment File

Create a .env file with your Roblox token:
RBX_TOKEN=your_roblosecurity_token
3

Run a Command

Remove badges from a specific place:
dbr --env-file .env --place 123456789

​
Command Categories

​
Badge Removal

Remove badges from your inventory using various methods:
  • By Badge ID - Remove a specific badge
  • By Place ID - Remove all badges from a game
  • By User ID - Remove all badges from a user’s games
  • By Group ID - Remove all badges from a group’s games
  • By File - Remove badges from a list of URLs
  • By MGS ID - Remove badges using MetaGamerScore game ID
See the Badge Removal page for detailed examples.

​
Inventory Scanning

Scan a user’s badge inventory to identify spam badges without removing them: 
dbr --check-inventory 123456789
This generates output files you can use with the --file command for batch removal. See the Inventory Scanning page for details.

​
List Downloads

Download curated lists of spam games:
  • MetaGamerScore Invalid Games - Games detected as problematic
  • Badge Spam Lists - Community-maintained lists of badge chains
See the Download Lists page for usage.

​
Safety Features

DBR includes several safety features:
  • Checks if badges exist before attempting removal
  • Verifies badge ownership before deletion
  • Automatic retry logic with exponential backoff
  • Caches checked places to avoid duplicate processing
  • Rate limiting to comply with Roblox API limits

​
Getting Help

dbr --help
For additional support, visit the GitHub repository.

Build docs developers (and LLMs) love

Get started for freeTalk to us