Roll20 Wiki

Latest revision as of 15:38, 12 October 2023

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

[edit] 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, and navigate to the "Overview Section".

[edit] Character Creation

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)

Character Creation Screen

Step by Step Creation Process
Begin by entering a name for your character in the header, and define it as a PC (Player Character) The Dropdown will allow you to select your Discipline and Race, but they can also be dropped from the Compendium. Racial Abilities, and Durability will be automatically computed. If an Unrecognized Race Name is entered, system will consider it as homebrew and you will be able to edit directly the Racial Attributes 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 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 be calculated automatically for official ED4 Disciplines and Paths, but can also be entered manually in the Parameters-Character Tab Here you can create your Talents. For ED4 official Disciplines a button will appear that allow you to create the listed Discipline Talents and get a choice for the Talent Options. For NPCs or Homebrew Disciplines, Talents can also be dropped from the compendium, or their name can be filled from the dropdown list to be searched in the local database, or an Import box exists where 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) 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. Racial Abilities are automatically Determined by your Race. Racial Talents have been created automatically Equip your character by navigating to the Equipment Tabs Flesh out your character by filling its Bio and Description back in the Overview Tab Drag and Drop on the map a picture that will be used as your token. Click "Link Token" Button End up the creation mode by clicking the button "Exit and Post". Note that this will memorize how you spent your free ranks for future Legend Points Calculation. If for any reason you don't want to memorize it (maybe you have already a value you don't want to overwrite), use the "Exit No post" button You’re (almost) ready to play !

[edit] Token Linking

It is very important 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.

Roll20 creates a link so that every time you drag and drop your character to the sheet, the linked token will be dropped on the map. (Note it is important to drag and drop selecting the name of the character and not its portrait)

In addition, the Earthdawn character sheet links the Karma, Damage and Wounds of the character sheet to the status bars of the token so that you can edit these 3 values from either place, and the API synchronizes your status and combat options, and your modifiers to the markers on the token

Token Linking Process
The process below assumes you have the "Earthdawn by FASA character sheet companion" API installed. If you don't have the API installed, follow the procedure in the link at the top of this section. Drag and drop an image on the map (can be done from a picture on your computer, from the roll20 image library, or by setting an Avatar to your character in the Bio & Info, and then dropping it on the map) Select this token. Click on the token and on the cog to set any token parameters you need (display of the name, aura, dynamic lighting), and adjust its size if necessary If you are in Creation mode, go to the bottom of the overview, and use the Link Token Button Alternatively if you closed the creation mode without linking or want to relink to another token, go to the Parameters/Sheet/Special Function dropdown. Select 'Link Token' and use the 'Do SF' button In both cases make sure your token is still selected on the VTT before pushing the button. You should get text saying the token has been linked. Note : For each Token, Roll20 can store an Avatar and a Token. The above process will set the Avatar as being the token. Edit the Character to access the Avatar if you want to have separate Avatar and Token images.

-

[edit] Basic Concepts : API, character sheet & Compendium

The Earthdawn character sheet(source code) is optimized for 4th edition, but currently has limited support for other editions. In its version without API freely accessible to roll20 Free and

Plus

^{^info} level subscriber, it integrates basic functionalities.

Overview of Functionalities without API
Character sheet Basic Step Dice Roller Basic Targeting : when ability with a target is rolled, selection of single target and comparison with appropriate defense Calculation of the steps according to combat options and statuses Calculated LP tracking, and transaction based with manual transactions (no detection that you changed a rank) Importing Creatures, Talents, Spells, Etc. from text will not work.

The sheet is tightly integrated with the Earthdawn companion API(source code), and as such the GM must be a

Pro

^{^info} level subscriber in order for this sheet to work at maximum functionality. The API will unlock many advanced functionalities.

Overview of API Functionalities
Follow up of Karma, strain, recovery tests… when an ability is rolled Recovery tests reduce damage, Initiative, and Initiative Talents are sent to turn tracker Calculation of extra successes. Attack Successes will be added to next damage roll Enhanced Targeting : multi-target spells and talents. Application of damage to target Management of creature/opponent maneuvers (display only) Automatic LP Transactions when you change a Rank or an ability Eye on the map ! “Token Actions” buttons allow quick access to the main functionalities from the VTT Eye on the map ! “Token Markers” allow to change combat options and status from the VTT Linking between abilities Spellcasting Sequence management Matrix Attuning 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 Importing Creature, Talents, Spells, Masks from the PDFs Special Effects (SFX). And much more… See the API section in this Wiki for more details on advanced functions.

Finally the character sheet and API have been built closely linked to the Earthdawn Compendium, that can be found on roll20 Marketplace. The Compendium is a structured copy of the content of the sourcebooks, that allow various functionalities:

Search through the whole book (all the headers are indexed)
Drag and Drop "stuff" directly on the character sheet to add it to your character (Talents, Spells, Disiciplines, Races ... )
Drag and Drop Creatures, Horrors, Dragons, Spirits, and NPCs (and even Traps) directly to the VTT... A new character will be created, with a Token with the best art available from the history of the game. Opposition to your PCs is one drag and drop away from your next combat

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

Pro

^{^info}

[edit] Basic Concepts : Action Tests from the Character Sheet

Once you character is created and your game begins, you will find in the sheet several buttons for your attributes, Talents, Knacks, Skills, and all/most of the possible tests that you can have to make. The sheet calculates the step to be rolled based on your base step (for a Talent based on the Rank and Attribute), any permanent adjustment, and any temporary modifiers. You have in the header various clickable icons for combat options and situations for which the modifier is calculated automatically according to the rules. You have also visible on the Combat tab (but can be displayed on any tab), a global modifier that will set a modifier for all appropriate rolls (for example all actions, or all attacks, or damage) When you click the button, depending on the setting for the Talent, various pop-ups will appear:

