Output Templates

When GCS exports a character sheet to text, it uses a modifiable template to create the resulting file. This template is itself is plain text and can be customized in any way desired. The default text template produces an HTML file and can be found in Library/Output Templates/html_template.html. To change the template used when exporting, check the Text Export Template box in the Output tab of the Preferences window, and select the desired template file. If you've selected an image for your character and the template you're using displays it, a copy of the image will be saved with the character sheet.

Creating New Templates

Templates are text files. The extension of the template file is used when creating a newly exported sheet from a template. Instructions on inserting character information and other functions are given to GCS with keys, which are of the form, @KEY. (Note that this turns @ into a reserved character, and so you must use @ if you wish the final HTML character sheet to include one.) Keys are case-sensitive and must be in all-caps. Incorrectly entered keys will be replaced with Unidentified key! in the character sheet.

The following examples show the creation of a template that will output a plain text list of the sort generally used to post characters on Internet forums. The most basic keys are simply markers for a find-and-replace operation. The template...

@NAME [@TOTAL_POINTS] Race: @RACE Sex: @GENDER Age: @AGE Size: @SIZE TL: @TL Unused Points: @EARNED_POINTS Attributes [@ATTRIBUTE_POINTS] ST @ST DX @DX IQ @IQ HT @HT HP @BASIC_HP FP @BASIC_FP PR @PERCEPTION WL @WILL Basic Speed: @BASIC_SPEED Basic Move: @BASIC_MOVE

...will output...

Jack Jackson [120] Race: Human Sex: Male Age: 38 Size: +0 TL: 4 Unused Points: 0 Attributes [50] ST 12 DX 10 IQ 10 HT 12 HP 12 FP 12 PER 12 WILL 10 Basic Speed: 5.5 Basic Move: 5

Lists of traits are generated with loop keys. When GCS encounters a loop, it applies the template within the loop once for each item on the list. If one adds...

@ADVANTAGES_LOOP_START @DESCRIPTION_PRIMARY@DESCRIPTION_MODIFIER_NOTES_PAREN [@POINTS] @ADVANTAGES_LOOP_END

...GCS will output...

Advantages [15] Fit [5] High Pain Threshold [10] Language: English (Native, -6; Spoken (Native), +3; Written (Native), +3.) [0] Disadvantages [-25] Bad Temper (CR: 15 (Almost All The Time).) [-5] Charitable (CR: 12 (Quite Often).) [-15] Skinny [-5]

There are several different forms of the @DESCRIPTION keys. _PRIMARY outputs the name only, _MODIFIER_NOTES outputs those notes due to modifers, and _NOTES outputs the text in the Notes field of the advantage, skill, or equipment. The latter two can also have _PAREN appended to them to surround the output, if any, in parenthesis. @DESCRIPTION_NOTES is omitted here because notes on advantages are rules summaries, which, while useful on character sheets meant for use in play, are not desirable in this template. Notes are, however, meaningful on skills, equipment, and spells, and so are included in those loops:

Skills [@SKILL_POINTS] @SKILLS_LOOP_START @DESCRIPTION_PRIMARY @DESCRIPTION_NOTES_PAREN @SL (@RSL) [@POINTS] @SKILLS_LOOP_END Spells [@SPELL_POINTS] @SPELLS_LOOP_START @DESCRIPTION_PRIMARY @DESCRIPTION_NOTES_PAREN @SL (@RSL) [@POINTS] @SPELLS_LOOP_END Equipment (@CARRIED_VALUE, @CARRIED_WEIGHT) @EQUIPMENT_LOOP_START @DESCRIPTION_PRIMARY, $@COST, @WEIGHT, x@QTY @EQUIPMENT_LOOP_END Notes @NOTES_LOOP_START @NOTE @NOTES_LOOP_END

Adding @NOTES to the end finishes this template.

Available Keys

Description

Point Cost

Attributes

HP and FP

Encumbrance Loop

Hit Location Loop

Lifting & Moving Things

Advantages, Skills, and Spells Loops

Melee Attacks Loop

Ranged Attacks Loop

Equipment Loop

Notes Loop

Notes all combined into one text block

Formatting