Character Vault
Any Concept / Any System
Your System Come To Life
Roll20 for Android
Streamlined for your Tablet
Roll20 for iPad
Streamlined for your Tablet

Personal tools

Difference between revisions of "Earthdawn - FASA Official V2"

From Roll20 Wiki

Jump to: navigation, search
(Walkthrough of Character Sheet)
(Basic Concepts and navigation)
Line 99: Line 99:
Note that as a general convention, permanent/semi-permanent modifications to an ability have been called '''Adjustments''' This can be a bonus to defense given by a Discipline Circle Ability, a bonus given by a thread item or any permanent curse your vicious GM imagined. Most of the time, the displayed value will be the total already including the adjustments. As an exception are Ranks of Talents/Knacks and Skills, and Weapon Damage steps, where the adjustment will be visible like a modifier.
Note that as a general convention, permanent/semi-permanent modifications to an ability have been called '''Adjustments''' This can be a bonus to defense given by a Discipline Circle Ability, a bonus given by a thread item or any permanent curse your vicious GM imagined. Most of the time, the displayed value will be the total already including the adjustments. As an exception are Ranks of Talents/Knacks and Skills, and Weapon Damage steps, where the adjustment will be visible like a modifier.
are temporary buffs/debuffs on an ability have been called '''Modifiers''' . It can be for example from a combat option, from a situation like being knocked-down, or from a spell or another talent. Modifiers will appear as smaller colored value near the value they are modifying
Temporary buffs/debuffs on an ability have been called '''Modifiers''' . It can be for example from a combat option, from a situation like being knocked-down, or from a spell or another talent. Modifiers will appear as smaller colored value near the value they are modifying
Throughout the sheet, steps and values are displayed consistently with:
Throughout the sheet, steps and values are displayed consistently with:
Line 118: Line 119:
On a very General Note, the sheet is PRINTABLE with compatible browsers (Chrome..). You need to pop-out the sheet to print.
On a very General Note, the sheet is PRINTABLE with compatible browsers (Chrome..). You need to pop-out the sheet to print.
=== Header & General Concepts ===
=== Header & General Concepts ===

Revision as of 00:54, 6 July 2021

Earthdawn® (FASA Official) Character sheet Version 2 & Earthdawn® (FASA Official) API Version 2



Player Quick Start Guide

Your GM (or the 'Welcome Package' API) should have created a character for you. If you don't find a character sheet that seems like it was meant for you, contact your GM. In the Virtual Table Top (VTT) sidebar above the chat window, select the N Journal-tab. Find your character and click it. Your character sheet should open up to it's 'Bio & Info' tab. Click the 'Character Sheet' tab.

Character Creation

Screen capture to be added

Unless your GM pre-created a character for you (in which case you can skip) this step, the Creation Window should open that will guide you step by step in the creation process (following the steps defined in the Player Guide p.57)

  1. Begin by entering a name for your character in the header, and define it as a PC (Player Character)
  2. The Dropdown will allow you to select your Discipline and Race. Racial Abilities, and Durability will be automatically computed. Discipline and Racial Talents will have to be entered manually (see step 4)
  3. Generate Attributes : the red inputs will allow you to distribute your 25 attribute points (AP) as per Player Guide (PG) p.59. They will turn green when you have spent all your points. The attribute steps are automatically calculated
  4. Secondary characteristics like health ratings, and defenses will be automatically calculated with no need for manual actions. Please note that when reaching higher Circles where bonus are granted to for example Defenses, those will have to be entered manually in the Adjustment Tab
  5. Here you can create your Talents. They have to be entered and parameterized manually. If the API is installed (see API, Token Markers and Character sheet) a text box will appear, where you can paste extracts from the sourcebooks that will be automatically parsed to speed up the data entry. See Talent, Knacks and Skills Section for more details. Note that for Spellcasters, the dedicated spellcasting Talents (SpellCasting, Patterncraft and Thread Weaving), as well as 2 Matrixes will be created. A “Dummy” Talent representing your Willpower will also be created. It will be used as a shortcut to roll spell Effect tests (See Spellcasting)
  6. Skills will follow the same logic as Talents, except for the languages. For languages, new lines for each known language can be created, and a checkbox will indicate to the system if it is known as a skill or as a Talent. See Talent, Knacks and Skills Section for more details.
  7. Racial Abilities are automatically Determined by your Race. You need to manually enter any Racial Talent (Versatility/Astral Sight)
  8. Equip your character by navigating to the Equipment Tabs
  9. Flesh out your character by filling its Bio and Description back in the Overview Tab
  10. End up the creation mode by unchecking the checkbox at the end of the sheet

You’re (almost) ready to play !

Now is probably a good time to link your Token. This is very important as it allows roll20 to recognize that the token on the VTT map corresponds to this character sheet.

  • At the top of your character sheet, there is an 'edit' button. This button allows you to set your Avatar picture.
  • Your chosen picture should now appear next to your character name in the character journal. Use your mouse to drag from your character name to the VTT. A token should appear on the VTT. If it does not, it is probably because you tried to drag the portrait picture to the VTT instead of the name.
  • Select this token.
  • On your character sheet go to the 'Adjust' tab, ‘Advanced’ subtab..
  • In the 'Special Function' dropdown select 'Link Token'.
  • Make sure your token is still selected on the VTT and push the 'Do SF' button. You should get text saying the token has been linked.

You can delete the token in the VTT now if you want. From now on whenever you drag a token from the Journal to the VTT, the new token will be correctly linked to your character (the token and your character sheet will share damage, wounds, karma, Etc). Note that tokens have some parametrization (like some aura or Dynamic lighting parameters). The token dragged from the Journal will always have the parameters at the time you made the Link, so if you made a change, you just need to repeat steps 3 to 6 Note that for some actions and Talents to work correctly you need to have a token selected. For example rolling Initiative requires having a validly linked token selected. Some people want a portrait picture for the character journal, but a top down view for the token. To do this, load your token picture in as the Avatar, then link the token, then change the Avatar picture to your portrait picture.

Basic Concepts : API, character sheet

The Earthdawn character sheet( GitHubLogo.png) is optimized for 4th edition, but currently has limited support for other editions. In its version without API freely accessible to roll20 Free and
info level subscriber, it integrates basic functionalities such as:
  • Character sheet
  • Basic Step Dice Roller
  • Calculation of the steps according to combat options and statuses
The sheet is tightly integrated with the Earthdawn companion API( GitHubLogo.png), and as such the GM must be a
info level subscriber in order for this sheet to work at maximum functionality. The API will unlock many advanced functionalities such as:
  • Follow up of Karma,strain, recovery tests… when an ability is rolled
  • Recording of the spending of Legend Points when abilities are modified
  • Addition of “Token Actions” buttons, that allow quick access to the main functionalities from the VTT
  • Linking between abilities
  • Spellcasting Sequence management
  • Combat management, taking into account extra success calculation and application of damage to targets
  • Linking between the options/statuses in the character sheet and the token markers on the VTT
  • And much more…

See the API section in this Wiki for more details on advanced functions.

This Wiki page should provide help to both players and GM's when using the sheet and its features but is not, and never will be, a substitute for having a good understanding of both the Earthdawn® rules and the roll20 system. Functions available only with the API will be preceded with (API)

Basic Concepts : Action Tests, Token Action

There are 3 ways you can roll an Earthdawn® test with the step dice roller for an ability listed in the character sheet:

  1. Clicking on the ability button in the character sheet will trigger a test roll for the character only
  2. Drag and drop the character sheet button to the bottom of the screen for quick access of this same button, even with the sheet closed
  3. (API) Click on a character Token on the map to make appear a list of its "Token Actions", as buttons on the upper left of the screen. Clicking this button will trigger a test of the chosen ability for all characters which token in selected (Note that it can be practical for the GM to do for example a group Perception test, or a group Initiative check)

Please note that before rolling the dice, the system may ask you several information such as if you want to add Karma points, if there are special modifiers, or targetting an opponent to compare with the appropriate defence. Note that all these requests will either appear on the VTT, or on the chat bar at the right of the VTT, resulting that it is not recommended to play with the character sheet popped out to a separate tab.

Token Actions can be customized in your character sheet. For Talents, Knacks, Skills, Weapons, and Matrix, opening the edit mode, and going to the parameter will give access to a "Tken Actn" checkbox, that marks the abilities that have their own Token Action button. These abilities will also be listed in the summary "Combat Tab" view. There are additional Token Actions that are automatically available for every sheet.

  • "Init" rolls initiative for the selected tokens.

* "Karma" toggles karma usage on or off. * "Attrib" lets you make Attribute rolls.

  • "Damage" allows damage to be assigned to tokens.
  • "Skills" allows access to skills that don't have their own token actions.
  • "Talents" allows access to all Talents and Knacks that don't have their own token actions.
  • "Status" allows access to just about everything else.

To be moved to a FAQ and support section The Roll20 "Earthdawn® (FASA Official)" character sheet and API were created by Chris Dickey (Chris D. on Roll20) You may PM me with problems and comments.
It is optimized for 4th edition, but currently has limited support for other editions.

The Roll20 "Earthdawn® (FASA Official)" character sheet was created by Chris Dickey (Chris D. on Roll20), and revised in v2.0 by Chris Dickey and J-B Faure.

Walkthrough of Character Sheet

Basic Concepts and navigation

The character sheet has on its top a header that groups some general information, and that on hovering your pointer will let appear a list of icons and information about the combat options, and modifiers applied to all tests. Below the header are a series of tabs that allow to navigate between the different sections of the sheet. Please note that the visualization is common to all Roll20 user, so if 2 users (GM and player for example) look at the sheet at the same time, they will see the same section. Please note that Roll20 takes into account a new value in an input field once you clicked out of the field. If you leave your pointer in the input, the value has not yet been taken into account

Insert screenshot

