Expansion Energy Equipment

Content

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

Also read http://wiki.alioth.net/index.php/Energy%20Equipment

Energy Equipment v1.11 ReadMe.txt

Energy Equipment OXP by Thargoid.

The Ships Systems Department of the Aquarian Shipbuilding Corporation would like to present to you their latest products, the Emergency Charge Device and the Emergency Energy Unit. Compatible with all known ships, they are a handy boost to any harassed commander on the go!

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

Equipment:

* Emergency Charge Device (ECD) - a pylon-mounted piece which when activated transfers an emergency boost of energy to the ships reserves. Single-use item, although multiple can be purchased. Note that it doesn't increase the ship's energy capacity, any excess charge on use is dissipated.
* Emergency Energy Unit (EEU) - an upgraded version of the ECD, fitted internally directly to the ships systems and activated automatically when the ships energy reserves get critically low. Again a single use device that must be replaced after it's activated.

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

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 "Energy Equipment 1.11.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 II screen appears) and the equipment should be added and available for purchase from sufficiently high-tech systems. 

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

Version history:

20/08/2008 - Version 1.00, Initial release.
20/08/2008 - Version 1.01, fixed typo in ECD config which stops it working properly
21/08/2008 - Version 1.02, removed missile role from ECD, to stop rogue use by NPCs (thanks to Eric Walsh for the test)
04/11/2008 - Version 1.03, script update for compatability with v1.72.
24/03/2010 - Version 1.10, scripting update for v1.74 (not compatible with lower versions)
13/02/2011 - Version 1.11, removal of upper limit, to allow running with 1.75

this.name					= "EE_ecd.js";
this.author					= "Thargoid";
this.copyright				= "Creative Commons: attribution, non-commercial, sharealike with clauses - see readme.txt";
this.description			= "Emergency charge device, adds 100 energy units on firing";
this.version				= "1.0";

this.shipSpawned = function()
	{
	this.ship.owner.energy += 100;
	if(this.ship.owner == player)
		player.consoleMessage("Emergency charge device triggered!",3);
	}

this.name      		= "Emergency Energy Unit"; 
this.author    		= "Based on frame's script from his Bounty Scanner, recycled by Thargoid"; 
this.copyright 		= "Creative Commons: attribution, non-commercial, sharealike with clauses - see readme.txt";
this.description 	= "Emergency Energy Unit - amended to stop the timer if the equipment gets damaged or destroyed.";
this.version   		= "2.1";

this.shipExitedWitchspace = this.shipLaunchedFromStation = function()
	{
	if(player.ship.equipmentStatus("EQ_EEU") == "EQUIPMENT_OK")
		{	
		if(this.energyCheckTimer)
			{
			this.energyCheckTimer.start()
			}
		else
			{
			this.energyCheckTimer = new Timer(this, this.energyCheck,0,3)		
			}
		}	
	}


this.energyCheck = function()
	{
	if(player.ship.docked || player.ship.equipmentStatus("EQ_EEU") != "EQUIPMENT_OK")
		{
		this.energyCheckTimer.stop();
		}
	else
		{
		if(player.ship.energy < 50)
			{
			player.ship.energy += 100;
			player.consoleMessage("Emergency Energy Unit triggered!",6);
			player.ship.removeEquipment("EQ_EEU");
			this.energyCheckTimer.stop()
			}
		}   	        
	}

this.shipDied = function()
	{
	if(this.energyCheckTimer)
	this.energyCheckTimer.stop()
	}