Character Management

Character Management

These commands allow you to create, manage, and delete Characters. Some of these commands function return slightly different results when used within a Game than they do when used outside a Game. "Used within a Game" simply means the command was used in a Channel that belongs to a Game.

Player Characters (aka PCs) and their Companions can be created inside or outside of a Game. Once created, though, PCs in Games cannot be used outside their Game of origin and PCs outside of Games cannot be used in a Game. Non-Player Characters (aka NPCs) and their Minions can only be created inside a Game, and only by a Game Master. Once created, they only exist and can only be used within that Game. Inside a Game, there is a special built-in NPC called "Game Master" that can be configured as if it were an NPC.

These commands differ in name to distinguish what you are managing (pc, npc, companion, minion, and gm) but they function the same otherwise.

Character Lifecycle

These commands are used to create, view, update, and delete a Character.

Create a Character

---

Creating a Character requires a name. If you are creating a Companion or Minion, it also requires a charName to identify the parent character. All other settings are optional and are set using the argument format of option="value". Character Options are detailed here.

Examples:

sage! pc create name="Bob the Fighter"
sage! companion create charName="Bob the Fighter" name="Stan the Squire"
sage! npc create name="Gobbo the Goblin"
sage! minion create charName="Gobbo the Goblin" name="Sluggo"

View Character Details

---

This command displays information about the named Character. This information includes name, alias, Player (for PCs/Companions), Companions/Minions, color, Auto Dialog channels, and stats (if any). Players in a Game can only get details on their own PC/Companions. Game Masters can get details on all Characters in the Game.

Examples:

sage! pc details name="Bob the Fighter"
sage! companion details charname="Bob the Fighter" name="Stan the Squire"
sage! npc details name="Gobbo the Goblin"
sage! minion details charName="Gobbo the Goblin" name="Sluggo"

Note: In a Game, where a Player has only 1 PC, they do not have to provide the name when viewing their PC's details.

Examples:

sage! pc details
sage! companion details name="Stan the Squire"

Update a Character

---

This command allows you to change the named Character's settings. Much like creating a Character, you only need to include the settings you want to change. Character Options are detailed here.

Examples:

sage! pc update name="Bob the Fighter" color="#01AB99"
sage! npc update name="Gobbo the Goblin" alias="GG"

Note: In a Game, where a Player has only 1 PC, they do not have to provide the name when updating their PC. Similarly, GMs do not have to include the name when updating the GM Character.

Example:

sage! pc update alias="BoB"
sage! gm update newName="Dragon Master"

Delete a Character

---

This command lets you delete the named Character. This deletes them forever and cannot be undone.

Examples:

sage! companion delete charName="Bob the Fighter" name="Stan the Squire"
sage! pc delete name="Bob the Fighter"
sage! npc delete name="Gobbo the Goblin"

Character Auto Dialog

These commands allow you to turn Auto Dialog on and off.

Auto Dialog On

This command turns on Auto Dialog for the given Character in the given Channel (or the current Channel if one isn't given). You can specify more than one Channel. You can specify dialogPostType= if you wish.

Valid dialogPostType values:

• Post
• Embed

Examples:

sage! pc auto on
sage! pc auto on dialogPostType="Post"
sage! npc auto on name="Gobbo the Goblin" #goblin-campfire
sage! gm auto on #main-ic #lore-dump

Auto Dialog Off

This command turns off Auto Dialog for the given Character in the given Channel (or the current Channel if one isn't given). You can specify more than one Channel.

Examples:

sage! pc auto off
sage! npc auto off name="Gobbo the Goblin" #goblin-campfire
sage! gm auto off #main-ic #lore-dump

Character Stats

In addition to the basic settings, you can track stats and other information on your Character using the Update command. Manual Stats are detailed here.

Examples:

sage! pc update name="Bob the Fighter" init="+1"
sage! pc update name="Bob the Fighter" conditions="unconscious"

---

Importing Characters

In addition to creating your characters stats manually, you might be able to import your character. Currently, this feature is in early stages and limited in what you can import, but it will continue to expand over time.

This command currently only works with:

• Pathbuilder 2e Export to JSON
• Essence 20 form fillable PDF downloaded from Renegade Game Studios

Slash Command:

/sage-import pathbuilder-2e id:
/sage-import essence20 pdf:

Options:

/sage-import pathbuilder-2e id: pin: attach:
/sage-import essence20 pdf: pin: attach:

pin (optional)
If this value is set to true then the imported character will be pinned in the channel.

attach (optional)
If this value is set to true then the imported character will be attached as a markdown formatted .txt file instead of being posted as an interactive character sheet.

Reimporting Characters

You can update an imported character sheet by replying to it with the id or pdf you wish to replace it with.

Pathbuilder 2e Example:

sage! reimport id="123456"

Essence 20 Example:

sage! reimport pdf="https://url_to_updated_character.pdf"

Link to Character Sheet

Once you have imported a character, you can turn on a link in character dialog back to the post containing the imported character sheet, or turn it off again.

sage! pc update name="Bob the Fighter" sheeturl=on
sage! pc update name="Bob the Fighter" sheeturl=off

Note

When it is turned on, the link will appear as small emoji will at the end of each dialog post/embed looking something like this: ✎

---

Character Lists

These commands allow you to list characters of the given type.

Player Character Lists

When used in a Game, this lists all the PCs in the Game. Otherwise, it lists all of your non-Game PCs.

Example:

sage! pc list

Companion Lists

This lists the Companions of the named Player Character.

Example:

sage! companion list charName="Bob the Fighter"

Non-Player Character Lists

When used in a Game, this lists all the NPCs in the Game, and is usable only by the Game Master.

Example:

sage! npc list

Minion Lists

This lists the Minions of the named Non-Player Character.

Example:

sage! minion list charName="Gobbo the Goblin"