Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
content-packs:core-rules:software:discord [2026/01/31 17:19] – jobcontent-packs:core-rules:software:discord [2026/02/04 19:21] (current) – [GM Commands] job
Line 20: Line 20:
 The following commands are available to facilitate game play and technical troubleshooting.  The following commands are available to facilitate game play and technical troubleshooting. 
  
-==== /help ====+=== /help ===
 Type //**/help**// [enter] to have the bot send you a link to this web page. Type //**/help**// [enter] to have the bot send you a link to this web page.
  
-==== /config ==== +=== ?ping === 
-This group of commands is for the GM of the active campaign. +Type //**?ping**// to check if the bot is online.  If it is, it will respond with a message like //Pong! Latency=0.1ms//.  If it doesn't respond, well, it must be on a drunken bender, better DM the bot admin to fix it...
-  * //**/config campaign**// will update the current campaign name with one you specify like: /config campaign No-Dice RPG, and set that campaign as active (makes you GM of that campaign). +
-  * //**/config adventure**// will update the current adventure name with one you specify like: /config adventure Sword of Hope and set that name as active.  +
-  * //**/config scenario**// will update the current scenario name with one you specify like: /config scenario Gar Cavern +
-  * //**/config scene**// will update the current scene name with one you specify like: /config scene Spawn of Circa Guards +
-  * //**/config hand**// will update the current hand name with one you specify like: /config hand Combat at the Gates +
-  * //**/config player <@user> <add|remove>**// adds or removes a Discord user to the GM's campaign. +
-  * //**/config actor <name> <statblock|@user|unassign|delete>**// examples: +
-    * __///config actor example-actor R1/1(27/0)-M3(3/3/3)-B3(3/3/3)-S3(3/3/3)//__ -- creates an actor named example-actor with the given statblock as an NPC in the GM's campaign. +
-    * __///config actor example-actor @user//__ -- assigns the existing actor named example-actor to the Discord user @user.. +
-    * __///config actor example-actor R1/1(27/0)-M3(3/3/3)-B3(3/3/3)-S3(3/3/3) @User//__ -- creates an actor named example-actor with the given statblock and assigns it to the Discord user @User. +
-    * __///config actor example-actor unassign//__ -- converts example-actor from being assigned to a player to becoming an NPC. +
-    * __///config actor example-actor delete//__ -- removes example-actor from the GM's campaign.+
  
-==== /hand ==== +----
-Type //**/hand**// to start a new hand, or save the current one, load the prior one, or show the cards that have been played so far. +
-  * //**/hand <some name>**// will start a new hand called "some name" in this example, ask you to choose which players will participate, and overwrite any previous hand that was not saved. +
-  * //**/hand save**// will save the current hand to disk on the server so it can be reloaded later. +
-  * //**/hand load**// will load the last hand that was saved with the ///hand save// command, overwriting the current hand if there is one.+
  
-==== /play ====+==== Player Commands ===== 
 + 
 +=== /play ===
 Type //**/play**// to play a card face-down.  A hand must have been created first with the ///hand// command, or you will get an error trying to play a card. Type //**/play**// to play a card face-down.  A hand must have been created first with the ///hand// command, or you will get an error trying to play a card.
   * //**/play <card name>**// will play the <card name> you typed **face down**, adding it to the hand, but showing only a card back to the channel. If you need help finding the possible card file names, you can view all of them with the ///show list// command.   * //**/play <card name>**// will play the <card name> you typed **face down**, adding it to the hand, but showing only a card back to the channel. If you need help finding the possible card file names, you can view all of them with the ///show list// command.
   * //**/play <card name> up**// will play the exact card file name you typed, like "/play ta-mind", **face up,** add it to the hand, and announce it to the channel.    * //**/play <card name> up**// will play the exact card file name you typed, like "/play ta-mind", **face up,** add it to the hand, and announce it to the channel. 