An additional modifier to the step
With API If Karma is in Auto, asking the number of Karma dice to be added (will reduce your Karma Pool accordingly)
Without API, the Karma Step you want to add
And depending on the setting, a Target (either a Target Number or a Target Token on the map)

[edit] Basic Concepts : Eye on the map with Token Actions and Token Markers

Screen space is a valuable asset and during a combat, you don't want to always toggle between the character sheet and the map. Roll20 and the

Pro

^{^info} API offer several ways that you can make actions/adjustments directly from the token without opening the sheet:

Drag and drop any character sheet button to the bottom of the screen for quick access of this same button, even with the sheet closed
Pro
^{^info} 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)
Pro
^{^info} Enter buffs/debuffs, combat options and situation modifiers directly from the Token, by clicking on it, and click on the little bubble below. If you have installed the custom set of Markers, this will give you a list of all markers (same as the icons on the sheet), and the token and the sheet are synchronized by the API. For multi-level statuses (like Movement Impaired, or Darkness), and buff/debuff, hover your pointer over the appropriate marker and type the level on your keyboard.

token Action Buttons

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 "Star" 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.

Default Token Actions
"Init" rolls initiative for the selected tokens. "Karma" toggles karma usage from off to auto or ask. "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.

[edit] Player Walkthrough of Character Sheet

[edit] 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

Overview

At the left of the sections are32 subsections for the attributes, for the defenses, armor and initiative, and for the Global Modifiers. Please note that this sections can be displayed or hidden per 3 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.

Edit Button

A parameter icon is also offered for some sheet options specific to this section

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.

The sheet also 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 We hope you will get used to the icons quick, but a legend can be found in the Parameter Tab (subsection “Help”)

[edit] Adjustment vs Modifiers

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

Sample Step Display

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, an option for displaying the final or base value is offered in the Parameter tab.

[edit] Printing the Sheet

The sheet is print friendly. You need to be on the Overview tab to print

[edit] 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.

File:Earthdawn-Header.pngg

Header

[edit] Health/Karma Pools

Header Pools

On the left of the logo will be found the main “pools”

Detail of the Header 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. In the header options (accessible from the overview and combat), a “stun” pool and modifiers for the Wound Threshold can be optionally displayed. 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

Pro

^{^info} : 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 threshold will be done automatically to apply wounds.

If your character sheet has been properly linked 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 vice versa.

[edit] 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.

Pro

^{^info} 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). (by default only one of these options is displayed, but the second one can be enabled via the header options in Overview/Parameters)

If no icon is selected, he will not spend any Karma or any test
As long as the “ask” mode is selected, and as long as Karma-Limit_max allows more than a single value to be selected, the user will be asked to confirm at each test the number of Karma 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-Limit_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-Limit_max=2 for a Talent that substitute its strength for damage tests.

Talent Karma Selector

When the auto mode is enabled in the header options, 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

[edit] Character Name and Quick Action buttons

Header Buttons

On the Right of the logo, in addition to the Character Name, are grouped several common buttons.

Detail of the Buttons Header
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 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 home-rules 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 home-rules for this particular character. Also in Adjustment there is a GM Special Command to set all characters to a certain option. Jump up, 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)

[edit] RollType

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 to the Parameters-Sheet tab, 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)

[edit] 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.

Global Modifiers, Options and Situation

An option of the Overview/Parameters allows to display all icons or just the basic ones

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 marker on the bubble directly below the token.

In the header, you can tell what Icons are for by hovering over them in turn until you find the correct one. Or you can go to "Parameters-Help" tab for a list of Icons and their descriptions.

Icons

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.

[edit] Attributes, Secondary Attributes and Global Modifiers

To the left of the sheet are displayed 3 hideable panes for the main and secondary attributes. In each of the section, to the left of the title bar, 3 icons allow to display/hide these 3 panes

[edit] Attributes

The Attributes has 3 different visualizations:

The Creation Mode displays the count of the 25 attribute points to be spent during character creation. Once Creation is finished this will never be displayed again. Note that in creation mode you can directly edit the step, and the value will be recalculated, which can prove practical for GMs for quick NPC creation
The Edit Mode displays the Attribute improvements done via Legend Points ( see PG p. 447). (API), Legend Points expenditures will be done automatically when these values are changed. See the Legend tab for more detail
The Normal Mode, displays the value and step value (Final or Base) as well as modifiers that apply to tests.

As Attributes can be rolled for either Effect of Action tests so icons allow to select the type of test that will be done by clicking on the attribute name..

Parameters for attributes are grouped in the Parameters-Character Tab such as:

Special Adjustments to the Value or Step
Karma-Max or DP-Max to specify if the character CAN spend karma on attribute tests, and that will display the Karma selector to decide if he WILL spend on next tests in auto mode
Visibility of rolls (public, player only, etc.)

Local modifiers to the step are available, and will also apply to any Talent/Skill/Knack based on the attribute

[edit] Secondary Attributes

Defenses, Armors, and Initiative are displayed in this pane with their own modifiers. Note that for Initiative, the Initiative Penalty of Armors and Shield are considered as a modifier.

Optionally (Set in Overview/Parameters) nn icon allows to display the "Natural Ratings" as defined in the Companion p 45.

Another set of buttons for initiative, knockdown and jump up are available

[edit] Global Modifiers

This subsection is 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.

Effect of Harried Status

The screenshot below gives a good example of what will happen when a character is harried (i.e. -2 to all Action Tests, Defenses, and Attack Tests). 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.

Note that the rules are unclear on the subject, but there seems to be a nuance between Action tests (done against a difficulty number) and Effect tests (like damages, or recovery tests, where the result is directly the effect). Global modifiers apply differently to these 2 types of test, so that Effect Tests are mostly affected only by Wounds. For example a Woodskin Test, done while Harried would be unaffected by Harried's Action Tests penalty

Pro

^{^info} in the Parameters-Sheet Tab, a GM parameter can be set via the GM Special functions so that Effect Tests are considered as Action tests.

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)

