1. Inviting RPG Sage

To invite RPG Sage to your Discord Server, click here.
Sage asks for various permissions needed to function as expected:
some features are still in development

[toggle permissions breakdown]

• Manage Roles:   A future Sage feature will create/manage roles for games. in development
• Manage Channels:   A future Sage feature will create/manage channels for games. in development
• Create Invite:   A future Sage feature will create invites for games posted as looking for players. not yet in development
• Manage Emojis and Stickers:   A future Sage feature may allow custom emojis for games. not yet in development
• Manage Webhooks:   This is how Sage posts dialog as characters instead of their players.
• Read Messages:   Sage needs to be able to read messages to parse commands.
• Send Messages:   Sage needs to be able to send messages to respond to commands.
• Manage Messages:   Sage needs to be able to manage messages to function (such as edit, pin, or delete messages).
• Embed Links:   Sage needs to be able to embed links to link game material to their source (such as Archives of Nethys).
• Attach Files:   Sage's import command can attach a .txt of your character formatted in markdown.
• Read Message History:   Sage needs to be able to search messages to function. A future Sage feature may allow for more enhanced game/dialog specific search. (not yet in development)
• Add Reactions:   Sage needs to be able to add reactions to inform and interact with users.
• Use External Emojis:   Sage needs access to the default emoji set on RPG Sage's Discord server.
• Use Application Commands:   I am currently moving most of the commands from posting as a message to Slash Commands!

2. Command Types

The primary ways in which you will interact with Sage are through commands. Sage has four types of commands that it responds to:

• Dialog Commands
• Dice Commands
• Message Commands
• Slash Commands

Dialog and Dice commands will be discussed later.

2a. Message Commands

Message Commands are commands given to Sage by posting a message into chat, either a channel where Sage has access or via a direct message to Sage.

2b. Slash Commands

Slash Commands are commands given to Sage by typing /sage and following the prompts Discord gives you to complete the command.

Note that Sage cannot respond to a DM from you unless you have opened a channel with it, which is done via the Slash Command: /sage dm.

2c. Command Prefix

By default, Sage commands that start with ! or ? require a prefix.
    sage! help [toggle command parts breakdown]

A Server Owner or "SageAdmin" can change Sage's prefix with the prefix command:
    sage!! prefix set newPrefix [toggle command parts breakdown]

A Server Owner or "SageAdmin" can also remove Sage's prefix with the prefix command:
    sage!! prefix unset [toggle command parts breakdown]

When the prefix is unset, commands look like:
    !help [toggle command parts breakdown]

2d. Command Permissions

By default, Sage responds to all commands in any channel it has access to read and send messages. That said, "admin" commands (those that manipulate Sage, the Server, or Games, denoted by !!) require permissions with Sage. The Server Owner has full access and must give permission to others.

Sage Admin: Full access to Sage on the server, can assign Server Admin and Game Admin permissions and perform their actions.
    sage!! admin add @UserMention SageAdmin [toggle command parts breakdown]

Server Admin: Can configure channels to work with Sage, can assign Game Admin permissions and perform their actions.
    sage!! admin add @UserMention ServerAdmin [toggle command parts breakdown]

Game Admin: Can configure Sage's game tables and channels, can assign Game Masters and perform their actions.
    sage!! admin add @UserMention GameAdmin [toggle command parts breakdown]

3. RPG Sage Help

/sage help category:Dialog Commands
This slash command provides help for the selected category.

Slash commands are NOT posted to chat for RPG Sage to respond to, they are activated by typing a / (slash) and then selecting from the options provided by Discord. Typing /sage before selecting the command will help remove slash commands on the server that are not related to RPG Sage.

4. Admin (Administrative) Commands

These commands are how you manage RPG Sage on your server. They allow a Server Owner to assign other admins at various levels of control (admins, roles) as well as configure some default options (colors, emoji) at the Server level.

4a. Sage Prefix Admin

/sage help category:Sage Prefix Management

These commands let a Server Owner or "SageAdmin" set or unset Sage command prefixes.
sage!! prefix get
sage!! prefix set {commandPrefix; ex: sage}
sage!! prefix sync
sage!! prefix unset

4b. Game, Sage, Server Admin

/sage help category:Sage Admin Management

These commands are for server owners to configure admin access to Sage.
sage!! admin add @UserMention {GameAdmin|ServerAdmin|SageAdmin}
sage!! admin remove @UserMention
sage!! admin update @UserMention {GameAdmin|ServerAdmin|SageAdmin}
• GameAdmin can only manage games.
• ServerAdmin can manage games and server channels.
• SageAdmin can manage all things Sage.

4c. Color Admin

/sage help category:Color Management

These commands are for managing the color that lines a post's embedded content.
sage!! color get {ColorType}
sage!! color get {server|game} {ColorType}
sage!! color list
sage!! color list {server|game}
sage!! color set {ColorType} {hexColorValue}
sage!! color set {server|game} {ColorType} {hexColorValue}
sage!! color sync
sage!! color sync {server|game}
sage!! color unset {ColorType}
sage!! color unset {server|game} {ColorType}
When choosing server or game you are deciding if you are working with Server colors or Game colors.
Use sage!! color list to see all of the acceptable values for ColorType.

