You are provided with a plethora of tags to use in your homebrew's json that elevates the style and functionality of your product to another level. The basic format of a tag is {@[tagname] [your text]}, but some tags get a little more complex. Tag properties with an asterisk * are required. Each of these tags are described in detail below.
When you see [display] in a tag format (typically on reference tags), that means that whatever you put there will be displayed rather than the default.
This paragraph is an example of how tgas tags are used. You can link to skills like athletics, careers like Captain of Starships, or any other resource (baked in and homebrew) provided here.
{@b This} paragraph is an {@i example} of how {@s tgas} tags are used. You can link to skills like {@skill athletics||crb}, careers like {@career starship captain|Captain of Starships|crb}, or any other resource (baked in and homebrew) available on this website.
Style tags don't provide any functionality, but they allow you to style your content such as by making text bold, italicized, etc.
- The format of the bold tag is {@i [text*]}.
- The bold tag makes text bold!
- The format of the italic tag is {@i [text*]}.
- The italic tag makes text italicized!
- The format of the title tag is {@s [text*]}.
- The
striketag puts a strikethrough over your text.
- The format of the title tag is {@title [text*]}.
- The title tag makes the wrapped text look like a title, for example in the core rulebook it is common to see Genesys written as Genesys.
More straightforward tags, the dice and symbol tags allow you to insert dice and symbols into your text!
The format for dice tags is {@dice [name*]|[quantity]|[upgrades]}.
Dice tags are the first tags to introduce the pipe | symbol. Every type of Genesys die can be rendered and you can use the die name or color to do so:
- j {@dice boost} {@dice blue} {@dice b}
- j {@dice setback} {@dice black} {@dice k}
- k {@dice ability} {@dice green} {@dice g}
- k {@dice difficulty} {@dice purple} {@dice p}
- l {@dice proficiency} {@dice yellow } {@dice y}
- l {@dice challenge} {@dice red} {@dice r}
If you need to display multiple instances of the same die, you can do so like this: jj {@dice boost|2}.
If you ever find yourself needing to display a set of dice with upgrades, use the third option: llkkk {@dice ability|5|2}.
The format for difficulty tags is {@difficulty [difficulty*]|[skill]|[upgrades]}
Difficulty tags are used to conveniently display the difficulty ratings of various things.
- Simple (-) {@difficulty simple}
- Easy (k) {@difficulty easy}
- Average (kk) {@difficulty average}
- Hard (kkk) {@difficulty hard}
- Daunting (kkkk) {@difficulty daunting}
- Formidable (kkkkk) {@difficulty formidable}
You can also add skills to the tag through the use of a pipe: Hard (kkk) Melee check {@difficulty hard|melee}.
If you need to display an upgraded difficulty, the third option is a number representing how many dice to upgrade: Hard (llk) {@difficulty Hard||2}.
The format for the symbol tag is {@symbols [symbol characters*]}.
The symbol tag renders all of the various Genesys symbols. Conveniently, the letters "o" and "r" are not used in the symbol font, meaning you can easily write "or" inside of the symbol tag, or example aaa or t {@symbols aaa or t}.
Symbol characters
- a {@symbols a}
- s {@symbols s}
- t {@symbols t}
- h {@symbols h}
- f {@symbols f}
- d {@symbols d}
The format for power tags is {@[combat/general/social*] [power]}
Introduced in the Expanded Player's Guide are power levels, approximate estimations of an adversaries power.
- c5 {@combat 5}
- g5 {@general 5}
- {@social 5}
These are tags you may find useful, but also may never need.
The format for external link tags is {@link [address*]|[display]}
This is for linking to outside sources. Use only when necessary. Here is an example that links to Google {@link https://google.com|Google}. This will always open a new tab.
The format for internal link tags is {@genesysref [address*]|[display]}.
This tag is for linking to internal pages. Typically you will want to use reference link tags when linking to a specific career, adversary, etc. The internal link tag is for linking to general pages of this website, and in the future will allow for linking to a specific page and auto-applying filters.
Here is an example that links to the Getting Started Homebrew Helper page {@genesysref /api/homebrew-helper/getting-started}. This will not open a new tab.
The format for filter tags is {@filter [item type]|[display]|[filter string]}.
This tag is for creating links to item type page with pre-set filters, and is by far the most complicated tag to work with as filter groups and filter names use json references that aren't obviously exposed anywhere since they are generated using collection data. To learn more about filters, check GenesysRef's indexeddb values or ask in the Discord.
A filter string is formatted as: [filterGroup]:[filterName]=[value],[filterName]=[value];[filterGroup]:[filterName]=[value];....
Here is a filter that links to Archetypes and filters by CRB, not 1 Brawn, and for wound thresholds between 8 and 9 (inclusive): {@filter archetype|Here|source:core-rule-book=1;brawn:1=2;wt:min=8,max=9}.
property
description
filterGroup*
The name of the filter group, ie. "source"
filterName*
The name of the filter, ie. "genesys-core-rulebook". If the filter is a slider, the name must be "min" or "max".
value*
One of: 0 (off), 1 (yes), 2 (no), or any number if the filter is a slider (within the bounds of the filter for best results).
The format for reference link tags is {@[reference] [name*]|[display]|[source]}
This is probably the coolest tag around. The reference link tag is what you will use to link to specific careers, adversaries, gear, etc. and will create the fancy little popover hint box.
By default, the reference link tag will assume the Core Rulebook as the source and will search the source by the reference and name provided. If you need to change the source but don't want to provide a different display, use the format: {@[reference] [name*]||[source]}. The provided source must match the abbreviation of the target source.
More tags will be added as more content becomes available.
Tip: To type Æ hold down alt and type 0198, or for æ type 0230.
Reference Link Tag Options
- Adversary: Bane Spider {@adversary Bane Spider}
- Archetype: Elf {@archetype Elf}
- Career: Æmbermancer {@career Æmbermancer||sotc}.
- Characteristic: Brawn {@characteristic Brawn}
- Gear: bandage {@gear painkiller|bandage}
- Quality: blast {@quality blast}
- Option/Feature: great wall {@optionFeature great wall||sotb}
- Rule: Collisions {@rule Collisions}
- Setting: modern day {@setting modern day}
- Skill: athletics {@skill athletics}
- Spell: Attack {@spell Attack}
- Table: Table I.5-4: Repairing Gear {@table I.5-4: Repairing Gear}
- Talent: finesse {@talent finesse||rot}
- Vehicle: Four Door Automobile {@vehicle Four Door Automobile}