Expansion Misjump Analyser

Content

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

Also read http://wiki.alioth.net/index.php/Misjump%20Analyser

Witchspace Analyser readMe.rtf

{\rtf1\ansi\ansicpg1252\cocoartf949\cocoasubrtf540
{\fonttbl\f0\fswiss\fcharset0 Helvetica;}
{\colortbl;\red255\green255\blue255;}
\paperw11905\paperh16837\margl1440\margr1440\vieww20980\viewh14640\viewkind0
\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural

\f0\b\fs42 \cf0 Witchspace Analyser \
\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural

\b0\fs24 \cf0 version 1.1 by Eric Walch\
\
Minimum version requirement Oolite 1.73\
\
\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural

\b \cf0 Overview\
\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural

\b0 \cf0 This oxp adds the equipment: Witchspace Analyser. This analyser scans the witchspace in the direction of the target system. On detection of disturbances in witchspace it sounds an alarm and writes the location of the disturbance in the communication log.\
\
It is up to the player how to react on this information by breaking of the jump countdown.\
\
\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural

\b \cf0 Why this equipment\
\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural

\b0 \cf0 Every player has to face it sooner or later: witchspace attacks by thargoids. It always happens at a bad moment. Wouldn't it be a good thing to be warned for this?\
\
\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural

\b \cf0 Usage
\b0 \
The detection process starts when the player initiates a witchspace countdown. The analysis will take several seconds. When a disturbance is detected, the distance is calculated and a communication message is send to the player. Because of technical reasons the on screen version of the massage is lost in the countdown message but an alarm sounds and the message can be called back by opening the comms log with the `-key.\
\

\b Availability
\b0 \
This equipment can be purchased in all high-technical systems (10+) for a sum of 1450 Cr.\
\

\b Technical specifications.
\b0 \
This is still an experimental version of the scanner. It can't detect all misjumps but any misjump that can be avoided by this equipment is a blessing. Currently no human completely understands how the analyser exactly works. The blueprint for this scanner is retrieved from a captured thargoid ship after a minor battle in the Najort nebula. From this blueprint and an intact thargoid navigator retrieved from the captured ship, it was discovered that when attaching this device to the ships navigational computer, it sounds an alarm when there are thargoids on the projected course.\
Rumour is that thargoids deliberately left the blueprint behind for human retrieval. \
\

\b Disclamer
\b0 \
The manufacture of the WA will never guarantee the WA always gives the right result. It always is advisable to get an additional live insurance in the benefit of your family that might stay back in case something does go wrong.\
\

\b Installation\
\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural

\b0 \cf0 Drop this oxp in your "AddOns" folder. This will make the equipment available for purchase.\
For de-installation just remove the oxp from the AddOns folder. If the analyser was already bought, it will stay latent present until the oxp is installed again or the ship is sold. (just like any other external equipment oxp).\
\
\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural

\b \cf0 Version History\
\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural

\b0 \cf0 1.0 	First release\
1.1	Added Galactic jump detection to fix false warnings on a Galactic-jump.\
	Changed code to work also correct with Oolite 1.74.}

this.name        = "misjump_analyser"; 
this.author      = "eric walch"; 
this.copyright   = "� 2008 the Oolite team."; 
this.description = "This script analyses the misjump chance."; 
this.version     = "1.1";

this.startUp = function ()
{
	 this.mySound = new SoundSource;
	 this.mySound.sound = "misjumpAnalyser.ogg";
	 this.mySound.loop = false;
}

this.playerStartedJumpCountdown = function (jump)
{
    if (Math.random()>0.05 || system.isInterstellarSpace || jump === "galactic") return;
    var oldLocation = player.ship.galaxyCoordinates;
    var newLocation = player.ship.cursorCoordinates;
    var dx = newLocation.x-oldLocation.x;
    var dy = (newLocation.y-oldLocation.y)/2;
    this.distance = Math.round(Math.sqrt(dx*dx + dy*dy)*2)/10 // half of jump distance.
    
    if (player.ship.fuel < 3 * this.distance) return; // make sure the player always has enough fuel left.
    if (player.ship.equipmentStatus("EQ_MISJUMP_ANALYSER") === "EQUIPMENT_OK")
    {
		if (this.misjumpTimer)
        {
			this.misjumpTimer.stop();
			delete this.misjumpTimer;
		}
		this.misjumpTimer = new Timer(this, this.giveWarning, 0.5+Math.random()*8);
	}
    this.misjump = true;
}

this.playerCancelledJumpCountdown = function ()
{
    if (this.misjump) this.misjump = false;
}

this.shipWillEnterWitchspace = function ()
{
    if (this.misjump) 
    {
        this.misjump = false;
        player.ship.scriptedMisjump = true;
    }
}

this.giveWarning = function ()
{
    player.commsMessage("Warning: witchspace disturbance detected at "+this.distance+" LY ahead!");
	this.mySound.play();
}