4d. Emoji Admin

/sage help category:Emoji Management

These commands are for managing the emoji used for various parts of Sage.
sage!! emoji get {EmojiType}
sage!! emoji get {server|game} {EmojiType}
sage!! emoji list
sage!! emoji list {server|game}
sage!! emoji set {EmojiType} {emoji}
sage!! emoji set {server|game} {EmojiType} {emoji}
sage!! emoji sync
sage!! emoji sync {server|game}
sage!! emoji unset {EmojiType}
sage!! emoji unset {server|game} {EmojiType}
When choosing server or game you are deciding if you are working with Server emoji or Game emoji.
Use sage!! emoji list to see all of the acceptable values for EmojiType.

4e. Server Role Admin Not Fully Functional

/sage help category:Server Management

These commands are for managing the Roles used for admins of Sage.
sage!! server role list
sage!! server role remove {ServerRoleType}
sage!! server role set @RoleMention {ServerRoleType}
ServerRoleType values: SageAdmin, ServerAdmin, GameAdmin

5. Game Admin (Administrative) Commands

These commands are for configuring a "Game Table" (a game and group of channels that are all part of a game).

5a. Game Admin

/sage help category:Game Management

These commands are for managing games.
sage!! game archive
sage!! game archive list
sage!! game count
sage!! game create name="Dragon Saga: Questbound!"
sage!! game create name="Dragon Saga: Questbound!" {optionKey}="optionValue"
sage!! game details
sage!! game list
sage!! game set {optionKey}="optionValue"
sage!! game set name="Dragon Saga: End Times ..."

Game Options (can set multiple options at the same time):

crit="timestwo|rolltwice|addmax|unset" DnD5e and PF2e only
• TIMESTWO default rolls the dice and multiplies the results x2.
• ROLLTWICE rolls the damage twice and adds the results together.
• ADDMAX RPG Sage House Rule rolls the dice once and then adds max damage to the result.
• UNSET uses the crit method inherited from either the game or the server.

dialogtype="embed|post|unset"
This determines how Sage's dialog posts are handled.
• EMBED default uses an embed that includes the character's avatar on the right.
• POST uses a simple message post some screen readers cannot read Discord embeds.
• UNSET uses the dialogtype method inherited from either the game, user, or server.

diceoutput="xxs|xs|s|m|l|xl|xxl|rollem|unset"
This determines how compact or expanded the dice results are displayed.
• M default
• ROLLEM uses the diceoutput method that most closely emulates what Rollem uses.
• UNSET uses the diceoutput method inherited from either the game or the server.

dicepost="post|embed|unset"
• POST will output dice results in a simple post.
• EMBED default will output dice results in an embed in a post.
• REPLY will output dice results in a reply to the input. future feature
• UNSET uses the dicepost method inherited from either the game or the server.

dicesecret="dm|gm|hide|ignore|unset"
This determines how Sage reacts to dice with the word "secret" in them.
• DM tells Sage to find the first available GM and send the dice results to them as a DM.
• GM tells Sage to find a GM channel and send the dice results there. If no GM channel exists, this is treated as DM.
• HIDE tells Sage to hide/redact the results using spoiler tags.
• IGNORE default simply ignores them.
• UNSET uses the dicesecret method inherited from either the game or server.

type="dnd5e|e20|pf1e|pf2e|quest|sf|none"
• DND5E Dungeons & Dragons 5e
• E20 Essence 20 system (G.I. Joe, Power Rangers, Transformers, etc.)
• PF1E Pathfinder RPG
• PF2E Pathfinder 2e
• QUEST Quest RPG
• SF Starfinder
• NONE default
The primary place this is noticable is the dice engine. For instance, PF2E dice know about ACs, DCs, and how to calculate Critical Success and Failure.

5b. Channel Admin

/sage help category:Channel Management

These commands are for managing what features are available on each channel.
sage!! channel add #ChannelReference {optionKey}="optionValue"
sage!! channel details
sage!! channel list {game|server}
sage!! channel remove #ChannelReference
sage!! channel set {optionKey}="optionValue"

Channel Options (can set multiple options at the same time):

crit="timestwo|rolltwice|addmax|unset" DnD5e and PF2e only
• TIMESTWO default rolls the dice and multiplies the results x2.
• ROLLTWICE rolls the damage twice and adds the results together.
• ADDMAX RPG Sage House Rule rolls the dice once and then adds max damage to the result.
• UNSET uses the crit method inherited from either the game or the server.

dialogtype="embed|post|unset"
This determines how Sage's dialog posts are handled.
• EMBED default uses an embed that includes the character's avatar on the right.
• POST uses a simple message post some screen readers cannot read Discord embeds.
• UNSET uses the dialogtype method inherited from either the game, user, or server.

