Running SimulationCraft

!!! READ THIS FIRST !!!

SimulationCraft comes with two executables

• simc.exe => A command-line-only interface, containing the core engine.
• simcqt.exe => A GUI built using Qt wrapped around the engine.

Quick Start Guide

• There are a number of configuration scripts shipped with the simulator
• Some are single-player scenarios: Rogue_T8_51_13_07.simc Warlock_T9_00_13_58.simc etc
• Some are multi-player single-class scenarios: Druid_T8.simc Hunter_T8.simc etc
• Some are multi-player multi-class scenarios: Raid_T8 etc

• Windows Users
• To simulate one or more config files, drag-n-drop them on top of simcqt.exe
• It will load the contents of the files dropped into the Simulate tab
• Click the Simulate! button and wait for the report
• For custom invocations, open a command-prompt window and run: simc.exe CONFIG1 CONFIG2 Parm1=Value1 Parm2=Value2 ...
• ALTERNATIVELY: If you double-click a .simc file Windows will ask you what program to use
• Choose the option to pick from a list
• Navigate to the directory where SimulationCraft is installed
• Select simcqt.exe (not simc.exe!)
• Make sure you check the box used to remember this setting
• From now on, you simply double-click the config file to run it

• UNIX Users
• The config files are tagged as executable, so they can be executed as-is: ./Raid_T8.simc
• To generate scale factors: ./Warlock_T9_00_13_58.simc calculate_scale_factors=1 iterations=10000

Basic Syntax

simcraft parm1=value1 parm2=value2 parm3=value3 ...

• Parameter values may be of the following three forms
• integer denotes an integer numeric value
• float denotes a floating point numeric value
• string denotes a string of characters
• boolean denotes a 1 (one) or 0 (zero)
• The same parameter may be specified multiple times on the command line and/or in multiple files
• The last value encountered will be used, with no warnings about values being over-written.
• A complete list of parameters can be found by looking at the parse_option() function in each of the .cpp files.

File Input/Output

• input=string

Since there are far too many parameters to conveniently specify on the command line, parameter files are convenient ways to drive the tool. SimulationCraft comes with several default config files that are good starting points. It should be noted that multiple parameter files can be specified with multiple input= directives.

• output=string

By default, the tool will generate text output to the console screen. However, unless one is running inside a console window that enables convenient scrolling, it is advisable to throw the output to a file to view in your favorite editor.

• html=string

If the html option is used, then it will generate an HTML file containing tons of interesting graphs detailing player performance. It is recommended to use a .html extension in the file name.

Detailed Examples

See Examples.simc for more detailed examples.