Dialog

Basic Dialog

The most simple Dialog commands include the type of character, the name of the character, and the content you wish to post as that character.

Player Character

Because RPG Sage limits a Player to a single Player Character per Game, the Player is be able to post dialog as Bardok by simply starting their message with pc::.

Example:

pc::Bob rushes into the room and shouts "For Honor!".

Outside of a Game, you are allowed to use any of your PCs, but you must include their name in your command.

Example::

pc::Bob the Fighter::Bob rushes into the room and shouts "For Honor!".

Companions

Because a PC can have multiple companions, you need to call them out by name.

Examples:

companion::Stan the Squire::I am a companion.

The following variants can be used to change the color of embedded dialog for companions: alt, familiar, and hireling.

Examples:

alt::Stan the Squire::I am an alt.
familiar::Stan the Squire::I am an familiar.
hireling::Stan the Squire::I am an hireling.

Non-Player Character

Non-Player Character dialog requires the Game Master to include character's name when posting with npc::. Also has ally and enemy variants.

Example:

npc::Gobbo the Goblin::"You shall find no honor here, Bob!"

Game Master

The special "Game Master" NPC can be used by the Game Master in the same way that a PC is used by a Player.

Example:

gm::Bob defeated Gobbo and had honor aplenty.

Advanced Dialog

All Dialog commands are made up of the following parts: type, name, display name, color, avatar, content

These parts are combined in Dialog commands in the following format:

type::name::(display name)::color::avatar::content

type

Character type: gm, npc, enemy, ally, pc, alt, companion, hireling

name

The name of the character to post as.

• optional for gm::
• optional for pc:: in a game

display name (optional)

the name to post as, instead of the character's name

• defaults to character name or 'Game Master' for GM

color (optional)

The color to override the Dialog embed color with.

• expects hex value 0x000000 or #FFFFFF

avatar (optional)

A url to override the avatar image in the embed.

content

The content you want to post as your dialog.

• accepts normal discord/markup as well as custom Sage markup

Editing Dialog

You can edit Dialog that RPG Sage posted for you, by replying to the message and starting your new content with edit::.

Example:

edit::updated dialog content

You can alter additional parts of your original message, such as display name or color by including them in your reply as you would a normal Dialog command.

Examples:

edit::#ff00ff::updated content

edit::https://img.rpgsage.io/253330271678627841/characters/mal/mal.png::updated content

Dialog Macros

These commands are for managing Advanced Dialog commands, known as Dialog Macros, that make repeat Dialog easier to use.

Dialog Macros allow you to take a long Dialog command and shorten it. Any valid Dialog is valid when creating an Dialog 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 a Dialog Macro, even content!

Dialog Macros were originally created as RPG Sage's first form of alias. Dialog Macros have expanded in functionality and aliases have been added directly to characters. An upcoming update will change these commands from their current alias to something more fitting.

Management Examples:

sage! alias delete name="AngryBob"
sage! alias details name="AngryBob"
sage! alias list
sage! alias set name="AngryBob" value="enemy::Farmer Bob::"
sage! alias set name="HappyBob" value="ally::Farmer Bob::"

Usage Examples:

angrybob::"Why are you adventurer's always riding through my field!?"

happybob::"Won't you come in for dinner?"