View source

From GCAWiki

You do not have permission to do that, for the following reason:
This page has been locked to prevent editing.
You can view and copy the source of this page:
'''GCA Data File''' (also referred to as '''GDF''') is a file format for containing the data and directives used to populate [[GCA]]'s character trait lists.  GDFs are cascading, meaning a GDF may delete, replace, or update data loaded by a previously loaded GDF.

== General format and syntax ==
...general format/syntax mumble...

=== Type Hinting Prefixes ===
Identifiers in GCA can, and should in most cases, include a prefix which signifies their type &mdash; this is especially important in cases where multiple traits have the same name, so GCA will know which trait you are referring to.  The common type prefixes are:
<blockquote>
<table border="0" cellpadding="0" cellspacing="0">
<tr>
<td style="vertical-align: top;">
{| border="0" cellpadding="2" cellspacing="0"
|- style="text-align: left;"
!Prefix
!&nbsp;&nbsp;
!Description
|-
|<tt>'''ST:'''</tt>
|&nbsp;&nbsp;
|Statistics/Attributes
|-
|<tt>'''TE:'''</tt>
|&nbsp;&nbsp;
|Templates
|-
|<tt>'''AD:'''</tt>
|&nbsp;&nbsp;
|Advantages
|-
|<tt>'''PE:'''</tt>
|&nbsp;&nbsp;
|Perks
|-
|<tt>'''DI:'''</tt>
|&nbsp;&nbsp;
|Disadvantages
|-
|<tt>'''QU:'''</tt>
|&nbsp;&nbsp;
|Quirks
|-
|<tt>'''SK:'''</tt>
|&nbsp;&nbsp;
|Skills
|-
|<tt>'''SP:'''</tt>
|&nbsp;&nbsp;
|Spells
|-
|<tt>'''EQ:'''</tt>
|&nbsp;&nbsp;
|Equipment
|-
|<tt>'''GR:'''</tt>
|&nbsp;&nbsp;
|Groups
|}
</td>
<td><!-- provide some separation of the tables -->&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td>
<td style="vertical-align: top;">
{| border="0" cellpadding="2" cellspacing="0"
|- style="text-align: left;"
!Prefix
!&nbsp;&nbsp;
!Description
|-
|<tt>'''SAMECAT:'''</tt>
|&nbsp;&nbsp;
|Refers to a trait of the same category as the trait being needs checked
|-
|<tt>'''TECAT:''', '''PACAT:'''</tt>
|&nbsp;&nbsp;
|Refers to a category of templates/packages
|-
|<tt>'''ADCAT:''', '''CA:'''</tt>
|&nbsp;&nbsp;
|Refers to a category of advantages
|-
|<tt>'''DICAT:''', '''DISADCAT:'''</tt>
|&nbsp;&nbsp;
|Refers to a category of disadvantages
|-
|<tt>'''SKCAT:''', '''SKILLCAT:''', '''CL:'''</tt>
|&nbsp;&nbsp;
|Refers to a category (class) of skills
|-
|<tt>'''SPCAT:''', '''SPELLCAT:''', '''CO:'''</tt>
|&nbsp;&nbsp;
|Refers to a category (college) of spells
|-
|<tt>'''EQCAT:''', '''EQUIPCAT:'''</tt>
|&nbsp;&nbsp;
|Refers to a category of equipment
|}
</td>
</tr>
</table>
</blockquote>
See the [[list of type prefixes]] for a more comprehensive list.

=== Other concepts ===

==== Bonuses ====

===== Compound bonuses =====
These are bonuses that use a single bonus listing to grant a bonus to one or more possible targets, but that will *not* add the bonus more than once to any particular target, no matter how many of the listed targets it may qualify as. For example, gives(+1 to (CO:Air, CO:Water)) is a compound bonus, as it grants a bonus to both the colleges of Air and Water, but any spell that might belong to both colleges will still only get a single +1 bonus, not a +2 for belonging to both colleges. Note that if the gives() had been written gives(+1 to CO:Air, +1 to CO:Water), a spell belonging to both colleges *would* receive a +2, because it would satisfy both targets for both bonuses--this is what compound bonuses are meant to address. Note that compound bonuses do not work with target tag bonuses, or with targets of me:: or owner::. To create a compound bonus, the structure is the same as any other gives() bonus, except that the targets should be enclosed in a parens as a comma separated list. If a target name includes commas, it may be enclosed in quotes or curly braces. Since: 4b366.

== Commands ==

=== <code>#DeleteByTag <traitlist>, <commands>, <tag=value></code> ===

<traitlist> is the list to look in, such as Skills, Equipment, or All for everything.

