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 name="Stan the Squire" charName="Bob the Fighter"
sage! npc create name="Gobbo the Goblin"
sage! minion create name="Sluggo" charName="Gobbo the Goblin"

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 name="Stan the Squire"
sage! npc details name="Gobbo the Goblin"
sage! minion details name="Sluggo" charName="Gobbo the Goblin"

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

Example:

sage! pc details

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 can have only 1 PC, they do not have to provide the name when viewing their PC's details.

Example:

sage! pc update alias="BoB"

Delete a Character

---

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

Examples:

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.

Examples:

sage! pc auto on
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 Stats command. Manual Stats are detailed here.

Examples:

sage! pc stats name="Bob the Fighter" init="+1"
sage! pc stats 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 pathbuilder2e-id:
/sage import e20-pdf:

Options:

/sage import pathbuilder2e-id: pin: attach:
/sage import e20-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.

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"