Difference between revisions of "Token"

From Viridian TTRPG Wiki
Jump to navigation Jump to search
(Layout changes + updates)
 
Line 1: Line 1:
=Tokens: How the game is played.=
<div style="float:left; margin:15px; max-width:30ch;">__TOC__</div>
A '''Token''' is a representation of a creature and/or entity that exists in the game world and sometimes used as a graphical user interface element for players to get a better idea of the environment and setting. As far as a Player is concerned, the token refers to their character and the other characters they would likely be interacting with. Tokens are used in '''Maptool''' in the same way figurines are used in traditional TTRPGs; they are graphical and often have a picture to give a face to a character, they can be moved around a map/environment and all contain important data that the virtual tabletop client can use to execute game mechanics.
<div style="max-width:125ch; margin:auto; text-align:left;">


==Player/Character Tokens==
A '''Token''' is a representation of a creature, character or any other entity that exists in the game world and used as a graphical element for players to interact with the environment and setting. As far as a Player is concerned, the token refers to their Character/Adventurer and the other characters they would likely be interacting with. Tokens are used in '''Maptool''' in the same way figurines are used in traditional TTRPGs; they can be moved around the map/environment and are capable of containing important data such as its stats and properties that the virtual tabletop client can use to execute game mechanics.
Every player has their own token, this token represents the character they will be roleplaying as. In Maptool, they will also gain 'ownership' of the token, meaning that they can commit edits to the token (if they know how to) as well as move around freely during roleplaying sections, and when it is their turn in initiative (although the GM can prevent players from moving entirely if desired). '''Token setup''' will be required, especially during creation, in order for all the character's stats to reflect the game rules and limitations, add the appropriate graphic for visual representation and even to set up their '''Command Macros''' necessary to execute complex actions at the click of a button.


:It is best that you, the player, read and apply the instructions of the [[Character Creation]] tutorial before you go ahead and set up a token. Your GM will be able to help you set up a token themselves as long as they have the correct information on hand. Additionally, when it comes to a token graphic, is it best that you find an image of your characters head and/or bust that you want to use to present your character so that the GM may use '''TokenTool''' to create a circular border around the image to maintain consistency amongst characters. The more space around the edge to crop, the better it will be to properly composite the image centrally without it going out of frame.
==Player Token Data==
A Player character's token is designed to contain a LOT of different stats and values known as '''Properties'''. Players are usually able to edit these values in order to set up their Token for play, however some properties are used by gameplay Macros to provide useful outputs and can usually be generated using certain Macro scripts. If you have any doubts on what you should change, ask your GM. Your GM can also set up your token themselves if they are provided the correct information.


===Player Token Data===
===Resource points===
A player's token can contain a LOT of different stats, some of them they can edit and others are to be left alone as they serve important mechanical information for commands to function. '''Attempts have been made to keep things presentable but the ability to distinguish editable and non-editable variables is not possible within the client.''' If you have any doubts on what you should change, ask your GM. Your GM can also set up your token themselves if they are provided the correct information.
The first set of properties a character token will contain are their '''Resource Points'''. Resource points include Health which determines how alive or unalive they are in combat, as well as several other resources types needed to cast spells or use abilities. Resource points differ from most stats is that they have a '''Current''' and '''Maximum''' value. The Maximum value is usually kept static most of the time, whereas interactions in the game may frequently change the Current value due to in-game events. The most basic event being a character taking damage to their health will lower their Current Health value. Usually, Resources can be lowered below 0 and into the negatives, but not higher than the character's Maximum values.


Updating tokens due to levelling up much easier because levels and EXP is controlled by Maptool scripts, attribute and skill point gains are simple to change and perk points don't usually affect a Token's stats directly.
In Maptool, certain graphical UI elements can be displayed, and these Resource properties can be used to give players an accurate representation of their current resources, when used with certain Macro scripts. For example: A HP bar can be displayed over a token and a script can be used to compare the current and maximum health values of a character to proportion the bar for easy status recognition.


====Resource points (HP, SP, Ki, PP)====
'''Stats include:'''
The first and most important stats a character token possesses are their '''resource points''', including their Health which determines how alive or unalive they are in combat, as well as several other resources that are often used in casting spells or using special abilities. What makes resource points differ from most stats is that they serve as '''containers''' with a maximum capacity and a current capacity. Taking damage will often reduce available health points to 0 or lower, but healing will only go as high as the character's Maximum.
* HP (Current health points)
* MaxHP (Maximum health points)
* SP (Current Spell points)
* MaxSP (Maximum Spell points)
* Ki (Current Ki points)
* MaxKi (Maximum Ki points)
* PP (Current Power points)
* MaxPP (Maximum Power points)
* THP (Current Temporary health points)
* MaxTHP (Maximum Tempoary health points)
* AP (Current Action Points)
* MaxAP (Maximum Action Points)


A dedicated Damage/Heal script is used to subtract or add resource points to a character when it is necessary. In Maptool a character's resources are represented by coloured bars above and/or below their character token when hovered over. These scripts will change the % of how those bars are filled for a more graphical feedback of a character's condition.
===Attributes===
The [[Attributes]] properties are used as described in the wiki article, and players are encouraged to enter the appropiate values into their token to begin setting their character's token up for play. The short name for Attributes are what are used in Macro scripts to make script-writing easier, the full name is displayed for the Player's benefit.


  Apart from HP and MaxHP, if a character does not possess the ability to use other resource points, those values should be reset to nothing ( ). Leaving a stat such as SP to 0 will make it appear on a token's quick-stats and provide useless information.
  '''Stats include:'''
* str (Strength)
* per (Perception)
* end (Endurance)
* cha (Charisma)
* int (Intelligence)
* agl (Agility)
* lck (Luck)


'''Stats include:'''
===Size / SizeDiff===
* HP (Current health points)
A token has the properties <code>'''Size'''</code> and <code>'''SizeDiff'''</code> which are needed for scripts to properly calculate stats and actions according to a character's Size-Rating. Players can enter a value for the '''Size''' property, but '''SizeDiff''' should be left alone for a script to write and read.
* MaxHP (Maximum health points)
* SP (Current Spell points)
* MaxSP (Maximum Spell points)
* Ki (Current Ki points)
* MaxKi (Maximum Ki points)
* PP (Current Power points)
* MaxPP (Maximum Power points)
* THP (Current Temporary health points)
* MaxTHP (Maximum Tempoary health points)


====Attributes====
For more information, read the [[Size]] article.
The '''Attributes''' stats are just the same as they are during character creation, they are defaulted to 0 and a player need only input the number relative to the attribute points that character should have. These numbers alone are used in many commands that scale depending on attributes.


  A Player is permitted to edit these values themselves as the entire section they fall under is used by commands/scripts but not variables for such scripts.
  '''Stats include:'''
* size (Size-Rating)
* sizediff (Size-Difference to current target)


'''Stats include:'''
[[Category:Mechanics]] [[Category:WIP]] [[Category:Maptool]]
* str (Strength)
* per (Perception)
* end (Endurance)
* cha (Charisma)
* int (Intelligence)
* agl (Agility)
* lck (Luck)
 
====Skills====
'''Skill''' stats similarly use the same values as present on a character's sheet, if they have 20 points from a Skill-Focus, the appropriate stats would be 20. If they need to add 15 points to a skill, they can add the points to that skill. Skill ranks are not represented on a character's token and should instead be reflected upon a character's sheet and in any commands they gain from reaching ranks. Circumstantial bonuses should not be written into these sections, instead, apply the circumstantial bonuses before executing commands as a modifier.
 
Skills are often separated out by sections, only skills with blank spots or ones filled with numbers should be edited. Ones marked with dashes are just decorations.
 
==Object/GUI Tokens==
 
[[Category:Game Mechanics]]

Latest revision as of 18:12, 9 May 2022

A Token is a representation of a creature, character or any other entity that exists in the game world and used as a graphical element for players to interact with the environment and setting. As far as a Player is concerned, the token refers to their Character/Adventurer and the other characters they would likely be interacting with. Tokens are used in Maptool in the same way figurines are used in traditional TTRPGs; they can be moved around the map/environment and are capable of containing important data such as its stats and properties that the virtual tabletop client can use to execute game mechanics.

Player Token Data

A Player character's token is designed to contain a LOT of different stats and values known as Properties. Players are usually able to edit these values in order to set up their Token for play, however some properties are used by gameplay Macros to provide useful outputs and can usually be generated using certain Macro scripts. If you have any doubts on what you should change, ask your GM. Your GM can also set up your token themselves if they are provided the correct information.

Resource points

The first set of properties a character token will contain are their Resource Points. Resource points include Health which determines how alive or unalive they are in combat, as well as several other resources types needed to cast spells or use abilities. Resource points differ from most stats is that they have a Current and Maximum value. The Maximum value is usually kept static most of the time, whereas interactions in the game may frequently change the Current value due to in-game events. The most basic event being a character taking damage to their health will lower their Current Health value. Usually, Resources can be lowered below 0 and into the negatives, but not higher than the character's Maximum values.

In Maptool, certain graphical UI elements can be displayed, and these Resource properties can be used to give players an accurate representation of their current resources, when used with certain Macro scripts. For example: A HP bar can be displayed over a token and a script can be used to compare the current and maximum health values of a character to proportion the bar for easy status recognition.

Stats include:
* HP (Current health points)
* MaxHP (Maximum health points)
* SP (Current Spell points)
* MaxSP (Maximum Spell points)
* Ki (Current Ki points)
* MaxKi (Maximum Ki points)
* PP (Current Power points)
* MaxPP (Maximum Power points)
* THP (Current Temporary health points)
* MaxTHP (Maximum Tempoary health points)
* AP (Current Action Points)
* MaxAP (Maximum Action Points)

Attributes

The Attributes properties are used as described in the wiki article, and players are encouraged to enter the appropiate values into their token to begin setting their character's token up for play. The short name for Attributes are what are used in Macro scripts to make script-writing easier, the full name is displayed for the Player's benefit.

Stats include:
* str (Strength)
* per (Perception)
* end (Endurance)
* cha (Charisma)
* int (Intelligence)
* agl (Agility)
* lck (Luck)

Size / SizeDiff

A token has the properties Size and SizeDiff which are needed for scripts to properly calculate stats and actions according to a character's Size-Rating. Players can enter a value for the Size property, but SizeDiff should be left alone for a script to write and read.

For more information, read the Size article.

Stats include:
* size (Size-Rating)
* sizediff (Size-Difference to current target)