<commands> is everything needed to specify what GCA should do with the comparison; usually, this means specifying Num or # for a numeric comparison, or $ or Text for a text comparison; this will vary by tag. You can also specify IgnoreEmpty to have GCA ignore tags that are empty (this prevents IsEmpty or IsNotEmpty from working; see below), and EchoLog if you want to fill your log with endless lines of GCA showing you what it looked at and did or didn't delete as a result.

<tag=value> is the name of the tag, the comparison to make, and the value you're looking for. The tag name should be exactly as used by GCA, and the value should be the exact text or number to compare against. Valid comparisons are >, <, =, >=, <=, or <>. Also, because comparing text for/against an empty tag can result in unexpected behavior during text comparisons (numeric comparisons convert empty tags to 0, so use IgnoreEmpty for those if 0 doesn't work for you in such cases), there are two special text comparison operators that have no "value" portion, and these are IsEmpty and IsNotEmpty. IsEmpty counts as True if the specified tag is empty, and IsNotEmpty counts as True if the tag is not empty.

Here are a couple examples:

<pre>#DeleteByTag Equipment, Num IgnoreEmpty, techlvl < 5 </pre>

This command will delete any equipment items that have specified a techlvl() tag, and for which the numeric value contained in that tag is less than 5. Note, however, that Numeric comparisons convert text values to numbers, and if there's not a number as the text value, it is probably going to convert to 0. This means that in our example here, traits such as "_New Armor", that have a techlvl([techlevel]) like this, will appear to evaluate to techlvl(0), which means in our example it would be deleted. To avoid this kind of result, you'll probably need to do a Text comparison, and compare each techlvl you want to delete, like so:
<pre>
#DeleteByTag Equipment, Text IgnoreEmpty, techlvl = 0
#DeleteByTag Equipment, Text IgnoreEmpty, techlvl = 1
#DeleteByTag Equipment, Text IgnoreEmpty, techlvl = 2
#DeleteByTag Equipment, Text IgnoreEmpty, techlvl = 3
#DeleteByTag Equipment, Text IgnoreEmpty, techlvl = 4
</pre>

Be aware that in this particular example, there are a number of traits, such as "_New Innate Attack", that are currently marked as techlvl(0), which you probably don't really want to delete. But, for our purposes here, this set of commands would delete everything below techlvl(5), but not delete traits with other text values.

<pre>#DeleteByTag All, Text, x IsNotEmpty</pre>

This command will delete any trait where the x() tag has anything in it at all. (This would remove pretty much everything in GCA that appears with a little wrench icon next to it in the Available lists.)

<tt>#DeleteByTag</tt> for some special case "comparisons" that can be done when working with Text. <tag=value> can use the format <tag> HasInList <value> or <tag> Contains <value>. In the HasInList case, the  being checked will be considered to be a comma delimited list, and the  must match one of the items in that list. In the Contains case, the whole string of text in the  will be looked at, and if  appears anywhere in the string, it will be considered to match. Both of these are case insensitive.

<tt>#DeleteByTag</tt> supports an Unless clause, to allow for an exception to the rule. Unless supports all the same comparisons as the standard clause. You create an Unless section by including the keyword Unless followed by the comparison to be made. You may also include the same Numeric or Text designations immediately after the Unless keyword, if you want to use a different type from the base comparision. Here is an example:

<pre>#DeleteByTag Equipment, Numeric IgnoreEmpty EchoLog, techlvl >= 5 unless $ techlvl contains ^</pre>

<tt>#DeleteByTag</tt> also supports two additional special text comparison operators: IsNumeric and IsNotNumeric. These test if the tag value would qualify as a numeric value or not. While making a Numeric test, remember that non-numeric values usually evaluate to 0 (or the value of any numbers beginning the text). If testing IsNumeric, it only qualifies as true if the entire value qualifies as a number. An example:

<pre>#DeleteByTag Equipment, Numeric IgnoreEmpty EchoLog, techlvl < 5 unless $ techlvl IsNotNumeric</pre>

A numeric test of the techlvl() tag would be done, and a number of special cases would be deleted if not saved by the Unless clause, which allows for preserving those values due to the fact that they're not actually numbers, just text that were converted to 0 for the simple numeric comparison.

== Directives ==
Directives are special commands within traits, that are acted upon by GCA when it adds a trait containing a directive to a character. As a general rule, directives will be found within the x() tag for a trait, but they may also be used within other tags when needed.

=== <code>#BuildIt</code> ===
The #BuildIt directive prompts GCA to offer the user the Modifiers window, with which they can build the version of the added item they intend to use.

'''Template:''' <code>#buildit</code>

This directive has no options, and therefore has no parentheses or available tags.

'''Notes:''' As with other directives, GCA will remove this directive from the trait when it is added to the character.