[edit] Overview and Combat sections

Overview and Combat sections are designed as a central place where data from many other tabs is displayed but in a summarized mode.

[edit] Data from other Sections

Overview section, is meant during general gameplay, shows all your talents, skills and knacks (coming from the appropriate sections), as well as the spellcaster matrixes (from the spell section)
Combat sections, is meant during combat obviously, so it filters the abilities above for the ones that you have clicked as "Token Actions". In addition it also shows "Token Action" weapons.

To display an ability in the Combat tab, open the parameters of such ability and click the star icon (same as for the Token Actions). It will create a token action button AND display it in the filtered combat tab. Note that the spellcasting talent will automatically filter out in a different part of the overview/combat closer to the spell matrixes.

[edit] Discipline and Race

Only a few fields are specific to these 2 sections At the top of the Overview is a subsection where Discipline and Race are entered, and the Movement is displayed. Discipline also covers:

Paths
Questor
Multi-disciplining
Homebrew Disciplines (Durability and type will become editable)

Races also cover:

Creatures
Horrors
Dragons
Spirits
Homebrew Races

Note that non-Namegiver will have a field for the Challenge Rating (or Strength Rating for Spirits), and in the model of spirits, Attributes, Talents, and some other abilities will have an icon that allows to add the SR to the value.

Health rating are automatically computed per the current durability and circle (for non-NameGiver, it will work like the Animal Companion Durability Talent, i.e. +5 to Unconsciousness and Death for each Rank) Buttons for half magic tests, and devotion tests will be automatically displayed.

In edition mode, a checkbox will appear allowing you to declare if the character is able to fly (whether on his own for Windlings or creatures, or via a spell). Flight ability will make a appear an icon close to the movement, that allows you to toggle if the character is currently flying or not, displaying the ground movement or the fly-movement. When Flying, at the bottom of the Combat/Overview will appear another box to set the flying altitude. This is linked via the API to a token marker, that will help you keep track of your characters in 3D. Note that this altitude is a number from 0 to 9 (because of the restrictions of roll20), so it is up to you to find a system with your GM

[edit] Path, Questor and Multi-Discipline

Each of those can get in the weeds as far as Legend Point Tracking, and abilities. Here is just a summary of what the books tell, and how it is actually done on the sheet:

When entering a Path, according to the books you have to swear a blood oath (2 points of blood magic), purchase a Knack, that will give you access to a Talent at Rank 1 that represent your Rank in the Path (pretty easy to understand right ?). Looking at the books Some paths have the Knack/Talent cost like Journeyman, ans some like Master. There are some Knacks eligible to this Talent. In the sheet you need to:

record a new discipline, and chose the Path ( or if Homebrew, type a name and select one of the Path - Type)
Go in Equipment, and record a new blood magic for the blood oath.
Both LP tracking systems (Calculated and Transaction), will use the Circle of this discipline as the rank of the Talent, so you don't need to create any Talent or Knack representing the Path Rank
If you purchase a Knack derived from the path Talent, and have the API, you can link it to this discipline
The buffs to PD, MD ...etc, granted by the Path are currently automatically computing.

The above process can be shortened if you have access to the compendium describing the Path, in which case dropping the Path on the sheet will also create the blood Oath

When becoming a Questor, you gain access to the Questor devotion, that is purchased as a Journeyman Talent. You also gain access to devotions, that work more or less as Talents, and to a pool of Devotion points.

Record a new discipline, and choose Questor (from the selected Passion)
Both LP tracking systems (Calculated and Transaction), will use the Circle of this discipline as the rank of the Questor devotion, so you don't need to create any Talent
If you need to roll your Questor devotion, use the button on the right of the discipline
A new pool for devotion points will appear, and DP spending on rolls will follow the same logic as Karma, except that it doesn't refill on a new day. You will have to deal manually when gaining devotion points
additional devotions are entered as Talent. Be sure to fill the Origin as "devotion" with appropriate Tier for appropriate LP Tracking
The buffs to PD, MD ...etc, granted by the Questor are autocomputed

[edit] Weapons/Attack and Damage

In the combat tab, instead of the Discipline and Race will be a section for weapons, and a "Damage Target" button will allow to select a token on the VTT and apply damage to it taking into account its armor rating.

For GMs, and NPCs an extra field and an extra button are appended for a Generic Attack and a number of attacks. This makes NPCs a bit easier to run.

[edit] Generic Pools, Notes, Legend Points

As an option accessible via the Overview/Combat parameters, 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.

There is also a notes field, that is common to the Notes Section, and a few description fields like Age, Hair ...etc

Racial Abilities are automatically displayed here depending on the Race, and for the creatures, if maneuvers have been set in the Parameters-Maneuvers tab, they will be displayed here for easy access for the GM.

Also based on your Discipline and Circle a field will track your Karma Abilities

[edit] Talents, Knacks and Skills sections

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

Talents, Knacks, and Skills are created as needed. Note that spellcasting Talents are created automatically when choosing a discipline, and a button to recreate them is available in the spells section.

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.

Pro

^{^info} 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.

Note that the system has also an Autofill functionality that checks the name of the Talent/Skill to a table of the most common ones, and will fill the system parameters automatically. This corresponds to the parameters that are not recognized by the importer, because it needs to read the text. For example understanding that Wound Balance is a Knockdown test substitution is beyond text recognition.

Talents Parameters

For each line item we have the following fields (some only appear if in edit mode, or if the parameters cog has been clicked)

