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 .guide 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 recommends randomized catalog alternatives in these slots:
- Two discs 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.
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 |
.bags [@member] |
Display all bags belonging to you or another member |
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.
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 |
.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.
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.