Batch Removal Using Text Files - Dumb Badge(s) Remover

Overview

The text file method allows you to batch process multiple removal operations from a single file. This is the most efficient way to clean up badges from multiple sources at once, and is particularly powerful when combined with downloaded spam lists.

Text files support mixed URL types - you can include games, users, groups, and even individual badges all in one file.

Supported URL Formats

DBR recognizes three types of Roblox URLs in text files:

Type	URL Format	What It Does
Badge	`https://www.roblox.com/badges/12345`	Removes the specific badge if you own it
Game	`https://www.roblox.com/games/12345`	Removes all badges from that game
User	`https://www.roblox.com/users/12345`	Removes all badges from all games by that user

The www. prefix is optional. URLs with or without it will work correctly.

Creating a Text File

Step 1: Create a New File

Create a plain text file with one URL per line:

https://www.roblox.com/games/606849621
https://www.roblox.com/users/5201234
https://www.roblox.com/badges/2124819458
https://www.roblox.com/games/789456123

Step 2: Save the File

Save with a .txt extension (e.g., badges_to_remove.txt)

Make sure to save as .txt not .json. DBR processes these formats differently.

Step 3: Run the Command

Use the --file flag with the path to your text file:

dbr --file badges_to_remove.txt --env-file .env

Example Text File

Here’s a complete example showing mixed URL types:

badges_to_remove.txt

# Badge chain games
https://www.roblox.com/games/606849621
https://www.roblox.com/games/789456123
https://www.roblox.com/games/456789012

# Specific spam badges
https://www.roblox.com/badges/2124819458
https://www.roblox.com/badges/2125678901

# Badge chain creators
https://www.roblox.com/users/5201234
https://www.roblox.com/users/6789012

# Group-owned games
https://www.roblox.com/groups/123456

