Menu

Tree [ef0ad0] master /
 History

HTTPS access


File Date Author Commit
 docs 2015-01-12 Effinhunter Effinhunter [e95f87] * Updated README and examples with SEA tool usage
 images 2017-06-17 Effinhunter Effinhunter [1f3585] * Added new Tomb trinkets
 installer 2017-04-20 Effinhunter Effinhunter [17cae8] * Added libcurl copy for installer dependency
 profiles 2017-10-11 Effinhunter Effinhunter [c7280c] * Adding sephuz trinket scripts for MM and SV
 scripts 2017-10-11 Effinhunter Effinhunter [ef0ad0] * Adding scripts for MM and SV with and without...
 src 2017-10-10 Effinhunter Effinhunter [6b8fe6] * Updated for latest simcraft and gear options
 LICENSE.txt 2017-04-20 Effinhunter Effinhunter [19c5b5] * Updated to version 7.202.1
 README.txt 2015-02-23 Effinhunter Effinhunter [84715a] * Fixed issue in README.txt with regards to con...
 VERSION.txt 2017-06-17 Effinhunter Effinhunter [1f3585] * Added new Tomb trinkets
 default.features 2015-06-07 Effinhunter Effinhunter [de14c8] * Added tier enable to T18 items
 doxygen_help_gen.mpb 2014-10-15 Effinhunter Effinhunter [b66fda] * Initial commit
 se.mpc 2016-09-05 Effinhunter Effinhunter [a2d102] * Updated T19 scripts for gear slots
 se.mwc 2014-10-15 Effinhunter Effinhunter [b66fda] * Initial commit
 using_ace.mpb 2014-10-15 Effinhunter Effinhunter [b66fda] * Initial commit
 using_curl.mpb 2015-06-07 Effinhunter Effinhunter [de14c8] * Added tier enable to T18 items
 using_madara.mpb 2014-10-15 Effinhunter Effinhunter [b66fda] * Initial commit

Read Me

Simcraft Explorer includes two tools: se and ser. These tools are located in
the bin directory.

For example usage, please see docs/examples.txt

To see help for each tool, provide a -h or a --help. An invalid option
will also bring up a help menu.

If you find bugs, please feel free to contact the author Effinhunter at
effinhunter@gmail.com

******************************* VERY FIRST STEPS ***************************

Download Simcraft from http://downloads.simulationcraft.org/. Extract the
latest version and then set two environment variables to let SE and SER know
where to find your Simcraft executables.

  SIMCRAFT_ROOT needs to point to the directory you put Simcraft in
  SIMCRAFT_BIN needs to list the simc command line tool (e.g. sim64.exe)

So, if you had downloaded Simcraft and extracted the contents of the zip file
to c:\simcraft, you would set the variables up to point to the following:

  SIMCRAFT_ROOT=C:\simcraft\{a folder with a name like "simc-603-7-win64")
  SIMCRAFT_BIN=simc64.exe


Unfamiliar with how to set environment variables on Windows?

Best way to set variables permanently is by doing the following:

1.) Go to Start Menu, Right-click on Computer or My Computer.
2.) Click Properties
3.) Click Advanced System Settings
4.) Click Environment Variables
5.) Click New and enter your variables. You'll probably just want to use the
    top New button for User-level variables. Set SIMCRAFT_ROOT and SIMCRAFT_BIN
    here. SIMCRAFT_ROOT should point to the location that actually has simc64
    in it. It's probably going to be something like C:\simcraft\simc-603-7-win64
    or something like that.
6.) Close any terminals you had open as they'll not have the environment variable
    updates. Open new terminals. You can check if these are set by doing the
    following:

    echo %SIMCRAFT_ROOT%

If you had set SIMCRAFT_ROOT=C:\simcraft\simc-603-7-win64, then that's what
should print out. If it just says %SIMCRAFT_ROOT% in response, then you've
messed up somewhere, and you'll want to try the list again above.

******************************* EXAMPLE USAGE SEA **************************

In version 0.6.3, the "sea" tool was added to allow targeted Simcraft profiles
of any gear upgrades from Highmaul, Blackrock Foundry, Crafted, or BoE gear
along with your armory information. At the moment, this tool is in an early
prototype phase, but it does have some very powerful features:

1.) You can specify any gear categories or tags that are important to you using
    the syntax from the "se" tool, including --gear-check, --gear-enchant, and
    --gear-gem. Use -h for help.
2.) You can specify your armory string in the form of country,realm,char, e.g.,
    us,area+52,Effinhunter would snag the author's character from the Blizzard
    armory
3.) A batch script is generated for running the Simcraft profile and generating
    an HTML output that you can browse, just like any other Simcraft result in
    the GUI.

Example 1: Generate all Highmaul, max crafted, and world drops for Effinhunter SV spec

%SE_ROOT%\sea -a "us,area+52,Effinhunter" --gear-check "(location=='Highmaul'&&ilvl>=670&&!warforged&&!socketed)||(type=='crafted'&&(bonus_id==527||bonus_id==66/527))||location=='World'" --gear-enchant ms --gear-gem ms -x Effin_SV -p survival -s %SE_ROOT%\profiles\T17M\hunter\all_items
.\Effin_SV_run.bat

