Skip to main content
DBR provides 16 command-line arguments to control its behavior. All arguments are optional unless specified otherwise.

​
Authentication

​
--rbx-token
string
required
Your .ROBLOSECURITY token for Roblox authentication. Required to delete badges.WARNING: Never share your token with anyone. It provides full access to your Roblox account.Learn more about obtaining your token: ro.py documentationAliases: -t
​
--env-file
string
Path to a .env file containing configuration settings like RBX_TOKEN and USER_AGENT.Using an env file is safer than passing tokens directly via command line, as it prevents accidental token exposure in shell history.Aliases: -eDefault: None

​
Input Sources

​
--badge
integer
Specify a single badge ID to remove from your account.Aliases: -bExample: dbr --badge 123456789
​
--place
integer
Specify a place ID. DBR will remove all badges from this place’s universe.Aliases: -pExample: dbr --place 987654321
​
--user
integer
Specify a user ID. DBR will scan all public games by this user and remove badges from them.Aliases: -uExample: dbr --user 12345
​
--group
integer
Specify a group (community) ID. DBR will scan all public games in this group and remove badges from them.Aliases: -g, --communityNote: Private games in the group will not be visible via the API.Example: dbr --group 67890
​
--mgs-id
integer
Specify a MetaGamerScore game ID to remove badges from.Example: dbr --mgs-id 54321
​
--file
string
Path to a text file containing Roblox URLs (one per line) in the format:
  • https://roblox.com/games/[PLACE_ID]
  • https://roblox.com/badges/[BADGE_ID]
  • https://roblox.com/users/[USER_ID]
Supports both .txt files and .txt.zst compressed files.Example: dbr --file spam_badges.txt

​
Download Operations

​
--download-mgs-invalid-list
boolean
Downloads MetaGamerScore’s list of Roblox games detected as problematic.Warning: May contain false positives. Review the list before using it to remove badges.This is a standalone operation - the program will exit after downloading.Default: false
​
--download-badge-spam-lists
boolean
Downloads text files from exurd/badge-spam-lists containing place IDs from various badge chains.This is a standalone operation - the program will exit after downloading.Default: false

​
Inventory Scanning

​
--check-inventory
integer
Scans a user’s inventory for spam badges without deleting anything.Requires downloaded spam lists (use --download-mgs-invalid-list or --download-badge-spam-lists first).Creates two output files:
  • List of places with spam badges
  • List of badge IDs found
Aliases: -cExample: dbr --check-inventory 12345

​
Advanced Options

​
--use-bor-badge-database
boolean
Use the Badgers of Robloxia’s Valuable Badge Database API instead of the Roblox API.Useful for detecting disabled badges that are hidden in the standard Roblox API.Warning: Requests can take significantly longer to complete.Recommendation: Use --check-inventory instead to find hidden badges.Default: false
​
--cache-directory
string
Directory where DBR stores cache data, including checked places and downloaded lists.Aliases: -cdDefault: ./dbr_cache (or executable directory for compiled versions)
​
--delete-threads
integer
Number of concurrent threads to use when deleting multiple badges.Higher values can speed up deletion but may increase rate limiting risk.Default: 2Example: dbr --delete-threads 4
​
--user-agent
string
Custom user agent string for HTTP requests.Aliases: -uaDefault: DBR/{version}

​
Utility Arguments

​
--version
boolean
Display the version number and exit.Example: dbr --version
​
--help
boolean
Show help message with all available arguments and exit.Aliases: -hExample: dbr --help

​
Usage Requirements

DBR requires at least one authentication method (--rbx-token or --env-file) AND one input source (--file, --badge, --place, --user, --group, or --mgs-id) to perform deletion operations.The download and inventory scanning operations can run without authentication.

​
Examples

​
Remove a single badge

dbr --rbx-token YOUR_TOKEN --badge 123456789

​
Remove badges from a place using env file

dbr --env-file .env --place 987654321

​
Remove badges from multiple sources

dbr -e .env --user 12345 --group 67890

​
Download lists and scan inventory

# First, download spam lists
dbr --download-badge-spam-lists

# Then scan an inventory
dbr --check-inventory 12345

​
Use a file with custom settings

dbr -e .env --file spam_list.txt --delete-threads 3

Build docs developers (and LLMs) love

Get started for freeTalk to us