diceoutput="xxs|xs|s|m|l|xl|xxl|rollem|unset"
This determines how compact or expanded the dice results are displayed.
• M default
• ROLLEM uses the diceoutput method that most closely emulates what Rollem uses.
• UNSET uses the diceoutput method inherited from either the game or the server.

dicepost="post|embed|unset"
• POST will output dice results in a simple post.
• EMBED default will output dice results in an embed in a post.
• REPLY will output dice results in a reply to the input. future feature
• UNSET uses the dicepost method inherited from either the game or the server.

dicesecret="dm|gm|hide|ignore|unset"
This determines how Sage reacts to dice with the word "secret" in them.
• DM tells Sage to find the first available GM and send the dice results to them as a DM.
• GM tells Sage to find a GM channel and send the dice results there. If no GM channel exists, this is treated as DM.
• HIDE tells Sage to hide/redact the results using spoiler tags.
• IGNORE default simply ignores them.
• UNSET uses the dicesecret method inherited from either the game or server.

gametype="dnd5e|e20|pf1e|pf2e|quest|sf|none"
• DND5E Dungeons & Dragons 5e
• E20 Essence 20 system (G.I. Joe, Power Rangers, Transformers, etc.)
• PF1E Pathfinder RPG
• PF2E Pathfinder 2e
• QUEST Quest RPG
• SF Starfinder
• NONE default
The primary place this is noticable is the dice engine. For instance, PF2E dice know about ACs, DCs, and how to calculate Critical Success and Failure.

type="ic|ooc|misc|gm|unset"
• IC denotes an In Character channel, thus only Dialog and Dice are allowed for GMs and Players.
• OOC denotes an Out of Character channel, thus all Sage commands are allowed for GMs and Players.
• MISC denotes an Miscellaneous channel, thus all Sage commands are allowed for GMs and Players.
• GM denotes an Game Master channel, thus all Sage commands are allowed for only GMs.
• UNSET tells Sage that this isn't a specific channel type, allowing you to customize the options.
Note: A GM only channel is where secret dice rolls are sent!

5c. GM (Game Master) Admin

/sage help category:Game GM Management

These commands are for managing Game Masters for games.
sage!! gm add @UserMention
sage!! gm add @UserMention {@OptionalUserMention}
sage!! gm list
sage!! gm remove @UserMention
sage!! gm remove @UserMention {@OptionalUserMention}

"OptionalUserMention" is there to show you can add or remove multiples.

5d. NPC (Non Player Character) Admin

/sage help category:NPC Management

These commands are for managing Non Player Characters for games.
sage!! npc create name="Farmer Bob" token="http://url_to_token_image" avatar="http://url_to_avatar_image"
sage!! npc delete name="Farmer Bob"
sage!! npc details name="Farmer Bob"
sage!! npc list "optionalFilter"
sage!! npc update name="Farmer Bob" alias="Bob"
sage!! npc update name="Farmer Bob" avatar="http://url_to_avatar_image"
sage!! npc update name="Farmer Bob" token="http://url_to_token_image"
sage!! npc update name="Farmer Bob" color="#FF00AA"
sage!! npc update oldname="Farmer Bob" newname="Blacksmith Bob"

Images should be urls. If you embed images in your post, the first one will be the token and the second one the avatar.
You can mix and match the avatar, token, and color options when you create or update a PC.

5e. Player Admin

/sage help category:Game Player Management

These commands are for managing Players for games.
sage!! player add @UserMention
sage!! player add @UserMention {@OptionalUserMention}
sage!! player list
sage!! player remove @UserMention {@OptionalUserMention}

"OptionalUserMention" is there to show you can add or remove multiples.

5f. PC (Player Character) Admin

/sage help category:PC Management

These commands are for managing Player Characters.
sage!! pc create name="Bardok the Brave" token="http://url_to_token_image" avatar="http://url_to_avatar_image"
sage!! pc delete name="Bardok the Brave"
sage!! pc details name="Bardok the Brave"
sage!! pc list "optionalFilter"
sage!! pc update name="Bardok the Brave" alias="Bardok"
sage!! pc update name="Bardok the Brave" avatar="http://url_to_new_avatar_image"
sage!! pc update name="Bardok the Brave" token="http://url_to_new_token_image"
sage!! pc update name="Bardok the Brave" color="#FF00AA"
sage!! pc update oldname="Bardok the Brave" newname="Bardok the Cowardly"

The following allows Game Masters to reassign Player Characters.
sage!! pc update name="Bardok the Brave" newuser="@Player"

Images should be urls. If you embed images in your post, the first one will be the token and the second one the avatar.
You can mix and match the avatar, token, and color options when you create or update a PC.

5g. Companion (Alt, Companion, Familiar, Hireling, etc) Admin

/sage help category:PC/NPC Companion Management

