Menu
▾
▴
UnderstandingSETool
The SE tool is the main entrypoint into Simcraft Explorer. It essentially generates all gear profiles given conditionals about what gear you are interested in. In this Wiki page, we'll describe how to use SE.
1. About Gear Profiles
SE uses a standard format for gear profile information that can be imported from Wowhead or other sources. The Simcraft Explorer comes with its own gear profile lists, which you can find in the following location:
%SE_ROOT%\profiles\T19M\hunter
Gear is listed by slot in the directory and you can also add action lists, preactions (prepotting, etc.), and postactions (such as summoning pets). Most of the files in this directory are self explanatory if you've ever used Simcraft to edit action lists, but leaving these blank is ok. What that means is that Simcraft can use the default APLs included in the class module.
Anyway, let's look at an entry in one of the slots. Gear in a Simcraft Explorer profile entry is specified in the format following format:
1:id;2:unique_name;3:descriptive_name;4:gear_properties;5:simcraft_attributes
As an example, the following is a line from %SE_ROOT%\profiles\T19M\hunter\trinkets.txt:
140796;entwined_elemental_foci;Entwined Elemental Foci;raid=1,type='drop',boss='Aluriel',location='Nighthold',ilvl=850,mythic=1,quality='epic';ilevel=850
So, 1:id is 140796. This id is the unique id you can lookup the item on wowhead from e.g., http://www.wowhead.com/item=140796. 2:unique_name in this case is entwined_elemental_foci. This is the name Simcraft recognizes as the unique name of the item. Generally, this is formed by changing spaces in the name to underscores. Hyphenations are ignored in the unique name, it appears. 3:descriptive_name is a human-readable name for the item. This is used when reporting by SE tools but is not included in the actual simulation files generated by Simcraft Explorer. 4:gear_properties is knowledge about the gear that can help with gear selection with the SE tool. For instance, in the above, we have indicated the trinket is dropped by Aluriel in Nighthold, has an ilvl of 850, and has an epic quality. If we wanted to very specifically identify this gear, we could create a conditional like "id==140796&&ilvl==850" and it would be this very specific trinket when generated by the SE tool. The final element of a gear entry is 5:simcraft_attributes. This is useful for specifying enchant=, gem=, and certain forcing functions into Simcraft. In this case, we force the item to be item level 850. We could also do this with bonus_ids, but in Legion, bonus_ids became so varied and ridiculous that we have been using ilevel= instead.
2. Selecting Gear with SE
To illustrate the power of SE in selecting gear, we'll show an example script that uses SE to generate all trinket profiles. The following script is used to generate all trinkets for BM in a single target scenario.
%SE_ROOT%\scripts\windows\T19M_bm_st_trinkets.bat
Inside of this script is the following call by SE, which we will break down in a moment.
%SE_ROOT%\se -v 110 -p beast_mastery --back-enchant binding_of_agility --fingers-enchant binding_of_mastery --neck-enchant mark_of_the_hidden_satyr -b 20 --allow-empty -i 10000 -s %SE_ROOT%/profiles/T19M/hunter -d . --gear-check "ilvl==895&&bm_default" --back-check "tier&&ilvl==895&&bm_default" --head-check "tier&&ilvl==895&&bm_default" --legs-check "tier&&ilvl==895&&bm_default" --chest-check "boss=='Nightbane'&&bm_default" --shoulders-check "tier&&ilvl==895&&bm_default" --mh-check "ilvl==925&&bm_default" --hands-check "tier&&ilvl==895&&bm_default" --trinket1-check 0 --trinket2-check 1 -g -r blood_elf -t 2202012 -x T19M > T19M_se_out.txt 2>&1
Now, some basic things here. -v 110 means to set the character level to 110. -p beast_mastery indicates that the profiles will all be beast_mastery. --back-enchant, --fingers-enchant, and --neck-enchant all indicate enchants that should be applied to those gear slots. -b 20 indicates that batches of 20 profiles should be fed into Simulationcraft. This seems to be a sweetspot that Simulationcraft handles well, but you can change this to 50 or so if you want which may speed things up slightly. --allow-empty allows for empty slots to be specified. For trinket sims, since we only sim 1 trinket and not combinations of all trinkets (which would take forever), this is necessary. -i 10000 means that we specify 10,000 iterations in simcraft. -r blood_elf specifies a race of Blood Elf. -t 2202012 specifies a talent string of 2202012, and -x T19M means that we use a prefix of T19M for all generated files.
Now, the gear-related checks are where things get interesting. We specify a base --gear-check of "ilvl==895&&bm_default". This goes through all gear slots and selects anything that is exactly ilvl of 895 and also that has bm_default enabled. We then hone the gear check with specific gear checks. For instance, on the back piece, we overwrite the gear_check to specific that we want to also have tier here. Same with head, legs, hands, and shoulders. On chest, we select the Nightbane chest, and the main hand (--mh-check), we want a 925 version of our artifact. --trinket1-check of 0 means that no items can satisfy our conditional for trinket1 slot. The trinket2-check however is 1 which means that the conditional always returns true (1), so all trinkets should be generated into trinket2 slot.
3. Getting help with SE
SE has its own built-in help system. Simply run the following:
%SE_ROOT%\se -h
And read the description of each feature.
4. Running what we generate
SE will generate a .bat file that can be ran to simulate all of the profiles we generated. The run file will adhere to the following convention:
<prefix>_run.bat
In the above, we specified -x T19M, so the run file would be called:
T19M_run.bat
4. After running
After you have completed your sim, the results will be in XML files that can be parsed by the SER tool
