God Editor v1.02
Author: Ballbarian
Email:  semirand@dom3minions.com
Web: http://www.dom3minions.com/~semirand/


About:
*****************
The God Editor is a tool for creating custom AI pretender files (.god)
for SemiRandom.  It may also be useful as an aid in the development
of custom pretenders for non-SemiRandom scenario type maps as well with
some slight modification of the output.


Requirements:
*****************
The God Editor was developed in VB6 and will therefore require
the VB runtime dll which you probably already have on your system.
If not, it is widely availble on the net. (If you are having problems
with the vb libraries, Gooles and Gandalf reported having some luck
with this link: http://www.ascentive.com/support/new/libraryfiles.exe

The God Editor will also require SemiRandom.  If you are using
the RanDom map generator, then you will already have SemiRandom.


To Install:
*****************
Place the D3GEv102 folder in your dominions3 directory (you should
have a SemiRandom folder here as well).  I would recommend taking
a moment to create a shortcut to GodEdit.exe and place the
shortcut on your desktop, or somewhere convenient for you.


Getting Started:
*****************
The first time that you run GodEdit.exe, you will see an open
dialog.  Use this to locate SemiRandom\SemiRandom.exe.

Once the program is loaded, you should see a window split into two
distinct sections...

The top section contains four tabs.  In theory, you should be able
to walk through the process of creating a god file somewhat like
reading a book.  Work from the top left corner to the bottom right
and then move on to the next page and continue.  In practice, you
will likely find yourself skipping back and forth as the theme for
the god develops.

The bottom section contains the "Unit Finder".  Use the controls at
the left to set various filters and remember to hit the [Apply Filters]
button to uhh... apply them.  Use the right dropdown box to browse
units by name.  Tip: Use the up/down arrow keys to browse the list
and the description box will update as you browse.  Tip2:  If you
select a unit, notice that the grey box will fill with a blue unit
number.  This is a link to that unit in the Online Unit List and
clicking it will open that units information page in your default web
browser.  The user name and password are provided at the bottom of the
window for your convenience.  These blue unit links also appear in the
poptype and magic site selectors.

Take note of the 2 green [?] buttons.  Pressing these will open
and close a help window which will update with information as your
mouse moves over various control sections.

The first time you create a pretender god, remember to change the
author name from the default to something original to you!  This
will help to prevent conflicts with other users gods.  The
index number will auto increment when you save your god,
but you can change it manually as well if needed.


Simple as 1,2,3:
*****************
Step 1 - > This tab is where you build the god file name.  This step
is very important as it will tell SemiRandom which nation your god is for
and how to handle it when it modifies a map file.

Step 2 - > This tab is where you can set some key attributes of the
province where the god is placed.  The province name, population and type,
and features may all be set here.

Step 3 - > This tab is where you can build a garrison for the province and
select pretender chasis, set dominion strength, scales, commanders and their
attributes, magic, items, bodyguards, units, etc.  As you work through the
sub tabs, use the [Submit] bottom to add commands to the code box at the left.
You can also edit this manually.

Step 4 - > This tab is where you can preview your creation and save it if
it is ready.  You may return to previous steps at any time and your changes
will be updated when you return.  Use the [Save As] button to select a location
to save the god file without adding it to SemiRandom's god list.  Use the
[Save and Add] button to automatically save the god file to your SemiRandom
god directory and add it to your god list so that it is available for use
the next time you SemiRandomize a map.  Use the [Clear Garrison] button to
clear the code box containing units and commanders from Step 3.  Use the
[Clear All] button to reset every control back to a fresh start.  Do not hit
these buttons accidentally, because there will be no warning box asking you
if you are sure that you want to!


Sharing is good:
*****************
Remember to share your best thematic creations with the community!  You may
submit god files, gan files, name lists, and RanDom settings to:
      semirand@dom3minions.com


Forum Discussions:
*****************
RanDom version 2
http://www.shrapnelcommunity.com/threads/showflat.php?Cat=&Number=523661

Province Editor
http://www.shrapnelcommunity.com/threads/showflat.php?Cat=&Board=d3smm&Number=528292

RanDom version 1 (OLD)
http://www.shrapnelcommunity.com/threads/showflat.php?Cat=&Number=496176

SemiRandom version 0.95 (OLD)
http://www.shrapnelcommunity.com/threads/showflat.php?Cat=&Number=496171

Online Unit Reference
http://www.shrapnelcommunity.com/threads/showflat.php?Cat=&Number=497152


Special thanks to EricM for supplying the organized unit sprites without which
the preview images would not have been possible.
