Expansion Cargo Shepherd

Content

• Manifest
• Documentation
• 1 Equipment
• 1 Ships
• 0 Models
• 1 Scripts

Also read http://wiki.alioth.net/index.php/Cargo%20Shepherd

Cargo Shepherd 1.01 Readme & License.txt

Cargo Shepherd OXP by Thargoid.

The latest piece of equipemnt from the labs of the Aquarian Shipbuilding Corporation, the Cargo Shepherd is designed for busy traders, scavengers and bounty hunters.

For those times when your cargo hold is just not big enough, the Cargo Shepherd is designed to mark the location of loose cargo pods, and also keep them in place via a specially designed broad-based tractor field. Put simply it will attract any loose cargo pod in range toward itself, and maintain them in a holding position 200m from the Shepherd unit.

To relocate the unit, simply tune your ASC (where fitted) to the magnet icon and follow it back. The unit is pylon-mounted and can be deployed in the normal manner. The unit is activated on launch, and keyed to the ship that launched it. It is fully re-usable, and once deactivated can be scooped (if sufficient cargo space is available) and restored onto your pylons (again if space is available). To deactivate the unit, gently bump into it with your ship (not too fast, or the unit may be damaged or destroyed).

It is not advised to leave units functioning and unattended for too long though, or else someone else may stumble upon your hoard!

This OXP requires Oolite v1.74 or higher, and will not run correctly on previous versions.

-------------------------------------------------------------------------------------------------------------------------------------
License:

This OXP is released under the Creative Commons Attribution - Non-Commercial - Share Alike 3.0 license with the following clauses:

* Whilst you are free (and encouraged) to re-use any of the scripting, models or texturing in this OXP, the usage must be distinct from that within this OXP. Unique identifiers such as (but not limited to) unique shipdata.plist entity keys, mission variables, script names (this.name), equipment identity strings (EQ_), description list arrays and entity roles must not be re-used without prior agreement.
* rebundling of this OXP within another distribution is permitted as long as it is unchanged. The following derivates however are permitted and except from the above:
	* the conversion of files between XML and openStep.
	* the merging of files with other files of the same type from other OXPs.
* Even though it is not compulsory, if you are re-using any sizable or recognisable piece of this OXP, please let me know :)

-------------------------------------------------------------------------------------------------------------------------------------
Instructions:

Unzip the file, and then move the folder "Cargo Shepherd 1.01.oxp" to the AddOns directory of your Oolite installation. Then start the game up whilst holding down the shift key (until the spinning Cobra Mk III screen appears) and the stations will appear in appropriate systems.

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

Version history:

07/04/2011 - Version 1.00, Initial release
11/06/2011 - Version 1.01, expanded the range of cargo pods that the shepherd can capture

this.name           = "cargoShepherd_magnet";
this.author         = "Thargoid";
this.copyright      = "Creative Commons: attribution, non-commercial, sharealike with clauses - see readme.txt";
this.description    = "Ship script for Cargo Shepherd";
this.version        = "1.00";

this.scanForPods = function() 
	{ 
	function allPods(entity) {return entity.isShip && (entity.hasRole("cargopod") || (entity.isCargo && !entity.isPiloted))}; 
	let farList = system.filteredEntities(this, allPods, this.ship, 25600); 
	let nearList = system.filteredEntities(this, allPods, this.ship, 200); 
	
	if(farList.length === 0)
		{
		this.ship.lightsActive = false;
		return;
		}
		
	if(farList.length > 0)
		{
		var podCounter = 0 ; // reset the counter
		for(podCounter = 0;podCounter<farList.length;podCounter++)
			{ farList[podCounter].velocity = this.ship.position.subtract(farList[podCounter].position).direction().multiply(10) }
		}
	
	if(nearList.length > 0)
		{
		var podCounter = 0 ; // reset the counter
		for(podCounter = 0;podCounter<nearList.length;podCounter++)
			{ nearList[podCounter].velocity = [0,0,0]; }
		}
	this.ship.lightsActive = true;	
	}

this.shipWasScooped = function(scooper)
	{
	if(scooper.isPlayer && player.ship.missiles.length < player.ship.missileCapacity)
		{ 
		player.ship.awardEquipment("EQ_CARGO_SHEPHERD_MINE");	
		player.consoleMessage("Cargo Shepherd available for re-use", 4);
		}
	}
	
this.shipCollided = function(otherShip)
	{
	if(otherShip && this.ship.owner && otherShip === this.ship.owner)
		{ this.ship.AIState = "INERT"; }
	else
		{ this.ship.AIState = "WARNING"; }
	}