-  * //**/play <card name> on card0**// will play the <card name> you typed **face down**, and add it to the hand **on top of** the first card played in the hand to form a Card Stack. You can see the sequence of cards played so far in the hand with the ///hand show// command. Note that the sequence of cards in a hand starts at 0, not 1. Also note that you cannot play a card on top of a card that was played on top of a card (nesting); instead, there is a base card at the bottom of the Card Stack, and you can play as many cards as you want on top of that base card.+  * //**/play <card name> on card0**// will play the <card name> you typed **face down**, and add it to the hand **on top of** the first card played in the hand to form a Card Stack. You can see the sequence of cards played so far in the hand with the ///show hand// command. Note that the sequence of cards in a hand starts at 0, not 1. Also note that you cannot play a card on top of a card that was played on top of a card (nesting); instead, there is a base card at the bottom of the Card Stack, and you can play as many cards as you want on top of that base card.
   * //**/play <card name> on card1 up**// will play the <card name> you typed **face up**, and add it to the hand //on top of// the second card played in the hand to form a Card Stack, and show the card face to the channel. Note that the sequence of cards in a hand starts at 0, not 1, and that is why card1 indicates the second card that was played in the hand.    * //**/play <card name> on card1 up**// will play the <card name> you typed **face up**, and add it to the hand //on top of// the second card played in the hand to form a Card Stack, and show the card face to the channel. Note that the sequence of cards in a hand starts at 0, not 1, and that is why card1 indicates the second card that was played in the hand. 
  
-==== /show ====+=== /bid === 
 +Type //**/bid**// to bid stat points on a card you've already played.  
 +  * //**/bid Card2 3WIL 1QUI**// will bid chips **face-down** on Card2 in the hand sequence, sending a message to the channel with the number of chips you have bid, but not what Attribute they are. You can type this command more than once if you made a mistake the first time and want to adjust your prior bid.  Each time this command is run it will send a message to the channel to alert other players what card you've bid on. 
 +  *  //**/bid Card0 3WIL 1QUI up**// will bid three WIL Attribute Points and one Quickness **face up** on the first card that has been played in the hand (card sequences in a hand start with 0, not 1).  
 + 
 +=== /flip === 
 +Type //**/flip**// to reveal to the channel all face down cards, and any Stat Points that have been bid on them. Cards are displayed in a bulleted list, in the order they were played.  Cards played on top of another card will listed right after the base card. The base card will have a solid bullet, and the cards played on it will have hollow bullets.  On a computer with a wider screen, the cards played on another card will be indented.  
 + 
 +=== /chips === 
 +Allows you to manage the chip stacks of your actor: 
 +  * //**/chips dmg Grogan -3str -2ag **// applies 3 STR and 2 AGI damage to the Actor Grogan 
 +  * //**/chips delta Grogan +2kno **// awards 2 KNO chips to Grogan 
 +  * //**/chips reset Grogan**// resets Grogan's chips back to base from Actor sheet. 
 + 
 +=== /show ===
   * //**/show actors**// shows the actors names assigned to you in the current //campaign//. If you are the GM, it shows all actors in the current //adventure// plus any //campaign// NPCs.   * //**/show actors**// shows the actors names assigned to you in the current //campaign//. If you are the GM, it shows all actors in the current //adventure// plus any //campaign// NPCs.
   * //**/show actor**// shows you the statblock of an Actor assigned to you like __/show actor example-actor__   * //**/show actor**// shows you the statblock of an Actor assigned to you like __/show actor example-actor__
 +  * //**/show bid**// will show you in a private message the sequence of all the cards you've played so far in the hand to help you find the sequence number of the card you want to bid on.
 +  * //**/show chips <actor_name> **// shows the state of the Actor's chips
   * //**/show config**// will send a private message to you showing all of the current game settings (Campaign, Adventure, Scenario, Scene, Hand, and Actor count)   * //**/show config**// will send a private message to you showing all of the current game settings (Campaign, Adventure, Scenario, Scene, Hand, and Actor count)
   * //**/show list**// will show just you a list of all possible card file names.   * //**/show list**// will show just you a list of all possible card file names.
Line 59: Line 61:
   * //**/show hand**// will send you a private message with the name of the current hand, the players participating, and what cards have been played so far, as well as who played them.  Card names and bids that were played face-down will be hidden. Cards played on top of another card will be indented on a computer with a wide screen, or listed with hollow bullets below the card they are played, which will have a solid bullet.   * //**/show hand**// will send you a private message with the name of the current hand, the players participating, and what cards have been played so far, as well as who played them.  Card names and bids that were played face-down will be hidden. Cards played on top of another card will be indented on a computer with a wide screen, or listed with hollow bullets below the card they are played, which will have a solid bullet.
  