Comments (lines starting with #) and blank lines are ignored.

Example Output

Dumb Badge(s) Remover 1.0.0
copyright (c) 2023, 2025 exurd

Getting universe from 606849621...
Searching universe's badges...
Checking badges on page 1...
|----||1||----|
Deleting badge 2124819458 from account...
Response Status Code: 200
Badge 2124819458 was successfully removed.
|----||1||----|
Searched all badges.

Finding user 5201234...
Searching player's games...
Checking place 1...
[... continues processing ...]

Working with Downloaded Lists

DBR can download and process pre-made spam lists:

MGS Invalid Games List

Download the List

dbr --download-mgs-invalid-list

This creates two files:

mgs_invalid_games.json - Full JSON data

mgs_invalid_games.txt - Ready-to-use text file

Review the List

MetaGamerScore lists may contain false positives. Always review before bulk removal!

head -n 20 mgs_invalid_games.txt

Process the List

dbr --file mgs_invalid_games.txt --env-file .env

Badge Spam Lists

Download Community Lists

dbr --download-badge-spam-lists

This downloads multiple categorized lists from exurd/badge-spam-lists.

Choose a List

Extracted files will be in badge-spam-lists-main/ directory:

ls badge-spam-lists-main/

Process Specific Lists

dbr --file badge-spam-lists-main/chain-name.txt --env-file .env

Advanced File Formats

Zstandard Compressed Files

DBR supports .txt.zst compressed files:

dbr --file large_list.txt.zst --env-file .env

Requires the zstandard Python library to be installed.

Mixed Content Files

Combine different removal types in one file:

comprehensive_cleanup.txt

# Known spam developers
https://www.roblox.com/users/5201234
https://www.roblox.com/users/6789012

# Specific problematic games
https://www.roblox.com/games/606849621
https://www.roblox.com/games/789456123

# Individual badges to remove
https://www.roblox.com/badges/2124819458

# Spam game groups
https://www.roblox.com/groups/123456

Tips & Best Practices

Start Small

Test with a small file first to ensure everything works correctly before processing large lists.

Use Comments

Add comments with # to organize your file and explain what each section contains.

Cache Efficiency

The checked places cache prevents duplicate processing across multiple runs.

Review MGS Lists

Always review MetaGamerScore lists before processing - they may include legitimate games.

Performance Optimization

Increase Thread Count

Speed up badge deletion:

dbr --file large_list.txt --delete-threads 4 --env-file .env

Custom Cache Directory

Use a dedicated cache directory for large operations:

dbr --file large_list.txt --cache-directory ./batch_cache --env-file .env

Split Large Files

For extremely large lists, split into smaller chunks:

split -l 1000 large_list.txt chunk_

Then process each chunk:

for file in chunk_*; do
  dbr --file "$file" --env-file .env
done

How DBR Processes Each URL Type

Badge URLs

https://www.roblox.com/badges/2124819458

Extracts badge ID: 2124819458
Checks if you own the badge
Removes it if owned
Skips if not owned

Game URLs

https://www.roblox.com/games/606849621

Extracts place ID: 606849621
Checks cache for previous processing
Runs full place removal if not cached
Adds to cache when complete

User URLs

https://www.roblox.com/users/5201234

Extracts user ID: 5201234
Fetches all user’s public games
Processes each game individually
Respects cache for each place

Troubleshooting

”text file is empty or unreadable”

Cause: File doesn’t exist, is empty, or has encoding issues. Solution: Verify file path and ensure it contains valid URLs with UTF-8 encoding.

URLs Not Being Recognized

Cause: URL format doesn’t match expected pattern. Solution: Ensure URLs follow these formats:

https://www.roblox.com/games/[ID]
https://www.roblox.com/users/[ID]
https://www.roblox.com/badges/[ID]
https://www.roblox.com/groups/[ID]

Processing Takes Forever

Cause: Large lists with many user/group URLs create cascading requests. Solution:

Use --delete-threads to increase parallelism
Process in smaller batches
Monitor progress and let it run overnight if needed

Some Badges Not Removed

Cause: You may not own those badges, or they were already deleted. Solution: This is normal. DBR only removes badges you actually own.

Creating Custom Lists

Inventory Scanner Output

Use the inventory scanner to generate a custom list:

dbr --check-inventory YOUR_USER_ID

This creates found_places.txt and found_badges.txt which can be used directly:

dbr --file found_places.txt --env-file .env

Combining Multiple Lists

Merge multiple lists into one:

cat list1.txt list2.txt list3.txt > combined_list.txt
dbr --file combined_list.txt --env-file .env

Deduplicating Lists

Remove duplicate URLs:

sort -u input_list.txt > deduplicated_list.txt

Remove by Place - Single game removal
Remove by User - All games from a user
Remove by Group - All games from a group
MetaGamerScore Integration - Using MGS invalid game lists

Source Code Reference

The text file processing logic is implemented in delete_from_text_file() at remover.py:431. URL pattern matching uses regex at remover.py:21:

ROBLOX_URL_PATTERN = re.compile(r"https?:\/\/(?:www\.)?roblox\.com\/([A-Za-z]+)\/([0-9]+)")

Get Started

Configuration

Commands

Guides

Reference

​Overview

​Supported URL Formats

​Creating a Text File

​Example Text File

​Example Output

​Working with Downloaded Lists

​MGS Invalid Games List

​Badge Spam Lists

​Advanced File Formats

​Zstandard Compressed Files

​Mixed Content Files

​Tips & Best Practices

Start Small

Use Comments

Cache Efficiency

Review MGS Lists

​Performance Optimization

​Increase Thread Count

​Custom Cache Directory

​Split Large Files

​How DBR Processes Each URL Type

​Badge URLs

​Game URLs

​User URLs

​Troubleshooting

​”text file is empty or unreadable”

​URLs Not Being Recognized

​Processing Takes Forever

​Some Badges Not Removed

​Creating Custom Lists

​Inventory Scanner Output

​Combining Multiple Lists

​Deduplicating Lists

​Related Methods

​Source Code Reference

Build docs developers (and LLMs) love

Overview

Supported URL Formats

Creating a Text File

Example Text File

Example Output

Working with Downloaded Lists

MGS Invalid Games List

Badge Spam Lists

Advanced File Formats

Zstandard Compressed Files

Mixed Content Files

Tips & Best Practices

Performance Optimization

Increase Thread Count

Custom Cache Directory

Split Large Files

How DBR Processes Each URL Type

Badge URLs

Game URLs

User URLs

Troubleshooting

”text file is empty or unreadable”

URLs Not Being Recognized

Processing Takes Forever

Some Badges Not Removed

Creating Custom Lists

Inventory Scanner Output

Combining Multiple Lists

Deduplicating Lists

Related Methods

Source Code Reference