> For the complete documentation index, see [llms.txt](https://stitch-bot.gitbook.io/mlb-bot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://stitch-bot.gitbook.io/mlb-bot/mlb-bot-documentation.md).
# MLB Bot Documentation
MLB Bot brings live baseball information, automatic game coverage, and server-based games into Discord. It includes scores, schedules, standings, lineups, box scores, player and team stats, Statcast tools, alerts, news, highlights, a virtual Stubs economy, Season Pass progression, Bingo, Trivia, Guess the Player, Wordle, and Diamond Dynasty.
Most commands use autocomplete. Start typing a team, player, game, date, division, or stat and choose the result instead of looking up an ID yourself.
If you are setting up a new server, begin with [`/setup`](/mlb-bot/mlb-bot-documentation/admin-support.md). It checks the serverโs current configuration and shows the next recommended commands.
***
## ๐ Documentation
* [๐ The Baseball Exchange](/mlb-bot/mlb-bot-documentation/baseball-exchange.md) โ the connected web dashboard for profiles, predictions, Season Pass, Wordle, and Diamond Dynasty
* [๐บ Live / Scoreboard](/mlb-bot/mlb-bot-documentation/live-scoreboard.md) โ scores, live trackers, lineups, calendars, standings, and scheduled game channels
* [๐๏ธ Stubs Economy](/mlb-bot/mlb-bot-documentation/stubs-economy.md) โ claims, predictions, pools, missions, profiles, shop items, and leaderboards
* [๐ซ Season Pass](/mlb-bot/mlb-bot-documentation/season-pass.md) โ Season XP, rewards, profile upgrades, and Prestige levels
* [๐ฎ Diamond Dynasty](/mlb-bot/mlb-bot-documentation/diamond-dynasty.md) โ cards, packs, collections, teams, challenges, and the market
* [๐ Bingo](/mlb-bot/mlb-bot-documentation/bingo.md) โ live game boards, difficulty levels, rewards, and leaderboards
* [๐ Trivia](/mlb-bot/mlb-bot-documentation/trivia.md) โ trivia categories, round settings, rewards, stats, and leaderboards
* [๐งฉ Guess / Wordle](/mlb-bot/mlb-bot-documentation/guess-wordle.md) โ private player puzzles with Stubs and Season Pass XP rewards
* [๐ฒ Game Details](/mlb-bot/mlb-bot-documentation/game-details.md) โ highlights, scoring plays, Statcast, pitcher arsenals, and umpires
* [๐ Stats / Teams / Players](/mlb-bot/mlb-bot-documentation/stats-teams-players.md) โ player profiles, comparisons, rosters, payroll, injuries, and transactions
* [๐ข Alerts / Updates](/mlb-bot/mlb-bot-documentation/alerts-updates.md) โ team alerts, player watchlists, news, daily scoreboards, and birthdays
* [๐ ๏ธ Admin / Support](/mlb-bot/mlb-bot-documentation/admin-support.md) โ setup, permissions, server controls, voting, and support
***
## Recommended server setup
The simplest setup is one MLB category with separate channels for daily games, news, birthdays, Stubs activity, and general bot commands.
1. Run `/setup` to see what is already configured.
2. Set `/staffrole id:@YourStaffRole` so trusted members can manage tracker controls and server-only features.
3. Run `/daily bets:true` in the channel that should receive the refreshed daily scoreboard and game-prediction buttons.
4. Run `/birthdays` in the channel that should receive the midnight player-birthday post.
5. Run `/news poll` in the channel that should receive new league-wide articles.
6. Run `/stubschannel channel:#stubs` for public prediction activity.
7. Run `/dd marketchannel channel:#market` if your members use Diamond Dynasty.
8. Add team alerts with `/alerts add`, or schedule complete game coverage with `/schedulegame add`.
For a full-season tracker, a common starting command is:
```txt
/schedulegame add team:Yankees count:162 bets:true
```
Use `team:All Teams` with a category when you want the bot to create matchup channels for every game. For team-specific servers, schedule only the team your community follows.
A simple channel layout for MLB Bot features.
***
## Quick start for members
* `/scores` โ todayโs complete scoreboard
* `/live` โ an automatically refreshing live-game tracker
* `/calendar team:` โ a monthly team schedule image
* `/player name:` โ player profile, season stats, career totals, and advanced information
* `/profile` โ your server Stubs and gameplay profile
* `/missions` โ current daily and weekly goals
* `/guess` and `/wordle` โ private player puzzles
* `/dd help` โ the private interactive Diamond Dynasty guide
***
## Important notes
* Scheduled posts use Eastern Time unless a section says otherwise.
* Starting times are displayed with Discord timestamps where available, so members see them in their own local time.
* Server settings, balances, progression, collections, and leaderboards are server-specific.
* MLB and third-party data can be delayed, incomplete, unavailable, or corrected later.
* The bot needs permission to view the channel, send messages, embed links, attach files, and use application commands.
* `All Teams` is supported where the command offers it. For alerts, it is intended primarily for Home Run alerts; other alert types require one team.
* Stubs, cards, tokens, and other bot rewards are virtual entertainment items. They have no real-world value and cannot be purchased, sold, or redeemed for money.
* Abuse, spam, exploit attempts, or harassment may result in a user or server losing access to the bot.
***
## ๐ Useful links
* [Terms of Service](/mlb-bot/mlb-bot-documentation/terms-of-service.md)
* [Privacy Policy](/mlb-bot/mlb-bot-documentation/privacy-policy.md)
* [Legal Disclaimer](/mlb-bot/mlb-bot-documentation/legal-disclaimer.md)
* [Support Server](https://discord.gg/zSUntxeYMq)
* [Change Log Channel](https://discord.com/channels/1511455923846123610/1513773142408167524)
***
## Credits and attributions
MLB Bot uses data, tools, libraries, and services maintained by third parties.
* **Major League Baseball, MLB.com, and MLB Advanced Media** โ scores, schedules, standings, teams, players, game data, play-by-play, headshots, highlights, and related baseball content
* **Baseball Savant / Statcast** โ Statcast search, percentiles, expected statistics, batted-ball data, pitch data, and advanced metrics
* **ESPN** โ MLB news, injuries, and related baseball information used by some features
* **SportsLogos.net** โ team-logo references and artwork used for some visuals: [sportslogos.net](https://www.sportslogos.net/)
* **UmpScorecards** โ umpire scorecard images: [umpscorecards.com](https://umpscorecards.com/)
MLB Bot is not affiliated with, endorsed by, sponsored by, or officially connected to Major League Baseball, MLB Advanced Media, MLB.com, Discord Inc., Top.gg, ESPN, Baseball Savant, SportsLogos.net, UmpScorecards, any MLB team, league, player, or organization unless explicitly stated.
All team names, logos, player names, statistics, trademarks, and related materials belong to their respective owners and are used for informational, documentation, and entertainment purposes only.