These commands are for managing companions for player characters.
sage!! companion create charname="Bardok the Cowardly" name="Ser Stallion" token="http://url_to_token_image" avatar="http://url_to_avatar_image"
sage!! companion delete charname="Bardok the Cowardly" name="Ser Stallion"
sage!! companion details name="Ser Stallion"
sage!! companion list "optionalFilter"
sage!! companion update charname="Bardok the Cowardly" name="Ser Stallion" alias="Stallion"
sage!! companion update charname="Bardok the Cowardly" name="Ser Stallion" avatar="http://url_to_avatar_image"
sage!! companion update charname="Bardok the Cowardly" name="Ser Stallion" token="http://url_to_token_image"
sage!! companion update charname="Bardok the Cowardly" name="Ser Stallion" color="#FF00AA"
sage!! companion update charname="Bardok the Cowardly" oldname="Ser Stallion" newname="Ser Bolts'a'lot"

Images should be urls. If you embed images in your post, the first one will be the token and the second one the avatar.
You can mix and match the avatar, token, and color options when you create or update a PC.

6. Dialog Commands

/sage help category:Dialog Commands

These commands are how you interact with the dialog engine of Sage.
When posting dialog, you do not need to use a command prefix.
Each different dialog type can be configured to have its own default color.

6a. Dialog Post Command

{type}::{name}({display name})::(title)::{color}::{avatar}::{content}

• {type}: gm, npc, enemy, ally, pc, alt, companion, hireling
• {name}: the name of the npc, pc, or companion to post as
    • optional for gm; optional for PCs in a game
• {display name}: the name to post as
    • optional: defaults to character name or 'Game Master' for GM
• {title}: a title or descripiton of the dialog
    • optional
• {color}: a color to override the dialog color with
    • optional: expects hex value 0x000000 or #FFFFFF
• {avatar}: a url to override the avatar image
    • optional
• {content}: everything you want to post in your dialog
    • accepts normal discord/markup as well as custom Sage markup

game master input

game master output

game master input

game master output

6b. Dialog Edit Command

edit::{updated dialog content}

If you send your edited content as a new message in the dialog channel, it will update the last dialog you posted. If you reply to a message with dialog that you posted, you will edit the message that you are replying to.

6c. Dialog Alias Macros

These commands are for managing advanced dialog alias macros that make repeat dialog easier to use.
sage!! alias delete name="AngryBob"
sage!! alias details name="AngryBob"
sage!! alias list
sage!! alias set name="AngryBob" enemy::Farmer Bob::
sage!! alias set name="HappyBob" ally::Farmer Bob::

Usage: angrybob::"Why are you adventurer's always riding through my field!?"
Usage: happybob::"Won't you come in for dinner?"

Alias Macros allow you to take a long dialog command and shorten it. Any valid dialog is valid when creating an Alias Macro ... meaning in addition to requiring the type (npc, pc, enemy, familiar) and name, you can include any part of a Dialog Post Command in an Alias Macro, even content!

6d. Character Auto Dialog

These commands allow you link channels and characters so that RPG Sage will repost everything you send to that channel as the assigned character.

To configure your PC for the current Game in the current channel:
sage!! pc auto on
sage!! pc auto off

To configure a specific PC in a specific channel:
sage!! pc auto on name="Bardok the Cowardly" #knightly-quest-ic
sage!! pc auto off name="Bardok the Cowardly" #knightly-quest-ic

To configure the GM in the current channel:
sage!! gm auto on
sage!! gm auto off

7. Dice Commands

/sage help category:Dice Commands

These commands are how you roll dice with Sage.

7a. Dice Basics

7b. Dice Groups

7c. Dice Output

RPG Sage's Dice can be configured to be as concise or verbose as you want. These settings can be set at the Channel, Game, or even Server level.

You output types are: XXS, XS, S, M, L, XL, XXL, and ROLLEM. The "small" and "medium" types all use a single line for any given dice block (a single []) while the "large" types use multiple lines. The ROLLEM type is for users that are familiar/comfortable with the way Rollem's output looks. The default value is M.

Let us consider the following dice roll for each of the output types:
    [1d20 conceal; 1d20+8 attack; 1d10 slashing +1d6 fire +2d6 holy]
Let us assume that the following rolls:
    conceal 5, attack 8, slashing 10, fire 3, holy 1,1
These values bring us the following totals:
    conceal 5, attack 16, damage 15

Output Type: XXS
5; 16; 15

Output Type: XS
5 `conceal`; 16 `attack`; 15 `slashing`

Output Type: S
5 `conceal` ⟵ [5]; 16 `attack` ⟵ [8] + 8; 15 `slashing` ⟵ [10] + [3] fire + [1,1] holy

Output Type: M default
5 `conceal` ⟵ [5]1d20; 16 `attack` ⟵ [8]1d20 + 8; 15 `slashing` ⟵ [10]1d10 + [3]1d6 fire + [1,1]2d6 holy

Output Type: L
5 `conceal` ⟵ [5]
16 `attack` ⟵ [8] + 8
15 `slashing` ⟵ [10] + [3] fire + [1,1] holy