=== <code>#BuildList</code> ===
The #BuildList directive allows you to create a list with custom text options, building up from a list output by another directive or entered directly.

'''Template:''' <code>#BuildList( list(''item1, ..., itemN''), template( [''some text'']%ListItem%[''more text''] ) )</code>

'''Available Tags:''' <code>list()</code>, <code>template()</code>

<blockquote>
; <code>list( ''item1, ..., itemN'' )</code> : Allows you to specify the comma-separated list of items to be used when building the output list. Any item that includes commas must must be enclosed within quotes or curly {} braces. If an item includes quotes, you should enclose it in braces instead of more quotes. If you use braces, GCA will not attempt to also remove any quotes or doubled quotes.
; <code>template( [''some text'']%ListItem%[''more text''] )</code> : Allows you to specify the appearance of the text for each item created in the output list. Every item in the list will be output to match the template, with the special variable %ListItem% being replaced by the item from the list that's currently being output. Text to the left and right of the %ListItem% will be used exactly as is to create the output item, so any quotes or other special characters will be used as is, and will appear in the output list. You must be careful, however, not to include single, unmatched parens, as that will mess up GCA's ability to parse things correctly. 
</blockquote>

'''Notes:''' As with other directives, GCA will remove this directive from the trait when it is added to the character. The output generated by this directive will be inserted directly in place of this directive.

=== <code>#Choice</code> ===
The #Choice directive allows you to provide the user with a list of options, and to obtain the one they pick. This is intended to be a quicker means of getting a simple, single choice from the user than #ChoiceList.

'''Template:''' <code>#Choice( "''item1''"[=''cost1''] [, ..., "''itemN''"[=''costN''] ] )
</code>

<blockquote>
This directive takes a comma separated list of items. If you also want to provide the user with costs for the items, you need to use the optional cost assignment, which is done by including the cost for each item after an equals sign following the item text.
</blockquote>

<blockquote>
The costs are not used for making the selection; they would be included for reference only, or if you needed the cost for the selected item later. Only a single item can be selected by the user.
</blockquote>

<blockquote>
The items in the list may be surrounded by quotes, as shown in the template, or by curly {} braces. You must use one or the other if the item includes commas or equals signs. Use the curly braces instead of the quotes if the item contains quotes, or even if you simply prefer them. Note that if you do use the braces, GCA will not attempt to remove any quotes or doubled-qoutes from the item names. Remember that in either case, the cost assignment would come outside the quotes or braces.
</blockquote>

'''Result Variables:''' <code>%choice%</code>, <code>%choicecost%</code>

<blockquote>
; <code>%choice%</code> : GCA will insert the user's selected option in place of this variable.

; <code>%choicecost%</code> : GCA will insert the specified cost of the user's selected option in place of this variable.

One or both of the options shown may be used, and may be used more than once. GCA will make the replacements anywhere the result variables are found in the trait definition. Note that the results placed into the variables by GCA will not include quotes.
</blockquote>

'''Notes:''' As with other directives, GCA will remove this directive from the trait when it is added to the character. Unlike with other directives, the output generated by this directive will be inserted in place of the result variables, instead of in place of this directive.

=== <code>#DoNotOwn</code> ===
The #DoNotOwn directive is used in Templates.

'''Template:''' <code>#DoNotOwn</code>

:This directive has no options, and therefore has no parentheses or available tags.
:This directive is used to remove an advantage/disadvantage/skill from a template that has the 'owns(yes)' tag, so that it can be separately edited.

:The line
::<code>AD:Acute Vision=2</code>
:adds the Acute Vision advantage at level 2 ''as part of the template'', so assuming the template has the <code>owns(yes)</code> tag and the <code>locks(yes)</code> tag, then the user can never increase the level of the advantage (nor can they simply add Acute Vision outside the package, as it would create a duplicate item).

:By adding this directive
::<code>AD:Acute Vision=2#DoNotOwn</code>
:the advantage is still added to the character, but not as part of the template.  The cost charged by the template (separate from the <code>displaycost()</code>) no longer includes the advantage, and the advantage no longer appears as part of the template; it is simply added to the character sheet.

:An alternative would be to use the <code>#DoNotLock</code> directive, in which case the advantage remains part of the template, but editable, and any change to the level of the advantage changes the actual cost of the template.

:This tag is most often used with template skills, which generally should be editable after the template is used.  It is also appropriate for any leveled advantage that might vary from individual to individual who has the template (Acute Vision, Appearance, Status, etc)

Usage Examples:

