-
Notifications
You must be signed in to change notification settings - Fork 0
Player Guide
When a fecht is in progress within a channel, you can make the following commands.
!s [your message]
It may be better to use a seperate channel for this, though switching between channels can be troublesome. THis can be used as a last ditch way of communicating information since by default the bot deletes off regular chat messages while a fecht is in progress to keep things clean.
When it's your turn as listed in the Fecht footer, the following actions can be made..:
!say [your message]
And roll manuevers can be made during your turn on phases which aren't reaction-only based (ie. phases configured to force turned players to only be able to tap on react buttons to submit their choice/advance the game forward). Roll manuevers !r/!rp must always have a label. Dice roll expression/comments are optional.
!r Label Of Manuever : Dice Roll Expression # Any optional comments after hash bang!r Label Of Manuever!r Label Of Manuever # Any optional comments
Dice roll expressions is using an engine somewhat similar to roll20's. Some differences are the actual use of math Operators which differentiates between >= vs > . https://wiki.roll20.net/Dice_Reference
Reply slot manuever with !rp [slot] where [slot] refers to an integer of a stored manuever listed on the Fechtboard. You can only reply to an integer slot. This will allow your manuever to be listed directly under that given integer slot as if "replying" to it.
!rp [slot] Label Of Manuever : Dice roll Expression # Any optional comments
eg. !rp 2 Block: 5d10>=7 # You can't pass this!
!r :character-handle Label Of Manuever : Dice roll expression # Any optional comments
A ": character-handle" statement can be used before a roll manuever (notice the colon, and the "character-handle" string to indicate a manuever being used under one of your characters.) This is to allow a single player user to manage multiple characters in a single turn. Example of users controlling various characters under his username can be found labeled like: @Glidias#0438:some-character-handle . All character handles must be a single string seperated by dashses or underrscores, it's like another secondary user-id itself and should not contain additional colons or too fancy characters.
All !s and !say commands can perform insta-resolved inline dice roll expressions. What you do is enclose the expression with backticks and the first backtick itself has a starting exclaimation mark like so:
!s Damaging !`4-2`, Thrust Hit location !`1d10`
When it's your user turn, you may optionally roleplay a character with the !say command via a specific :character-handle prefix... like so:
!say :orc-archer I am going to dish you out! Shoot !`8d10>=7` against target of RS 2
Make sure you spell your character handle (if any) correctly (it's case sensitive!), to ensure any say commands you make is valid and isn't demoted to "outgame" (colored black border).
*Currently, there is no proper mechanism to edit !s and !say commands directly which is tricky since the outputted messages belong to the FechtBot. As of now, only the GM is able to delete off such messages via adding a reaction to it with a red ❌ symbol. (Easily search for emoticon using : "X") to clean up messages. Also , if a !say or !s message "belongs" to you under similar matching display member name, you can delete it with an ❌ reaction. Only then you can then consider rewriting your message.
Any !r /!rp manuever messages being created/edited by the players themselves during their turn, will have the bot react to it to indicate if its a valid/rollable manuever expression. Here are the symbols.
- 👌 Ok hand symbol indicates it's parsable and will be stored in the Fecht board after turn is done.
- 🎲 Dice symbol indicates there's a roll expression detected for the manuever and you can roll it to trigger your maneuver immediately by clicking on the Dice symbol button instead of having it stored in the Fechtboard after the turn is done..
- ❌ X symbol indicates invalid dice roll expression
- ❗ ! symbol indicates it failed to match a
rp [slot]manuever slot. - ❓ ? symbol indicates character-handle failed to find resolve to one that matches the current turn.
Be sure the bot validates your manuever (and dice roll expression, if any) , before ending your turn otherwise it won't be stored in memory!
You (or any character-handle you assume under your username) can join a given Side available on the fecht, using the following command formats:
join Name Of Sidejoin :some-character-handle Name Of Side
Be sure to match Name Of Side carefully to match exactly with what is shown. (It is case sensitive). In the event your name vanishes from the Fecht roster, perhaps, you might have mispelled it. This method (spelling the Name Of Side as something else like "dead") can also be used to hide your Name from the roster, especially if you're inactive/dead or something.
Once you (or a character of yours) joins a Side, you may set your own (character's) initiative dice roll expression setup. Such a dice roll expression could be simply a constant (eg. 5), some math expression (eg. 5+2), or actual dice rolling (eg. 1d6) as per standard similar to Roll20. This initiative value that you set up is unique per character and can be used to determine the order of your characters' turns on certain phases (depending on how a certain phase is configured by the GM).
The following formats are considered valid:
!init [dice roll expression]!init :some-character-handle [dice roll expression]!init @YourUserIdMention:some-character-handle @YourUserIdMention:another-character-handle [dice roll expression]!init [dice roll expression] @YourUserIdMention:some-character-handle @YourUserIdMention:another-character-handle!init @YourUserIdMention:some-character-handle @YourUserIdMention [dice roll expression]!init @YourUserIdMention:some-character-handle [dice roll expression] @YourUserIdMention
The above commands using !init does not alter your position in the initiative ladder, but determines your position in the initiative ladder for any relevant upcoming phases that is configured to use that character initiative value of yours. If, during a phase, you need to trigger the dice roll expression results immediately in order to SHIFT your current character initiative position up in the initiative ladder queue (this only works if the results managed to shift your position up the ladder), you can use the !init-t command instead.
The dice roll expression is a standard dice roll expression with the exception that any comments portion seperated by a \, eg. (1d6>=4\vs), will have the last portion be used as flags to determine several options for the dice roll expression. If you need EXTRA comments in the dice roll expressions without the comments being treated as flags, you can enclose the comments with another \ character. (eg. (1d6>=4\Red Die\) .
Here are the following character flags for dice roll expressions when setting initiative dice rolls.
-
vs- Use successes (instead of total) for resolving dice roll results to determine initiative value. -
h- If triggered on a public channel while a phase is in progress usinginit-tcommand, the resolved dice roll results are hidden from public view (but the dice roll expression is still shown).
If you are not a GM, you can only set initiatives for your own characters. However, depending on what you agree with the GM, the GM might set up the initiatives for you instead.
This allows you to privately send instructions to Fechtbot. By default, if you happen to trigger a reaction button on a given phase for a given fecht, you will be connected to that fecht channel via DM. However, if no such mechanism is available or you need to switch between channels or simply connect to a channel fecht in order to communicate via DM, you can use the command !dmconnect at the respective public channel accordingly.
As of now, the following commands are available for usage via Direct Messages.
!init!init-t
Take note that using @mentions in DM channel is not really possible since it's only between you and the bot.
For these commands, you may refer to a specific character handle of yours by starting your remaining contents after the command with :character-handle prefix, similar to how you'd handle manuevers.
On the public fecht channel for !init related commands made on DM channel, the Fechtbot only indicates you were setting these values privately, but do not give further details on what you entered.