
PlayerCharacters provides a list of Characters by Player, as well as the means to add Characters for Players easily.
Lists Characters by Player
- --skip-all -- causes the listing to not show characters which have a controleld by of
all
.Characters with Players explicitly assigned to them in addition toall
will still be listed under the explicit Player name. - --add-character <Player ID or all> -- Add a character for the specified player or all players. This command is used via the plus button in the list output.
- --name [Name] -- Set the name for the new character. This is only used if
--add-character
is also specified. If no name is specified, a default name based on the Player is used. This command is used via the plus button in the list output. - --help -- Shows the Help screen.
If called by the GM, PlayerCharacters whispers a list of characters divided by player. If called by a player, they will see their own characters as well as characters available to all players. Each character shows the character's avatar, name, and a button to open that character. There is also a green plus button that will add a new character for that player. Pressing it will prompt for a name (you can leave the prompt blank to have a default name assigned).
You can list all the characters that players have access to with the following command:
If you want, you can ignore characters with controlled by set to all players
. Characters that also have an explicit character assigned will still be shown under that player:
Additionally, PlayerCharacters will whisper a list of available characters to a player when they log in to a game.
--config takes option value pairs, separated by | characters.
- show-characters-on-login -- Contols if players will be shown their characters when they log on. Values:
on
,off
,toggle
- show-characters-delay -- How long to wait before showing players their characters. Value:
<number of seconds>
- players-can-add-characters -- Can players add characters for themselves. Values:
on
,off
,toggle
- players-can-add-all-characters -- Can players add characters for All Players. Values:
on
,off
,toggle
Example GM View:
Github: https://github.com/shdwjk/Roll20API/blob/master/PlayerCharacters/PlayerCharacters.js