Utility SemiRandom version 095

Ballbarian · #9 March 6th, 2007, 10:58 PM

Looks good!

If you have already downloaded SR, then you already have this, but I will paste the relevant details copied from the included readme below:

Code:



How to author GAN scripts (province files):

===========================================

It is assumed that you are familiar with map commands and map editing. The 

format is pretty simple for editing GAN scripts and there are just a few rules 

& suggested steps:

1. Look at existing GANs as a guide.

2. You do not need to add #nostart.  This is added automatically.

3. You do not need to add #setland or #land.  This is handled in the filename. (see below)



GAN FILENAME FLAGS:

-------------------

<Climates>

_HOT_   Hot Zone (southern map)

_CLD_   Cold Zone (northern map)

_TMP_   Temperate Zone (mid map)



<Patterns>

_IS_    ISLAND

_LK_    LAKE

_VC_    VOLCANO

_PN_    PENN

_VL_    VALLEY

_CO_    COAST

_LO_    LOST



<Treatment>

_R_     REPLACE  - (#land)    Set active prov & kill everyone in it. Used to REPLACE randomly placed units.

_A_     ADD      - (#setland) Set active prov.  Units added to existing.

_M_     MULTIPLE - More than one of a single province gan may be added to the map file.

_U_     UNIQUE   - Once a single instance of the province gan is "picked", it can not be picked again.



<Terrain>

_S/L/N_   Small/Large/Normal

_PLN_     Plains

_SEA_     Sea

_WTR_     Some water

_MNT_     Mountain

_SWP_     Swamp

_WST_     Waste

_FST_     Forest

_FRM_     Farm

_MST_     Many Sites

_DEP_     Deep

_CAV_     Cave

_FS_      Fire Site

_AS_      Air Site

_WS_      Water Site

_ES_      Earth Site

_SS_      Astral Site

_DS_      Death Site

_NS_      Nature Site

_BS_      Blood Site

_PS_      Priest Site

_EMT_     Edge Mountain



SPECIAL GAN COMMANDS:

---------------------

@<value> <command>

  ->select a random line from the following <value> lines to follow this <command>.



Example #1:

  @3 commander

  "Minotaur Lord"

  240 -- Priest

  -- no commander

   Result= "#commander 240 -- Priest" <- 1 in 3 chance to be printed in map file.



Example #2:

  @1 landname

  "Icky Swamp"

   Result= "#landname <province#> "Icky Swamp" <- 100% chance to be printed in map file.



Example #3:

  @2 

  #mag_astral 1

  #mag_fire 1

   Result= "#mag_fire 1" <- 1 in 2 chance to be printed. Note the space following "2 ".



Example #4:

  @2 units

  10 17 -- Archer

  -- no Archer

   Result= "-- no Archer" <- 1 in 2 chance to be printed. ie 50% chance of these units.



@RANDOM <command> <name or item list>

  ->select a random name or item to follow <command>.



Example #1:

  @RANDOM landname FOREST

   Result= "#landname <prov#> "Simple Woods"" <- Rnd name from DATA1 + rnd name from DATA2.

     OR

   Result= "#landname <prov#> "Ohmyg Forest"" <- Generated name + rnd name from DATA2.



Example #2:

  @RANDOM comname COMMANDER

   Result= "#comname "Kullray"" <- Generated name.



Example #3:

  @RANDOM comname COMMANDER

  @RANDOM additem HELMET

  @RANDOM additem 1HANDWEAPON

  @RANDOM additem SHIELD

  @RANDOM additem ARMORHVY

  @RANDOM additem BOOTS

  @RANDOM additem MISCITEM

   Result=  <- Random item from the named item list.

            #additem "Starshine Skullcap"

            #additem "Jade Knife"

            #additem "Weightless Tower Shield"

            #additem "Silver Hauberk"

            #additem "Boots of Stone"

            #additem "Bracers of Protection"

   (NOTE: I recommend only 1 or 2 MISC items as duplicates are possible!)

In a nutshell there are the flags used in the filename for pattern/terrain matching and flags for add/replace and multi/unique. Plus the following two structures:
@<value> <command>
@RANDOM <command> <name or item list>

A list of the current name & item lists can be pulled from "\LIST_CRATE\NameList.txt". The user should probably be given the option to select from the list or to enter a custom selection to allow for future additions or their own creations.

Oops, I was going to email this to you, but eh. I am a walking zombie tonight.