> 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
Welcome to the documentation for the MLB Discord bot.
This bot provides MLB scores, live game trackers, daily scoreboards, box scores, lineups, schedules, standings, player stats, team information, alerts, highlights, news, injuries, transactions, umpires, Statcast tools, and a virtual Stubs economy for Discord communities.
Use the sidebar categories, on the left, to find the commands you need.
New servers who don't know where to begin, can start with [**`/setup`**](/mlb-bot/mlb-bot-documentation/admin-support.md#setup), which shows a guided checklist for staff roles, daily posts, alerts, scheduled game trackers, Stubs channels, and other recommended server settings.
***
## 📚 Categories
* [📺 Live / Scoreboard](/mlb-bot/mlb-bot-documentation/live-scoreboard.md)
* [🎟️ Stubs Economy](/mlb-bot/mlb-bot-documentation/stubs-economy.md)
* [🎫 Season Pass](/mlb-bot/mlb-bot-documentation/season-pass.md)
* [🎮 Diamond Dynasty](/mlb-bot/mlb-bot-documentation/diamond-dynasty.md)
* [🔠 Bingo](/mlb-bot/mlb-bot-documentation/bingo.md)
* [📚 Trivia](/mlb-bot/mlb-bot-documentation/trivia.md)
* [🎲 Game Details](/mlb-bot/mlb-bot-documentation/game-details.md)
* [📊 Stats / Teams / Players](/mlb-bot/mlb-bot-documentation/stats-teams-players.md)
* [📢 Alerts / Updates](/mlb-bot/mlb-bot-documentation/alerts-updates.md)
* [🛠️ Admin / Support](/mlb-bot/mlb-bot-documentation/admin-support.md)
***
### :newspaper: Recommended Setup
I recommend creating a **Category** dedicated for the bot features.
* **Daily** Posts the daily scheduled MLB games and refreshes every day at **5:00 AM ET**. Command: [`/daily bets:True`](/mlb-bot/mlb-bot-documentation/alerts-updates.md#daily)
* **News** Fetches the latest MLB articles from ESPN. This is constantly polling/running for new updates. Command: [`/news`](/mlb-bot/mlb-bot-documentation/alerts-updates.md#news)
* **Birthdays** Displays MLB player birthdays for the current day. Posts daily at **12:00 AM ET**. Command: [`/birthdays`](/mlb-bot/mlb-bot-documentation/alerts-updates.md#birthdays)
* **Predictions** This is the Stubs betting feed. It posts updates when users place bets, win bets, or lose bets. Command: [`/stubschannel`](/mlb-bot/mlb-bot-documentation/stubs-economy.md#stubschannel-channel-clear)
* **Botspam** A general channel where members can freely use bot commands like stats, teams, calendars, standings, player lookups, and everything else.
* **Game Channels** The Game channels listed below are self-creating and self-updating game channels. They are created deleted and created again daily at **5:00 AM ET**, post pre-game information, and then automatically update with the live game tracker once the game starts. Ending with the final detailed box score when the game is finished. It's not necessary to display all teams, you can have individual follow teams. Command: [`/schedulegame`](/mlb-bot/mlb-bot-documentation/live-scoreboard.md#schedulegame-add-team-less-than-team-greater-than-date-count-channel-category-pitchchart-bets) `add team:All Teams count:162 category:#"MLB Bot Feed" bets:true/false pitchchart:true/false` You can enable the bets embed with true/false and pitchchart as well.
* It's important to set a [`/staffrole`](/mlb-bot/mlb-bot-documentation/admin-support.md#staffrole-id-less-than-roleid-greater-than) `id:123456789101112` to prevent people from pressing the Stop button as well as other things.
* Many people like setting [alerts](/mlb-bot/mlb-bot-documentation/alerts-updates.md) for channels that talk about the current game The most common setup is: `score change` `delayed` `postponed` `homerun` `pitcher change` `final score`
* If you wish to disable stubs/betting all together simply run [`/stubsconfig enabled:false`](/mlb-bot/mlb-bot-documentation/admin-support.md#user-content-stubsconfig)
### 📌 Notes
* Most team, player, date, division, game, and stat inputs support autocomplete.
* Game options usually accept a game selected from autocomplete, or a pasted `gamePk`.
* Some setup commands require server staff permissions, `Manage Server`, or a configured staff role.
* Live game trackers depend on Discord, hosting, and MLB data availability. If an API is delayed or unavailable, bot updates may also be delayed.
* Scheduled posts and daily scoreboard features use Eastern Time unless stated otherwise.
* MLB scores, schedules, stats, highlights, news, injuries, and transactions may be delayed, incomplete, or corrected later by third-party data sources.
* Stubs are a virtual server currency for entertainment only. They have no real-world cash value.
* Stubs predictions and live bets are not real-money gambling and cannot be exchanged for money, prizes, or cash-equivalent rewards.
* `All Teams` is mainly intended for Home Run alerts. Most other alert types require one specific team.
* Bot settings are server-specific. A setting changed in one Discord server does not automatically apply to another server.
* If a command does not respond correctly, check that the bot has permission to view the channel, send messages, embed links, attach files, and use slash commands.
* Abuse, spam, exploit attempts, or harassment may result in the user or server losing access to the bot.
***
## 🔗 Useful Links
* **Terms of Service:** [Terms of Service](/mlb-bot/mlb-bot-documentation/terms-of-service.md)
* **Privacy Policy:** [Privacy Policy](/mlb-bot/mlb-bot-documentation/privacy-policy.md)
* **Legal Disclaimer:** [**Legal Disclaimer**](/mlb-bot/mlb-bot-documentation/legal-disclaimer.md)
* **Support Server**:
* **Change logs** can be followed along here
***
### Credits & Attributions
MLB Bot is built with data, tools, libraries, and services from several third-party sources. Credit and thanks go to the creators and maintainers of these resources.
#### Baseball Data & Media
* **Major League Baseball, MLB.com, and MLB Advanced Media** - MLB scores, schedules, standings, teams, player information, game data, play-by-play data, headshots, highlights, and related baseball content.
* **Baseball Savant / Statcast** - Statcast search, percentile rankings, leaderboards, expected stats, batted-ball data, pitch data, and advanced baseball metrics.
* **ESPN** - MLB news, team data, injuries, and related baseball information used by some bot features.
* **SportsLogos.net** - Team logo references and logo artwork used for team visuals where applicable:
* **Umpire Scorecards** - Umpired scord cards from
#### Trademark Notice
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, 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. They are used for informational, documentation, and entertainment purposes only.
***