<pre><nowiki>AD:Acute Vision=2#DoNotOwn</nowiki></pre>
<pre><nowiki>SK:Flight==4pts#DoNotOwn</nowiki></pre>
<pre><nowiki>AD:Magery=1#DoNotOwn with "Song, -40%, group(Magery), page(B67)"</nowiki></pre>

=== <code>#GroupList</code> ===
The #GroupList directive allows you to include a comma separated list of items based on an existing Group. By default, the name of the items obtained from the group will include the prefix tag.

'''Template:''' <code>#GroupList(''GR:GroupName'' [, ''taglist''])</code>

<blockquote>
; <code>''GR:GroupName''</code> : The name of the Group to be used, as defined in a Group section of a data file. It may be enclosed in quotes (must be if the name includes a comma).

; <code>''taglist''</code> : The optional list of tags applicable to creating the output of the #GroupList directive.
</blockquote>

'''Available Tags:''' <code>append()</code>, <code>prepend()</code>, <code>flags()</code>

<blockquote>
; <code>append( ''text'' )</code> : Allows you to include a bit of text that will be added to the end of each item from the group. Do not enclose the append text in quotes, although you may use quotes as part of the append text if you wish.
; <code>prepend( ''text'' )</code> : Allows you to include a bit of text that will be added to the front of each item from the group. Do not enclose the prepend text in quotes, although you may use quotes as part of the prepend text if you wish.
; <code>flags( ''flaglist'' )</code> : Allows you to include flags that alter the behavior of the list generation. One or more flags may be included in the <code>''flaglist''</code>, and if more than one, they should be separated by commas.

The flags that may be used in the <code>''flaglist''</code> are: 

* <code>NoPrefix</code> to prevent the inclusion of the prefix tags in the names of group items. 
* <code>InQuotes</code> to enclose each list item within quotes. Any appended or prepended text will appear outside the quotes. 
* <code>InParens</code> to enclose each list item within parentheses. Any appended or prepended text will appear outside the parens. 
* <code>InBraces</code> to enclose each list item within curly {} braces. Any appended or prepended text will appear outside the braces. 
* <code>MasterQuotes</code> to have GCA place quotes around the whole item and appended/prepended text combination. 
* <code>MasterBraces</code> to have GCA place curly {} braces around the whole item and appended/prepended text combination.
</blockquote>

'''Notes:''' As with other directives, GCA will remove this directive from the trait when it is added to the character. The output generated by this directive will be inserted directly in place of this directive.

=== <code>#List</code> ===
The #List directive allows for building a list from the contents of a List section in a data file, without having to include the contents of the list entirely in the trait where it is found. The #List directive will take the specified <code>''ListName''</code> and create a comma separated list, which will be inserted in place of the #List directive in the trait, before it is added to the character. This allows for building a #ChoiceList or other list-based part of a trait at the time the trait is added to the character.

'''Template:''' <code>#List(''ListName'' [, ''taglist''])</code>

<blockquote>
; <code>''ListName''</code> : The name of the List item, as defined in the List section of a data file. It may be enclosed in quotes (must be if the name includes a comma).

; <code>''taglist''</code> : The optional list of tags applicable to creating the output of the #List directive.
</blockquote>

'''Available Tags:''' <code>append()</code>, <code>prepend()</code>, <code>flags()</code>

<blockquote>
; <code>append( ''text'' )</code> : Allows you to include a bit of text that will be added to the end of each item from the list. Do not enclose the append text in quotes, although you may use quotes as part of the append text if you wish.
; <code>prepend( ''text'' )</code> : Allows you to include a bit of text that will be added to the front of each item from the list. Do not enclose the prepend text in quotes, although you may use quotes as part of the prepend text if you wish.
; <code>flags( ''flaglist'' )</code> : Allows you to include flags that alter the behavior of the list generation. One or more flags may be included in the <code>''flaglist''</code>, and if more than one, they should be separated by commas.

The flags that may be used in the <code>''flaglist''</code> are: 

* <code>InQuotes</code> to enclose each list item within quotes. Any appended or prepended text will appear outside the quotes. 
* <code>InParens</code> to enclose each list item within parentheses. Any appended or prepended text will appear outside the parens. 
* <code>InBraces</code> to enclose each list item within curly {} braces. Any appended or prepended text will appear outside the braces. 
* <code>MasterQuotes</code> to have GCA place quotes around the whole item and appended/prepended text combination. 
* <code>MasterBraces</code> to have GCA place curly {} braces around the whole item and appended/prepended text combination.
</blockquote>

'''Notes:''' As with other directives, GCA will remove this directive from the trait when it is added to the character. The output generated by this directive will be inserted directly in place of this directive.

== Functions ==
...general function mumble...

=== Math functions ===

==== <code>@IsEven(''value'')</code> ====
Returns true if given value is an even integer, or false otherwise. Since: 4b367.

