Discord Bot Patches and FAQ

[TuscanSota]

Hi everyone,

 

I don't think we have a thread specifically regarding the discord bot; so I'm posting here to create a quick FAQ page on how to use the SimFBA Discord Bot on our Discord Server.

 

The Discord Bot is a tool we can use to quickly pull up stats related to our teams within the leagues we host here on SimFBA. We also stream games through our bot in near-real-time so that you can see games play out in a text format. This enhances the user experience from seeing the games play out before results are revealed.

When is the Bot Active?

The bot is active on a home server and runs 24/7. There are moments where it does crash, in which I do my best to bring it back up as soon as possible. As for why the crashes occur, it has to do with Discord.JS's currently implementation.

 

Who Can Use the Bot?

Anyone can.

 

Which Commands Can Be Used?

Below is a table listing out each possible command along with the leagues and permissions associated:

League	Command	Inputs	Description	Permissions
SimCFB	player	{firstName} {lastName} {team}	User can look up any given CFB player based on the first name, last name, and team abbreviation provided	All
	team	{team}	Based on the abbreviation provided a user can look up any team	All
	croot	{firstName} {lastName}	Look up any croot given the name provided	All
	class	{team}	Look up the recruiting class for any given team	All
	stats player pi	{week} {firstName} {lastName} {team}	Look up the individual stats of any player in the specified week	All
	stats player ps	{season} {firstName} {lastName} {team}	Look up the season stats of any player in the specified season	All
	stats team ti	{week} {team}	Pull up the weekly stats of the inputted team	All
	stats team ts	{season} {team}	Pull up the season stats of the inputted team	All
	live	{timeslot} {week}	Given the provided timeslot and week, stream all FBS games in that timeslot	Staff & Moderators
	fcs_live	{timeslot} {week}	Given the provided timeslot and week, stream all FCS games in that timeslot	Staff & Moderators
SimNFL	nfl_live	{timeslot} {week}	Given the provided timeslot and week, stream all SimNFL games in that timeslot	Staff & Moderators
SimCBB	cbb_player	{firstName} {lastName} {team}	Look up any CBB Player on a given team	All
	cbb_team	{team}	Look up any CBB Team and see all related data for the current week and season	All
	cbb_croot	{firstName} {lastName}	Look up any CBB Croot	All
	cbb_conf_standings	{conference}	Look up the standings for a conference in the current season	All
	cbb_live	{day} {week}	Given the provided day (A,B,C,D) and week, stream all user games	Staff & Moderators
	tbs_live	{day} {week}	Given the provided day (A,B,C,D) and week, stream all non-user P6 games	Staff & Moderators
	espn_live	{day} {week}	Given the provided day (A,B,C,D) and week, stream all remaining non-user games	Staff & Moderators
SimNBA	nba_player	{firstName} {lastName} {team}		All
	nba_team	{team}		All
	nba_conf_standings	{conference}		All
	tnt_live	{day} {week}	Given the provided day (A,B,C,D) and week, stream all nba-user games	Staff & Moderators
	nbatv_live	{day} {week}	Given the provided day (A,B,C,D) and week, stream all non-user nba games	Staff & Moderators
	int_live	{day} {week}	Given the provided day (A,B,C,D) and week, stream all ISL games	Staff & Moderators

 

Will there be more commands in the future!

Yes! I will be adding more commands, especially, SimNFL, during the offseason. I want users to be able to look up players, stats, and information related to each conference and division. Here is a shortlist of commands I want to provide in the near future:

• Conference Matches (Get all upcoming games given the specified Conference. Both CFB and CBB)
• NFL Player (Look up a SimNFL Player)
• NFL Team (Look up an NFL Team and get all data related to the current season)
• NFL Stats (Look up a player/team and get stats based on week/season input)
• Free Agent (Look up a Free Agent and all existing offers)
• NFL Contract (Look up an NFL Contract for an existing player)
• Coach (Look up a CFB coach and see their record across their entire time in the Sim)
• Current (Get the current week, season, and quick info for the given league (CFB/NFL/CBB/NBA)

 

Is there anything we can do to help?

For those interested in development on the discord bot please reach out. If you have experience in using Discord.JS or Discord's Python related package, definitely reach out as well.

[TuscanSota]

Patch 9/21/23

• Added the following commands:
  • cbb_player
  • nba_player
  • cbb_croot
  • cbb_conference_standings
  • cbb_team
  • nba_team
  • nba_conference_standings
• Added conference logos to the bot

[TuscanSota]

Patch 11/2/23

• Added the following command:
  • cfb_flex

 

Want to check the series history between two teams? Now you can with the cfb_flex command!

Input the abbreviations for two teams, and the discord bot will return the series between the two teams. The following data will be returned:

• Wins, losses, and streaks between the two teams
• Largest Margin of Victory, if a team won during the series

 

While we only have three seasons of data available, this command will be widely used the longer the sim ages.

Enjoy!

[TuscanSota]

Patch 4/15/24

• Added ability to look up NFL players via the discord bot
• Added season stats lookup for CFB and NFL players via the CFB_player and NFL_player command
• Added ability to register to a team via the Discord Bot. This will allow users to be tagged when their team plays via stream
• Discord Bot has now been deployed to Pi server and is available 24/7

[TuscanSota]

Patch 5/2/24

• Added additional streaming channels for CFB Games. Each FBS Timeslot on Saturday now has their own channel for streaming. Below are the following channels and their saturday timeslot:
  • Saturday Morning: simfba-live
  • Saturday Afternoon: b1g-noon-kickoff
  • Saturday Evening: prime-time
  • Saturday Night: Pac-2-afterdark
• A new role has been added to the discord server called @simfba-redzone. Users with this role will now be notified when a big play happens during any streamed game. Here are the following guidelines on what counts as a big play:
  • Any pass or run that goes over 40 yards
  • A touchdown
  • An interception
  • A fumble
  • A sack
  • A safety
• Users can now view info related to their offensive and defensive scheme on the depth chart page. They cannot view other team's scheme info cards on this page.
• Additional measures will be implemented in the near future to better inform users when their depth chart is invalid due to the following events:
  • A player is injured
  • A player is redshirted
  • A player is cut from a team
  • A player is traded
  • A player is placed on the practice squad

[TuscanSota]

Patch 5/6/24

- All offense & defense formations now have a button beside their name which will reveal a graphic of what the formation will look like in-sim:

[TuscanSota]

Patch 6/4/24

• Numerous discord commands added allowing users to search for players by name or id, along with viewing either stats or attributes. Shoutout to @kgreene829 for his work on getting these commands up.

[TuscanSota]

Patch 6/21/24

• Numerous commands related to basketball sim have been implemented
• Commands for looking up cfb recruits
• Commands related to teams more accessible are now more accessible based on user input for team names
• You can now flex your CBB & NBA teams against one another (I think)

 

Shoutout to @kgreene829 for his extensive work on the discord bot. He's put in a lot of work into making it easier for everyone to use the commands and look up team & player info.