InTheBag User Guide¶
InTheBag is a disc golf Discord bot for exploring discs, maintaining personal bags, checking PDGA
ratings, and finding tournaments. Commands begin with a period (.) and are not case-sensitive.
Use .discguide in Discord for the interactive guide. This page is the complete browser-friendly
reference.
Disc lookup¶
Flight numbers¶
.flight <disc name>
Example:
.flight firebird
The response includes the manufacturer, mold, and Speed, Glide, Turn, and Fade values. Exact names are preferred. Partial names and misspellings use fuzzy matching; when several catalog discs are possible, Discord shows selection buttons that only the command author can use.
Who throws a disc?¶
.who <disc name>
Example:
.who firebird
This lists members of the current Discord server who have the selected catalog mold in at least one bag.
Search by flight characteristics¶
Start with any flight characteristic and add more characteristic/value pairs in any order:
.speed 9
.glide 5
.turn -1 fade 2
.speed 9 glide 5
.speed 9 glide 5 turn -1 fade 2
Without a company filter, the bot reports the total match count and displays up to five matches chosen at random. Values may contain one decimal place, and each characteristic can appear only once.
If no disc has the requested flight-number combination, the bot responds with one of its playful no-match messages.
Filter by company¶
Put a manufacturer flag at the end of a flight search:
.speed 4 --discraft
.turn -1 --dynamic discs
.speed 9 glide 5 --latitude 64
The manufacturer flag must be last because company names can contain spaces. A company-filtered search returns every match in alphabetical, paginated results.
Browse a company¶
Use a company name as the command:
.innova
.latitude 64
The bot reports the number of active catalog discs made by that company and shows buttons for Putt & Approach, Mid Range, Control Driver, and Distance Driver. Selecting a button lists every matching mold.
You can include the category directly:
.innova distance driver
.discraft mid range
.latitude 64 control driver
Only the command author can operate category and pagination buttons.
Find similar discs¶
.iLike <disc name>
Example:
.iLike Destroyer
The bot shows whether each disc is beaded and recommends randomized catalog alternatives in these slots:
- One beaded and one beadless disc with the same flight numbers.
- One disc with less Speed and one with more Speed.
- One disc with less Glide and one with more Glide.
- One disc with less Turn and one with more Turn.
- One disc with less Fade and one with more Fade.
In disc golf terminology, more Turn means a more-negative number. Relative to Turn -1, more
Turn is -2 and less Turn is 0. The bot first tries a difference of 1; if none exists, it tries 0.5.
Unavailable recommendation slots display No catalog match.
Disc measurements and bead filters¶
.measurements <disc name>
.bead yes
.bead no
.speed 3 bead yes
The measurement lookup shows diameter, height, rim depth, rim width, inside-rim diameter, rim-depth ratio, rim configuration, and bead. Bead may be searched alone or combined with Speed, Glide, Turn, and Fade. The other physical measurements are display-only and cannot filter the catalog.
Plastic catalog¶
List the manufacturers covered by the locally curated plastics catalog or browse one company:
.plastics
.plastics innova
.plastics discraft
Look up a plastic by its full name or a common alias:
.plastic halo star
.plastic ti
.plastic discraft z-swirl
Plastic details include the manufacturer, plastic family, category, aliases, a short description, and a reference link. Fuzzy matching helps with misspellings and buttons resolve ambiguous names. The plastics catalog describes manufacturer plastic lines; it does not claim that every mold is available in every listed plastic.
Bags¶
Each member can maintain up to four named bags in each Discord server. Each bag can hold up to 60 physical discs, including multiple copies of the same mold. Bags are public within the server and isolated from bags in other servers.
View and select bags¶
| Command | Result |
|---|---|
.bag |
Display your active bag, creating a Main Bag if needed |
.bag list |
List your named bags and identify the active one |
.bag create <name> |
Create and select a new bag |
.bag select <name> |
Make a bag active |
.bag show <name> |
View one named bag without selecting it |
.bag rename <name> |
Rename the active bag |
.bag delete <name> |
Delete a named bag after confirmation |
.bagPic with one attached image |
Add or replace the active bag's picture |
.bagPic remove |
Remove the active bag's picture |
.inthebagpic |
Upload a separate photo of all discs in the active bag |
.inthebagpic remove |
Remove the active bag's InTheBag photo |
.inthebagshow |
Show one of your InTheBag photos |
.inthebag @member |
Show one of another member's InTheBag photos |
.bags [@member] |
Display all bags belonging to you or another member |
Bag pictures may be PNG, JPEG, GIF, or WebP files up to 8 MB. Each named bag has its own picture, which appears at the top of the bag display.
An InTheBag photo is stored separately from the normal bag picture, so each named bag may have one
of each. With no attachment, .inthebagpic prompts for an image upload in the next message. When
.inthebagshow or .inthebag @member finds pictures for multiple named bags, the person who ran
the command selects which bag to display. Only bags with an InTheBag photo are offered.
Bag displays show flight numbers and group discs in this order:
- Putts With
- Putt & Approach
- Mid Range
- Control Driver
- Distance Driver
The catalog's disc type is used when available; Speed is only a fallback for missing types.
Add catalog discs¶
.bag add <disc name>
Optional copy details are --plastic, --weight, --color, and --notes. Quote a value that
contains spaces:
.bag add Firebird --plastic Champion --weight 175 --color Orange --notes "Utility disc"
Separate as many as 10 additions with semicolons. Each entry may have its own copy details:
.bag add Firebird --plastic Champion; Envy --plastic Electron; Hex
Batch additions are processed from left to right. Processing stops at the first missing or ambiguous name. Selecting an ambiguous disc adds it, but entries after it are not processed; run another command for those discs.
Edit a physical disc¶
.bag edit Toro --plastic Champion --weight 175 --color Orange --notes "Forehand disc"
Only supplied fields change. Use --clear-plastic, --clear-weight, --clear-color, or
--clear-notes to remove a value. Multiple matching physical discs open a single-disc selection
menu.
Remove discs¶
.bag remove <disc name>
.bag remove Firebird; Envy; Hex
One matching physical copy is removed directly. Multiple copies or molds open a menu showing plastic, weight, color, and notes where available. Select as many as 10 physical discs per command.
To remove everything from the active bag:
.bag empty
Discord asks for confirmation before emptying or deleting a bag.
Putts With¶
.puttsWith <mold>
.puttsWith
The first form marks a catalog mold as a putting putter in the active bag. The second shows the current selections. Each bag can have up to two putting molds. Adding a third prompts you to choose which previous mold to replace. Putts With molds appear only in the special top section, not again under their normal disc category.
Bag matrix¶
.matrix
.matrix <bag name>
The matrix displays disc types from putters through distance drivers and places discs left to right by stability, calculated as Turn + Fade:
| Stability | Turn + Fade |
|---|---|
| Very OS | 2.1 or greater |
| OS | 1.0 through 2.0 |
| US | -0.5 through 0.9 |
| Very US | -0.6 or less |
Special discs¶
A special disc belongs only to the active bag and is never added to the shared catalog.
.bag add special
The bot prompts for:
| Value | Allowed value |
|---|---|
| Unique name | 1–100 characters |
| Disc type | A standard type or a custom type up to 16 characters |
| Speed | 1 through 16 |
| Glide | 1 through 8 |
| Turn | -8 through 3 |
| Fade | -1 through 7 |
Flight numbers may have one decimal place. Reply cancel during a text prompt to stop. Special
discs appear in bag displays and can be removed with .bag remove <name>.
Use .who special to browse server members' special discs. Select a member and then a disc to see
its user-entered flight numbers.
PDGA ratings¶
Connect your Discord account by running:
.addMyPDGA
Reply to the prompt with your PDGA number within 60 seconds. After linking, these commands are available:
| Command | Result |
|---|---|
.myRating [@member] |
Current official player rating |
.roundHighest [@member] |
Highest-rated PDGA round |
.roundLowest [@member] |
Lowest-rated PDGA round |
.ratingHighest [@member] |
Highest official rating in player history |
.ratingNext [@member] |
Estimate the next rating from currently posted rounds |
.rankings |
Rank linked server members by current official rating |
.rankings1months through .rankings11months |
Rank linked server members by an unweighted rolling-month rating |
.rating1month [@member] through .rating11month [@member] |
Unweighted rating over recent calendar months |
Calculated ratings are estimates. PDGA's official calculation may differ. Public PDGA information
is cached and normally refreshed after the configured Tuesday refresh boundary.
Linked members without a rating for the selected ranking appear at the bottom. The bot application
must have Server Members Intent enabled in the Discord Developer Portal for complete rankings.
Ranking commands with a number above 11, such as .rankings12months, show current official ratings.
Tournament search¶
.tournaments ZIP [--count] [--miles] [-A|-B|-C]
Spaces are required. The first --number controls the result count and the second controls the
radius in miles.
| Argument | Default | Limits |
|---|---|---|
| Five-digit US ZIP code | Required | Exactly five digits |
| Result count | 5 | 1–10 |
| Radius | 30 miles | 1–500 miles |
-A |
No tier filter | A-tier only |
-B |
No tier filter | B-tier only |
-C |
No tier filter | C-tier and XC-tier |
Examples:
.tournaments 45223
.tournaments 45223 --10
.tournaments 45223 --5 --50
.tournaments 45223 --5 --50 -A
.tournaments 45223 --5 --50 -B
.tournaments 45223 --5 --50 -C
Results include event details and registration links. With no tier flag, all listed tournament tiers are eligible.
Interactive controls¶
Selection, category, and pagination controls can only be used by the member who ran the command. Most controls expire after 60 seconds. If one expires, run the command again.
Disc catalog attribution: The Disc Database. Tournament information and registration links: Disc Golf Scene. PDGA player information: Professional Disc Golf Association.