###############################################################################
 Version: 3.3
 Author : Dr Xavia (dr.x@sympatico.ca)
 Desc   : Command a ship to mine an asteroid
 Dependancies: This pack requires the latest Advanced Navigation Libraries from Xai Corp.
 Files  :	
	init.Xai.AutoM				:set autopilot commands
	plugin.Xai.AutoM.chk.cmds		:dissable commands on ships without equip.
	plugin.Xai.AutoM.cmd.collTrans  	:collect ore and transfer command
	plugin.Xai.AutoM.cmd.StartMining	:Start miner command
	plugin.Xai.AutoM.collect.Ore		:Collect ore fragments
	plugin.Xai.AutoM.fly.toMiner		:finds and returns to a miner
	plugin.Xai.AutoM.miner.XferCargo	:transfers cargo off miner
	plugin.Xai.AutoM.mining.timer		:safety check for loopy miners
	plugin.Xai.AutoM.mining			:main mining script
	plugin.Xai.AutoM.signal.wait		:keeps following ships away while mining
	plugin.Xai.AutoM.start.followers	:start followers capable of collecting
	plugin.Xai.AutoM.Transfer		:Handles transfer of collected ores
	plugin.Xai.lib.AP.get.emotion		:returns the emotional state of pilot
	plugin.Xai.lib.AP.getName		:returns name of ship and pilot
	plugin.Xai.lib.AP.message		:transforms message by pilot race/emotion
	plugin.Xai.lib.cargoXfer.frmTrgt	:transfer cargo from a ship to this
	plugin.Xai lib.cargoXfer.toStat  	:transfer cargo to a station(not sell)
	plugin.Xai.lib.cargoXfer.toTrgt  	:transfer cargo to a ship from this
	plugin.Xai.lib.find.scannerRange	:returns scanner range
	plugin.Xai.lib.find.sect.inRange	:returns all sectors in range
	plugin.Xai.lib.find.ship.byCmd  	:find ship from list by it's command
	plugin.Xai.lib.Fly.toSafeStation	:find and land at a safe station
	plugin.Xai.lib.register.script  	:registers script in Xai Database
	plugin.Xai.lib.trade.bestsell		:best selling script without requiring homebase
	plugin.Xai.Setup.Sell.Products  	:register script and set products for sale.
	(xx)5001.xml				:text file to set command name and 
							format messages sent by script.
	
###############################################################################

 Thankyou for choosing Xai Corporations Automining software. 

  Please not that the following equipment is required for the proper 
  functioning of these software commands. A Mobile Drilling system 
  and a mineral scanner. An ore Collector is not required on the mining
  ship, but must be present on a following ship if not. Failure to meet
  all of these criteria will result in the failure of the command
  and the transmission of this message.

 Xai Corporation. For all your AI needs.
 www.xai-corp.tk
############################################################################### 
 
 Installation: 
 ŻŻŻŻŻŻŻŻŻŻŻŻŻ
  The Xai Corporation Advanced Navigation Libraries are also required for this to work. The latest version can be found at www.xai-corp.tk. 

  Just drop all the files in to the script folder, except for the xx5001.xml files which go in the X2-The Threat\t folder
  The new commands will become available when you have the Mobile Drilling System and Ore Collector installed. 

 Usage:
 ŻŻŻŻŻŻ
  The player must be in the same sector as the mining ship, but not necessarily in the mining ship itself. A message will be sent if you are not in the same sector during mining.

*  Automining:
   -Activating this command will cause the ship to search for a nearby asteroid and proceed to position itself ready to fire the Mobile drilling system(MDS). At this time any following ships equipped with Ore Collectors will automatically switch to   the Collect and Transfer command with no target. 
   -If the MDS is not installed in one of the laser slots it will be installed in an apropriate slot.
   -If you have the MDS mounted in the rear turret the ship will automatically rotate to face the turret towards the asteroid
   -If the mining ship does not have an ore collector it will not attempt to collect ore, however a ship following it must be equipped with an ore collector in this case.
   -Once the asteroid has been blown apart the mining ship will collect the fragments before heading on to the next asteroid. Any ships set to Collect will also collect the fragments.
   -When the ship cannot find anymore asteroids to mine it will find a safe place to land. Note that the ship will only look for asteroids within it's scanner range.
   -The mining ship will use a transporter device, if installed, to transfer ores to any following ship in range.
   =The command parameters are: select ore type to mine(0=any;1=ore;2=silicon;3=nividium), set max yield to mine (set to 25 to ignore asteroids with yields greater than 25)

*  Collect and Transfer:
   -Ships following a mining ship that are equipped with an Ore Collector will automaticlly switch to this command when the miner begins it's cycle. New ships can be told to follow the miner after it has started and they will switch at the begining of the next mining cycle.
   -If the ship has a transporter device installed it will use it to beam ore from the miner, and to beam it to any following ships, if they are within range.
   -If you select this command from the menu you will be asked to specify a target to transfer to. Various targets can be specified, but mostly this will specify what type of target, and the range to look for targets, rather than specifying an exact target.
   -If a target has been specified it will show in the command as either SHIP or STATION depending on what was specified. The ship will attempt to transfer the ores in it's cargobay when it's about 95% full.
   -Choosing a player station will cause the ship to transfer it's cargo to any player station capable of holding ores (ore,silicon,nividium) within the same distance as the target specified. No money changes acounts
   -Choosing a player ship will see the ship transfer ores to the specified ship, using a transporter device if installed, or by docking at the ship if possible
   -Choosing any non-player station will cause the ship to search for the best place to sell the ore withing the distance to the target you specified. If you want the ship to search within one jump of the mining sector select a station one jump from the mining sector.


 New to Version 3.3
 ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ 
+ included missing library file.

 New to Version 3
 ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ 
+ can select which type of ore to collect

 New to Version 2.3
 ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ 
+merged with the Remote Mineral Scan

 New to Version 2.2
 ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ
-removed the need for player in sector
-removed redundant transfer then collect command
+better positioning
+timeout on positioning to break endless loops
+better responces to many situations.
+now uses the Xai Corporation Navigation libraries
+now uses Xai Corporation Artificial Pilots for comunications.

 New to Version2
 ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ
+more reliable positioning before mining
+comunication and transporting of ores between mining ships and collecting ships.
+firing from front mount on demeter
+Transfer ore to player station/ship or sell for best price

_______________________
 İ 764 Xai Corporation,
 Cloudbase South West
 www.xai-corp.tk