Detail of the Talents Fields
Name (click on the button to roll the Talent) Type : Is used to set what global modifiers will apply. 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). Rank : Ranks are the only exception where permanent adjustment are displayed like modifiers. A manual adjustment (upper left) will be for example for a thread item adding +1 to the rank of a talent, to keep the difference with the actual used for LP costs and Circle advancement. Upper left will be the value inherited by links. See links below for more details. 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 (API): whenever the Rank is changed, a dialog in the chat will propose to post to the Record section the expenditure of Legend Points. See the field Origin to make sure the amount is right. Attribute Step (with the standard display for automatic and manual modifiers. Refer to the Header section for more details) Target : a dropdown will be offered to decide how the API should compute a target number. Note that damage tests have a type of damage selection instead of the target). 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 '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" (i.e.: 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 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. Origin declares how the Talent/Skill/Knack was acquired for Legend Point tracking purposes. Note that Origin: Dummy can be used to create Dummy Talents/Knacks for many special uses (see links). 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 Links Action is for information only. See PG p.373 Strain will be automatically applied by the API whenever the ability is rolled Karma Selector (see in the Header the Karma Section) A magnifier glass icon will hide/show the notes, where you can paste the full description of the ability A cog icon (only available in edit mode) will hide/show the parameters for this ability: Link Button :. See specific section (option in General Talents Parameters) Special : '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'. Spellcasting Talents are automatically set here. Replacement Spellcasting Talents (like Willforce that replaces Willpower) should be set with the same setting in Special(option in General Talents Parameters) Modifiers exception: These 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.(option in General Talents Parameters) '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. 'MoveBased' is for tests that are moved based and that will take a penalty for impaired movement. 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 MoveBased field. 'VisionBased' is for tests that take a penalty for darkness or impaired vision. It is, again, a judgment call, but most Talents based on Per or Dex will qualify as Vision Based. Think about whether the character could perform the Talent just as well with their eyes closed as open. RollType: specific Roll visibility setting for this ability. 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-Adjust 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. 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.(option in General Talents Parameters) Say Total, with some Talents or Spells, (such as Melee Weapons), you want to know how many EXTRA successes you had "You hit with 3 Extra successes". With other Talents or Spells (such as Thread Weaving) you want to know the total number of successes you rolled "You had 4 successes". Use this to determine which way the successes for this Talent or Spell is reported. 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, or some players like to put it for description. It will be displayed along with the roll results. This field also is also very useful for implementing thread item special abilities. Make a Dummy Knack of type "No Roll", with a name, some strain, and a bit of text. When you "roll" this Knack it will spend the strain and display the text, letting everybody know your Thread Item has been activated. Token Actn (Star icon) 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.

[edit] Languages

At the bottom of the Skills, you will find the Languages, where you can list all languages known to the character and whether it was learned through the Skill or through the Talent. Note that as per the player guide, the mechanics of the Talents and of the skill are slightly different, and this is reflected in a slightly different mechanics

The learning of a language with the skill is the same painful process we non-adepts suffer. As such, it is considered that the number of languages known and the rank in the skill are the same thing. Adding a language will directly propose you to spend the Legend Points for the rank of the skill. You don’t need to create a line for the Skill as it is the shown hardcoded value
Learning the language through the Talent is a matter of minutes/hours. A player would be wise to have at least a couple of unassigned ranks in order to be able to magically learn a new language when useful in a game. Therefore the number of languages known is for display only, and you will have to also enter a Talent in the Talent section to track your actual rank and LP, and make sure that you Rank in the Talent exceeds the number of Languages known. The Talent will be set with a "Special" as Speak Language/Read and Write Language so that you can see the number of available ranks

[edit] Option :Links

Pro

^{^info}Links are a very versatile function that allows a user to customize a lot of stuff. Links are only available with API.

They were initially designed for Knacks, as knacks use the same rank as the Talent they are based upon, but possibly with a different attribute. Links from a Knack to a Talent allowed to use the Talent Rank instead (or as part of) the Knack Effective Rank Calculation.

Links can now be used for many cases where the Step/Rank of something depends on the Rank of “something else”

Free Talents or Free Matrixes have their Rank equal to the Circle of a certain Discipline. This can be done by Linking them to the Discipline
The Final Damage Step when using Damage enhancement Talents such as Surprise Strike or Down Strike depends both on the Talent Rank, and on the Weapon Damage Step. These can be combined via links to the weapon and/or Talent
Situations where 2 Talents are stacked up like Tiger Spring and Air Dance can be dealt with a Dummy Talent linked to the 2 actual Talents

Links can be setup via the appropriate button in the parameters of an ability. Both the ability that Gets the Value, and the One that Provides will be identified with appropriate links icons. Only the ability that Gets the value will have clearly identified what other ability it is linked to. Note : the link only carries the Rank (or Circle). Not the strain or Karma-max. If you create a for example a combination of 2 Talents, you will have to sum up their strain and Karma-max

Nota : Knacks are designed to Get links. They don’t have their own rank value. As such, the value received from the link will be displayed directly as the center value.

Talents have their own Rank, so the value received from a link will displayed as a buff to the left of the center value

[edit] Example 1 : Surprise Strike + Weapon

For example, a Thief that wants to implement Surprise Strike, would have different options.

If the character always uses the same weapon, the user could create a single link to the weapon in the Surprise Strike Talent, so that rolling Surprise Strike will automatically include the weapon step
If the user wants to keep the actual Talent standalone, possibly because he uses several weapons, he could a dummy Talent with a link to Surprise Strike and to the weapon for each weapon he uses.

Link Creation

First Option

Second Option

[edit] Example of Talents and Knacks parametrization - Typical and Special Cases

Earthdawn can get pretty complex, and we tried to automate as much as we could. You could do a lot with the default parametrization of Talents, but parametrizing for the appropriate calculation of modifiers requires a bit more understanding of the various parameters described above. In order to facilitate the understanding, here are a few detailed examples of parameters for some common, or less common Talents. Please note that some of this parametrization is done automatically by the Autofill, but understanding it would allow you to troubleshoot or customize

[edit] Melee/Missile Weapon

