Remove by Badge ID
Remove a specific badge by its ID.The badge ID to remove from your accountAliases:
-b, BADGE_IDExample
Expected Output
Expected Output
If the badge doesn’t exist or isn’t in your inventory, DBR will return a 404 error and skip it.
Remove by Place ID
Remove all badges from a specific Roblox game/place.The place ID containing badges to removeAliases:
-p, PLACE_IDHow It Works
- Fetches the universe ID from the place ID
- Retrieves all badges in that universe
- Checks which badges you own
- Removes owned badges in batches
Example
Expected Output
Expected Output
Using BoR Database
For disabled badges (hidden in Roblox API), use the Badgers of Robloxia database:Remove by User ID
Remove all badges from every game created by a specific user.The user ID whose game badges you want to removeAliases:
-u, USER_IDHow It Works
- Fetches all public games created by the user
- Processes each game using the place removal logic
- Caches checked places to avoid duplicates
- Continues through all pages of games
Example
Expected Output
Expected Output
DBR caches checked places in
dbr_cache/checked_places.json to avoid reprocessing.Remove by Group ID
Remove all badges from every public game owned by a group.The group/community ID whose game badges you want to removeAliases:
-g, --community, GROUP_IDHow It Works
- Fetches all public games in the group
- Processes each game using the place removal logic
- Skips private games (not accessible via API)
- Caches checked places
Example
Expected Output
Expected Output
Only public games are visible. Private group games cannot be scanned via the API.
Remove by File
Remove badges, places, or users from a text file containing Roblox URLs.Path to text file with Roblox URLs (one per line)
Supported URL Formats
The file should contain one URL per line:URLs can be in
http:// or https:// format, with or without www.Example
spam_badges.txt Content
spam_badges.txt Content
Compressed Files
DBR supports Zstandard-compressed files (.txt.zst):
Remove by MetaGamerScore ID
Remove badges from a game using its MetaGamerScore game ID.The MetaGamerScore game ID
How It Works
- Fetches the Roblox place ID from MetaGamerScore
- Processes badges using the place removal logic
Example
This requires an active internet connection to query MetaGamerScore’s website.
Combining Commands
You can combine multiple removal methods in a single command:- Badge removal (
--badge) - MetaGamerScore lookup (
--mgs-id) - Place removal (
--place) - Group removal (
--group) - User removal (
--user) - File processing (
--file)
Performance Tuning
Concurrent Threads
Increase deletion speed with multiple threads:Number of concurrent deletion threads (default: 2)
Cache Directory
Customize where DBR stores cache data:Directory for cache storage (stores checked places)
Error Handling
Common Errors
400 Bad Request
400 Bad Request
The badge ID or place ID is invalid. Verify the ID is correct.
401 Unauthorized
401 Unauthorized
403 Forbidden
403 Forbidden
CSRF token validation failed. DBR automatically re-validates and retries.
404 Not Found
404 Not Found
Badge doesn’t exist or isn’t in your inventory. DBR skips it automatically.
429 Too Many Requests
429 Too Many Requests
Rate limit exceeded. DBR automatically waits and retries with exponential backoff.
Retry Logic
DBR automatically retries failed deletions:- Up to 8 retry attempts per badge
- Exponential backoff between retries (2^n seconds)
- Automatic CSRF token re-validation on 403 errors
Best Practices
Use Environment Files
Store tokens in
.env files instead of command-line arguments for securityStart Small
Test with a single badge before processing large lists
Monitor Progress
Watch console output for errors or issues
Backup Data
Save your badge list files before deletion (deletion is permanent)