Example 2: Generate all Highmaul, max crafted, and world drops for Effinhunter MM spec

%SE_ROOT%\sea -a "us,area+52,Effinhunter" --gear-check "(location=='Highmaul'&&ilvl>=670&&!warforged&&!socketed)||(type=='crafted'&&(bonus_id==527||bonus_id==66/527))||location=='World'" --gear-enchant ms --gear-gem ms -x Effin_MM -p marksmanship -s %SE_ROOT%\profiles\T17M\hunter\all_items
.\Effin_MM_run.bat

******************************* EXAMPLE USAGE SE ***************************

USING SE

  "se" is an application to generate simulation profiles. If we want to sim
  a complete race breakdown of all gear, specs, talents, and races with action
  lists provided in this installer, we would do the following:

    se -s %SE_ROOT%\profiles\T17M\hunter

RACES

  This will generate a LOT of profiles. So, be wary. Let's narrow down the
  generation a bit. First, let's specify a single race of troll.

    se -s %SE_ROOT%\profiles\T17M\hunter -r troll


SPECS

  Now, let's limit the simulations to Marksmanship (case sensitive)

    se -s %SE_ROOT%\profiles\T17M\hunter -r troll -p marksmanship


TALENTS

  We can further narrow our scope by specifying the talents we want. For
  talents, we use the Simcraft string that will be used in the talent section.
  This is a 4 length list of indexes for the last four tiers of talents (the
  dps talents). Each entry starts at 1. For example, here is how to
  reference talents in Hunter Tier 60.

  Tier 60:

  1 - Steady Focus (First column in the tier)
  2 - Dire Beast (Second column in the tier)
  3 - Stampede (Third column in the tier)

  To limit our runs to having Thrill of the Hunt, Stampede, Barrage, and
  Adaptation, we would specify 3333, like so:

    se -s %SE_ROOT%\profiles\T17M\hunter -r troll -p marksmanship -t 0003333

PREFIX

  By default, se generates files with a prefix of "Hunter", but you may want
  to make it more descriptive for what you are trying to test out. For
  instance, for the above, we might do "T17M_Troll_MM" like so

    se -s %SE_ROOT%\profiles\T17M\hunter -r troll -p marksmanship -t 0003333 -x T17M_Troll_MM

GEAR

  By default, we would include all possible gear profiles, but some gear
  configurations may be obviously subpar. For instance, in T17M, the legendary
  ring is BiS. We can specify that we want to always wear this ring by
  specifying its index in the appropriate gear listing. To understand gear
  listings, let's first go over the indexing system in the gear limiter string.

  A gear limiter string is at least 15 characters long and each character
  corresponds to limiting the following items:

                    [0] Head              [7] Waist
                    [1] Neck              [8] Legs
                    [2] Shoulders         [9] Feet
                    [3] Back             [10] Finger 1
                    [4] Chest            [11] Finger 2
                    [5] Wrists           [12] Trinket 1
                    [6] Hands            [13] Trinket 2
                   [14] Main Hand Weapon

  The rings are indices 10 and 11. So, if we want to equip a certain ring,
  we would want to modify one of these two entries with the appropriate item.
  To find the items, we look in the source directory (profiles\T17M\hunter in this
  case) and check the contents (e.g. finger.txt in this case).

    113877;unexploded_explosive_shard;...
    113917;cinderwolf_signet;...
    118307;spellbound_runic_band_of_unrelenting_slaughter;...

  The legendary ring is the 3rd item in this list, which is index 2. So,
  to limit the gear to using this ring in first ring slot, we would do:

    se -s %SE_ROOT%\profiles\T17M\hunter -l xxxxxxxxxx2xxxx

  This would generate all possible profiles that use this legendary ring.

TESTING

  If you'd like to run sample configurations to see how many profiles would
  be generated, simply pass the -0, --test or --no-generate options like so:

    se -s %SE_ROOT%\profiles\T17M\hunter -l xxxxxxxxxx2xxxx --no-generate

  You can also debug your configurations with the -g option (--debug)

RUNNING YOUR SIMS

  There will be a .bat file generated in the destination directory (default
  is current directory) that you can click on or call from inside a command
  line terminal. It will begin with the prefix you specified followed by
  _run.bat. So, for a default prefix, this file will always be named:

    Hunter_run.bat

  Click the file and it will execute.

******************************* EXAMPLE USAGE SER ***************************

ser is a bit easier to use because it has less options. You'll need to know
the prefix and output locations used with the "se" tool to generate the
simcraft profiles. Otherwise, the options are pretty straightforward and
you can get help with -h, --help or an invalid option.

Most profiles will simply need to specify source and destination directories
for results and the prefix used to generate with "se". For instance...

  ser -d . -s . -x Hunter

This would read simulation results from running Hunter_run.bat and aggregate
them into a report called Hunter_report.txt. You can also generate a BBC
forum post with the -f option like so:

  ser -d . -s . -x Hunter -f my_results.txt

Your forum post with BBC codes will be found in my_results.txt
Want the latest updates on software, tech news, and AI?
Get latest updates about software, tech news, and AI from SourceForge directly in your inbox once a month.