Type : Respectively Attack CC/Attack. Some modifiers apply only to Attack Tests (Called Shot), or only to Close Combat Attack Tests (Aggressive Attack)
Target : PD, so that when rolling, the API will ask you to click on a Target Token, and compare with its PD to calculate success levels
Exceptions : May be subject to GM interpretation, but I would consider Melee Weapon to be Move Based, and Vision Based, so that movement impaired and Darkness conditions affect rolls... Missile Weapon could be only Vision Based.

Many Attack Talents (Swift Kick, Second Attack, Second Weapon ...etc) could be parametrized the same, with appropriate strain

[edit] Avoid Blow

Type : Action
Target : PD-Ask allows to give the TN either in absolute value or by difference to your PD... Could also be N/A for GMs that don't want to give the result of the roll
Exceptions : Again subject to GM interpretation, but definitely an Active Defense (doesn't get penalty from Defensive Stance)... I would personally consider it also movement and vision based.

[edit] Riposte

Type : This is tricky, and generates a lot of debate... The choice is between Attack CC and Action, to decide the effect particularly of an Aggressive Attack
Target : We created a Target just for Riposte, called Riposte :) What it does is that it will Ask you a TN (the result of the opponent Attack test), and to click on a target Token... According to the rules (PG. p.165), it will evaluate if you exceeded the TN (like an avoid blow), but also if it has extra success on this, and if it exceeds the opponent PD...
Exceptions : Again subject to GM interpretation. Active Defense? Maybe, but GM could rule otherwise because of the counterattack... I would personally consider it also movement and vision based.

[edit] Claw Shape

Type : Damage CC, so that the aggressive attack bonus is counted, and the when rolled it is offered to apply the damage to a target
Rank : Claw Shape is the only Talent with an offset on the Attribute + Rank calculation. As it is permanent, and we don't want to offset the Legend Points calculation, the best way is to enter it in the Rank Adjustment
Target : Physical Armor so that the armor is deduced when applied to a target
Exceptions : I would put none

[edit] Surprise Strike

Type : Damage CC if using Melee, or Damage if using a Missile/Thrown
Target : Physical Armor so that the armor is deduced when applied to a target
Exceptions : I would put none
Link : If you mostly use Surprise Strike with the same weapon, you can directly Link Surprise Strike to the Weapon so that when rolling Surprise Strike, the Damage Rank of your Weapon is also added to the roll.

If using several weapons, it would be better to create a new Surprise + Weapon line, with Rank 0, and a link to both Surprise Strike and the Weapon. Should work well for other Damage replacement Talents like Waterfall Slam

[edit] Tiger Spring /Air Dance

Reading the rules in Detail, Tiger Spring and Air Dance are slightly different: Air Dance Actually substitutes completely you initiative, while Tiger Spring adds the Rank to the base Initiative. In my interpretation, this leads to some "refinements" in the parameters

Type : Initiative Penalty so that the IP is counted against the roll
Rank : Both would have their normal Rank, and Dex as Attribute but some Discipline at high Circle get a bonus to the "Base Initiative". Air Dance being its own step, and Tiger Spring being a Rank added to the Base Initiative, This discipline bonus could be added as a Rank Adjustment only for Tiger Spring
Target : N/A
Exceptions : None, only the IP Applies
Special : Initiative so that the result is sent to the turn order
Karma-max : Some errata of the rue explain the Tiger Spring being only a rank added to the base initiative, you can't add Karma to Tiger Spring, so Karma-max should be set to 0

[edit] Wood Skin

Type : Effect, only wounds would modify the roll
Target : N/A
Exceptions : None, there is already no modifiers applying
Special : Recovery so that it removes a recovery test and the result reduces the damage...

Note that Wood Skin gives you temporary extra damage points, and that at the end of the duration, you heal those... An equivalent way to put it, is to immediately heal those, and allowing for negative damage points... The system won't automatically go to negative damage (because some other talents declared as "Recovery" like Fire Blood will not heal you below 0), but you can see the roll result, and edit the damage to the appropriate negative value

[edit] Impressive Display

This is typical of a Talent that you don't roll, but that has a strain associated (Long Shot is another one)

Type : No Roll

Clicking the Talent will spend the Strain, without rolling any dice. The user can then click on the Talent to be used in combination for the test

[edit] True Shot

A very very special case, for which we made a unique opportunity to roll a lot of Karma Dice at once.

Type : No Roll

First click True Shot to spend the 2 strains. Then switch the Karma mode to "Ask' and click Missile Weapon with the appropriate number of Karma

[edit] Example 2 : Tiger Spring + Air Dance : Tiger Dance

Make a Knack or a Dummy Talent 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 initiative with both Air Dance and Tiger Spring.

[edit] Spells section and Spellcasting Sequence

[edit] Talents

The spellcasting Talents are listed at the top of the section. This must be understood as a filtered view of the Talents entered in the Talents section, and therefore edition/parametrization is done from the Talents section. The Circle 1 Talents are normally created automatically during the selection of a spellcaster discipline or importing a spellcaster from an older version of the sheet. Should you accidentally delete one of the Talents, and need to recreate it, or when creating higher circle spellcasting talents like Willforce, Concise Casting, or Elemental Mastery, you can switch to edit mode and use the Create buttons to get a clean copy. It is important to understand that the system uses the "Special" field in the Talents parameters to identify the talents displayed here. This is also used for the API to identify the different Talents to be used for the spellcasting sequence. You have also a special Dummy Rank 0 Talent that corresponds to your willpower attribute. This allows for a quick effect roll, and again is used by the API for the sequence (see below).

[edit] Grimoire Tab

The Grimoire subsection has another set of tabs within it, that allows to filter the spells. To add new spells, press the 'Add' button at the bottom of the list. A blank spell will appear. Note that You can import spells from a PDF via Text Import similar to how described under Talents. Copy all the text starting at name.