==== <code>@Modulo(''value1'', ''value2'')</code> ====
Returns the remainder value after value1 is divided by value2. For example, @Modulo(10,2) would return 0, while @Modulo(10,6) would return 4. Since: 4b367.

==== <code>@round(''VALUE [, DECIMALPLACES]'')</code> ====
VALUE may be any valid math expression or numeric value, and DECIMALPLACES specifies how many decimal places VALUE should be rounded off to. If DECIMALPLACES is omitted, an integer value is returned.

== System Variables & Keywords ==
...general variable & keyword mumble...

== Tags ==

=== Conventions ===

==== <tt>char</tt> prefix ====
Tags beginning with the prefix <tt>char</tt> are used for holding values calculated for specific characters based upon the values of their non-prefixed namesakes and applicable modifiers.

=== System Tags ===

All of the tags listed here can be accessed through TagItem("tagname"). Some of these tags are actually read-only, and will be noted where appropriate.

==== <code>aa</code> ====

Applies to: <tt>Traits</tt>

Valid values: <tt>1</tt>

The aa() tag is used by GCA to mark ''active armor'' traits, such as those selected in the Apply Armor section of the Protection window. If aa() is not empty, the armor or shield is active, otherwise it is not. GCA will set this value to aa(1), or delete the aa() tag, as appropriate, while in the Protection window. Externally setting the aa() tag to some value is acceptable, but it will have no effect on the character until the Protection window is opened and the tags are read, allowing GCA to reconfigure the armor settings.

==== <code>acc</code> ====

Applies to: <tt>Traits</tt>

Valid values: <code>x</code> | <code>x+y</code> : where <code>x</code> and <code>y</code> are integer values.

The acc() tag represents the ''acc'' value as from the GURPS weapons charts. This is the default ''acc'' value, but may not be the actual ''acc'' value for the particular weapon; for that, see the characc() tag.

<tt>addmode</tt>

<tt>adds</tt>

<tt>apppoints</tt>

<tt>armordivisor</tt>

<tt>baseapppoints</tt>

<tt>basecost</tt>

<tt>basedgroup</tt>

<tt>basedon</tt>

<tt>baselevel</tt>

<tt>basemod</tt>

<tt>basepoints</tt>

<tt>baseqty</tt>

<tt>basescore</tt>

<tt>basevalue</tt>

<tt>baseweight</tt>

<tt>blockat</tt>

<tt>blocklevel</tt>

<tt>bonus</tt>

<tt>bonusbasepoints</tt>

<tt>bonuslevels</tt>

<tt>bonuslist</tt>

<tt>bonuspoints</tt>

<tt>castingcost</tt>

<tt>cat</tt>

==== <code>characc</code> ====

Applies to: <tt>Traits</tt>

Valid values: GCA filled

The characc() tag represents the ''acc'' value as from the GURPS weapons charts, but as it specifically applies to the particular weapon or attack containing this tag. Any bonuses or penalties applied against the trait's acc() value will be reflected in the final characc() value. GCA always calculates this value, so any changes made directly to the tag value will be lost next time GCA recalculates it.

<tt>chararmordivisor</tt>

<tt>chardamage</tt>

<tt>chardamtype</tt>

<tt>chardb</tt>

<tt>chardr</tt>

<tt>charminst</tt>

<tt>charparry</tt>

<tt>charparryscore</tt>

<tt>charradius</tt>

<tt>charrangehalfdam</tt>

<tt>charrangemax</tt>

<tt>charreach</tt>

<tt>charshots</tt>

<tt>charskillscore</tt>

<tt>charskillused</tt>

<tt>childkeylist</tt>

<tt>childof</tt>

<tt>childpoints</tt>

<tt>childrencosts</tt>

<tt>childrenweights</tt>

<tt>college</tt>

<tt>conditionallist</tt>

<tt>control_downto</tt>

<tt>control_upto</tt>

<tt>cost</tt>

<tt>costcnt</tt>

<tt>count</tt>

<tt>countasneed</tt>

<tt>creates</tt>

<tt>currentmods</tt>

<tt>damage</tt>

<tt>damagebasedon</tt>

<tt>damtype</tt>

<tt>db</tt>

<tt>default</tt>

<tt>deffrom</tt>

<tt>deffromid</tt>

<tt>deflevel</tt>

<tt>defpoints</tt>

<tt>description</tt>

<tt>disabled</tt>

<tt>disabledfrom</tt>

<tt>disabledwith</tt>

<tt>display</tt>

<tt>displaycost</tt>

<tt>displayweight</tt>

<tt>dmg</tt>

<tt>doubleinplay</tt>