Output Type: XL
5 `conceal` ⟵ [5]1d20
16 `attack` ⟵ [8]1d20 + 8
15 `slashing` ⟵ [10]1d10 + [3]1d6 fire + [1,1]2d6 holy

Output Type: XXL
[1d20 conceal; 1d20+8 attack; 1d10 slashing +1d6 fire +2d6 holy]
5 `conceal` ⟵ [5]1d20
16 `attack` ⟵ [8]1d20 + 8
15 `slashing` ⟵ [10]1d10 + [3]1d6 fire + [1,1]2d6 holy

Output Type: ROLLEM
'conceal', ` 5 ` ⟵ [5] 1d20
'attack', ` 16 ` ⟵ [8] 1d20 + 8
'slashing', ` 18 ` ⟵ [3] 1d10 + [4] 1d6 fire + [5, 6] 2d6 holy

7d. Dice Overrides

The Game used to process the Dice and the output used for the results can both be overridden for any dice block. To do so, you simply need to start your dice with the game or output code you wish to use.

To override the game engine:
[dnd5e 1d20 ac 10 attack]
[pf2e 1d20 dc 10 check]

To override the output used:
[xxs 1d20 ac 10 attack]
[xxl 1d20 dc 10 check]

You can override both!
[xxs pf2e 1d20 dc 10 check]
[xxl dnd5e 1d20 ac 10 attack]

7e. Game Specific Dice Features

While you can use the basic dice engine for any system (all you need is to roll and maybe test results), you are likely used to seeing certain syntax in your rolls. Additionally, there are a number of tests and other bits of math that are performed with almost every roll of many games. With RPG Sage, when you set your Channel, Game, or Server to a specific Game (such as Pathfinder 2e), the Dice engine will know to perform many of these actions for you. We plan to continue adding more games as well as expanding the things we can do within each game.

Success / Failure core dice engine
When rolling a test, the output will include an emoji to indicate success or failure. By default, these are :thumbs_up: and :thumbs_down:.

7f. DnD 5e Dice Features

Versus (VS)
This shortcut tells the dice to do a test to see if the roll meets or exceeds (the "vs" is treated as ">=") the value given.
[1d20 + 5 vs 10]

Armor Class (AC)
This shortcut tells the dice to do a test to see if the roll meets or exceeds (the "ac" is treated as ">=") the value given.
[1d20 + 5 ac 10]

Difficulty Class (DC)
This shortcut tells the dice to do a test to see if the roll meets or exceeds (the "dc" is treated as ">=") the value given.
[1d20 + 5 dc 10]

Critical Damage
If your attack roll has a target AC and your result is a critical hit, RPG Sage will adjust your damage accordingly. By default this is simply x2 damage, but RPG Sage has multiple methods of determining critical hit damage.

Advantage / Disadvantage (+/-)
If your roll has Advantage, you may roll [+2d20] to tell RPG Sage to roll twice and take the higher of the two dice. Likewise, if you have Disadvantage, you may use [-2d20] to roll twice and take the lower of the two dice.

Graded Success / Failure
When playing DnD 5e, a Natural 20 is a Critical Success and Natural 1 is a Critical Failure. RPG Sage takes this into account when you roll using AC, DC, or VS and changes the emoji used accordingly. Additionally, when you roll an attack/damage combo [1d20 ac 10; 1d6 damage] RPG Sage will know to double the damage if your success was critical.

7g. Essence20 Dice Features

Versus (VS)
This shortcut tells the dice to do a test to see if the roll meets or exceeds (the "vs" is treated as ">=") the value given.
[1d20 + 5 vs 10]

Skill Test (+)
[+d4]

Difficulty (DIF)
[+d2 dif 10]

Upshift / Downshift (UP/DN)
[+d4up2]
[+d6dn1]
Currently known bug: no spaces surrounding up/dn

Specialization (*)
[+d4*]
[+d6*]

All of these may be combined!
[+d4*up2 dif 5 simple test]
Currently known bug: no spaces surrounding up/dn

7h. Pathfinder 2e Dice Features

Versus (VS)
This shortcut tells the dice to do a test to see if the roll meets or exceeds (the "vs" is treated as ">=") the value given.
[1d20 + 5 vs 10]

Armor Class (AC)
This shortcut tells the dice to do a test to see if the roll meets or exceeds (the "ac" is treated as ">=") the value given.
[1d20 + 5 ac 10]

Difficulty Class (DC)
This shortcut tells the dice to do a test to see if the roll meets or exceeds (the "dc" is treated as ">=") the value given.
[1d20 + 5 dc 10]

Critical Damage
If your attack roll has a target AC and your result is a critical hit, RPG Sage will adjust your damage accordingly. By default this is simply x2 damage, but RPG Sage has multiple methods of determining critical hit damage.

Fortune / Misfortune (+/-)
If your roll has Fortune, you may roll [+2d20] to tell RPG Sage to roll twice and take the higher of the two dice. Likewise, if you have Misfortune, you may use [-2d20] to roll twice and take the lower of the two dice.

