Skip to content

exurd/DBR

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

59 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Dumb Badge(s) Remover

Dumb Badge(s) Remover (DBR) is a Python package that removes Roblox badges, specifically any dumb ones that you don't want anymore. It can declutter your badge inventory of Badge chains and other various filler badges. You can also scan your inventory for spam badges without removing any badges.

This program is useful you have been invalidated by the scanner on MetaGamerScore. You can download their list of invalid games through a function.

Requirements

DBR runs on Python 3.11+. To install the required pip packages, you can run pip install -r requirements.txt in the project's directory to install the packages.

Installation and Running

Install the program with pip by running pip install git+https://github.com/exurd/dbr. Other Python package managers are supported, like pipx install and uv pip install.

To use the program, run python -m dbr [COMMAND] or dbr [COMMAND]. Adding -h will give you the full arguments you can use.

usage: Dumb Badge(s) Remover [-h] [--version] [--file FILE] [--badge BADGE_ID]
                             [--place PLACE_ID] [--user USER_ID]
                             [--group GROUP_ID] [--mgs-id MGS_ID]
                             [--env-file ENV_FILE] [--rbx-token RBX_TOKEN]
                             [--download-mgs-invalid-list]
                             [--download-badge-spam-lists]
                             [--use-bor-badge-database]
                             [--check-inventory USER_ID]
                             [--cache-directory CACHE_DIRECTORY]
                             [--delete-threads NUM_THREADS]
                             [--user-agent USER_AGENT]

Removes Roblox badges very quickly

There are 16 arguments available.

options:
  -h, --help            show this help message and exit
  --version             show program's version number and exit
  --file FILE           Filename path with 'https://roblox.com/[TYPE]/[ID]'
                        urls you want gone from your account.
  --badge, -b BADGE_ID  Specify a badge ID you want gone from your account.
  --place, -p PLACE_ID  Specify a place ID you want gone from your account.
  --user, -u USER_ID    Specify a user ID you want gone from your account.
  --group, -g, --community GROUP_ID
                        Specify a group / community ID you want gone from your
                        account.
  --mgs-id MGS_ID       Specify a MetaGamerScore game ID you want gone from
                        your account.
  --env-file, -e ENV_FILE
                        An .env file allows you to specify settings (the below
                        options) for Dumb Badge(s) Remover to follow without
                        cluttering the terminal or risking important tokens.
                        More information on .env files can be found in the
                        README.
  --rbx-token, -t RBX_TOKEN
                        .ROBLOSECURITY token. By using this option, you agree
                        that this is your unique token and not anyone else's.
                        DO NOT SHARE YOUR ROBLOX TOKEN WITH ANYONE! More info
                        can be found here:
                        https://ro.py.jmk.gg/dev/tutorials/roblosecurity/
  --download-mgs-invalid-list
                        Download MetaGamerScore's list of Roblox games that
                        were detected as problematic. May contain games that
                        are not considered spam, so use with caution.
  --download-badge-spam-lists
                        Download text files from exurd/badge-spam-lists; a
                        bunch of text files containing place IDs from various
                        Roblox badge chains.
  --use-bor-badge-database
                        Tell DBR to instead use the Badgers of Robloxia's
                        Valuable Badge Database to view badges in a universe.
                        Useful for disabled badges, which are hidden when
                        checking universes via the Roblox API. NOTE: Requests
                        for this API can take a long time to complete. It is
                        recommended to instead use the inventory scanner to
                        find hidden badges that you have collected.
  --check-inventory, -c USER_ID
                        Checks a user's inventory for spam badges. DOES NOT
                        DELETE BADGES. Requires a list of place IDs to check
                        (use download arguments above).
  --cache-directory, -cd CACHE_DIRECTORY
                        The directory where cache data is kept.
  --delete-threads NUM_THREADS
                        Sets how many concurrent threads used when deleting
                        multiple badges.
  --user-agent, -ua USER_AGENT
                        Sets the user agent for requests made by the program.

Configuration

To be able to delete badges, you will need to authenticate yourself with a ROBLOSECURITY token. To export your token, read the ro.py's page on the topic. BE VERY CAREFUL WHEN USING THE TOKEN!

DO NOT SHARE IT WITH ANYONE!

IF ANYONE (EVEN YOUR FRIENDS) ASK YOU TO SEND YOUR TOKEN TO THEM, DO NOT GIVE THEM YOUR TOKEN! THEY CAN DO ANYTHING TO YOUR ACCOUNT IF THEY HAVE YOUR TOKEN. THIS INCLUDES STEALING YOUR ROBUX, UPLOADING BANNABLE CONTENT AND DELETING YOUR ACCOUNT FOREVER!

DO NOT SHARE IT WITH ANYONE!!

Once you have your token, add the argument --rbx-token [TOKEN] to your command.

For better safety, you can use .env files to avoid leaks. The .example_env in this repository can be used as a starting point. Copy the file and rename it it .env. Paste the ROBLOSECURITY token into this line: ROBLOXTOKEN="[TOKEN HERE]". Use the argument --env-file [.env file].

Downloading lists

There are two commands for downloading lists for this program; --download-mgs-invalid-list and --download-badge-spam-lists. The first command downloads a list of games that are considered spam by MetaGamerScore. The other command downloads multiple text files from exurd/badge-spam-lists.

To delete badges from games in a text file, use the --file command with the path to the file. Make sure it ends with .txt and not .json!

Scanning inventories

With the -- check-inventory option, you can scan any public inventory for spam badges. It will use any lists downloaded via the above commands. It can then be used to gauge how many spam badges a user has.

Two text files will be created; one for places and one for badges. Each place found in the places list will have the name in the URL. For the badge list, only the

Caution

Check the results of the scan before using them to remove badges, especially if you have downloaded the MGS spam list; false positives have been known to show up there.

This project has been licensed with the MIT License.

About

Dumb Badge(s) Remover ─ Batch remove Roblox Player Badges

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •  

Languages