grungnet/src/docs/howTo/usingTokens.md
2021-10-21 19:59:06 +11:00

5.0 KiB

embed:

Once you have a map shared between a party all players can drag tokens from the Token List on the right hand side of the screen. Tokens can then be used to represent players, monsters or any other object that needs to be moved around the map.

Default Tokens

Owlbear Rodeo comes with a variety of default tokens that represent various player classes and monsters in a fantasy setting.

Default Tokens

Currently there are default tokens representing these types: Barbarian, Bard, Cleric, Druid, Fighter, Monk, Paladin, Ranger, Rogue, Sorcerer, Warlock, Wizard, Artificer, Blood Hunder, Aberration, Beast, Celestial, Construct, Dragon, Elemental, Fey, Fiend, Giant, Goblinoid, Humanoid, Monstrosity, Ooze, Plant, Shapechanger, Titan and Undead.

Working With Tokens

Once a token has been placed on a map there are a few settings available for them. To access these settings click a token on the map.

Working With Tokens

An overview of each setting is listed below:

  • Label: allows you to write text that is then displayed at the bottom of the token.
  • Status: allows you to overlay a coloured ring on top of the token, these can be useful for showing status effects.
  • Hide / Show (GM Only): toggle the visibility of the token, useful for tracking invisible enemies.
  • Lock / Unlock (GM Only): when a token is locked it can't be moved until it is unlocked again.
  • Category (GM Only): Change the token category. See Editing Tokens for more information about token categories.

Tokens can be resized by using the controls on the left and right of the token or rotated with the control on the top.

To delete a token drag in into the delete button that appears when dragging.

Deleting Tokens

Custom Tokens

When you need more then the default tokens Owlbear Rodeo allows you to upload a custom token. Custom tokens are similar to custom maps and can be uploaded in a similar way.

Custom Tokens

To upload a custom token select the Edit Tokens Button at the bottom of the Token List. This will open the Edit Tokens Screen which allows you to upload and edit tokens.

To upload a new token either click the Add Token Button or drag an image into the Edit Tokens Screen.

Tip: Owlbear Rodeo has full transparency support for tokens. This means that players can only interact with visible parts of a token so feel free to upload creatures that might have large extended areas like wings.

Editing Tokens

Token Editor

Once a custom token has been added there are a few settings you can edit if you wish.

To get access to these settings you can click the Edit Token button while a token is selected.

The topmost view of the Edit Token Screen is a preview of what the token will look like on a map.

The first setting available is the Name input which allows you to change the name of the token that shows up in the Edit Tokens Screen.

Next you can change the Category of your token, a summary of the options is below.

  • Character - when selected this token will render on top of all other tokens. Used for things like players or enemies.
  • Prop - when selected this token will render beneath all other tokens. Used for things like items or markers.
  • Mount - when selected this token will render beneath characters but above props and when moved a character on top of this token will also be moved.
  • Attachment - when selected this token will attach to any character underneath it. Used for auras or markers.

Lastly you can adjust the default size that is used when adding the token to the map by adjusting the Default Size Input.

Note: The size input for a non-square image represents the number of grid cells a token takes up on the horizontal axis. The number of cells in the vertical axis is determined by the aspect ratio of the uploaded image.

Removing, Grouping and Hiding Tokens

Hiding, Removing and Grouping Tokens

To remove a custom token select the token in the Edit Tokens Screen then click the Remove Token button or use the Delete keyboard shortcut.

Once a token has been added you can use the Hide/Show Token in Sidebar toggle to prevent it from taking up room in the Token List on the right side of your screen.

Tokens can also be grouped to allow for better organisation. To do this with you can drag and drop a token onto another token to create a group.

Once a group has been created you can double click that group to open it.

To ungroup a token you can drag that token back out of the group into the main view when the group is open.

Tokens can also be reordered by dragging them into the desired position.

Tip: You can select multiple tokens at the same time using the Select Multiple option or using the Ctrl/Cmd or Shift keyboard shortcuts

Filtering Tokens

Filtering Tokens

In the Edit Tokens Screen you can filter the tokens that are being shown by entering a term in the Search Bar. This will show tokens whose names or groups best match your search term.