Multi Attack Penalty (MAP)
If you are rolling the same attack multiple times, you can simplify your roll by combining the multiple roll modifier 2# with MAP-5. You can, of course, roll more than twice and change the MAP to another value (most likely 4).
[2MAP-5#1d20 ac 10; 1d6 damage]
[3MAP-4#1d20 ac 10; 1d6 damage]

Graded Success / Failure
When playing Pathfinder 2e, a Success of 10 or more is a Critical Success, while a Failure of 10 or more is a Critical Failure. Additionally, a natural 1 lowers your success grade by 1 while a natural 20 increases your success grade by 1. RPG Sage takes this into account when you roll using AC, DC, or VS and changes the emoji used accordingly. Additionally, when you roll an attack/damage combo [1d20 ac 10; 1d6 damage] RPG Sage will know to double the damage if your success was critical.

Striking, Greater Striking, Deadly, and Fatal
When playing Pathfinder 2e, there is some extra math involved in critical hits when you have striking, deadly, and fatal weapons. RPG Sage looks at the input of your dice to see if it can find any of these when calculating your critical damage.
[1d20 + 10 ac 10 pick (fatal d10); 1d6 piercing]
[1d20 + 10 ac 10 longbow (deadly d10); 1d8 piercing]
[1d20 + 10 ac 10 striking longsword; 1d8 slashing]
[1d20 + 10 ac 10 greater striking longsword; 1d8 slashing]
[1d20 + 10 ac 10 major striking longsword; 1d8 slashing]

7i. Quest Dice Features

Versus (VS)
This shortcut tells the dice to do a test to see if the roll meets or exceeds (the "vs" is treated as ">=") the value given.
[1d20 + 5 vs 10]

7j. Random Selection

Another feature of RPG Sage's dice engine is its ability to select items from a list. This was built mostly to alleviate the GM's constant need to select which PC a baddie targets, but we are sure it has many other uses as well. Note: Currently this feature relies on commas to separate the items in the list, so be careful of putting fancy names in your lists!

Simple Selection
[Fighter, Wizard, Rogue]

Multiple Selections
[2#Fighter, Wizard, Rogue]
The results will be listed in the order they were selected.

Multiple Selections, Sorted
[2s#Fighter, Wizard, Rogue]
The results will be sorted alphabetically.

Multiple Selections, Unique
[2u#Fighter, Wizard, Rogue]
The results will be listed in the order they were selected.

Multiple Selections, Secret
[gm#Fighter, Wizard, Rogue]
This treats the roll as a "secret" roll and is handled by the channel's or game's settings accordingly.

The Multiple, Sorted, Unique, and Secret flags can be mixed and matched in any combination.

7k. Simple Math

In addition to rolling dice, using macros, and selecting things from a list, RPG Sage's dice engine can also do simple math that doesn't involve dice. This is intended to be a simple, but helpful, addition for folks that want or need to do math in their games.

[1+2]
[1+2*3]
[1+2(3-8)]

8. Dice Macros

/sage help category:Dice Macros

These commands are for managing macros that make dice rolls easier to use.
sage!! macro delete all
sage!! macro delete category="Melee"
sage!! macro delete name="BobScythe"
sage!! macro details name="BobScythe"
sage!! macro list
sage!! macro list category="Melee"
sage!! macro move name="BobScythe" category="Bob the Farmer"
sage!! macro set name="BobScythe" [1d20+3 atk; 1d10 S dmg]
sage!! macro set name="BobDagger" category="Bob the Farmer" [1d20+2 {ac} atk; 1d4 {type:P} dmg]
Usage: [BobScythe]
Usage: [BobDagger ac=10]
Usage: [BobDagger type=S]
Usage: [BobDagger ac=10 type=S]

Macro Categories are helpful in grouping related macros together, but they also serve a special function for Pathfinder 2e players using imported characters. Macros with the same category name as an imported Pathfinder 2e character name will show up in the imported character's sheet so that you can select then and roll them with the click of a button. (Will provide link to importing documentation as it is finished.)

8a. Dice Macro Arguments

Macros allow arguments, making them very flexible but also easy to overcomplicate.
Arguments are indicated with curly braces: { and }

The two primary types of arguments are: indexed and named.
Note: If you use an argument more than once in your macro, it will be replaced every time.

    Indexed arguments start with 0 go up: {0}, {1}, {2}, etc
        Example Macro: "attack" [1d20 {0} atk; 1d6 {1} dmg]
        Example Usage: [attack "+1" "+2"]
        Example Roll: [1d20 +1 atk; 1d6 +2 dmg]

    Named arguments should can only letters, numbers, and underscores: {bless_bonus}
        Example Macro: "attack" [1d20 {bless_bonus} atk; 1d6 {bless_bonus} dmg]
        Example Usage: [attack bless_bonus="+1"]
        Example Roll: [1d20 +1 atk; 1d6 +1 dmg]

    Arguments can have default values: {atk_bonus:+0}, {dmg_type:P}
    Note: A default value of 0 (or +0) will NOT be shown in the final dice roll
        Example Macro: "dagger" [1d20 {atk_bonus:+0} atk; 1d4 {dmg_type:P} dmg]
        Example Usage: [dagger]
        Example Roll: [1d20 atk; 1d4 P dmg]
        Example Usage: [dagger atk_bonus="+1"]
        Example Roll: [1d20 +1 atk; 1d4 P dmg]
        Example Usage: [dagger atk_bonus="+2" dmg_type="S"]
        Example Roll: [1d20 +2 atk; 1d4 S dmg]

Two special argument types are: "vs" {vs} and "remaining" {...}

    VS is a convenience for setting the roll's target success value in d20 style games; AC, DC, and VS are all acceptable as {ac}, {dc}, or {vs}
        Example Macro: "attack" [1d20 {ac} atk; 1d6 dmg]
        Example Usage: [attack ac=10]
        Example Roll: [1d20 ac 10 atk; 1d6 dmg]

    Remaining is more advanced- it takes every indexed argument that wasn't explicitly used in your macro and adds them all with spaces between them.
        Example Macro: "extras" [1d20 {0} atk; 1d6 {1} {...} dmg]
        Example Usage: [extras +1 +3 "+1d6 sneak" "+1d4 fire" "+1 holy"]
        Example Roll: [1d20 +1 atk; 1d6 +3 +1d6 sneak +1d4 fire +1 holy dmg]
    Note: If you have more than one "remaining" arg in your macro, they will all get the same set of values.

9. Maps prototype

Yes, you heard that right, we can do maps! And all you have to do is create a metadata text file that has a name ending in .map.txt and then drop the file in the channel you want your map. Sage will take it from there!

Note about prototype.
This feature is still a prototype, perhaps consider it an alpha release. The interface and feedback aren't as clean as we want and the execution of features is a tad clumsy. But, we assure you that we already have planned improvements that will make it much better!

Note about image storage.
RPG Sage doesn't store any images used in the creation of maps. Therefore, you will need to make sure that they are all public urls that will be available until you are no longer using the map. The simplest way to do this is to post the image(s) into a discord channel and then grab the url from the uploaded image(s).

You can see more information about using these here.

9a. Map Controls

Movement Arrows left side
Move your active token (or terrain if GM) one square in the direction indicated.

Gear
Disabled; saved for future use.

Mountain
GM uses this button to cycle through the terrain images to select the active terrain.

Yellow Circle
Cycle through aura images (for the active token) to select the active aura. A token can have any number of auras configured, but only one can be active at a time. (This also applies to terrain for GMs.)

Person
Cycle through token images to select the active token. Players can only cycle through tokens assigned to them. GMs cycle through all tokens. If you are using RPG Sage's Game feature, a PC's token (along with familiars/companions) should be added automatically to the map when trying to select their token. There is a known bug in the current code that will likely spawn a PC's token even if you already assigned them a token when making the map.

Up / Down Arrows right side
GMs can use this to reorder (alter the z-index) of the terrain and tokens.

Red X
GM uses this button to delete terrain / tokens. The thought was you import a map for an encounter with all baddies and delete them as they are removed from play.

9b. Map File Contents

[map] background image/layer
• url = url to the image
• name = name of the map
• grid = number of columns (first) and rows (second): 24x11
• spawn = column (left) and row (right) where where new tokens appear: 2,1

[terrain] bottom layer
• url = url to the image
• name = name of the terrain or object
• size = width (first) and height (second) of terrain: 1x1
• position = starting column (left) and row (right) on the map: 3,2
• Only a GM can move an object of this layer

[aura] middle layer
• url = url to the image yes, it requires images for now
• name = name of the aura
• anchor = name of the token (or terrain) to anchor the aura to
• opacity = how transparent the image is (0% - 100%): 50%
• size = width (first) and height (second) of aura: 1x1
• position = column (left) and row (right) on the map relative to anchor
• A 5 ft. emanation from a 1x1 token would have an anchor, size=3x3, and position=-1,-1
• Auras will change greatly in the next iteration.

[token] top layer
• url = url to the image
• name = name of the PC or NPC
• size = width (first) and height (second) of token: 1x1
• scale = image scaling factor: 1.5
• position = starting column (left) and row (right) on the map: 3,2
• user = Discord handle of the User to ownership of the token (PCs only): @PlayerName#1234

9c. Map Command

/sage map addimage

This slash command is used to add images to the map.

The following options are required:

• map : Map id (Map post message id)
• layer : one of aura, terrain, token
• url : image url
• name : image name
• cols : image width
• rows : image height
• col : image column position
• row : image row position

10. Character Import

/sage import

This slash command is used to import characters so that you can view their stats and quickly roll dice/macros.

The two main options (pathbuilder2e-id and e20-pdf) are for your character source and you can only use one of them at a time. The other two options (attach and pin) change how Sage posts your imported character and you can use either, both, or neither of them.

/sage import pathbuilder2e-id:12345
This requires the export "Pathbuilder 2e JSON ID" that you get from Pathbuilder 2e via the "Export JSON" command.

/sage import e20-pdf:joe-cool.pdf
This requires either the url to a PDF or the url to a Discord message that has a PDF file as an attachment. The PDF must be one official PDFs downloaded from Renegade Games Studios.

attach="true"
When set to true, this tells Sage to post the character as a .txt file attachment instead of creating an interactive character sheet.

pin="true"
When set to true, this tells Sage to pin the post that it creates for the character.

11. Other Commands

The following commands are not system specific.

11a. Coin / Currency Calculator

sage! {1pp} {-2gp} {+3sp} {-4cp}
sage! {1pp} {2gp} {3sp} {4cp}

11b. Weather Report Generator

/sage help category:Random Weather Report

This command creates a random weather report.

sage! weather {climate} {elevation} {season}
• Climate Options: Cold | Temperate | Tropical
• Elevation Options: SeaLevel | Lowland | Highland
• Season Options: Spring | Summer | Fall | Winter

12. Pathfinder 2e Commands

The following commands are specific to Pathfinder 2e.

12a. Golarion / Absalom Staton Info (days & months)

/sage help category:Golarion Calendar Info

These commands are for viewing the dates, days, and months of the Golarion (Pathfinder) and Absalom Station (Starfinder) calendars.

sage! date {yyyy-mm-dd}
- Displays the given date on Golarion, Absalom Station, and on Earth. Includes season.
sage! days
- Lists the days of the week on Golarion and Absalom Station,.
sage! months
- Lists the months of the Golarion and Absalom Station calendars (along with how many days are in each).
sage! today
- Displays today's date on Golarion, Absalom Station, and on Earth. Includes season.

12b. Pathfinder 2e DCs

/sage help category:PF2e DC Values

These commands are for viewing the various DCs used in Pathfinder 2e.
sage! dc by level {level}
sage! dc by spell level {level}
sage! dcs by level
sage! simple dc {proficiency}
sage! {proficiency} simple dc

12c. Pathfinder 2e Lists

sage! list {deities|gods} by domain {domain}
sage! list {weapons|armor|spells} by trait {trait}
Future releases will expand on these lists.

12d. Pathfinder 2e Content Search

These commands perform full text searches.
sage? {searchTerm}
sage? {searchTerm} -{categoryOrObjectType}
Category/ObjectType examples: Background, Feat, Spell, etc.
This isn't fully operational, nor is the data complete yet.

12e. Pathfinder 2e Content Find

These commands perform searches only against names.
sage?! {searchTerm}
sage?! {searchTerm} -{categoryOrObjectType}
Category/ObjectType examples: Background, Feat, Spell, etc.
This isn't fully operational, nor is the data complete yet.

12f. Pathfinder 2e Spell Lists

These commands allow you to view various types of spell lists
sage! spells {tradition} {level|Cantrips}
sage! spells {tradition} {level|Cantrips} by school
sage! {level} {tradition} spells
sage! {level} {tradition} spells by school
sage! {tradition} cantrips
sage! {tradition} cantrips by school
sage! {tradition} spells {level|Cantrips}
sage! {tradition} spells {level|Cantrips} by school
The following creates a specialized list of spells by merging or excluding traditions
sage! spells {level|Cantrips} {+tradition} {-tradition} {|tradition} {&tradition}

12g. Pathfinder 2e Focus Spell Lists

sage! focus spells {Archetype|Class|Domain}
sage! {Archetype|Class|Domain} focus spells

12h. Pathfinder 2e Starting Wealth Info

sage! starting wealth
sage! starting wealth {level}

12i. Pathfinder 2e Income Info

sage! income earned
- Shows the entire table 4-2: Income Earned
sage! income earned {taskLevel}
- Shows the results for the given level.
sage! income earned {proficiency} {taskLevel}
- Shows the results for the given level and proficiency.

13. Pathfinder Society 2e Commands

The following commands are designed to help if you are playing Organized Play (Pathfinder Society) games for Pathfinder 2e.

13a. Pathfinder PFS / Org Play Links

sage! pfs links
DISABLED FOR NOW (their site changed)

13b. Pathfinder PFS Downtime Rolls

sage! pfs income {pcLevel} {skillProficiency} {skillModifier}
sage! pfs income {pcLevel} {skillProficiency} {skillModifier} {days}

13c. Pathfinder PFS Scenario Randomizers

sage! pfs s1-01 {pc1Level}, {pc2Level}, {pc3Level}, {pc4Level}, {pc5Level}, {pc6Level}, {pc7Level}
Future releases will include more scenarios.
PFS Guidelines now recommend against 7 player tables

13d. Pathfinder PFS Tier Calculator

sage! pfs {tier} {minLevel}-{maxLevel} {pc1Level} {pc2Level} {pc3Level} {pc4Level} {pc5Level} {pc6Level} {pc7Level}
PFS Guidelines now recommend against 7 player tables