SimC String Format

Overview

The SimulationCraft WoW addon exports a plain text profile string (not JSON). It’s copy-pasted by the user into the app. This document details the exact format and parsing rules.

Full Annotated Example

# SimC Addon 11.0.5-01
# Requires SimulationCraft 1210-01 or newer

# Player: Thrall - Draenor - EU
# Spec: Enhancement Shaman
# Build: 11.0.5.57400

shaman="Thrall"          ← class="characterName"
level=80
race=orc
region=eu
server=draenor
role=attack
professions=Blacksmithing=100/Leatherworking=100

spec=enhancement
talents=BYQAAAAAAAAAAAAAAAAAAAAAgUSShQSQJRSSJkQSJ...

# ---- EQUIPPED GEAR ----
head=,id=235602,bonus_id=10355/10257/1498/8767/10271,gem_id=213743,enchant_id=7359
neck=,id=235610,bonus_id=10355/10257/1498/8767/10271,enchant_id=7361
shoulder=,id=235604,bonus_id=10355/10257/1498/8767/10271
trinket1=,id=235616,bonus_id=10355/10257/1498/8767/10271
trinket2=,id=235617,bonus_id=10355/10257/1498/8767/10271
main_hand=,id=235620,bonus_id=10355/10257/1498/8767/10271,enchant_id=7444

# ---- BAG ITEMS ----
# head=,id=229379,bonus_id=10390/10257/1498/8767/10271,gem_id=213743,enchant_id=7359
# trinket1=,id=225652,bonus_id=10390/10257/1498/8767/10271
# finger1=,id=225639,bonus_id=10390/10257/1498/8767/10271,enchant_id=7340

Parsing Rules

Character Metadata

Parse as key=value pairs:

Line Pattern	Parsed As
`shaman="Thrall"`	class=shaman, characterName=Thrall
`level=80`	level=80
`race=orc`	race=orc
`region=eu`	region=eu
`server=draenor`	realm=draenor
`spec=enhancement`	spec=enhancement
`talents=<base64>`	talentString (passed through unchanged)

Supported class keywords: warrior, paladin, hunter, rogue, priest, deathknight, shaman, mage, warlock, monk, druid, demonhunter, evoker

Equipped Gear Lines

Format: slot=,id=N[,key=value]*

Field	Format	Notes
`id`	Single integer	Required
`bonus_id`	`/`-separated integers	Optional, determines ilvl/stats
`gem_id`	`/`-separated integers	Optional, 1 per socket
`enchant_id`	Single integer	Optional
`craft_stat`	`/`-separated integers	Ignored (crafted gear)

Known slot names: head, neck, shoulder, back, chest, wrist, hands, waist, legs, feet, finger1, finger2, trinket1, trinket2, main_hand, off_hand

Bag Items

Same format as equipped lines but prefixed with # (hash + space):

# head=,id=229379,bonus_id=10390/10257/1498/8767/10271

Parse identically to equipped lines. Tag with isEquipped: false.

Lines to Ignore

# SimC Addon ... header comments
# Requires SimulationCraft ...
# Player: ..., # Spec: ..., # Build: ...
professions=...
role=...
Empty lines

Lines to Preserve

Store ALL original lines in rawLines so profile reconstruction can replace only the gear lines it needs and pass everything else through unchanged.

Profile Reconstruction

To build the SimC input for one combination:

Clone rawLines
For each slot in the combination, find the first non-commented line for that slot and replace it with the chosen item’s line
Join with \n