Grimoire Fields details
* Name Discipline : (El, IL, Ne, Sh, Wz, Other, Power). Important to be filled in for the right Thread Weaving Talent to be used in the spell Sequence (Note, if you have only one spellcaster discipline, system will fill it for you) Circle of the spell. 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, with certain pre-defined entries Duration Field is locked to direct input. Use Edit button to set the duration field. Effect : 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. Success Levels field to select the option that most closely matches what the spell is to do with extra successes. Disp Text : This text will be displayed when the spell is successfully cast, and can be used to remind yourself of side effects. Extra Thread : Use 'Edit ' button to set what extra threads allowed for this spell do. Set FX to optionally add special effects to the spell. This works exactly like Talent FX, so see the Talents section of this Wiki. Pro ^{^info} : From the Grimoire tab, in display mode, you have 2 buttons to initiate sequences : The Attune Button (shaped as a parchment) will copy the spell to one of your Matrix. Note that a "Create and Attune" option, allows to create a temporary "Pseudo Matrix" and attune to it, to emulate shared matrixes and cases where more than one spell can be held in the same matrix The master spellcasting button (which holds the name of the spell) will initiate the spell sequence even if it is not in Matrix (if you do Grimoire Casting or are crazy/desperate enough for Raw casting)

[edit] Matrixes

In the bottom part of the section is the tab selector for the Matrix and grimoire subsections.

In the Matrix subsection, the edit mode allows to parametrize the Matrix with its Rank, Origin (for LP calculation and type. In display mode you will be able to deal with the spell contained by the Matrix. Without the API, you can just type the name of the spell and parametrize the number of threads. There is no attuning or casting sequence. You just use the talent buttons above to make the appropriate tests API implements an Attuning sequence and a spellcasting sequence. The Attuning Sequence can be launched via the Grimoire, and will copy appropriate data to the Matrix In the rules, there are several cases where a Matrix can hold several spells:

This can be a "Shared" Matrix
Some spells like Ephemeral Bolt and True Ephemeral Bolt can be attuned in the same Matrix.

The Character Sheet emulates this by a "Pseudo" Matrix, that will be created additionally to the first one just to hold the additional spells. Those can be created manually or by a specific selection in the Attuning Sequence.

[edit] SpellCasting Sequence

The user can manually follow the sequence, and click directly on the Talents and keep track of what is left to do.

The API offers a guided spell-sequence that can be initiated, or moved to the next step via a "master button" that can be located at different places:

On the character sheet on each Matrix
On the character sheet, on the Grimoire for each spell (for Raw Casting or Grimoire Casting.)
From Token Actions

To cast a spell, press the master button with the name of the spell that will trigger a dialog in the chat that will guide you through the various steps of the spellcasting sequence:

Chose Extra Threads
Weave Threads
Cast
Roll the Effect

Note that the system will recommend you on the next step(s) according to your last action, but you can still select any of the actions. Note also that you can have several Talents that correspond to the same action, and in this case the various options will be offered. The most common case will be Willpower and Willforce, but at higher circle, other Talents like Concise Casting (for spellcasting) or Elemental Mastery (for Elementalism) could fall under this case, but you could also have a Dummy Talent for some special case (a Thread Item that gives a Bonus to Elementalism just for Fire spells). The system recognizes the different options by looking at the "Special" parameter of the Talent. 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.Note that in the current version there is no automatic import for the weaving for creature that use it... You have to create the Weaving with the "Power" button in spells Talent

The system also manages some edge cases like:

Grimoire Casting : When clicking the Master Button from the Grimoire, the user will be offered to Attune its Grimoire. The Test of Patterncraft will be rolled and if successful, next steps will be considered as Grimoire casting (and as per PG one extra success will be added)
Raw Casting : When clicking the Master Button from the Grimoire, if the user ignores the Grimoire Attuning, and goes to any of the sequence steps, he will be considered casting raw. A warning message will be issued, and when the spellcasting test will be done, the GM will be offered to roll for Warping and Horror Mark
Attuning and Attuning on the Fly: When clicking the Master Button from the Grimoire, the user will be offered to Attune (normal attuning, like the button on the sheet), or to Attune on the fly (see PG. Attuning on the Fly costs 1 strain and requires a Thread Weaving Test. As per the PG once starting to Attune on the Fly, the spellcaster must continue until he succeeds. Failing to pull through, or failing a concentration check if taking damage would result in wiping all of his Matrix. If the Attuning on the Fly is failed, the Wipe Matrix button will appear, but the user can decide to ignore it, or to retry the Attuning on the Fly)

[edit] Equipment Section

The Equipment Section 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), and Blood Charms.

[edit] Blood Magic

You can list here all of your blood charms and their blood damage and effects. Blood Damage is automatically substracted from the health ratings. Effects are to be done manually (as modifiers) If your sheet was imported from an older version, there was no detail of the blood charms, only a “Blood Damage” value. The conversion routine will therefore create a “Dummy Blood Charm” that you can replace with your actual Blood Charm(s). Blood Wounds are not supported, just don't break your oaths (or enter manually a wound and don't heal it).

[edit] Armor and Weapons

You can enter here the stats of your Armor, and Shield. The ratings and Initiative Penalties will be carried to the other sections You can also here create one line for each of your weapons, and click the Tkn Actn to get their damage roll listed in the Combat Section and Token Actions. Note that it is important to click on the attack icon of a weapon to set it as Ranged or Close Combat so that Aggressive Attack buffs apply correctly (API) Note also that weapons can be linked (see Talents section). This can be used for example, to link to Talents that substitute Str in. Damage roll, but note that strain is not supported for weapons, so it could be better to link the Talent to the Weapon.

[edit] Inventory Cash and Lifestyle

On top of the inventory are listed quantities for pretty common stuff like potions, rations ...etc which unitary weight is known in the system (we even calculate weight for coins !!!) Inventory, in general, is simply recorded, with the total weight calculated 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, or for notes about the inventory

[edit] Thread Items

