Game Management

These commands let a Server Owner, "SageAdmin", or "Game Admin" manage games. Once a user is added to a Game as a Game Master, they are allowed to manage their own game.

Note: These commands do not work in an IC (in-character) channel, as those channels are designed to avoid clutter by only responding to Dialog and Dice commands.

Note: When creating, updated, or viewing a Game, RPG Sage will also attempt to confirm it has all the Discord Permissions it needs to perform its tasks correctly. You may get a prompt asking if you want it to fix these permissions, and upon clicking Yes you may get a notification that it failed. In that case, you will need to get an admin in your Discord Server to help you out. Similarly, Sage detects when some other bots are present in the Game Channels and may ask if you want them blocked.

Game Lifecycle

These commands are used to create, view, update, and archive a Game.

Create a Game

Creating a Game requires a name. If a channel is not provided, the current channel will be added to the game. All other settings are optional and are set using the argument format of option="value". Game Options are detailed here.

Examples:

sage! game create name="Dragon Saga: Questbound!"

sage! game create name="Dragon Saga" gameSystem="dnd5e"

sage! game create name="Questbound!" gameSystem="pf2e" diceSecret="gm"

sage! game create name="Questbound, 2e!" gameSystem="pf2e" ic=" #qb-2e-ic " ooc=" #qb-2e-ooc " gms=" @Randal " players=" @QuestboundPlayers "

View Game Details

This command displays information about the Game the current channel is a part of. It lists things like the Game's name, channels (and their types), and the users in the Game. Users are listed as either Game Masters or Players (and PCs are listed if a Player has one).

Example:

sage! game details

Update a Game

This command allows you to change a Game's settings. Much like creating a Game, you only need to include the settings you want to change. You are also able to unset a setting to return it to the default. Game Options are detailed here.

Examples:

sage! game update name="Oops, all bards!"
sage! game update gameSystem="pf2e" dicesecret="unset"

Archive a Game

This command lets you archive a Game. Archiving a Game tells RPG Sage that you are done with the Game, but it does not delete the Game from the system. This frees up the channels to be used for other Games, but keeps the information about the Game for later reference.

Example:

sage! game archive

Channels

These commands are used to add or remove a Channel.

Add a Channel

This command allows you to add a Channel to a Game. You should see the 👍 if successful, or 👎 if not.

Examples:

sage! game update gm=" #gm-only "
sage! game update ooc=" #player-chat "

Remove a Channel

This command removes the referenced Channel(s) from its current Game. You should see the 👍 if successful, or 👎 if not.

Examples:

sage! game update remove=" #player-chat "
sage! game update remove=" #player-chat #peanut-gallery "

Game Masters

These commands let you add or remove Game Masters.

Add a Game Master

This command adds the referenced Users to the current Game as Game Masters. You should see the 👍 if successful, or 👎 if not.

Examples:

sage! game update gms=" @forever-gm "
sage! game update gms=" @dunge @onmaster "

Remove a Game Master

This command removes the mentioned Game Master(s) from the current Game. You should see the 👍 if successful, or 👎 if not.

Examples:

sage! game update remove=" @forever-gm "
sage! game update remove=" @dunge @onmaster "

Players

These commands let you add or remove Players.

Add a Player

This command adds the referenced Users to the current Game as Players. You should see the 👍 if successful, or 👎 if not.

Examples:

sage! game update players=" @bob-villa "
sage! game update players=" @ren @stimpy "

Remove a Player

This command removes the mentioned Player(s)from the current Game. You should see the 👍 if successful, or 👎 if not.

Examples:

sage! game update remove=" @bob-villa "
sage! game update remove=" @ren @stimpy "

Characters

When Character Management commands are used within a Game, they only affect characters within that Game. Characters created in a Game cannot be accessed outside that Game. Characters created outside a Game cannot be accessed from within one. "Used within a Game" simply means the command was used in a Channel that belongs to a Game. You can read about Character Management here.