Equipment.wiki

This documentation is a part of the TCI reference.

Is there an error? Something missing? Funky grammar? Do not hesitate to leave a comment.

Declaring items

Syntax

Equipment pieces are declared through the following syntax: <slot>=<item_name>[,<option1=value1>,<option2=value2>,...] The item name is used by replacing any white spaces with underscores. Note that some names have built-in support: for example, the Shadowmourne proc is hardcoded into Simulationcraft and you don't need to specify it. For example:

 # The following line is valid but it only adds a dummy helmet with no stats.
 head=dummy_headgear

 # This will add a rakata force masters's headgear.
 # Its stats are ( 44 + 37 + 24 ) endurance, ( 61 + 61 ) willpower, ( 11 + 37 ) power and 51 alacrity.
 head=rakata_force_masters_headgear,stats=44end_61willpower__37end_61willpower_11power__24end_37power_51alacrity

Slots keywords

Acceptable slots are:

• head
• ear
• shoulder, shoulders
• back
• shirt
• chest
• waist
• wrist, wrists
• hand, hands
• implant1, implant2
• relic1, relic2
• main_hand, off_hand
• ranged
• tabard

Options

Importing stats through ID

• id (default: 0) can be used to specify the item's id and force the application to query the stats, the quality and armory type from the items importation sources (see the items data importation section). The returned parameters will replace those you may have specified.

 # Let's import our helm's stats
 head=earthen_helmet,id=60325

• source (default: "") can be used to override the item_db_source global setting for this item (see the items data importation section). It uses the same syntax.

 # Let's import our helm's stats from mmo-champion, or local if mmo-champion doesn't work.
 head=earthen_helmet,id=60325,source=mmoc|local

Basic properties

• quality can be used to specify the item's quality. All values are accepted but, for random enchants, it has to be one of "rare", "epic" or "uncommon" i order to figure out the stats values.

 tabard=some_tabard,quality=epic

• ilevel is the item level. It is especially important for random enchants, in order to figure out the stats values.

 tabard=some_tabard,ilevel=359

• type is the armor type, it should be one of "light", "medium", "heavy".

 head=some_helm,type=heavy

Stats

• stats is the sequence describing the stats. The syntax is : <value1><stat1>[_<value2><stat2>_...]. For example: "300force_200surge".

 head=rakata_force_masters_headgear,stats=44end_61willpower__37end_61willpower_11power__24end_37power_51alacrity

• weapon is used to specify the weapons' damage ranges. It is a sequence of options. Syntax is: weapon=<type>[_<option1>=<value1>...]. Type can be one of: dagger, fist, beast, beast2h, sword, sword2h, mace, mace2h, axe, axe2h, staff, polearm, bow, gun, crossbow, thrown. Additional types for wands are: arcane, bleed, chaos, fire, frost, frostfire, holy, nature, physical, shadow, spellstorm, shadowfrost, shadowflame, drain. Options are:
  1. min and max are the damages range.
  2. dmg (or damage) is the weapon's constant damages. It is not used when min and max are set.

 # Here is a lightsaber weapon definition with min and max.
 main_hand=esome_lightsaber,weapon=lightsaber_306min_459max

 # Alernative syntax with average weapon damage
 main_hand=esome_lightsaber,weapon=lightsaber_382.5dmg

Procs

• use allows you to specify on-use effects. The syntax is: <value1><param1>[_<value2><param2>...]. The parameters can be:
  1. Any school abbreviation, for damages effects. For example: "451physical".
  2. Any stat abbreviation, for stats gains. For example: "1500str".
  3. cd or cooldown for a cooldown. For example: "45cd" for a 45s cooldown.
  4. dur or duration for a duration. For example: "15dur" for a 15s duration.

 # Unsolvable riddle: 1605 str on-use effect every 2mins, 20s duration.
 relic1=unsolvable_riddle,stats=321mastery,use=1605str_120cd_20dur

• equip allows you to specify procs. The syntax is: <trigger>_<value1><param1>[_<value2><param2>...]. the triggers can be: on[spell/attack][tick/direct]damage (ex: ondamage, on spelltickdamage, etc), on<school>damage(onholydamage, onphysicaldamage, etc), onspell[cast/direct][hit/crit/miss](ex: onspellhit, onspellcastmiss, etc), onattack[direct][cast/hit/crit/miss] (onattackdirecthit, etc), onharmfulcast, ontick. The parameters are the same as with use and also:
  1. % can be used to specify a proc chance as a percentage. For example: "25%" for a 25% proc chance.
  2. ppm can be used to specify a proc chance per minute. For example: "2ppm" for a proc chance leading to 2 procs per minute.
  3. stack or stacks for a maximum stacks amount. The effect will occur on every stack. For example: "3stacks" for a stackable effect with a maximum of 3 stacks. TOCHECK.
  4. tick can be used to specify the ticks occur periodically. The tick will be the delay, in seconds, between every stack. TOCHECK.

 # "Plasma Burst Device": 168 elemental damages, about 30% chance to proc on damage, 4.5s internal cooldown
 relic1=plasma_burst_device,stats=77end,equip=ondamage_168Elemental_30%_4.5cd

 # Reign of dead (id=47477): You gain a Shard of Flame each time you cause a non-periodic spell critical strike.  When you reach 3 Shards, they will release, firing a Pillar of Flame for 1959 to 2275 damage.  Shard of Flame cannot be gained more often than once every 2 sec.
trinket1=reign_of_dead,equip=onspelldirectcrit_2117Fire_3Stack_2.0Cd

• addon is a shortcut for adding proc effects with a built-in support. For example, addon=pyrorocket is equivalent to specifying use=1165Fire_45cd. For a list of supported procs, you can look at the sc_unique_gear.cpp file.

 # Gloves with pyro-rockets (id=54998) on it.
 hands=some_gloves,addon=pyrorocket

Set bonuses

Set bonuses are automatically added if you have enough set pieces equipped.

You can enable the set bonus manually with with keywords such as set_bonus=rakata_force_masters_4pc. The generic syntax is set_bonus=[set_name]_[2pc/4pc].

Note that enabling the 4pc bonus does not automatically enable the 2pc bonus, so you may want to toggle both of them.

 # Enable the Rakata Force Master's set bonus.
 set_bonus=rakata_force_masters_2pc
 set_bonus=rakata_force_masters_4pc

You can also forcibly disable a set bonus with the syntax 'set_bonus=no_set_name_[2pc/4pc]' when wearing pieces of this set.

 # Forcibly disable the Rakata Force Master's 2pc set bonus.
 set_bonus=no_rakata_force_masters_2pc

Appendix: stats abbreviations

Stats abbreviations are (non-exhaustive list):

• Resources: ammo, energy, focus, force, heat, rage and health
• Primary: str, aim, cun, wil, pre, end
• Secondary: accuracy, crit, alacrity, exp, surge, power, force_power, tech_power
• Defensive: armor, def, shld, abs
• Weapon damages: wdmg, wohdmg