<tt>down</tt>

<tt>dr</tt>

<tt>duration</tt>

<tt>extralevels</tt>

<tt>extrapoints</tt>

<tt>familiarities</tt>

<tt>features</tt>

<tt>forceformula</tt>

<tt>formula</tt>

<tt>frozencost</tt>

<tt>frozenlevel</tt>

<tt>fullname</tt>

<tt>fullnametl</tt>

<tt>gives</tt>

<tt>gms</tt>

<tt>group</tt>

<tt>hasmods</tt>

<tt>hide</tt>

<tt>hides</tt>

<tt>init</tt>

<tt>initmods</tt>

<tt>inplaymult</tt>

<tt>invalid</tt>

<tt>isparent</tt>

<tt>itemtype</tt>

<tt>keep</tt>

<tt>level</tt>

<tt>levelmult</tt>

<tt>levelnames</tt>

<tt>load</tt>

<tt>location</tt>

<tt>locked</tt>

<tt>locks</tt>

<tt>lockstep</tt>

<tt>mainwin</tt>

<tt>maxdam</tt>

<tt>maxscore</tt>

<tt>mergetags</tt>

<tt>minscore</tt>

<tt>minst</tt>

<tt>modcnt</tt>

<tt>mode</tt>

<tt>mods</tt>

<tt>multpoints</tt>

<tt>name</tt>

<tt>nameext</tt>

<tt>ndl</tt>

<tt>needs</tt>

<tt>needs*disabled*</tt>

<tt>needscheck</tt>

<tt>noresync</tt>

<tt>notes</tt>

<tt>ocount</tt>

<tt>optspec</tt>

<tt>owned</tt>

<tt>owns</tt>

<tt>page</tt>

<tt>parentkey</tt>

<tt>parentof</tt>

<tt>parry</tt>

<tt>parryat</tt>

<tt>parryatbonus</tt>

<tt>parryatmult</tt>

<tt>parrylevel</tt>

<tt>pd</tt>

<tt>pkids</tt>

<tt>pointmult</tt>

<tt>points</tt>

<tt>precountcost</tt>

<tt>precountweight</tt>

<tt>premodscost</tt>

<tt>premodspoints</tt>

<tt>premodsvalue</tt>

<tt>prereqcount</tt>

<tt>race</tt>

<tt>radius</tt>

<tt>raiseruleof</tt>

<tt>rangehalfdam</tt>

<tt>rangemax</tt>

<tt>reach</tt>

<tt>replacetags</tt>

<tt>round</tt>

<tt>roundmods</tt>

<tt>score</tt>

<tt>sd</tt>

<tt>sets</tt>

==== <code>shieldarc</code> ====

Applies to: <tt>Traits</tt>

Valid values: <code>None</code> | <code>Left Arm</code> | <code>Right Arm</code> | <code>Back</code>

The shieldarc() tag is used by GCA to mark specific protection arcs provided by a shield. At this time, these are represented by the specific values shown in ''Valid values''. Additional valid values may be added in the future, but GCA will not currently understand any but those shown here. <code>Left Arm</code> represents the arc from the left flank through the front hexes. <code>Right Arm</code> represents the arc from the front hexes through the right flank. <code>Back</code> represents only the rear hex. GCA will set these values, or delete the tag, as appropriate, while in the Protection window. Externally setting the shieldarc() tag to a value is acceptable, but it will have no effect on the character until the Protection window is opened and the tags are read, allowing GCA to reconfigure the shield arc settings.

<tt>shortlevelnames</tt>

<tt>shortname</tt>

<tt>shots</tt>

<tt>skillused</tt>

<tt>stat</tt>

<tt>step</tt>

<tt>stepoff</tt>

<tt>symbol</tt>

<tt>sysbonus</tt>

<tt>syslevels</tt>

<tt>syspoints</tt>

<tt>taboo</tt>

<tt>taboo*disabled*</tt>

<tt>taboofailed</tt>

<tt>tabootext</tt>

<tt>tier</tt>

<tt>time</tt>

<tt>tl</tt>

<tt>type</tt>

<tt>up</tt>

<tt>upto</tt>

<tt>usernotes</tt>

<tt>value</tt>

<tt>valuenum</tt>

<tt>weight</tt>

==== <code>x</code> ====

Applies to: <tt>Traits</tt>

Valid values: various #Directives

The x() tag serves as a convenient place to store any directives that may be needed for a trait.

=== User Tags ===
...user/custom tag mumble...

== Sections ==
...general section mumble...

=== Header ===
The header section is a special section which must exist, and must also be the first section in the data file.  It consists of a number of required and optional variables.