-==== /bid ==== +----
-Type //**/bid**// to bid stat points on a card you've already played.  +
-  * //**/bid show**// will show you in a private message the sequence of all the cards you've played so far in the hand to help you find the sequence number of the card you want to bid on. +
-  * //**/bid Card2 3WIL 1QUI**// will bid chips **face-down** on Card2 in the hand sequence, sending a message to the channel with the number of chips you have bid, but not what Attribute they are. You can type this command more than once if you made a mistake the first time and want to adjust your prior bid.  Each time this command is run it will send a message to the channel to alert other players what card you've bid on. +
-  *  //**/bid Card0 3WIL 1QUI up**// will bid three WIL Attribute Points and one Quickness **face up** on the first card that has been played in the hand (card sequences in a hand start with 0, not 1).  +
-==== /flip ==== +
-Type //**/flip**// to reveal to the channel all face down cards, and any Stat Points that have been bid on them. Cards are displayed in a bulleted list, in the order they were played.  Cards played on top of another card will listed right after the base card. The base card will have a solid bullet, and the cards played on it will have hollow bullets.  On a computer with a wider screen, the cards played on another card will be indented. +
  
-==== ?ping ==== +==== GM Commands ===== 
-Type //**?ping**// to check if the bot is online.  If it is, it will respond with a message like //Pong! Latency=0.1ms//.  If it doesn't respond, well, it must be on a drunken bender, better DM the bot admin to fix it...+ 
 +=== /hand === 
 +Type //**/hand**// to start a new hand, or save the current one, load the prior one, or show the cards that have been played so far. 
 +  * //**/hand <some name>**// will start a new hand called "some name" in this example, ask you to choose which players will participate, and overwrite any previous hand that was not saved. 
 +  * //**/hand save**// will save the current hand to disk on the server so it can be reloaded later. 
 +  * //**/hand load**// will load the last hand that was saved with the ///hand save// command, overwriting the current hand if there is one. 
 + 
 +=== /config === 
 +This group of commands is for the GM of the active campaign. 
 +  * //**/config campaign**// will update the current campaign name with one you specify like: /config campaign No-Dice RPG, and set that campaign as active (makes you GM of that campaign). 
 +  * //**/config adventure**// will update the current adventure name with one you specify like: /config adventure Sword of Hope and set that name as active.  
 +  * //**/config scenario**// will update the current scenario name with one you specify like: /config scenario Gar Cavern 
 +  * //**/config scene**// will update the current scene name with one you specify like: /config scene Spawn of Circa Guards 
 +  * //**/config hand**// will update the current hand name with one you specify like: /config hand Combat at the Gates 
 +  * //**/config player <@user> <add|remove>**// adds or removes a Discord user to the GM's campaign. 
 +  * //**/config actor <name> <statblock|@user|unassign|delete>**// -- manages actors: 
 +    * __///config actor example-actor R1/1(27/0)-M3(3/3/3)-B3(3/3/3)-S3(3/3/3)//__ -- creates an actor named example-actor with the given statblock as an NPC in the GM's campaign. 
 +    * __///config actor example-actor @user//__ -- assigns the existing actor named example-actor to the Discord user @user.. 
 +    * __///config actor example-actor R1/1(27/0)-M3(3/3/3)-B3(3/3/3)-S3(3/3/3) @User//__ -- creates an actor named example-actor with the given statblock and assigns it to the Discord user @User. 
 +    * __///config actor example-actor unassign//__ -- converts example-actor from being assigned to a player to becoming an NPC. 
 +    * __///config actor example-actor delete//__ -- removes example-actor from the GM's campaign. 
 +  * //**/config cp <list,filename, on|off>**// -- manages game Content Packs: 
 +    *  __///config cp list//__ -- lists all available game Content Packs.  
 +    * __///config cp fantasy.py//__ -- shows a message about what this Content Pack adds. 
 +    * __///config cp fantasy.py on//__ -- turns on this Content Pack 
 +    * __///config cp fantasy.py off//__ -- turns off this Content Pack 
 +  * //**/config ex <list,filename, on|off>**// -- manages game rule Extensions: 
 +    *  __///config ex list//__ -- lists all available game Extensions.  
 +    * __///config ex body_locations.py//__ -- shows a message about what this Extension file changes. 
 +    * __///config ex body_locations.py on//__ -- turns on this Extension 
 +    * __///config ex body_locations.py off//__ -- turns off this Extension
  
-==== ?sync ====+=== ?sync ===
 **<wrap em>!Important!</wrap>**: this command only works for the bot developer, and is used to update Discord when new bot commands have been coded. **<wrap em>!Important!</wrap>**: this command only works for the bot developer, and is used to update Discord when new bot commands have been coded.
   * __**?sync**__ this takes all global commands within the CommandTree and sends them to Discord.   * __**?sync**__ this takes all global commands within the CommandTree and sends them to Discord.