The section for thread items allows you to record the progress of your thread item discovery.

The 'Rank' field corresponds to the woven rank. The 'Ranks Known' field will correspond to the number of ranks that have already been discovered by Item History, i.e. the number of Ranks for which you know the power and test Knowledge. It will hide/show lines up to the rank you discovered On each rank line, you will be able to record the attached power, the test knowledge, and if you know it the key knowledge. The 'Done' checkbox is meant to record if you have discovered the appropriate Key Knowledge (i.e. if you are ready to weave to this rank). It has no automatic effect and is only for your own tracking. A 'Weave' icon will appear on the line corresponding to your current woven rank

[edit] Legend Section

This section is for your Legend Points and Silver Pieces Journal. Record here any transaction such as Legend Awards at the end of a Game.

The sheet offers you 2 options to record the LP in your Journal. You can use one or the other or a combination of both.

[edit] Calculated Legend Point Tracking

In the CALCULATED MODE, you only have to record your Career Legend Points @{LP-Total}. Based on all your Rank values and Attribute improvements, the system will fill your Calculated Current Legend Points @{LP-Current-Calc}. The Current Legend Points are different fields for the 2 modes Note that the system needs to know the ranks you spent for free at creation. If your character was created from scratch using the current version of the sheet, the LP costs corresponding to the creation ranks will be recorded at the end of creation. If you are importing a character from an older version of the sheet, or from a game out of roll20, you will need to go in the details (hidden by the magnifier glass icon), and fill in the LP Creation Offset that correspond to the LP points for the free ranks in Talents, Skills and Spells during the Creation. A simple way to do this is to record the offset so that the calculated Current LP matches with the one calculated by the system

[edit] Transaction Legend Point Tracking

In the TRANSACTION MODE, your Career and Current points can be edited. The Current is stored in a separated @{LP-Current} field. You track your LP/SP by posting transactions in your journal. Transaction can be a Legend Award at the end of an Adventure, or the cost of increasing a Talent Rank. (API) Changes in the Ranks will be detected and a pre-filled transaction will be proposed in the chat. (API) When you press the 'Update Dates' button, if there exists a character named 'Party' that is editable by all players, then whatever date is in the 'Throalic Date' field will be copied into the current characters 'Throalic Date' field. Thus the GM can keep the campaign date current and all players can import that date.

There are different type of transactions, for different uses. Even if using the Calculated LP Tracking to track the expenditures of LPs, it is possible to keep using the transactions to record the Legend Awards. The different type of transactions are

An LP Gain will increase both the current LP, and the Career LP. This is to be used for the rewards given by the GM
A Spend posting will only decrease the current LP. This is to be used to manually record a transaction. See below for automatic transactions
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.

[edit] Automatic Transactions

The system also generates automatic transactions when you change an appropriate value (Talent/Skill/Thread Rank, Attribute Improvement, Circle Advancement). When you edit an entry in the appropriate section (for example a Talent), the change will be detected, and the system will propose you in the chat to post automatically the transaction. Once everything confirmed, the LP/SP amounts will be spent, and the transaction posted in the Legend tab.

[edit] Notes Section

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. There is also a bunch of informative fields for shaping your character including a list of Personality traits from the list in the Player Guide Finally you have 3 free text Notes with a customizable title… Your call to use it for description, allies, Campaign notes or whatever you feel like. The third one is also accessible via the Overview and Combat Tab for convenience.

[edit] Parameter Section

[edit] Parameter Tab - Character

Almost everything on the Parameter-Character tab is meant to make permanent adjustments to the main attributes that are somewhere else is the sheet. 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. It is a very good idea to use the notes field at the bottom to document the reason for each adjustment. '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 Parameters-Character 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."

Note that with Edition 4, the bonus coming from your Discipline are already taken into account automatically

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.

[edit] Parameter - Maneuver

This is only used for creatures. Refer to appropriate section in the GM part.

[edit] Parameter Tab - Sheet

This subsection lists some advanced functions that change the behavior of the sheet and/or API. 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.

'Hide Spells' hides the 'Spell tab. If the character is not a spellcaster, you might as well get rid of that tab as you don't need it.

The API checkbox tells the character sheet whether the API is present. If for some reason the API is present, but does not check this box at character creation, it can be set manually here.

The Creation mode checkbox is a way to reenter or exit creation mode if for some reason that is needed.

The other values are display only. PlayerWho displays the roll20 name of the player who the API thinks probably owns the sheet and who will get all the "Player Only" messages. Edition and API Version control how the API does certain stuff.

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 or some other token attribute you want preserved in new tokens that get dragged to the VTT. 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 'Parameters-Sheet 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 'Paramerers-Character' 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: These two things are normally done in creation mode, but can also be done here. They are similar to importing a Talent or Spell. A text box appears and you can paste an entry from a PDF 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).

[edit] Parameters - Help Tab

This section shows some helpful GIFs of basic principles, displays all the icons used in the system and what they mean, and all the status markers and what they do.

[edit] GM

[edit] Managing Creatures and NPCs

[edit] Creation of Creatures and NPCs

By far the easiest way is to drop from the compendium... Search the adequate entry in the compendium, drop on the VTT, and the character sheet will be created and opened in Creation Mode. Here you can tweak some of the stats if necessary, and your Creature is good to go.

Note that NPCs are created per the rules, so could be used as pregenerated PCs, but you will need to adjust the LP tracking

[edit] Importing from the books

An easy 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 "Overview" tab. In the Creature import field, 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.

Note that the blog of Morgan Weeks, list a number of new creatures and NPCs that are listed in a format compatible with the importer http://Pandagaminggrove.blogspot.com/

[edit] Importing Masks

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.