At the left of the sections are 2 subsections for the attributes and for the defenses, armor and initiative. Please note that this sections can be displayed or hidden per 2 icons on the title bar of each of the sections. Their visualization can be selected individually for each section.

In many title bar, an edit icon will be present, that allows to unlock a portion of the sheet to an edit mode.

Any/most of the fields on the sheet have a tooltip. Hovering your pointer will display a tooltip that will give detail of the field name and its meaning.

Note that as a general convention, permanent/semi-permanent modifications to an ability have been called Adjustments This can be a bonus to defense given by a Discipline Circle Ability, a bonus given by a thread item or any permanent curse your vicious GM imagined. Most of the time, the displayed value will be the total already including the adjustments. As an exception are Ranks of Talents/Knacks and Skills, and Weapon Damage steps, where the adjustment will be visible like a modifier.

Temporary buffs/debuffs on an ability have been called Modifiers . It can be for example from a combat option, from a situation like being knocked-down, or from a spell or another talent. Modifiers will appear as smaller colored value near the value they are modifying

Throughout the sheet, steps and values are displayed consistently with:

  • In the center the step itself
  • On the left the automatic modifiers, i.e. modifiers have been set somewhere else in the sheet. For example, when you take a wound, all/most of your steps will immediately display a (-1)
  • On the right is the manual modifier, that you can enter manually. This modifier itself can become the left automatic modifier somewhere else in the sheet. For example, if you are under a spell giving you +2 to Strength, you can enter a manual +2 to your Str Step, and automatically, all your damages, Talents/Knacks/Skills based on Strength will have an automatic -2 modifier appearing on the left

In the example above, the ability could have -3 because of being knocked down (or 3 wounds), and a manual +2 has been entered just on this ability (maybe a spell), so the next roll will be at -1

During development we realized that what had to be displayed in the center value was a matter of taste and opinion:

  • Some people prefer to see in the center value only their permanent, unmodified step. If affected by modifiers, they will mentally calculate the final value that will be used for their next test
  • Other people don't like this gymnastics, and prefer to see directly the final modified value.

To cater to all people, the ones that agree with me, and the ones that are wrong, a sigma icon in the header allows to toggle between the 2 visualization modes

The sheet uses a lot of icons to represent game concept. Such icons will be found throughout the sheet, and can be also used as token markers (see XXX) We hope you will get used to the icons quick, but a legend can be found in the Adjust Tab (subsection “Help”)

On a very General Note, the sheet is PRINTABLE with compatible browsers (Chrome..). You need to pop-out the sheet to print.

Header & General Concepts

The header groups several icons and fields that you can access from anywhere, regardless of the section displayed. Hovering your pointer on the header will unwrap many options.