==== <code>Version=''GDF specification version''</code> ====
The <tt>Version</tt> variable is required and must be the first variable in the header -- more specifically, it must also be the first line in the data file.  Its value is the data file specification version to be used.  All current data files should use the current version of the specification (<tt>3</tt>).

Usage example:
<pre><nowiki>
Version=3
</nowiki></pre>

==== <code>Description=''GDF description''</code> ====
The <tt>Description</tt> variable is optional, but recommended.  Its value is the description of the contents/purpose of the data file.  If the description is long enough that splitting it into multiple lines is desired, each line except the last must end with an underscore.

Usage example:
<pre><nowiki>
Description=This data file contains information taken from the GURPS Supers sourcebook. GURPS Supers is copyright _
    © 1989, 1991, 1996, 2000, 2007 by Steve Jackson Games Incorporated. All rights reserved.
</nowiki></pre>

==== <code>Program=''GCA version''</code> ====
The <tt>Program</tt> variable is optional, but recommended.  Its value is the '''''required minimum''''' version of [[GCA]] needed to correctly load the file.  Useful for ensuring that a data file will not be used with a version of [[GCA]] older than the given version, which may not support all of the features included in the file.

Usage example:
<pre><nowiki>
Program=4.0.348
</nowiki></pre>

==== <code>Requires=''file1[, file2[, fileN]]''</code> ====
The <tt>Requires</tt> variable is optional.  Its value is a comma-delimited list of data file names which '''''must''''' be loaded before the current file.  File names should consist of the full name of the data file (without path info), and must be enclosed in quotes or braces if they contain a comma.  <tt>Requires</tt> is intended for specifying files that the current file is dependent on to work correctly, not necessarily for files that should be loaded when things are being added to the character.  For example, if the file includes commands that change previously loaded data definitions, <tt>Requires</tt> would be a good bet to use.

Usage example:
<pre><nowiki>
Requires="GURPS Basic Set 4th Ed.--Characters.gdf", "GURPS Powers 4e.gdf"
</nowiki></pre>

==== <code>LoadAfter=''file1[, file2[, fileN]]''|''All''</code> ====
The <tt>LoadAfter</tt> variable is optional.  Its value is a comma-delimited list of data file names, or the special keyword <tt>All</tt> to denote all files, which '''''should''''' be loaded before the current file.  File names should consist of the full name of the data file (without path info), and must be enclosed in quotes or braces if they contain a comma.  <tt>LoadAfter</tt> is intended for specifying files that the current file should be loaded after, but is not dependent on to work correctly.

Usage examples:
<pre><nowiki>
LoadAfter="GURPS Ultra-Tech 4e.gdf"
</nowiki></pre>
<pre><nowiki>
LoadAfter=All
</nowiki></pre>

==== <code>Taboo=''file1[, file2[, fileN]]''</code> ====
The <tt>Taboo</tt> variable is optional.  Its value is a comma-delimited list of data file names which '''''must not''''' be loaded with the current file.  File names should consist of the full name of the data file (without path info), and must be enclosed in quotes or braces if they contain a comma.  <tt>Taboo</tt> is intended for specifying files that the current file is incompatible with.

Usage example:
<pre><nowiki>
Taboo="My Custom Data File.gdf"
</nowiki></pre>

==== <code>WorldBook=''SettingName''</code> ====
The <tt>WorldBook</tt> variable is optional.  It accepts only one value, the name of the setting covered by the file, and designates that the file is a World Book (which often contains changes to Basic Set assumptions, and therefore will almost certainly clash with other World Book files not in the same setting).

Multiple files that may all be used for the same setting may all be tagged with the same <code>WorldBook=''SettingName''</code> information, and GCA will not raise notice of a conflict. However, if any files use different <code>WorldBook=''SettingName''</code> values, GCA will raise a flag about the potential conflict.

Usage example:
<pre><nowiki>
WorldBook=Banestorm
</nowiki></pre>

==== <code>Incomplete=''Yes''</code> ====
The <tt>Incomplete</tt> variable is optional.  It accepts only one value (<tt>Yes</tt>) and designates that the file is incomplete or unfinished, a work-in-progress.

Usage example:
<pre><nowiki>
Incomplete=Yes
</nowiki></pre>

=== <code>[AUTHOR]</code> ===
Available Tags: ''none''

The <tt>[AUTHOR]</tt> section is fairly simple: it should consist comments, and nothing else, and all comments following the section marker, until it reaches a new section marker or the end of the file, are considered author information.