[edit] Creating from scratch

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.
from the Overview in Creation mode, see, 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.
Creature statistics in the Books are usually not listed with full attribute values, only with attribute steps. On the 'Overview' tab,in Creation mode, attribute steps can be edited directly. If a value is set into the Step 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 all done via the usual modifiers in the Overview. Simply increase or decrease the associated 'buff' field until the total value is correct for the creature. Normally the overview/combat tab is for entering buffs and debuffs, permanent adjustments should go on the Parameters-Character tab. When all the values are correct, go to the 'Parameters-Sheet' tab, and in the 'Special Function' drop-down select 'Set Adjustments' and press 'Do SF'. All the Buffs on the Combat tab will be transferred into Adjustments on the 'Parameters-Sheet' 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'.
For Creatures that have spellcasting abilities, you can add spellcasting talents and matrix in the spells section in edit mode.
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.
Note that if the name of a power starts with Atk, the AutoFill will set it directly as an Attack Close Combat targetting PD... If you name Dmg, it will automatically become a Damage Close Combat on PA
Make sure you click the 'token action' icon for commonly used attacks and powers.

[edit] Token Linking for NPCs, Difference between NPC and Mook

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 Paramters-Sheet tab, 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.

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, horses, 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.

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.

[edit] Maneuvers

In the Parameters tab- Maneuvers, 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. Those selected will also display on the Combat tab

'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 an icon in the header 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 other additional powers may be listed with a name and a Description. There are also some common Opponent Maneuvers hard-coded, along with space for other additional Opponent Maneuvers. Opponent Maneuver have a "show" icon, that can be used to determine if the Maneuver will be offered to opponents when rolling extra successes. This is used if GM requires a test like Creature Analysis before communicating the existence of these Maneuvers

[edit] 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.

On the Parameters - Sheet tab there is a "Special Functions" option to Verify/Fix character sheet. A subset of this routine is now run every time a token is dropped onto the VTT. But running it can sometimes fix various problems. In addition in the Special Functions GM Commands, you can run the Verify/Fix on all characters in the campaign.

Using Roll20 tools, you can look at the system created macros (on the collections tab) and token actions (in the attributes and abilities section). You can make your own macros and token actions. If you do, I suggest that instead of starting them with !Earthdawn or !edToken, start them with !edCustom. That way abilityRebuild will ignore them and not report that there are corrupted token actions.

[edit] Installation, FAQ and Troubleshooting

[edit] Installation

[edit] Install the Sheet in Your Game

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.

[edit] Import the Custom Marker Set

*Procedure for the Token Markers

Go to the following link and download the set of icons to your computer

https://github.com/Roll20/roll20-character-sheets/tree/master/Earthdawn%20(FASA%20Official)/Token-Markers.zip

In your download folder, open the zip file which contains all the token markers.
Back in Roll20 go to Tools>Token Marker Library
Create a new set, and click on Import Images
Drag and Drop all the images you downloaded, and click upload
Once the files have been processed in roll20 go to the Games>Your Campaign
On the right, below the List of Players, click on the + of "Token Marker Sets" to add the set to your campaign.
Click on the "..." on the right of the Default Marker Set, and remove it from your campaign

[edit] Create the Macros

Start the VTT and create any character. Go to the Parameters-Sheet tab. 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.

[edit] Options

Open any character sheet. go to the last tab (Parameters) -Sheet. In the 'Special Function' drop-down, select 'GM Special Functions'. 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).

Some of the Sections have also their own parameters that can be displayed with the cog icon in the title: Overview and Combat

Karma Auto Mode: In addition to the "Ask" mode, that basically ask you how much karma you want to spend each time you roll, unlocks the "Auto" Mode, where you can set for each action a default number of Karma (by acting on the icon selector close to the Action on the sheet), and this number of Karma will be spent as soon as you roll
Damage Stun: Displays the Stun Damage pool in the header
Wound Treshold: Displays a bigger field for the Wound Treshold, with a local modifier. Useful if you have powers that temporarly modify the treshold
Combat Options and Situation Modifiers: Displays the complete list of icons, instead of just the main ones
Misc Pool and Movement': Displays on the appropriate section a box with custom pools to track whatever you want... Ammo, Temporary stuff, poison dosis...

Talents, Skills, Knacks

Modifier Exceptions: Displays 4 additional icons in the parameters of each Talent, that allows to set some special modifiers. If hidden, those will still be autofilled
After roll parameters: Displays additional options to customize some display when you roll. Can be a personalized text or a special effect
Links: Shows the button to create links
Special: Shows the "Special" setting that allows to set some special behavior, such as recognizing Initiative Talents, Knockdown, Recovery Talents, or the Spellcasting talents. Those should all be Autofilled, but you can access for your own use

[edit] FAQ

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.

[edit] 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.

[edit] 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 Character Sheet & Compendium^(Forum) 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.

[edit] 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.

[edit] If you don't have the API, how can I make a generic Roll-Public or Roll-GM macro. ?

You have a generic Roll in the header, but you can also use the code below

/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.

[edit] 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

Pro

^{^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 Parameters-Sheet and switch the dropdown.

If many sheets 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".

[edit] I have a bunch of red bordered or empty Talents, or Token Marker buttons

It can happen during import that some ghost entries or duplicate are created. You can delete them.

[edit] Talents or Spellcasting behave "funny"

If modifiers do not apply as you would expect, check the Type of Talent, and the Modifier Exceptions If Talents side effects like Initiative, Recovery or Knockdown do not appear, check the "Special" parameter If the talents Target Number or Targeting is off, check the Talent setting If it is linked to spellcasting and the Talent do not appear in sequence or in the Spells Talent, check the "Special", or recreate the Talent using the Edit in the Spells section Finally if the step value does not calculate right, go to Parameters/Sheet, and in special functions select "Recalc"

[edit] 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 'Parameters-Sheet - Special Function'. Particularly 'Inspect'. That is covered in section 'Parameters'.

[edit] Copyright and Legal

Earthdawn® (FASA Official) Character sheet and associated API by Christopher D. Dickey and Jean-Baptiste Faure. 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. 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.