On the Left of the logo, in addition to the Character Name, are grouped several common buttons:

  • Dice Roller : Enter a step, enter a Karma Step, roll. It is very recommended to drag-drop this button to the macro bar for easy access
  • Sigma button : Final/Base Step selector. See Basic Concept
  • New Day: This buttons declares a new day, refilling the number of available recovery tests, and declaring a Karma Ritual. By default, clicking this button will max out the Karma pool (that is on the right of the logo), but some tables have homerules based on older editions for the number of Karmas refilled. There is a dropdown selector in the Adjust tab, Common section that allow for some of these homerules
  • Jumpup, Knockdown, Initiative : these buttons will roll the appropriate tests. Note that the Token has to be selected for initiative
  • Wiki : If you click this button a button will be sent to the chat window. If you right-click that button and open it in another tab, this WIKI page will appear (don't just click it, or the wiki will open in the same window as the VTT, closing the VTT)


RollType determines the visibility of your roll results. They can be set as 'Public', 'GM Only', or 'GM and Player only'. In the header you set the default value that will be used everywhere in the sheet, but most of the abilities (attributes, talents etc), have their own setting that can override this default. As an example of usage, some GM's prefer that 'Awareness' tests should go to 'GM Only', which should be done for the RollType for the Awareness Talent/Skill only. Some GM's might desire all their NPC's rolls to be shown to GM only, this is done for each NPC character in the Header. With the API, the GM can also go in the Advanced subsection of the Adjust subsection, to call the GM Special Commands, and use Default RollType. This will allow to set the Default rolltype at creation of each type of characters (PC/NPCs/Mook)

On the right of the logo will be found the main “pools”:

  • Damage records the number of damage, up to the unconscious (left) and death (right) ratings. The title is a button that allows to apply a certain type of damage, selecting the type of armor to be substracted. A “stun” icon allows to display a second damage pool for the stun damage. The title of the stun damage pool allows to roll a stun damage recovery test. Damage is compared to the ratings, and if it exceeds, the character status will be updated to dead or unconscious
  • Wounds: debuffs due to wounds are automatically taken into account in the different rolls
  • Recovery tests: number of tests left and button to roll a recovery test

(API) : when a recovery test is rolled, number of available tests and current damage will be decreased. When damage is applied via the Damage button, comparison to wound treshold will be done automatically to apply wounds. If your character sheet has been properly linked to a token (See Player Quick Start Guide or 'Adjust - Advanced - Special Functions') then these three values will be updated in the token bubbles. Green for Karma, Blue for Wounds, Red for Damage. Changes here will show up in the token and visa versa.

Karma, Karma Control, and Devotion Points

Earthdawn® allows Karma to be added to some rolls, but not others. The player may or may not wish to spend karma even when allowed.

Without API, when making a roll, the user will be asked if a karma step has to be added (by default should be 4 for D6). The user will have to manually count its karma points.

With API, different modes will allow the user to declare if he wants to spend karma points on the test. The API will remove the points of the Karma Pool automatically. In the header, to the right of the logo, we keep track of the number of Karma the character has left. 2 additional icons can be selected to declare the users intentions towards using karma on his next test(s).

  • If no icon is selected, he will not spend any Karma or any test
  • As long as the “ask” mode is selected, user will be asked to confirm at each test the number of Karmas he wants to spend.
  • As long as the “auto” mode is selected, all tests will be done using exactly the number of Karmas decided for this kind of tests.

For each ability, for example for each Talent/Skill/Knack, the user will find in the parameters or Adjust section, a “karma-max” parameter that will declare the maximum number of Karma that can be spent on tests with this ability. For example, skills will most likely be 0, Talents will most likely be 1, but a character that can spend Karma on Damage tests may enter Karma-max=2 for a Talent that substitute its strength for damage tests. For each Talent/Skill/Knack (or attribute where Karma-max is set), a Karma selector will appear on the right of the ability. This selector will declare how many Karma points the user wants to spend on tests when the Karma mode is “auto” In the example below, if Karma mode is in auto, each Awareness test will be done with 1 Karma, Astral sight with none, and Elemental Tongue test will be done spending 2 Karma points

If your character is a Questor (see Overview tab) then 'Devotion Points' (DP) fields will appear next to the Current Karma field and the use Karma field, and next to every Karma Control field will appear a DP Control field. These fields are for Questor Devotion Points and work exactly like karma.

Note that the Karma and Devotion Names, are buttons, and clicking them will roll 1 single Karma/DP dice

=Global Modifiers, Combat Options & Situation modifiers

This part of the header displays when the pointer hovers over the header. Anything selected will remain visible after the pointer leaves the area. The right part of this subsection is a series of icons representing all the combat options and situation modifiers described in the rule (see PG p.382). The icons will toggle on and off the selected status. (API) Statuses and options can also be set directly from the token by clicking on the token and setting the appropriate icon on the bubble directly below the token.

Note the difference between Blindsided and blindsiding or HalfCover and Target Half Cover, that are statuses that either apply to yourself, or to your target.

Strain Per Turn is for things such as 'Horror Fend' charms or a Talent or Spell Effect that cause Strain every turn, but which might not have a separate dice roll that this strain can be attached to. It simply spends this much strain every time Initiative is rolled. If somebody goofs up and for some reason Initiative is rolled more than once, make sure you get this damage back for the extra rolls.

The left part of the subsection are a summary of the global modifiers that will apply throughout the sheet to all tests of a certain category. These global modifiers will then be inherited and displayed to all tests in the sheet. The screenshot below gives a good example of what will happen when Defensive Stance is applied (i.e. -3 to all Action Tests, and Damages, and +3 to defenses). It can be seen that the global modifiers updated to reflect these modifiers, that have then been applied to all the attribute tests, defenses, and talents. Wood Skin being an “Effect Test”, it is not affected by Defensive Stance. Screenshot

Additionally to the automatic values for each modifiers from combat options, situation modifiers and wounds, a manual modifier can also be set. Attack and Damage can be toggled between Close Combat, and All Attacks, as some modifiers only apply to close combat. (example Agressive Attack) Note that a parameter cog allows to also add a bonus die (for example with spells like FlameWeapon)


  • What Editions does this sheet support?
    • The bulk of the effort has been made to make this sheet complete for Earthdawn® 4th Edition. However there is an option available to the GM to make the sheet more usable with other editions. For example the 3rd edition step-dice table can be used instead of the 4th edition table. A GM wishing behavior more in concert with previous editions is welcome to work with the sheet author to identify specific modifications to make the sheet more compatible with other editions.
  • How do I send you some feedback, suggestions, comments, or report bugs/issues?
    • You may ether send a PM to the to the sheet author, or you may post a question or help request in the sub-forum. The forums are a good way to engage the community at large, but I often don't read the forums, so might miss your posts so the best idea is to open a new thread and PM me so I know about it.
  • What situations does the character sheet not support?
    • The sheet does not do anything to support keyword damage and keyword protections against certain damage types. For example Fire damage, Cold Damage, Etc. Nor protections against such damage. The Players / GM will need to make adjustments to damage/protection themselves manually.
  • If you don't have the API, how can I make a generic Roll-Public or Roll-GM macro. ?

/gm &{template:default} {{name=Misc Roll}} {{Step: [[?{Step|8}]] + Bonus Step [[?{Bonus or Karma Step|0}]]}} {{Result: [[ [[floor({?{Step}-8,0}kh1 / 11)]]d20! + [[ [[{1e3, 7}=[[{?{Step}, 0}kh1]] ]] + [[{6, 7, 7, 8, 9, 10, 11}=[[{((?{Step}-8) % 11)+1,0}kh1]] ]] ]]d12! + [[ [[{1e3, 6}=[[{?{Step}, 0}kh1]] ]] + [[{4, 5, 5, 6, 11}=[[{((?{Step}-8) % 11)+1,0}kh1]] ]] ]]d10! + [[ [[{1e3, 5}=[[{?{Step}, 0}kh1]] ]] + [[{2, 3, 3, 4, 9, 10, 10, 11}=[[{((?{Step}-8) % 11)+1,0}kh1]] ]] ]]d8! + [[ [[{1e3, 4}=[[{?{Step}, 0}kh1]] ]] + [[{1, 1, 2, 8, 8, 9}=[[{((?{Step}-8) % 11)+1,0}kh1]] ]] ]]d6! + [[{1, 2, 3}=[[{?{Step}, 0}kh1]] ]]d4! - [[{1, 2}=[[{?{Step}, 0}kh1]] * (3 - [[{?{Step}, 0}kh1]])]] + [[floor({?{Bonus or Karma Step}-8,0}kh1 / 11)]]d20! + [[ [[{1e3, 7}=[[{?{Bonus or Karma Step}, 0}kh1]] ]] + [[{6, 7, 7, 8, 9, 10, 11}=[[{((?{Bonus or Karma Step}-8) % 11)+1,0}kh1]] ]] ]]d12! + [[ [[{1e3, 6}=[[{?{Bonus or Karma Step}, 0}kh1]] ]] + [[{4, 5, 5, 6, 11}=[[{((?{Bonus or Karma Step}-8) % 11)+1,0}kh1]] ]] ]]d10! + [[ [[{1e3, 5}=[[{?{Bonus or Karma Step}, 0}kh1]] ]] + [[{2, 3, 3, 4, 9, 10, 10, 11}=[[{((?{Bonus or Karma Step}-8) % 11)+1,0}kh1]] ]] ]]d8! + [[ [[{1e3, 4}=[[{?{Bonus or Karma Step}, 0}kh1]] ]] + [[{1, 1, 2, 8, 8, 9}=[[{((?{Bonus or Karma Step}-8) % 11)+1,0}kh1]] ]] ]]d6! + [[{1, 2, 3}=[[{?{Bonus or Karma Step}, 0}kh1]] ]]d4! - [[{1, 2}=[[{?{Bonus or Karma Step}, 0}kh1]] * (3 - [[{?{Bonus or Karma Step}, 0}kh1]])]] ]]}}

For public rolls, remove the /gm from the front.

Earthdawn® (FASA Official) API

The Earthdawn® (FASA Official) Character sheet was designed to work with the Earthdawn® (FASA Official) character sheet companion API. This section describes the differences between using the character sheet with and without it's API companion. The character sheet has a flag that alerts it whether or not the API is installed and uses that flag to change what character sheet fields are present, or what options might be available. The look and behavior as described in the other sections of this document always describes the Character Sheet as it appears when the API is installed. This section describes what is different depending upon whether the API is installed or not.

  • NoAPI: None of the Token Action buttons or Chat Window buttons described elsewhere will be present or work.
  • NoAPI: Importing Creatures, Talents, Spells, Etc. from text will not work.
  • NoAPI: The "use karma" field is gone as are all "karma control" fields. karma toggling will not work, nor will the described status-markers. Most buttons will separately ask about a step for "Karma or Bonus".
  • NoAPI: Token Actions will not be automatically created when the "Tkn Actn" box is checked.
  • NoAPI: Knacks tab is hidden as Knack linking will not work. In this case Knacks should be entered on the Talents tab.
  • API: Chat menu's will be available to help with many tasks.
  • API: Spells can be loaded into matrices with a button. NoAPI: You will have to enter values manually to keep track of spells in Matrixes.
  • API: When Talents, Skills, and Knacks are increased, chat menu's will appear suggesting how much LP and Silver should be spent in training. A button will record these expenditures on the 'Record' tab and the LP and Silver totals will be adjusted. NoAPI: The 'Record' tab does not have data entry fields or buttons, but the large text area can be edited freeform.
  • API: Advanced Targeting of tokens is available. IE: Highest MD and Highest MD plus 1 per target. NoAPI: Only single tokens can be targeted.
  • API: Number of successes are calculated. NoAPI: Target number and roll are displayed so the user can calculate how many successes that is.
  • NoAPI: Special Effects (SFX) are not available.
  • NoAPI: The "Special" processing of talents, skills, and knacks (where the system does additional processing of Inititive or Recovery Talents) is removed. As are modifications for Defensive, Resistance, NotMoveBased, and NotVisionBased.
  • NoAPI: In combat options and conditions, the Blindsiding and Target Partial Cover options are removed.

Token Actions

During gameplay, you can ether have the sheet open, and make rolls directly from the sheet, or you can use token actions. When a token is selected, you can see the token actions associated with that token. Talents, Knacks, and Skills have a checkbox labeled "Tkn Actn" (Token Action). When that box is checked, the system creates a Token action for that action for that character.

There are additional Token Actions that are automatically available for every sheet. "Init" rolls initiative for the selected tokens. "Karma" toggles karma usage on or off. "Attrib" lets you make Attribute rolls. "Damage" allows damage to be assigned to tokens. "Skills" allows access to skills that don't have their own token actions. "Talents" allows access to all Talents and Knacks that don't have thier own token actions. "Status" allows access to just about everything else.

Guide to the Character Sheet

Mostly this section is going to be a tab by tab guide to the character sheet, with particular attention paid to the tricky parts. Except that Karma Control selectors are scattered all over, so get their own separate section. Take a look at the Knacks section, even if your character is not using Knacks yet. Knacks are the best section to enter 'Dummy' talents.

There are a few categories of fields that, while scattered around many places of the sheet, all do basically the same thing. The next two sections explains them once so we don't have to cover then several times.


RollType determines whether nearby buttons should roll 'Public', 'GM Only', or 'GM and Player only'. 'Default' tells it to use whatever type of roll is listed as typical in the "Adjust - Advanced' section. As an example of usage, some GM's prefer that 'Awareness' tests should go to 'GM Only', which should be done for the RollType for the Awareness Talent/Skill only. Some GM's might desire all their NPC's rolls to be shown to GM only, this is done for each NPC character in the "Adjust - Advanced" section.

Karma, Karma Control, and Devotion Points.

Earthdawn® allows Karma to be added to some rolls, but not others. The player may or may not wish to spend karma even when allowed. So we keep track of how much Karma the character has left, and what rolls he can spend it on, and whether he wishes to spend it.

In the sheet header, to the left of the logo, we keep track of the number of Karma the character has left. When a Karma ritual is done you should increase current karma to max karma (top right of the Core Tab). The header also has a 'Use Karma' field. Setting that field to zero means you don't want it to spend Karma on rolls. Setting it to a number means you want to spend that many karma every roll. Each character has a Token Action labeled 'Karma' that toggles the 'Use Karma' field from zero to one and visa versa. In addition, the Token for that character will show a status icon of 'lightning-helix' when that character is set to spend Karma.

For just about every dice roll button, there is an associated Karma Control drop-down. If the Karma Control for that roll is set to 'Never', then the system will not spend karma on those rolls, even when the 'Use Karma' field says to. If it is set to 'Always', '2', or '3', it will always try to spend 1, 2, or 3 Karma on that roll (it will not spend karma unless the character has some left). The other possible value for a Karma Control is 'Sometimes', and that is the only time the system pays any attention to the characters 'Use Karma' field.

So for every test where the character is not allowed to spend Karma, the Karma Control field should be set to Never. For those tests where you always or almost always want to spend karma, set it to 'Always' (For example: Avoid Blow might be set to Always if you always want to spend karma on Avoid Blow tests). For the tests where you may spend Karma, but will not always want to, set it to Sometimes, and toggle 'Use Karma' on or off before making those rolls.

Down in the 'Core' tab, if you have selected a Passion in the 'Questor' drop-down, then 'DP' fields will appear next to the Current Karma field and the use Karma field, and next to every Karma Control field will appear a DP Control field. These fields are for Questor Devotion Points and work exactly like karma. The token action to toggle 'Use DP' is 'DP'. The status marker is 'angel-outfit'.


In the very upper left hand corner of the sheet is a button with a question mark. If you click this button a button will be sent to the chat window. If you right-click that button and open it in another tab, this WIKI page will appear (don't just click it, or the wiki will open in the same window as the VTT, closing the VTT). Also on the top row of the header you can change the name of the character, and enter your name as the owner of this character.

The 2nd row records the number of Karma you have left unspent, Your characters current Damage, Stun Damage, and number of Wounds. After your token has been linked (See Player Quick Start Guide or 'Adjust - Advanced - Special Functions') then these three values will be reflected in the token bubbles. Green for Karma, Blue for Wounds, Red for Damage. Changes here will show up in the token and visa versa.

Also in the Header are two fields for 'Action Tests'. You can edit one to adjust for any buffs or debuffs that affect all Action tests. The other field lists the total modification to all Action tests from all Conditions and Options. See the next section for more information on category Adjustments.

Modifiers, Combat Options & Conditions

This section can be hidden by clicking the word 'Hide' at the bottom of the Header. When hidden it can be displayed by clicking the word 'Show'. It is often convenient to hide it when you are not going to be using any combat options for a while, such as during character creation or maintenance. But you will probably want to open it up during game-play.

At the top of this section is a place for entering and seeing adjustments. For example to give a plus 4 step bonus to all attacks, you could enter a 4 in the attack adjustments box. The system will add 4 steps to any tests it recognizes as being an Attack test. Further, you can see the effects of various combat options. For example, checking 'Aggressive Attack' automatically adds +3 to attack and damage totals, and -3 to defense totals. If you give an adjustment to Action Tests it will be reflected in the Action Tests Total, and in the Attacks Total (since Attacks are Action Tests). If you give an Adjustment to all Effect Tests, you will also see it in Damage Test Totals (since Damage Tests are Effect Tests).

For Attacks and Damage you can also enter Bonuses (these are the input fields after the totals display). Bonuses are pretty much like adjustments, except the system does not just add to the step number, it rolls separate bonus dice. For example, if you are making a step 10 test, the system rolls the step 10 dice (2d8). If you give it a step 4 adjustment, it will instead roll step 14 dice (2d12). If you give the step 10 roll a 4 step bonus, it will roll the step 10 dice, and a step 4 die (2d8 plus 1d6). If a buddy casts Monstrous mantel upon your character, you could give your character adjustments to defenses, attacks and damage. If they cast flameweapon upon your character, you could give the character a step 4 bonus to damage, and more clearly see exactly what damage was flameweapon damage.

Also in this section are a bunch of check-boxes and Drop-Down lists representing combat options (such as defensive stance) and conditions (such as knocked down). You can check or uncheck these boxes as appropriate, and the sheet will adjust your attributes. Tail Attack is only checkable if 'Race' is T'Skrang. Blindsided is for when your character is blindsided through a series of attacks, and adjusts your characters stat's. Blindsiding is for when your character is blindsiding a target, and the GM gives you permission to make a Blindsiding attack, it will then use the targets blindsided defenses. Note that it is only necessary to set ether the Target to Blindsided, or the Attacker to Blindsiding, though nothing goes wrong if both are set. In much the same manner, a Target can be set to have Partial Cover, or an Attacker can simply click that their target has partial cover.

Some combat options do not have a checkbox, but there is a word or two about them in this section. You can hover your mouse over those words to get a quick summary of that combat option.

Core Tab

At the very top of the Core tab is a field that displays your Max Karma (calculated from your Race Karma Modifier and your highest Circle, plus any unspent Attribute Points), your Karma Step (Step 4 except for very high circle characters and some creatures and horrors), and a button where you can roll a single karma die. If the 'Questor' field has a Passion listed, there are also max DP, DP step, and a button for rolling Devotion Points. Also on the top line is an option to show or hide the attribute details. When not actually dealing with Attribute Details, it is highly recommended to keep them hidden away. The details are not needed most of the time, and especially if the character is a Questor, displaying the details makes the form too long, and all the tabs have a horizontal slider. If you hide the details the horizontal slider goes away. When details are not hidden, you get a field telling you how many of the 25 attribute points that starting PCs get that you have not spent. This is only used during character creation. For PCs in play, that number should always be zero or barely above it.

There is one row for each of the 6 attributes. The button that has the name of the attribute will roll a normal Action Test using that attribute as a base. The FX button will roll an Effect Test using that attribute. Step displays the base Step value of that attribute adjusted for things that affect all Action Tests. Mod is a Step adjustment for all tests of that attribute. Base is the base step number for that attribute adjusted for nothing. Note that even though Base is colored as a non-editable field, it is actually editable. It is used to make it faster for GMs to enter creatures. Race is the races base attribute value, and is reset whenever the Race is changed. The Race column is editable, but there are very few reasons to ever edit it (one reason would be if you are playing a non-standard race). AP is where you spend your Attribute Points at character creation. After character creation you should never change these. LP is where you spend Legend Points to increase your attributes. Value is the final sum of all these values. There is are Karma Control and DP Control fields for the buttons, then values and buttons having to do with the attribute. Note that the values that end in -N (such as PD-N) are a 'Natural' value for that attribute, looking only at the Attribute value and nothing else. The current total value for those attributes (including armor, shields, etc.) is given on the combat tab. Also note that MA-N is NOT the characters 'Natural' MA using the definition in the 'Earthdawn® Companion'. That 'Natural' MA is also on the combat tab. Once again, after spending AP in character creation, and when not increasing attributes through LP expenditure, Hide all the detail fields.

Below the Attribute block is the rest of the Core Tab. On the Right is a block where you can specify one or more Disciplines. Press 'Add', Use the Drop-down to select a Discipline. Click that it is Circle '1'. It should Display the Durability for that Discipline. If playing a Non-Standard Discipline, Select 'Other/Misc' and enter the durability for that Discipline. Record the actual Discipline name elsewhere.

Setting the race sets several other things, including Karma, Movement, and Racial Attributes. Setting a Passion name in Questor activates Devotion Point fields in the sheet.

Legend Points - Current and Career are editable (just in case), but you should avoid editing them directly. As you add LP on the Record Tab, and Spend it on the Talents, Skills, Knacks and other tabs, these fields will auto-update.

All other fields on the core tab are for descriptive purposes only.

Combat Tab

The Combat Tab gathers together in one place everything needed for combat (except spells, Spell-casters will need to keep flipping to the Spells tab). Most fields come in pairs of two, one for a buff/debuff or other temporary adjustment, and one for a final total value. For most fields for which the Combat Tab has a Buff value, the 'Adjust' Tab has a corresponding 'Adjust' value for more permanent changes or conditions. As a Tip for GMs entering creatures, you can do all of your fine tuning on the Combat tab using the buff values and immediately seeing their effects upon the totals, then go to the 'Adjust - Advanced' section, set 'Special Function' to 'Set Adjustments' and click 'Do SF'. This will copy all of the buffs to be adjustments and zero out the buffs. That way the creatures permanent stat's are all set to correct using adjustments, and the buffs are zeroed out to be ready for combat adjustments.

The hope is that most of the fields are self-explanatory, but I few warrant special mention.

The 2nd line is about defenses Physical Defense, Mystic Defense, Social Defense, with buffs, followed by final value. The third line does the same with armor values. But the first line displays the Natural values of Armor values and Defenses. It might be a little confusing what is being displayed, so hover over the individual fields and look at the hover text. Adjustments to Natural values are made on the adjust tab.

Shield Buff PD and MD are slightly different than other PD and MD buffs in that these fields are for buffs that are specifically tied to the shield. Any condition that causes you to loose your shield benefits also causes you to loose these buffs.

Strain Per Turn is for things such as 'Horror Fend' charms or a Talent or Spell Effect that cause Strain every turn, but which might not have a separate dice roll that this strain can be attached to. It simply spends this much strain every time Initiative is rolled. If somebody goofs up and for some reason Initiative is rolled more than once, make sure you get this damage back for the extra rolls.

When the character is not a PC, an extra field and an extra button are appended for a Generic Attack. This makes NPCs a bit easier to run.

There are three Generic pools where you can keep track of anything you want. For example you can keep track of Woodskin health, Burning Vigor usages, or anything else that you need to keep track of here. Just put in the name of the thing you are tracking, and the number.

After the Stat block is every Weapon from the Equipment tab where you requested a Token Action be created. After each weapon is a button that you can use to roll for that weapons damage.

The 'Take damage' buttons are for your own token to accept damage. If the GM says 'give your character 12 points of damage minus your Mystic Armor', you could use these buttons. The 'Damage Target' buttons allow you to give damage to other tokens (so the GM does not have to take the time to do so himself). You just click a 'Damage Target' button, the system asks for a Target, you click a Token, a Pop-up appears asking how much damage to give, and you click Submit. There are three 'Take Damage' buttons and three 'Damage Target' buttons. The first has no armor subtraction, the others reduce the damage by the targets PA or MA respectively.

The tab concludes with a list of every Talent, Knack, and Skill that you have identified as having a Token Action. So you can roll these actions directly from the Combat Tab.

Talents, Knacks, and Skills Tabs

I am going to cover most Talents, Knacks, and Skills together, as they are almost identical.

Talents, Knacks, and Skills are created as needed. At the bottom of each section are two buttons: Add and Modify. Clicking 'Add' adds a new blank line. Simply fill out the name and all the other information as normal. After clicking 'Modify', the item you hover over is disabled except for two new buttons. On the right, a Red Garbage-Can that deletes that item, and on the left a Silver icon with three horizontal lines (Move within list). Dragging the Move control allows you to move an item higher or lower on it's list. Make sure you click 'Done' when done deleting and moving stuff which will put you back in the mode where you can make changes to the fields.

When you first create a new, empty line there is a text box where you can paste in text from a PDF to import the bulk of the information. In the PDF, select the entry starting at the Talent (or whatever) name, and continuing down to the end. If you get a chance, you might want to not select any tables, examples or sidebars and paste those into the notes separately. After you paste it in, the API should parse it out and fill out the values as well as it can. Always check each entry carefully, as not all of the fields can be interpreted correctly by the parser. Once a name has been entered the text import box will disappear. To make it reappear, blank out the name.

Each item in these sections has it's own detail control at the right top edge. When the Plus sign is selected it displays 'all details'. This is needed when the item is first entered, but rarely thereafter. The play icon (triangle facing right) is 'show most details'. This gives all the fields required for most normal play, but hides the esoteric details. The minus sign is 'hide all details' and hides everything except the very top row. Many users will want to keep all details hidden most of the time, then show most details for items that are actively being referenced.

For each item in each section, first we have a Roll Button, that makes a test using this Item. After that is a Step number that gives the current step value after accounting for Combat Options, Conditions, Adjustments, etc. The Name of the ability should be entered in the next field. Rank is a calculated field that is the sum of the Base Rank and the Rank Mods. For example if you have purchased 3 ranks (Base Rank 3) and have a Thread Item that gives you plus two Effective Ranks, this should display that you have an Effective Rank of 5. Action tells what type of action it is (Standard, Simple, Free, Sustained, or NA). Strain is how much strain it costs to perform the action.

Type is how you have access to this ability. For example 'Novice' means it is a Novice Discipline talent for your first Discipline. 'TO2-Novice' means it is a Novice Talent Option for your 2nd discipline. These values are used to calculate the amount of LP rank increases cost, so select this before filling in Base Rank. Questor Devotions should be entered on the Talents tab (even though they are not talents) using the 'QD' Types. Depending upon GM preferences and the power, Creature or Horror powers may be recorded upon the Talents or Knacks tabs as 'Creature Powers' or as spells. Note that the 'Versatility' Talent itself is a Racial Talent. Only Talents Gained through Versatility are of type Versatility. Talents that you only have access to because of a Thread Item can be recorded as Item Talents. Sometimes you may wish to setup 'Dummy' Talents to represent frequently made rolls that might not be separate talents, for example you might set up a dummy Awareness skill, though see the 'Knacks' section for how to set up even more flexible Dummy Knacks.

The Attribute value is added to the base step of every roll. Base Rank is how many ranks you have purchased. Rank Mods might be bestowed by Magic Threads. Step Mods give you additional Steps on your Rolls, but don't increase your Effective Rank. Result Mods are rarely used, but add or subtract to the result after dice are rolled. When reading Thread Item descriptions, be careful of the difference between a bonus to the Rank, and a Bonus to the Test. For example: lets say that you have a character with 6 ranks in Avoid Blow. 'Avoid Blow' would be entered in the Talent 'Name' field. The Attribute is 'Dex'. You have purchased 6 ranks in the Talent, so the base rank is 6. Lets say the character has a Lightning Bolt earring Thread item that gives plus two ranks in Avoid Blow, so Rank Mods would be 2, and Effective Rank would be 8. Lets say the character also has a different thread item that allows them to spend one extra Strain for a Plus 3 bonus to Avoid Blow tests. Lets say you decided that you will almost always be using this power, so you want it 'baked in' to your sheet. Simply put a 3 in Step Mods, and make Strain 2 instead of 1. Note that your Effective Rank is 8, which means you can use the power 8 times per round. But your Step has an additional plus 3 to every test.

It is very important that you pick the correct modifiers for the Talent. Most tests use 'Action Test' modifiers, but some use 'Effect Test' modifiers. 'Attack' and 'Attack Close Combat' are subsets of 'Action Tests', but signal that the test is an attack test (such as the 'Melee' Talent. 'Damage' and 'Damage Close Combat' are subsets of 'Effect Test's. 'Init Penalties' are for Initiative replacement tests such as Air Dance and Tiger Spring. 'Init Armor Penalties' are pretty much just for 'Jump-up' replacement tests. 'None' means the roll is never modified by anything (rare), and 'No Roll' means the talent is never rolled (for example 'Sprint' and 'Resist Pain' are never rolled).

'Special' indicates certain special functions, such as the test being treated as an Initiative roll, or a recovery test. Except for Air Dance, Fireblood, Etc. This will usually be 'None'.

The next fields do not appear, as such, in the official rules. These new fields are intended to clarify the Talents expected normal usage. You and your GM will need to use your judgment about how these fields should be set. 'Defensive' means the Talent is an 'Active Defense' and as such does not take a penalty from being in Defensive Stance. In general, only Avoid Blow, Steel Thought, Resist Taunt, Riposte, and sometimes Trick Riding are considered Active Defenses. 'Resistance' Talents do not take a penalty from being Knocked Down. This quality has NO support in the rules, but I added it because some things should not (in my personal opinion) be penalized for lying down. If anybody at your table has ever said "Stand up before you take a Recovery Test", or "Stand up so you can resist the disease or poison better", than you know what I mean. Recovery Tests, FireBlood, Iron Constitution, Lion Spirit, and other tests to resist things, should have the 'Resistance' button checked.

'NotMoveBased' is for tests that are NOT moved based and that DO NOT take a penalty for impaired movement. A lot of talents will qualify to have this checked, but very few Dex based ones or ones that involve moment will. This will require a lot more thought than other fields. Note that some movement options will allow you to move out of impaired movement situations, but would still be affected by other impairing situations. For example, a character in a crowd decides to climb a wall to get above a pressing crowd. After he gets above the crowd he no longer needs to have Impaired movement selected due to the crowd, but if he finds himself atop a wall with glass embedded in the mortar, he is in impairing terrain again. So Climbing does suffer from conditions that impair movement, but somebody climbing might be impacted or not impacted by different types of terrain than somebody on the ground. This will normally be adjusted by using the 'impaired movement' field, not by the NotMoveBased field.

'NotVisionBased' is for tests that DO NOT take a penalty for darkness or impaired vision. It is, again, a judgment call, but most Talents based on Per or Dex will not qualify as Not Vision Based. Think about whether the character could perform the Talent just as well with their eyes closed as open.

Target Number is a very important field to get right, and has lots of options. 'None' simply means that the test does not have a target number. For example your GM might frequently ask for 'Awareness' tests, but will almost never tell you whether there is a specific TN they are looking for. They just ask for Awareness tests and look at the results. 'PD-1' etc. means that the test is always against the corresponding attribute of exactly one token. The user will be asked to click one token and the system will look up that defense value.

'Ask' simply puts up a pop-up that asks what the target number is. 'Ask PD', etc. is usually used with Active Defenses such as Avoid Blow. A pop-up appears where the user may enter a target number, but they may also enter a number as being plus or minus a certain amount from one of their own defenses. For example, if the GM says that a creature hit their character "by 2" (ie: they got two above your characters PD), if their Avoid Blow talent is setup as 'Ask PD" the user could enter +2 to the pop-up and the system will know that the target number is 2 above the characters own PD.

'PD-v' first first asks how many attacks are being made. A question appears in the chat pane where the user can select a number of attacks, then that number of attacks are made. You can use this if a creature has two or more identical attacks, or if attacking with a squad. For example if you have three creatures, each with 2 attacks, you can simply have one creature roll 6 attacks, then use the other excess results when those creatures turns come up in the turn order.

'hMD' etc. is often used for spells. It asks for the number of targets, the user clicks all the targets, and one attack test is made against the highest MD among all the targets. 'mMD+1p' works exactly the same except the TN is highest MD plus one per additional target. 'MD-Nat' etc. uses the 'Natural' value of the defense, counting only the attribute and bonuses from Discipline. Spells, Threads, and everything else is specifically excluded from 'Natural' defenses. Some Talents have specific hardcoded target numbers, and these may also be specified in Target.

The usage of the Karma Control and DP Control fields to specify when Karma and DP are spent is explained above, as is Rolltype to determine who sees the roll result. 'Disp Text', also known as 'SuccessText' is displayed whenever a test succeeds. For uncommonly rolled tests you can put a brief message in here to remind you how this Talent works and what to do with the result. It will be displayed along with the roll results.

The 'SFX' button and field is used for Special Effects if you want them. You can have your fireball appear on the map or your sword cause a gush of blood. You can specify whether the FX will appear every time you attempt the Talent, or only when it Succeeds, What effect you want (there are 11 pre-programmed effects, plus with research you can learn how to do custom effects), what color you want (there are 11 pre-programed 'colors'. Note that the 'colors' are named things like 'acid' (green) and 'death' (black)), and whether the effect should occur at the casters location, the first targets location, all targets location, or travel from caster to first target to all targets. Note that only Beam, Breath, Splatter and Custom special effects can travel from the caster to a target. All others must affect only a single point, caster or targets.

Finally, you can specify whether the Talent should have a Token Action. Clicking Token action does several things. First, it causes it to be summarized on the Combat tab, so you can access it there. Secondly, it creates a Token Action, which will appear on the top of the VTT screen when a Token linked to this character is selected, so you can access this Talent when the Character sheet is not open. Note that in order to group Token Actions, all Talent Token Actions are prefixed with a small t, all Knacks are prefixed with a small k with a cedilla under it, and all Skills are prefixed with a small s with a cedilla under it. It looks weird, but I like having them grouped. I am open to suggestions on how it could better be done.

The full text of the Talent / Knack / Skill can be listed in the Notes field.

Knacks Tab

The Knacks tab looks a lot like the Talents and Skills tabs, but does not have a 'Base Rank' field, instead allowing items to be linked to Talents, Weapons, Attributes, and/or other Knacks. It will then use the 'Base Rank' or Damage of the linked item. It will use the Attribute listed in 'Attribute', but a 2nd attribute could also be linked if needed.

One usage would be a standard Knack. For example a 'Destructive Shout' can be linked to 'Battle Shout'. the Knack would use 'Wil' as an attribute even though the base Talent uses 'Cha'. The Strain and everything else is set to be correct for the Knack. If the Base Rank of the Talent is increased, the linked Knack also automatically increases.

Another example would be a double talent. Make a Knack named Tiger Dance, link it to both Air Dance and Tiger Spring. Set the Strain, etc. to combine both the base talents. Attribute is 'Dex', Modifiers is 'Init Penalties', Special is 'Initiative'. Type is Dummy. Selecting this one Dummy Knack will roll inititive with both Air Dance and Tiger Spring.

A third example would be combination attacks. You could create a dummy knack linking your favorite Weapon and the 'Surprise Strike' Talent. The attribute would be Str, modifiers would be 'Damage'.

To setup a link, use the 'Do Stuff' button and select 'Link'. Select the category to link to, then enter an exact match (including capitalization) for a substring of the name that you are linking to.

The Base Talent, Requirements Rank, and Restrictions fields are for information only.

Spell Tab

At the top of the tab is 'Spellcasting Talent Details'. You will normally keep details hidden. At the top all the spellcasting Talents are hard-coded. These spellcasting talents should NOT be entered on the Talents tab, only here. Check the boxes for the Talents the character has. You also need to set your Rank Bases, Rank Mods, and Step mods.

In the bottom section, you can add spell Matrixes. Only the first 5 fields of the matrix section describe the matrix itself, the rest of the fields describe the spell in the matrix. The Spell fields will be described under the Grimoire tab.

If you have more than one Spell that can share a matrix, you should create 'sharing' matrices for the extra spells. For example, if you have two 'free' Standard matrix's, and have purchased one Standard matrix as a Talent Option, and you put both 'Ephemeral Bolt' and 'True Ephemeral Bolt' in one of them, you would do this by putting one of the spells in one of the matrix's (See Grimoire tab), and making a 4th matrix, of type and origin 'sharing' to put the other one in. Remember that the extra matrix(s) only exist when you have the correct spells loaded into your real matrix's.

To cast a spell, press the 'Cast' button. There are 4 options under that button. 'Start new Casting' resets number of threads pulled back to zero, displays how many threads are required, and allows the caster to choose optional threads they intend to pull. Weave threads weaves threads. Cast causes the system to ask what the targets are and roll the spellcasting dice. Effect rolls the Will Effect and generates buttons to apply damage to targets.

You can also use the Spells Tab to implement Creature or Horror powers, especially if you consider the power more spell-like than Talent-like.

Grimoire Tab

The Grimoire Tab has another set of tabs within it. You may choose to only display spells of a certain circle, or all spells. To add new spells, press the 'Add' button at the bottom of the list. A blank spell will appear. Type in the name, then set the Discipline field (El, IL, Ne, Sh, Wz, Other, Power), and Circle field. Threads is the minimum required to cast the spell (not counting any Extra Threads the caster may wish to add), Casting is the target number, often hMD (Highest Mystic Defense among all targets). Range and AoE (Area of Effect) allow free-form input, but should match what is in the spell description in the book.

You can import spells from a PDF via Text Import similar to how described under Talents. Copy all the text starting at name.

The 'Duration' Field is locked to direct input. Use 'Do Stuff' and 'Edit Duration' to set the duration field.

Not all spells have a Will Effect, but if it does the Will Effect and Effect Armor fields should be set. The 'Other Effect' field allows free-form input. Use the 'Success Levels' field to select the option that most closely matches what the spell is to do with extra successes. You can enter anything that you want in 'Disp Text' (Display Text or Success Text). This text will be displayed when the spell is successfully cast, and can be used to remind yourself of side effects.

Use 'Do Stuff' and 'Add Extra Thread' to set what extra threads allowed for this spell do. Use 'Do Stuff' and 'Set FX' to optionally add special effects to the spell. This works exactly like Talent FX, so see the Talents section of this Wiki.

You can use the 'Notes' field to list the full text of the spell so that you have it for reference.

You may cast a spell directly from this tab by using 'Do Stuff' and the 4 GC (Grimoire Cast - work almost exactly like the Matrix buttons. ) entries. However normally you would copy the spell into a Matrix and then cast it. 'Do Stuff - Attune' asks which of your existing matrices you want to move this spell into. Create Matrix and Attune creates a new Sharing Matrix.

Equipment, Gear, and Notes Tabs

The Equipment tab gives spaces for listing Armor, Shield, and Weapons. Plus optionally room for stats for mounts, thread items, and other magical threads (such as group patterns). Wherever possible, the values listed here are used elsewhere on the sheet. For example your armors PA is included on your characters PA on the combat tab.

Gear, in general, is simply recorded, but the values are not used anywhere else. Lifestyle is not official rules, just something from my home campaign. The large field at the bottom can be used for free-form inventory.

The large field at the bottom of the Notes tab can be used for anything you want. There is a 'Release Notes' section at the top that can be hidden. When a new version of the sheet is released, it might cause all characters to display the release notes the first time the sheet is opened. After reading the release notes for the current version, this section can be hidden.

Record Tab

The 'Record' tab is where you can record gains and expenditures of Legend Points, Silver, and other things. At this time the large field at the bottom can be freely edited (this may change in future releases), but the idea is that you will use the fields and buttons to post entries into that larger field.

There are two date fields. One is for the real-world date, the other is for the campaign date. When you press the 'Update Dates' button the real-world date will be filled in using your computers date. If there exists a character named 'Party', then whatever date is in the 'Throlic Date' field will be copied into the current characters 'Throlic Date' field. Thus the GM can keep the campaign date current and all players can import that date.

Simply set whether you are recording changes to LP, SP, or something else, and the amount. Whether it is a Gain or a Spend, and a brief description of the transaction, then press 'Post'. For example. LP, 3000, Gain, 'Session rewards for storming the castle'. An LP Gain will increase both the current LP, and the Career LP. A Spend posting will only decrease the current LP. A Decrease or a Refund are made for backing out mistakes. For example a Refund of LP will add the LP back into current LP without adding it to career LP again.

The various accounting routines will also post transactions here. For example on the Skill tab, if you increase a Novice Skill from rank 3 to rank 4, a chat window message will appear saying how much time, LP, and training silver that normally costs, with a chat window button saying to press it to record these costs. Upon pressing the button pop-ups will appear asking for confirmations on each amount, and when submitted will cause the expenditure to be posted to the record tab.

Adjust Tab

At the top of the Adjust tab is an Advanced section that may ether be shown or hidden. See the next section of this document for details of that section.

Almost everything else on the Adjust tab is calculated or entered on other tabs, and this is the place where more or less permanent adjustments should be made. For example: If you tie a thread to an item that gives you a +2 to Physical Defense, you should add the +2 on this tab. Buffs and other temporary modifications to Defenses and Armor should be made on the Combat Tab. It is a very good idea to use the notes field at the bottom to document the reason for each adjustment.

'Blood Magic' is one field that is not anywhere else on the sheet, but it adjusts your Unconsciousness and Death ratings as explained in the rules. 'Aggressive Strain' and 'Aggressive Penalty' are really only used for Sky Raiders as for everybody else the values are always '1' and '3' respectively.

At the bottom of the Adjust Tab is a Notes field. Document every permanent or semi-permanent adjustment there. You or your GM should be able to glance at these notes and know why every adjustment has been made. Example typical entry might be "MD +3: +1 Wiz 2nd, +2 Group thread."

Adjust Tab - Advanced

At the top of the Adjust tab is an Advanced section that may ether be shown or hidden. Most players, after linking the character and deciding whether or not to hide his 'spell' tabs, can close this section and ignore it forever after. There are however some fields that the GM needs to know about.

In the 'PC?' field, you can specify whether the character is a PC, NPC, Mook, or Object. Mooks are linked differently, such that multiple Tokens can share one character sheet. Objects tell the system to not roll initiative. A few fields (the generic attack) are not used for PCs.

'Announce Turn' is used for 'Status Tracker' integration. If the 'Status Tracker' API is used, then if this is checked it will announce in the chat window when it is this characters turn.

Most buttons have an associated 'Roll Type' field, that determines who will see the result of the roll. Public (Everybody), Player and GM, GM only, or Default. The 'Roll Type' field in the Adjust - Advanced section is the global control that determines what the 'Default' is for all the other controls, GMs who do not want players to see NPC dice rolls should make the rolls 'GM only' here for each NPC.

'Hide Spells' hides the 'Spell' and 'Grimoire' tabs. If the character is not a spellcaster, you might as well get rid of those tabs as you don't need them.

the 'Special Function' drop-down, and the 'Do SF' button together combine to perform a lot of miscellaneous functions. First you select the Special Function you want on the drop-down list, then press the 'Do SF' button. The following Special Functions are available:

  • Link Token: It is very important to link your tokens. You only ever need to link a token once unless you change the Avatar picture. Mooks should only be linked after you have their health and karma maximums set, others can be set anytime after you have your Avatar picture set. To set the Avatar picture, click the 'Edit' button at the very top of the character pane. find a suitable picture (probably from the Internet), and drag it onto the place for the Avatar. Save it. To link the token, drag the character name (not the picture) from the character journal to the VTT. Select the new token. Back on the character sheet, go to 'Adjust - Advanced - Special Function - Link Token' and press 'Do SF'. It will link the token to the character sheet. New tokens dragged from the character journal to VTT for this character will have properties (aura, sight, light, Etc.) similar to token as it was when you linked it.
  • Recalc: You don't need to press the 'Do SF' button to make this function work. Just setting the drop-down to this value from something else will cause the sheetworker to recalculate all the values on this sheet.
  • Set Adjustments: When typing in a creature from an outside source such as a book, it is usually easiest to set the stat's on the core tab, then go to 'Combat' tab and enter buffs/debuffs until the various values are all correct (death rating, wound threshold, etc.). When everything is correct on the 'Combat' tab, you can then come here and use 'Set Adjustments' to transfer all the adjustments on the 'Combat' tab to their corresponding values on the 'Adjust' tab. This zero's out the Combat tab and those values are available again for buffs and debuffs.
  • GM: Special Commands: See the section 'Options available to make the sheet behave differently'
  • Macros: You can create all the macro's needed with this sheet or delete them. Refresh causes them all to be deleted then created again.
  • Import Creatures and Import Masks: This is similar to importing a Talent or Spell. A text box appears and you can paste an entry into it. A whole creature description starting with the name, and including everything in the standard format - except try to avoid including examples or sidebars). When importing a mask, import only the mask section being used. For example the mask section "Fast" includes three subsection masks, fleet, swift, and quicksilver. If you want the middle mask, you would start copying at "Swift (+1 Circle)" and continue on until just before the "Quicksilver" entry starts. After importing a creature or a mask, it is important to check all the Maneuvers and Powers. Many of them will just be stubs, with most of the values not set correctly. The user will need to set these powers correctly.
  • Mask Remove attempts to back out a mask, but again everything should be checked to make sure it was done correctly.
  • Verify/Fix Repeating Sections: This should rarely if ever be needed, but this goes over all of a characters repeating section entries and looks for errors. Try this if things look corrupted.
  • Inspect: This is debug code. This will produce buttons in the Chat window that allow you to inspect various stuff. The normal Roll20 tools allow you to see simple values, but it is difficult to inspect values contained within repeating sections. 'Lookup Value' allows the entry of an attribute name (simple or whole repeating section name), and gets the value. 'IDs from Name' allows the entry of a text fragment, and get IDs of every repeating section name that contains that fragment. 'TokenObj' is Test code to cause selected tokens to display TokenInfo to chat. 'Repeating Section' is Test code to show information on a row. 'Object ID' is Test code to show information on what an ID is. Character ID, Token ID, etc. 'Statusmarkers' is Test code to cause selected tokens to display statusmarkers to Chat.
  • Status to Token: This sets the character sheets tokens status markers to match the character sheets status'. This is done automatically when you drop a token from the journal onto the VTT. Character sheet status changes are automatically copied to tokens on the active page, but if switching back and forth between multiple maps, status markers and status' could get out of sync. Players or GMs can use this to get them back into sync again.
  • Earthdawn Test: This is a debug code stub that runs a test routine.
  • showEach API: This is a debug code stub that displays whatever attributes I have currently hard-coded it to display.
  • Sheet Worker Test: This is debug code. A test routine is run by a sheetworker when the drop-down is set to this value (no need to press the 'Do SF' button).

Test Worker Thread is a debug tool to test if the sheet-workers have been messed up. If you change the first value, the 2nd value should change to match. If it does not, then the sheet-workers are messed up, If closing the sheet and refreshing your browser does not fix it you will need to contact the sheet author).

There is a list of Creature Powers and Opponent Maneuvers that may apply to this character. Normally these are for NPC creatures, but 'Resist Pain' may be used if the character has that Talent. 'Dive/Charge' should be used for any creature that has ether 'Dive' or 'Charge' (since the two powers behave in almost identical ways). Note that 'Ambush' and 'Dive/Charge' have a checkbox that should be checked if the creature is actually using that power. For example, an Eagle has 'Dive (5)'. 5 should be put in 'Dive/Charge' and should always remain there, but the GM should only check the 'Diving/Charging' box when the creature is actually diving or charging.

Only the most common creature powers are hard-coded in. There are fields where up to three additional powers may be listed with a name and a Description.

There are also some common Opponent Maneuvers hard-coded, along with space for up to three additional Opponent Maneuvers.


How to install this sheet

Note: This sheet is tightly integrated with it's API. It works best if you have a Roll20 'Pro' level account and install both the sheet and the API. If you do not have a Roll20 PRO account, you only need to do the first part of these instructions, and the sheet will still work with limited functionality without the API.

  • It is really easy to install the sheet. Create the campaign in the normal Roll20 way. Go to your main campaign page. As GM you should see a drop-down menu labeled with a gear icon and the word 'Settings'. Choose 'Campaign Settings' from that. On the Settings page, you should see a drop-down list labeled 'Character Sheet Template' It is probably currently set to 'none'.
  • The 'Character Sheet Template' list is in Alphabetical order. Go down and select 'Earthdawn (FASA Official)'. There will be something that tells you which sheet you selected, and you can click the 'Save Changes' button.
  • Go up to the top of the page and press the campaign name to return to the main campaign page. On the 'Settings' drop-down select 'API Scripts'. On the new page, the 'Script Libraries' tab is probably already selected. If not select it. Within the drown list, Under the 'System Toolbox' section Select 'Earthdawn (FASA Official) character sheet companion' It will ask if you want to 'Add Script' or 'Import' it. Importing it gives you a copy of the script that you can look at and change. However when I make updates to the script, you will not get the updates, nor even be notified of them. If you 'Add Script' then you always run the most recent copy I have uploaded.
  • It will tell you that the script does not work without 'HTML Builder' and ask if you want to load that as well. Say yes.
  • It will not insist that you add 'Welcome Package' but I highly recommend that script as well. Welcome Package will automatically create a new character for each player you invite to join your campaign. There are many other fine scripts that you may optionally learn about and add.
  • Start the VTT and create any character. Go to the Adjustment tab - Advanced section. In the 'Special Function' drop-down list, choose 'Macros' and press 'Do SF'. Choose 'Macros - Create' and submit. In the chat window 'Collection' tab it should have created some macro's. Click that you want 'Roll-public', 'Roll-player-GM', 'Roll-GM-only' in your macro bar. Recommend to each of your players that they also put those three macro's into their bar. They are useful for making ad-hoc rolls. As GM you should also add 'NPC-ReInit' to your bar. This will clear the Initiative tracker and re-roll initiative all the non-dead NPCs that were there. You can use this macro at the start of every round after the first when Initiative is rolled.

You have now done everything needed to install the sheet, however also read the next section.

Options available to make the sheet behave differently

Open any character sheet. go to the last tab (Adjust). If 'Advanced' is hidden, show it. in the 'Special Function' drop-down, select 'GM Set State variables'. Click 'Do SF'. Assuming you are a campaign GM, A bunch of buttons will appear in the Chat Window that will allow you to change how the game operates.

  • Change Edition: Depending upon which character sheet is loaded, By default the campaign is set to ether Earthdawn 4th edition or 1879 1st Edition and the sheet tries very hard to automate all the correct rules it can. You can change it to Earthdawn 3rd or 1st editions. Not as many 1st and 3rd edition features are implemented, but when set appropriately, it will use the 3rd edition step dice tables, Shields will improve armor instead of defense, etc. GMs that use other editions may contact the sheet author if they want to work with me to automate other editions behaviors.
  • Result styles: The default is to be vague on what the exact dice roll was (Vague Roll). Other choices are Full Results, and Vague Successes. Which is to say, assuming you are doing a roll against a creatures PD. If the campaign is set to give Full Results, it would say that your TN was 8 (or whatever the Targets PD was), that you rolled a 5 and a 4 for a total of 9, and that you succeeded by 1. This might be more information than the GM really wants to give out about the monsters PD. With the default Vague Rolls, it does not tell the player the TN nor the total of the roll. It merely tells the player that their roll succeeded by 1. They don't know if the target's PD was high and they rolled very well, or if the target number was low and they rolled poorly (but good enough). When giving vague rolls a separate message is sent to the GM giving the TN and the exact dice rolled. The third option of 'vague Successes' did not work out very well and is not recommended. It tells the player the number of extra successes without saying exactly how close to the target number the roll was.
  • Default RollType: By default PCs default to public rolls, but NPCs and Mooks default to rolls visible only by the GM. This can be changed.
  • Token Link Options: By default, when NPCs are linked, Nameplate and Wounds are visible to players, Damage and Karma are not. For PCs, the Karma bar is not visible to players other than the owner of the character (This is to reduce clutter). This can change those defaults.
  • Effect is Action: This defaults to 'false'. In general, Action Tests are actions that you can take, Whether Standard Actions, Simple Actions, Free Actions or Sustained actions. They often have a Target Number or can be Failed. Effect Tests are things like damage rolls, spell effects, recovery tests, etc. While they may roll poorly, they can't be said to Fail. There is a philosophical disagreement as to whether Effect Tests are Action Tests or not. It is discussed in detail (Here) but the DL is that the book uses "All Tests" as shorthand for "All Action Tests", The book seems to be mostly written with the assumption that All Tests are Action Tests, but a large number of GMs, including some of the developers, play that Effect Tests are not Action tests. The result of this is that sometimes when the book says a penalty applies to "All Tests", the GM might not want it to apply to Effect Tests. If this state variable is set to true, then Effect Tests are Action Tests. Everything that applies to Action Tests automatically apply to all dice rolls (including Effect Tests). If this is false, then then there is another field present at the top of the 'Combat Options & Conditions' section where you can specify modifiers that apply to Effect Tests as separate from Action tests. You can separately apply bonuses or penalties to Action Tests, Effect Tests, or Both.
  • Curse Luck Silent: Defaults to 'false'. By default the system announces when a dice roll has been affected by Cursed Luck. However the possibility exists that some GMs might want it's effects to be unobtrusive. When this is set to 'true', then the program just silently changes the dice rolls without announcing it.
  • No-Pile-on: Dice. This option is for if a GM desires a less lethal game, or to reduce risk in specific encounters, they can use this option to keep NPC dice from exploding too many times. This controls the maximum number of times a single dice can 'explode' (be rolled again after rolling a max result). -1 is the standard default of unlimited. 0 means no dice will ever explode. 2 (for example) means a dice can explode twice, but not three times. This is done quietly, without announcing it to the players.
  • No-Pile-On: Step. This option is for if a GM desires a less lethal game, or to reduce risk in specific encounters, they can use this option to keep NPC roll results from exceeding a specific multiple the step number. If zero or -1, this is disabled and roll results are unlimited. if 1, then the dice result will never be very much greater than the step result. If (for example) the value is 3.5, then the result will never get very much greater than 3.5 times the step being rolled. This is done quietly, without announcing it to the players.
  • API logging: By default the API writes a message in the console log whenever it starts. It can also write a message in the console log whenever it receives an API command. This is basically a debugging option. See the 'Debugging' section below for when you might want to use this.
  • Version: You can change the API version number stored in the state. This can force character sheet update routines to be run next startup.
  • ToAPI: ToAPI will set all sheets to use API. FromAPI will set all sheets to use noAPI buttons and remove all Earthdawn state variables (can be run just before deactivating API or uninstalling sheet to clean things up).

Tips on how to quickly enter Creatures and other NPCs

By far the easiest way is to use Text Import to import a creature from a PDF or other text source as described in a previous section. Create a blank sheet, go to the "Adjust" tab, in the Special Functions select "Creature Import" and paste a creature description into the little box. Paste everything from the name at the top to the very bottom of the description. Then check to make sure all the powers came in OK, sometimes the importer misses something. Assign a portrait picture, drop a token, and link it.

When importing a spirit, the process is slightly more complex. First set the "Discipline" to Spirit and the Circle to the spirits SR. Then follow the procedure for importing a creature above. Where the importer see's a formula that includes "SR" it will substitute the circle number you entered into the formula.

Another great way to get something new is to take an existing creature and apply a mask, creating an exciting and new difference. You can also just reskin an existing creature, give an existing creature a new name and Avatar, and rename some of its powers. For example with minimal work you could reskin an Ice Flyer to be aquatic or a monkey to be strange bird. If you do it right the players might never realize they are encountering a creature that has almost the exact same stat's and powers that they have seen before.

Even if you can't use Text Import, there are a number of shortcuts that can be taken while entering creatures, both to make data entry quicker, and to make it easier for the GM running the game.

  • I recommend starting by loading the Avatar picture, then dragging a copy of the token to VTT, and selecting the token, then working on the character sheet. You can't link the token until the picture is loaded, and some rolls work best when a token is selected when you make test rolls.
  • Very early in the creature data entry process, you should visit the Adjust tab, and in the advanced section, in the 'PC?' drop-down, select NPC or Mook. This will turn off the LP accounting routines, so it will not keep telling you how much LP everything costs. NPCs and Mooks are linked differently. See the end of this section for more details on linking.
  • If you want to have a small library of tokens that characters can pull down to the VTT and manipulate, you can make "characters" that are torches, light crystals, wagons, Etc. If you list them as 'Items' in 'PC?' then the system will never attempt to roll their initiative. You can also list mounts as being 'Items' so their initiative will not be rolled, However you can still list movement rates, defenses, and hit points for these tokens and they are valid 'Targets' for Talents that target tokens.
  • Creature statistics in the Books are usually not listed with full attribute values, only with attribute steps. On the 'Core' tab attribute steps can be entered directly into the "Base" column. This column is colored like a calculated field, but it can be edited. If a value is set into the Base field, an appropriate attribute value will be calculated for the AP (Attribute Point) column (however you can ignore the AP column).
  • Usually you will need to fine tune various values. For example a creature might have higher health ratings than its Toughness step alone would account for, or different defense ratings than their attribute would normally give. For quickest editing these can be seen and adjusted on the 'Combat' tab. Simply increase or decrease the associated 'buff' field until the total value is correct for the creature. Normally the combat tab is for entering buffs and debuffs, permanent adjustments should go on the Adjust tab. When all the values are correct, go to the 'Adjust' tab, 'Advanced' section and in the 'Special Function' drop-down select 'Set Adjustments' and press 'Do SF'. All the Buffs on the Combat tab will be transfered into Adjustments on the 'Adjust' tab, and the buffs will be reset to zero.
  • You don't necessarily have to enter all of a creatures powers separately. If some of the creatures powers have the same step and behave similarly, they can often be combined. For example if a creatures Bite and Claw attacks steps are the same, instead of entering two separate attacks, simply enter both as a generic attack. As another example, If all or some of a creatures powers that target MD have a similar step, they can be combined into one Creature Power, and all of the powers that target SD and have a similar step can be combined into one other power.
  • When you mark a character as an NPC (see the tip a few entries higher in this list), The system automatically shows a new field on the Combat tab labeled "Attack" and creates a token action for it. Rather than needing to enter a skill or talent for the most common attack step that targets PD, this has already been created and you can simply add the monsters rank to that field. Damage can simply be entered as weapons on the Equipment tab. For example weapon Bite and weapon Claws. Remember to click the CC button if it is close combat damage, so that the damage will be adjusted correctly if you have the creature aggressively attack or go defensive. Also remember to click the Token Action box so a token action is created for those 'weapons'.
  • Similarly, creature powers that target MD and have a similar step can be easily simulated by using the pre-programmed spell-casting and will-effect buttons that are already there, however the GM will need to know that this is how they were entered and check which powers use the generic spell-casting / will effect values.
  • While the most common and simple attacks and powers can use the Generic Attack Button, and the Spell-casting value, other, more complex or uncommon powers could be entered as ether talents, skills, spells, or knacks. It is up to you as to which is easiest to enter and easiest to understand and use while running the game. If you do enter the powers as spells, enter then on the Grimoire tab, on the spell tab create a fake matrix for each power, and load the spell into the matrix. This will create a Token Action for that effect.
  • When Powers are entered as Talents or Skills, the important things are Attribute, Base Rank, Target, and Modifiers. Most powers will use "All modifiers", except of course Attack and Damaging powers. For Damaging powers, you also have to set what armor reduces the damage.
  • Make sure you click the 'token action' checkbox for commonly used attacks and powers.
  • You will need to link your token. NPCs are linked exactly like characters, with the character sheet tied to a token. Changes to the token (damage, wounds, karma spent, etc.) changes the character sheet and visa versa. As a side effect of this, if you have two tokens on a map both linked as PCs or NPCs to the same character sheet, adding damage to one token gives the damage to both. This is bad. Mooks are linked a bit differently, and damage given to one token is not also given to the character sheet, nor all other tokens of the same creature. For Mooks it is important that linking be done after the health (unconsciousness rating and death rating) and karma (if any) have been correctly set. Go to the adjustments tab, Advanced section, and make sure "link token" is selected in the special functions drop-down list. Make sure the correct token is selected on the VTT. Click the "Do SF" button. The token will be linked, such that the health ratings, karma and wounds will be set, as well as other good stuff. Note that it is OK to link a character multiple times. If for example in your first encounter you want one copy of a monster, you can link it as an NPC. If on another day you want more than one copy of the same monster, simple make sure the character sheet is clean and correct and link it again as a Mook. Then just drag extra tokens to the VTT. See "GM Tips" below for how to link multiple tokens as NPCs instead of Mooks. If you don't like using tokens linked as Mooks, you can install the script 'DupCharToken' and use it to make multiple copies of character sheets and tokens linked as NPCs.

Other GM Tips

  • If you create a character named 'Party' and on the 'Record' tab put a date in the 'Date - Throalic' field, then whenever anybody on any other sheet presses the 'Update Dates' button, the date from the 'Party' sheet will be copied to their date field. That way the GM can update the campaign date in one place, and everybody can get it from there. If you give everybody the ability to edit the sheet, then the 'Party' character sheet is a good place for the party treasury, supplies, etc. You can also move a 'Party' token around a large scale map.
  • You can easily add or remove Masks to a creature. See the 'Adjust - Advanced - Special Functions' section for more information.
  • Some GMs like Mooks, Some hate them. You can ether use them or not. As discussed in the previous section, if you want to link your tokens as mooks, Simply do so, but remember that all tokens of that character will share the character sheet. If you click "Knocked down" or "Harried" on the character sheet, then all the tokens using that sheet will have that condition.
  • The alternative to using Mooks is to have multiple character sheets for the same type of creature, one for each token in play. This can be done manually, but the easiest way is to use the "Duplicate a Character and Token" API (DupCharToken) from the API Script Library.

GM FAQ and Frequently encountered problems

The sheet looks different, Most of the "Special Functions" are not there

The sheet has two modes, API and Non-API. The Non-API mode has all of the fields and functions that require the API to process removed. The GM must have a
info account and have the "Earthdawn FASA Official character sheet companion" API installed for API mode to work. Each individual character has an attribute that flags if it should be displayed in API or Non-API mode. If, when the character is created, the API is not working properly, the flag that tells it to display in API mode will not be set. If a few characters are in the wrong mode, you can go to the Attributes and Abilities tab and look for an Attribute named API. If it does not exist create it. If it does not exist, or is set to zero, the sheet will display in Non-API mode. If API is set to 1, then it will display in API mode.

If The API does exist, but many sheet are in the wrong mode, you can go to Special Functions, GM: Special Commands, and press "Do SF". Then in the chat window press "ToAPI".

Debugging and other GM information

Sad to say, but sometimes the API crashes. Usually it is a bug in the code, and will always crash at the same time in the same place. If the buttons and Token Actions stop responding, you need to open another browser window, go to your campaign main page, select 'Settings - API scripts', and if there is an error message, make note of what the error message is (just copy it into a notepad or or email or something). Then press the 'restart API' or 'Save Script'.

If you yourself manage to figure out what was wrong, and fix it. Also please PM me with the solution. ie: if there is a certain sequence that generates an API error, I would like to know about that sequence so that I can have the code check for it, so that it recovers rather than throws an error.

However in order to debug what is going wrong, I will almost certainly need to know exactly what was going on when the API crashed, and the error message it throws out is almost never enough information. It the API is acting buggy, and the API is repeatedly encountering fatal errors, try to repeat the last few things that were successfully done, and try to figure out the exact sequence that throws the error. Go to the GM State settings (as described above) and select the option that tells it to start the API logging command lines. Leave a tab of your browser open with the API Scripts page. Every time the API does anything, it will be logged to the console log. The next time the API throws an error, copy the last few lines of the console log, and the error message. Send them and a detailed description of exactly what was being done in a PM to me. You might also need to invite me to be a GM in your campaign so that I can look in detail at the character having the problem. Finding obscure bugs is hard. Sometimes I don't find them because I never attempt to have the sheet do certain things, or configure it certain ways. The only way I can fix bugs is if I have very detailed bug reports that tell me exactly what was being done, and exactly how it was different than anything I have ever tested.

There are a few debugging entries in 'Adjust - Advanced - Special Function'. Particularly 'Inspect'. That is covered in section 'Adjust'.

Copyright and Legal

Earthdawn® (FASA Official) Character sheet and associated API by Christopher D. Dickey. Approved by FASA.

Earthdawn® is the sole property of FASA Corporation, and is protected by copyright, trademark, and other intellectual property laws. You are granted a limited, revocable, non-sub-licensable right to access and use character sheet and associated API solely for personal and non-commercial use. This character sheet is meant to be compatible with the Earthdawn® game from FASA and the Roll20 Earthdawn® Compendium (Forthcoming). Any information copied into this character sheet or this WiKi maintains it's original sources copyright, whether it was copied from the Compendium, or copied or typed in by the user, or by any other means.

Any use of FASA Games, Inc.’s Intellectual Property other than as specifically authorized by FASA Games, Inc. is strictly prohibited and will terminate the rights granted herein.

Earthdawn® is a registered trademark of FASA Corporation. Earthdawn® and all associated trademarks and copyrights are used under license from FASA Corporation.
FASA and the FASA Logo are trademarks of FASA Corporation and are used under license from FASA Corporation.