 ------------------------------------------------------------------------
    Documentation for the matrixshard-towncontrol npcdesc.cfg settings:
 ------------------------------------------------------------------------
 
 Note: All town-NPC's must be defined in the :towncontrol:npcdesc.cfg.
 Note: No other NPC's are allowed to be defined here!
 
 -- doing otherwise will mess the towncontrol-upkeep datafile, and 
    will thus make the administration for Administrators that much harder!
    
 ------------------------------------------------------------------------


 See here for a typical cfg entry:
 =================================

#Warning: don't spawn this one!!!
NPCTemplate <npcname>            
{   
    Name        <dummy-name>
    script      :towncontrol:ai/<scriptname>
    
    #the following are dummy entries - will be overwritten by npc setup script
    ObjType     0x190
    Color       0
    TrueColor   0
    Gender      0
    STR         200
    INT         200
    DEX         200
    HITS        200
    MANA        200
    STAM        200
    AttackAttribute	Wrestling
    AttackSpeed		20
    AttackDamage	1d1
    AttackHitSound	0x1E
    AttackMissSound	0x239
    DeathSound		0x82
    DamagedSound	0x1F
    
    #towncontrol specific data:
    npcpurchase         <string.splitword()>
    npcmaxowned         <integer>
    npcplacing          <string.splitword()>
    npcplacearea        <string.splitword()>
    
    service             <servicename>
    #note: upkeep defaults to 250 gold/week -> see .towncontrol
    
}

- Note: <npcname> is also the value which will be used to link the npc to it's datafile
        from where e.g. upkeep cost and service fees will be calculated!!!
- Note: <dummyname> is just some dummy npc name, which will be overwritten by the npc script anyway.


 Explanation to towncontrol specific settings:
 ----------------------------------------------
 
 npcpurchase: Defines what privileges are required to purchase the npc.
              This entry is a splitword() string - e.g. "-2 1 2 3"
              
              Note: mere city members cannot hire npc's in general!
              value -2 means that any citizen may purchase this npc
              value -3 means that any merchant may purchase this npc
              value -4 means that any noble can hire the npc for private use
              value -5 means that any king/emperor can hire the npc for private use
              value -9 means that any guild leader may purchase this npc for his guild 
                       - Note: npc prices are identical in ALL towns!
            
              value >= 1 means, that the npc can be hired by nobles as a town npc, whereas the number
                       defines the priveleges used (see town-datafile documentation, players, "privs")
               
 npcmaxowned: Defines how many of these npc's may be owned per player!
              Note: this value DOES NOT apply to town-hired NPC's
              
 npcplacing:  Defines what command levels are allowed to place (and fire!) this npc...
              Note: this value ONLY applies to town-hired NPC's
              
              the values are all >=1 and once again equal the player "privs" (see town-datafile docu)
              
 npcplacearea: Defines the structure types (see town-datafile docu, houses, "isshop" property)
               Note: The player placing town-npcs does not need to be owner of the area.
               
               a value >= 0 defines the structure types
               
               a value == -1 means "anywhere" - careful when using this, it is merely intended for debug use
               
               NOTE: this value does not apply to NPC's hired by guilds - Guild NPC can ALWAYS be placed
                     within their guild only!
               NOTE: Private NPC's can ALWAYS only be placed in private homes, shops or public buildings
               NOTE: Town NPC's can be placed in private structures/shops only if the noble is an owner there.
        
 service:     services are optional, scripted duties that the npc will perform, and where you (as a 
              scripter) want the NPC to collect a charge for, which can be configured by Administrators.
              
              Note: you only specify the name of the service here! The charge automatically defaults
                    to 10 gold pieces for use of the service, however the charge is then automatically
                    configureable in .towncontrol (at least to shard administrators!)
                    
              An example might be e.g. "service Haircut" which is offered by a town-barber.
              
              Note: you can specify multiple services, by adding multiple "service" lines!!!
              
 