Usage example:
<pre><nowiki>
************************************************************************************************************************
*
* GURPS(R) Character Assistant
* Filename: GURPS Basic Set 4th Ed.--Characters.gdf
* Created:  August 24, 2004
* Requires GCA v4 or later!
*
* This data file contains information taken from the GURPS Basic Set: Characters sourcebook. GURPS Basic Set:
* Characters is Copyright(C) 1986, 1987, 1988, 1989, 1991, 1992, 1993, 1994, 1996, 1998, 1999, 2002, 2004 by
* Steve Jackson Games Incorporated. All rights reserved.
*
* Information in this file includes:
*	Attributes
*	Advantages, Disadvantagess, Quirks, Including Bonuses and Penalties.
*	Skills, Including Bonuses, Classes, Needs and Prereqs.
*	Spells, Including Bonuses, Colleges, Needs and Prereqs.
*	Equipment
*	Templates
*
************************************************************************************************************************
*
* David L. Watkins - Major work
* Armin D. Sykes   - Changes, Updates, Packages/Templates
* Craig Roth       - Equipment
* Eric B. Smith    - GURPS Data File Coordinator, Equipment, Updates, Corrections, Skill Categories
*
* If you find any errors or omissions in this file please contact the Data File Coordinator at:
* eric.frogkiller@gmail.com
*
* Or drop a message at:
* http://forums.sjgames.com
*
************************************************************************************************************************
*
* GURPS is a registered trademark of Steve Jackson Games Incorporated, used with GCA by permission of Steve Jackson
* Games. All rights reserved.
*
* The GURPS game is copyright (c) 1986-1989, 1991-1994 by Steve Jackson Games Incorporated. This product includes
* copyrighted material from the GURPS game, which is used by permission of Steve Jackson Games Incorporated. All
* rights reserved by Steve Jackson Games Incorporated.
*
************************************************************************************************************************
</nowiki></pre>

You are strongly encouraged to use this, or a similar format, for your <tt>[AUTHOR]</tt> section.  Regardless of the format chosen, you should definitely include: the name of the data file, which version of [[GCA]] it's for, any appropriate copyright notices from the source used to create the data file (''don’t forget this!''), what the data file includes, and contact information so users of the file can get in touch with you if they have questions or problems.

=== <code>[SKILLTYPES]</code> ===
...skill type section mumble...

=== <code>[BASICDAMAGE]</code> ===
...basic damage section mumble...

=== <code>[CONVERTDICE]</code> ===
Available Tags: <code>break()</code>, <code>adddice()</code>, <code>subtract()</code>

This section allows you to tell GCA the method to use when converting extra damage bonus additions to damage dice instead, as per the Optional Rule: Modifying Dice + Adds (p. [[GCA Abbreviations|B]]269).

When GCA finds this section in a data file, it clears any previously defined <tt>[CONVERTDICE]</tt> values, even if the new section is blank.  Each line defines a new <tt>[CONVERTDICE]</tt> instruction, and consists of three tags:

'''<code>break(''breakvalue'')</code>, <code>adddice(''addvalue'')</code>, <code>subtract(''subtractvalue'')</code>'''

If the bonus is <code>''breakvalue''</code> or more, GCA will add <code>''addvalue''</code> to the damage dice and subtract <code>''subtractvalue''</code> from the bonus value.  When applied, each instruction is used, repeatedly, until its <code>''breakvalue''</code> test fails, at which point processing continues with the next instruction, if any.

Usage example:
<pre><nowiki>
break(7), adddice(2), subtract(7)
break(4), adddice(1), subtract(4)
</nowiki></pre>

Which tells GCA: If there is a bonus of +7 or more, subtract 7 from it and add 2 dice to the damage. If there is a bonus of +4 or more, subtract 4 from it and add 1 die to the damage.

=== <code>[ATTRIBUTES]</code> ===
...attributes section mumble...

=== <code>[ADVANTAGES]</code> ===
...advantages section mumble...

=== <code>[PERKS]</code> ===
...perks section mumble...

=== <code>[DISADVANTAGES]</code> ===
...disadvantages section mumble...

=== <code>[QUIRKS]</code> ===
...quirks section mumble...

=== <code>[SKILLS]</code> ===
...skills section mumble...

=== <code>[SPELLS]</code> ===
...spells section mumble...

=== <code>[EQUIPMENT]</code> ===
...equipment section mumble...

=== <code>[TEMPLATES]</code> ===
...templates section mumble...

=== <code>[GROUPS]</code> ===
...groups section mumble...

=== <code>[LISTS]</code> ===
...lists section mumble...

=== <code>[MODIFIERS]</code> ===
...modifiers section mumble...

==See also==
*[[List of GCA file types]]


[[Category:File types]]
Return to GCA Data File.
Retrieved from "http://www.misersoft.com/gca/wiki/index.php/GCA_Data_File"
View source

From GCAWiki

Views

Personal tools

Navigation

Search

Toolbox
