Elite Wiki - User contributions [en]

SniperLock

2020-12-11T12:46:19Z

Dybal: /* Download */

== Introduction ==

CommonSense 'Outside-the-Box' Design Studios Ltd. is happy to announce the latest design in software upgrades for use in all ranges of space vessels. SniperLock software allows for more accurate targetting by enabling longer dwell times on targets. This OXP authored by CommonSenseOTB Dec. 17, 2011.

== Overview ==

SniperLock software acts as an intermediary between you and your ship. When you have a great shot lined up on your currently selected target, in either the forward view or the aft view, the software temporarily takes micro-control over the ships attitude thrusters to keep the ship lined up on target. The override lasts for
a fraction of a second and provided the pilot continues to aim, the software can then re-lock again and again. The pilot may override the lock-on by simply pushing slightly on the pitch or yaw controls. The best way to use this software upgrade is not to think about it. Fly and aim normally and the system will automatically micro-correct any minor misalignment in your aim. Fire a laser burst at the beginning of each lock-on for most effective results. SniperLock software is not perfect and there may be a slight lag as the target is tracked.
Sudden evasive movements and fuel injecting by the target may break the lock-on. Also, due to liability issues, the software will only initiate lock-on with targets over 5km distant to avoid the possibility of collisions. SniperLock software and control interface works with most other targetting systems and heads-up-displays. Any odd behaviour should be reported to the software arm of CommonSense 'Outside-the-Box' Design Studios Ltd., of which SniperLock is a wholly owned
subsidiary.

When you want to keep the bad guys out of arms reach, get SniperLock. Legal in all 8 sectors.

== Customizability ==

For those with drifting joysticks, disabilities, unnaturally poor aim, and for other reasons, you now have the option of adjusting how accurate you have to aim to get a lock, how much force you have to apply to the controls to force an unlock, and how long the lock will last.

== SniperLock Plus ==

An upgrade version, SniperLock Plus, has become available to deal with the issue of off-centre weapons.

Standard SniperLock aligns the centreline of the ship with the centre of the target. If the weapon mount in that facing is offset from the centre line more than the target's "thickness" in the offset direction, that will guarantee a miss. With Standard SniperLock, the only recourse for those ships would be to roll the ship so the target's widest dimension is aligned with the offset direction.

SniperLock Plus takes into account the weapon mount offset and aligns the weapon position with the target's centre.

== Equipment Details ==

===SniperLock===
*Tech Level - 12.
*Cost - 500 credits.
*Required Equipment to operate - Scanner Targetting Enhancement.

===SniperLock Plus===
*Tech Level - 13.
*Cost - 1500 credits, with a rebate of SniperLock price if installed.
*Required Equipment to operate - Scanner Targetting Enhancement.

== OXP Requirements ==

*[[Oolite]] version 1.75.3+ due to CTD frame callback issues in previous oolite versions.
*Sniperlock software requires scanner targetting enhancement to be installed to operate.
*Can be used with most heads-up-display systems.
*Works in either Forward view or Aft view mode.
*Compatible with target tracker.
*No dependancies.

== Download ==

SniperLock is available on the Expansion Manager and here: [[Media:Oolite.oxp.CommonSenseOTB.SniperLock.oxz|SniperLock v1.0]]

SniperLock Plus is available on the Expansion Manager an here: [[Media:SniperLockPlus-1.0.2.oxz|SniperLock Plus v1.0.2]]

{{equipment-OXP}}
[[Category:Oolite expansion packs]]

File:SniperLockPlus-1.0.2.oxz

2020-12-11T12:44:39Z

Dybal: SniperLock Plus OXP v1.0.2

SniperLock Plus OXP v1.0.2

Vimana HUD

2020-12-09T17:06:07Z

Dybal: /* Download */

==Overview==

This HUD (Heads Up Display) is highly complex and can be augmented with a selection of equipment purchasable through the F3 screen while docked. Gnievmir from Poland burst onto the bulletin board as a new member offering this HUD as a gift! His original Vimana HUD altered some of the game mechanics, added some extra items for sale in the shipyards - and provided HUD lights for a variety of combat-related OXP equipment.

[[User:Dybal|Dybal]] has taken on maintaining it, and has updated it and disentangled some of its dependencies. He has also made it compatible with the HUD Selector, sorted out the licensing issues and posted it on the Expansions Manager.

[[File:Vimana Hud info.png|800px]]

Description:

1 '''Target Module''' (if target selected) or '''Travel Module''' box (shown)
2 Active/primed equipment (with next piece of equipment to be selected shown beneath)
3 Equipment mode (if defined by b or n keys)
4 Fuel Injector (red if damaged or no fuel)
5 Low Fuel warning (insufficient for next witch-space hop)
6 Distance to Target (if selected)
7 Cloaking Device (if active)
8 ECM (red if damaged)
9 Self Repair System (oxp)
10 LMSS (Laser Mount Selection System) (oxp)
11 Current weapon
12 AMS Anti-Missile System darts count/status (oxp)
13 SRS Self Repair System bots count/status (oxp)
14 If visible - ship needs maintenance!
15 IronHide armour (oxp)
16 Extra Energy Unit
17 Shield Capacitors (oxp)
18 Shield Cycler (oxp)
19 '''Ship Status module''' box

==Crosshairs==
The matrix shows the variety of crosshairs depending on alert condition and on weapons being toggled on or off 

[[File:Vimana HUD Crosshairs.png|400px]]

==Visual Alerts==

[[File:Vimana HUD Alerts.png|400px]]

==Purchasable Additions==

- Travel Module (TL6 1,000₢) shows multiple witchspace destinations - see (1) above

- Ship Module (TL6 1,500₢) shows damage status of ship - see (19) above

- Target Module (TL6 2,500₢) shows combat information with a nice icon of most of the probable targets

- Vimana Beam Laser (TL9 15,000₢) a cool-running military-style laser with only 25km range

- TFSystem (''Target Filtering System'', TL7 3,100₢) selects class of target: hostile, police, thargoid, neutral, asteroid ''etc''

==Additional OXP==

The ship overrides in version 2.05 have been moved to a separate OXP, '''Vimana Ship Overrides''', available on the Expansion Manager in the '''Ships''' category.

Those overrides make VimanaHUD the default HUD for many core game ships, and increase ship properties like cargo capacity, flight speed, number of pylons, energy banks.

The reason for the move is that some players will want to stay with the original ship's characteristics and can use HUD Selector to change their HUD into Vimana HUD.

'''Players that are using VimanaHUD v2.05 (or earlier) are advised to install this additional OXP before loading the saved game of a ship that has cargo based on the expanded capacity granted by v2.05, or cargo loss will result.'''

==The Name==
The Sanskrit word vi-māna (विमान) literally means "measuring out, traversing" or "having been measured out". Monier Monier-Williams defines ''Vimana'' as "a car or a chariot of the gods, any self-moving aerial car sometimes serving as a seat or throne, sometimes self-moving and carrying its occupant through the air; other descriptions make the Vimana more like a house or palace, and one kind is said to be seven stories high", and quotes the Pushpaka Vimana of Ravana as an example. It may denote any car or vehicle, especially a bier or a ship as well as a palace of an emperor, especially with seven stories. In some Indian languages like Tamil, Malayalam, Telugu, and Hindi, vimana or vimanam means "aircraft", for example in the town name Vimanapura (a suburb of Bangalore) and Vimannagar, a town in Pune. In another context, Vimana is a feature in Hindu temple architecture (from Wikipedia - see below).

==Download==

Available on the Expansion Manager or here: [[Media:VimanaHUD-2.07.oxz|Vimana HUD v2.07]], [[Media:VimanaShipOverrides-2.07.oxz|Vimana Ship Overrides v2.07]]

Older versions:

[[Media:VimanaHUD-2.06.oxz|Vimana HUD v2.06]]

[[Media:VimanaHUD-2.05.oxz|Vimana HUD v2.05]]

== Version History ==

v2.07 (by Dybal)

* Fixes display of Repair System status.

v2.06 (by Dybal)

* Moves overriding of ship characteristics to VimanaShipOverrides OXP.
* Fixes Repair System worldScript name.
* Makes HUD compatible with HUD Selector.
* Updates compatibility with Repair Bots 2.14, Shield Equalizer and Capacitors v1.6+, SniperLock Plus.
* Changes Repair Bots, Shield Equalizer and Capacitos, SniperLock, Missile Analyser, Missile Beep, LMSS, Iron Hide and Auto Crosshairs from required to optional.
* Makes it compatible with Shield Cycler Next v2.0+.
* Adds a 12-MFDs version.
* Makes it incompatible with Active Crosshairs OXP (it overrides the HUD's crosshairs).
* Adds central dot to crosshairs.
* Sets crosshairs before launch.
* Adds docked version of the HUD, displaying info on the screen borders and leaving the screen centre free for Station Interfaces.
* Keeps the Compass target when an ident or missile target is acquired.
* Uses beacon label, if defined, for Compass target display
* Doesn't display shield low warning in Torus Drive (for HardWay OXP users).

v2.05

* Initial version published by Gnievmir on http://aegidian.org/bb/viewtopic.php?p=268089

== Quick Facts ==
{{OXPLevel|0}}
{{IconOXP|ooVersion="1.81"|oxpCPU="Low"|oxpMEM="Low"|oxpGPU="Low"}}
{{Infobox OXPb| title = Vimana HUD
|version = 2.07
|release = 2020-11-24
|features = Full featured HUD plus equipments.
|license = CC BY-NC-SA 4.0
|category = HUDs OXPs
|author = [[User:Gnievmir|Gnievmir]]
|feedback = [http://aegidian.org/bb/viewtopic.php?f=4&t=20408&p=272091 BB-Link]
}}
[[Category:HUDs OXPs]]
[[Category:Oolite expansion packs]]

== Gameplay and Balance indicator ==
[[File:Tag-colour-blue.png]]

==Links==

Vimana HUD is now downloadable in-game through the Expansions Manager.

[http://www.aegidian.org/bb/viewtopic.php?f=4&t=20408 BB Discussion]

[https://www.youtube.com/watch?v=t4rl1Nhw3uE Video]

[http://ag.108.pl/pliki/VimanaHUD_v2.oxp.zip To download Gnievmir's original Vimana]

[https://en.wikipedia.org/wiki/Vimana Wikipedia article on Vimana]

File:VimanaShipOverrides-2.07.oxz

2020-12-09T17:05:07Z

Dybal: Vimana Ship Overrides OXP, v2.07

Vimana Ship Overrides OXP, v2.07

File:VimanaHUD-2.07.oxz

2020-12-09T16:55:35Z

Dybal: Dybal uploaded a new version of File:VimanaHUD-2.07.oxz

Vimana HUD OXP, v2.07

NPC Energy Units OXP

2020-12-09T15:11:05Z

Dybal: /* Downloads */

== Description ==

NPC Energy Units OXP aims to make the energy units in NPC ships operational, enhancing the NPCs energy recharge rate.

For those NPC ships created with the energy units, this OXP will enable them by itself, for those ships whose energy units were granted by OXPs after the ship was spawned, this OXP makes available a function for the awarding OXP to call to enable the awarded energy unit.

This OXP also awards energy units (civilian and naval) to NPCs, based on their accuracy (the higher accuracy have greater probability of getting them) and recharge rate (the higher recharge rates have lesse probability of getting the energy units).

== Notes for OXP developers ==

This OXP makes available the following functions:

* <code>worldScripts.NPC_Energy_Units.$getShipEnergyUnit(ship)</code>

:A convenience function that returns the equipment Key for any energy unit installed on the ship, or null if the ship has none.

* <code>worldScripts.NPC_Energy_Units.$setupEnergyUnits(ship)</code>

:Updates the ship's energy recharge rate to the factory value boosted by the energy unit installed, if it's not damaged.
:Returns true if the ship's energy recharge was modified and false otherwise.

* <code>worldScripts.NPC_Energy_Units.$energyUnitDamaged(equipmentKey)</code>

:An event handler for damage to energy units, it MUST be called in the context ('this') of the ship's script, as in:

worldScripts.NPC_Energy_Units.$energyUnitDamaged.call(ship.script, equipmentKey)

:It restores the ship to its factory energy recharge rate if the equipmentKey is an energy unit and its status in the ship isn't EQUIPMENT_OK: it can be called after an energy unit is removed from the ship to reset its energy recharge rate, but that means that if the ship has a naval energy unit and this function is called with the key for an extra energy unit, the ship's energy recharge rate WILL be reset, rendering the naval energy unit non-functional.

:This OXP includes this function in NPC Equipment Damage OXP list of equipment damage handlers if that OXP is installed.

== License ==

This OXP is licensed under the [https://creativecommons.org/licenses/by-sa/4.0/legalcode CC-BY-SA 4.0].

== Aknowledgements ==

This OXP is based on Ngalo's original NPC Energy Unit.

I would rather have updated the original OXP, but although it had a CC BY-NC-SA, it didn't specify the version, so I opted to write a new one to replace it just to be in safe licensing grounds.

== Downloads ==

The latest version is available on the Expansion Manager and here: [[Media:NPCEnergyUnits-1.0.1.oxz|NPC Energy Units v1.0.1]]

== Version History ==

Version 1.0.1 (december/2020):

* Adds _alreadyGotOne array (with ships that have high energy recharge rate to emulate an energy unit) for backwards compatibility with Ngalo's version (and used by Military Shields OXP).
* Changes parameters for granting NEU and EEU to reduce probability of granting to ships with recharge rate above 6.

Version 1.0 (november/2020):

* Initial version

== Quick Facts ==

{{OXPLevel|5}}
{{IconOXP|ooVersion="1.82"|oxpCPU="Low"|oxpMEM="Low"|oxpGPU="Low"|oxpIsAPI=true|oxpIsDocumented=true}}
{{Infobox OXPb| title NPC Energy Units
|version = 1.0.1
|release = 2020-12-02
|license = CC-BY-SA 4.0
|features = Enables the NPCs energy units
|category = Mechanics OXPs
|author = [[User:Dybal|Dybal]]
|feedback = [http://www.aegidian.org/bb/viewtopic.php?f=4&t=18161 Oolite BB]
}}

== Gameplay and Balance indicator ==
[[File:Tag-colour-red.png]]

{{Mechanics-OXP}}

File:NPCEnergyUnits-1.0.1.oxz

2020-12-09T15:10:03Z

Dybal: NPC Energy Units OXP, v1.0.1

NPC Energy Units OXP, v1.0.1

File:NpcEnergyUnits-1.0.1.oxz

2020-12-09T14:45:53Z

Dybal: Dybal uploaded a new version of File:NpcEnergyUnits-1.0.1.oxz

NPC Energy Units OXP, v1.0.1

File:NpcEnergyUnits-1.0.1.oxz

2020-12-09T14:43:00Z

Dybal: Dybal uploaded a new version of File:NpcEnergyUnits-1.0.1.oxz

NPC Energy Units OXP, v1.0.1

SniperLock

2020-12-09T14:29:58Z

Dybal: /* Download */

== Introduction ==

CommonSense 'Outside-the-Box' Design Studios Ltd. is happy to announce the latest design in software upgrades for use in all ranges of space vessels. SniperLock software allows for more accurate targetting by enabling longer dwell times on targets. This OXP authored by CommonSenseOTB Dec. 17, 2011.

== Overview ==

SniperLock software acts as an intermediary between you and your ship. When you have a great shot lined up on your currently selected target, in either the forward view or the aft view, the software temporarily takes micro-control over the ships attitude thrusters to keep the ship lined up on target. The override lasts for
a fraction of a second and provided the pilot continues to aim, the software can then re-lock again and again. The pilot may override the lock-on by simply pushing slightly on the pitch or yaw controls. The best way to use this software upgrade is not to think about it. Fly and aim normally and the system will automatically micro-correct any minor misalignment in your aim. Fire a laser burst at the beginning of each lock-on for most effective results. SniperLock software is not perfect and there may be a slight lag as the target is tracked.
Sudden evasive movements and fuel injecting by the target may break the lock-on. Also, due to liability issues, the software will only initiate lock-on with targets over 5km distant to avoid the possibility of collisions. SniperLock software and control interface works with most other targetting systems and heads-up-displays. Any odd behaviour should be reported to the software arm of CommonSense 'Outside-the-Box' Design Studios Ltd., of which SniperLock is a wholly owned
subsidiary.

When you want to keep the bad guys out of arms reach, get SniperLock. Legal in all 8 sectors.

== Customizability ==

For those with drifting joysticks, disabilities, unnaturally poor aim, and for other reasons, you now have the option of adjusting how accurate you have to aim to get a lock, how much force you have to apply to the controls to force an unlock, and how long the lock will last.

== SniperLock Plus ==

An upgrade version, SniperLock Plus, has become available to deal with the issue of off-centre weapons.

Standard SniperLock aligns the centreline of the ship with the centre of the target. If the weapon mount in that facing is offset from the centre line more than the target's "thickness" in the offset direction, that will guarantee a miss. With Standard SniperLock, the only recourse for those ships would be to roll the ship so the target's widest dimension is aligned with the offset direction.

SniperLock Plus takes into account the weapon mount offset and aligns the weapon position with the target's centre.

== Equipment Details ==

===SniperLock===
*Tech Level - 12.
*Cost - 500 credits.
*Required Equipment to operate - Scanner Targetting Enhancement.

===SniperLock Plus===
*Tech Level - 13.
*Cost - 1500 credits, with a rebate of SniperLock price if installed.
*Required Equipment to operate - Scanner Targetting Enhancement.

== OXP Requirements ==

*[[Oolite]] version 1.75.3+ due to CTD frame callback issues in previous oolite versions.
*Sniperlock software requires scanner targetting enhancement to be installed to operate.
*Can be used with most heads-up-display systems.
*Works in either Forward view or Aft view mode.
*Compatible with target tracker.
*No dependancies.

== Download ==

SniperLock is available on the Expansion Manager and here: [[Media:Oolite.oxp.CommonSenseOTB.SniperLock.oxz|SniperLock v1.0]]

SniperLock Plus is available on the Expansion Manager an here: [[Media:SniperLockPlus-1.0.1.oxz|SniperLock Plus v1.0.1]]

{{equipment-OXP}}
[[Category:Oolite expansion packs]]

File:SniperLockPlus-1.0.1.oxz

2020-12-09T14:28:30Z

Dybal: SniperLock Plus OXP, v1.0.1

SniperLock Plus OXP, v1.0.1

File:N-Shields-1.0.1.oxz

2020-12-08T15:55:12Z

Dybal: Dybal uploaded a new version of File:N-Shields-1.0.1.oxz

N-Shields OXP, v1.0.1

File:NpcEnergyUnits-1.0.1.oxz

2020-12-08T15:48:15Z

Dybal: Dybal uploaded a new version of File:NpcEnergyUnits-1.0.1.oxz

NPC Energy Units OXP, v1.0.1

File:TechnicalReferenceLibrary-1.0.1.oxz

2020-12-08T15:43:14Z

Dybal: Dybal uploaded a new version of File:TechnicalReferenceLibrary-1.0.1.oxz

Technical Reference Library OXP, v1.0.1

File:VimanaShipOverrides-2.06.oxz

2020-12-08T15:40:24Z

Dybal: Dybal uploaded a new version of File:VimanaShipOverrides-2.06.oxz

Vimana Ship Overrides OXP, v2.06

File:VimanaHUD-2.07.oxz

2020-12-08T14:48:22Z

Dybal: Dybal uploaded a new version of File:VimanaHUD-2.07.oxz

Vimana HUD OXP, v2.07

Technical Reference Library

2020-12-04T16:21:58Z

Dybal: /* Installing */

[[File:tech_ref_lib_cobra.png|200px|thumb|right|Core ship Cobra Mark III specs]]
[[File:tech_ref_lib_wolf.png|200px|thumb|right|Oxp ship Wolf Mark III specs]]
[[File:tech_ref_lib_hud.png|200px|thumb|right|Hud view of Moray specs]]

==The Story==

Mrs Ming (Head of our marketing and fundraising department) from Spara, PrOog & Ming Agency had to pull lots of strings to get all the biggest ship manufacturers to give out technical specifications of their ships commonly seen in the space lines. Funnily, when the ball got rolling, manufacturers started to call us. We did not anticipate such a high level of interest. Suddenly every single company that had something to do with ships wanted to sponsor us. The deal we did with them was that Technical Reference Library will be a free bundle to every STE upgrade sold anywhere. The catch is, that every sponsor wants their name to be seen. That's the price for it to be free. We don't complain, as this liberated resources for Mr PrOog (Head of our R&D department) to develop an equipment that links Technical Reference Library to the hud. That piece how ever is not free as we were not ready to show sponsor messages in the hud. The price is set to a reasonable 1250 credits and the equipment is available from any TL12 system.

Mr Spara (CEO) is quite happy with the results of his team.

==Features==

* Free STE upgrade that will show information of spacecrafts via a primable equioment "Ship Identifier". (lock ident to a spacecraft, select the correct equipment with shift-n, activate with n or b)
* Boughtable equipment that will show the same information in the hud when activated. (lock ident to a spacecraft, select the correct equipment with shift-n, activate with n)

==Which spacecraft are identified==

* Entities with scan classes "CLASS_NEUTRAL", "CLASS_MILITARY", "CLASS_POLICE" and "CLASS_THARGOID" are identified as spacecrafts.
* Entities with scan classes "CLASS_MILITARY", "CLASS_POLICE" and "CLASS_THARGOID" are not included in the Reference Library. Military and Police are thought to be classified information and Thargoid ships are not made by known shipmakers.
* In addition, Constrictor, ships from Aliens oxp, Black Monk Gunships, ships with the role bigTrader, Green Gecko and ships from Capisastra oxp are not included in the library.

==Information for oxp makers==

* Ships with script info "classifiedShip = true" are not included in the library.
* A ship can be declared classified from a script by calling worldScripts.tech_ref_lib.$addClassifiedRole("foo"), where "foo" is the special role of the ship.
* A ship can be declassified from a script by calling worldScripts.tech_ref_lib.$removeClassifiedRole("foo"), where "foo" is the special role of the ship.

==Requirements==
* This [[OXP]] needs Oolite v1.77.

==Credits==

* Technical drawings from Mandoman are used in the background graphics

==Download==

Available on the Expansion Manager and here: [[Media:TechnicalReferenceLibrary-1.0.1.oxz|Technical Reference Library OXP v1.0.1]]

==Quick Facts==
{{Infobox OXPb| title = Your OXP name
|version = 1.0.1
|release = 2013-03-23
|license = CC BY-NC-SA 3.0
|features = Equipment
|category = Equipment OXPs
|author = Spara
|feedback = [http://www.aegidian.org/bb/viewtopic.php?f=4&t=13848 BB]
}}

{{equipment-OXP}}

Technical Reference Library

2020-12-04T16:21:40Z

Dybal: /* Download */

[[File:tech_ref_lib_cobra.png|200px|thumb|right|Core ship Cobra Mark III specs]]
[[File:tech_ref_lib_wolf.png|200px|thumb|right|Oxp ship Wolf Mark III specs]]
[[File:tech_ref_lib_hud.png|200px|thumb|right|Hud view of Moray specs]]

==The Story==

Mrs Ming (Head of our marketing and fundraising department) from Spara, PrOog & Ming Agency had to pull lots of strings to get all the biggest ship manufacturers to give out technical specifications of their ships commonly seen in the space lines. Funnily, when the ball got rolling, manufacturers started to call us. We did not anticipate such a high level of interest. Suddenly every single company that had something to do with ships wanted to sponsor us. The deal we did with them was that Technical Reference Library will be a free bundle to every STE upgrade sold anywhere. The catch is, that every sponsor wants their name to be seen. That's the price for it to be free. We don't complain, as this liberated resources for Mr PrOog (Head of our R&D department) to develop an equipment that links Technical Reference Library to the hud. That piece how ever is not free as we were not ready to show sponsor messages in the hud. The price is set to a reasonable 1250 credits and the equipment is available from any TL12 system.

Mr Spara (CEO) is quite happy with the results of his team.

==Features==

* Free STE upgrade that will show information of spacecrafts via a primable equioment "Ship Identifier". (lock ident to a spacecraft, select the correct equipment with shift-n, activate with n or b)
* Boughtable equipment that will show the same information in the hud when activated. (lock ident to a spacecraft, select the correct equipment with shift-n, activate with n)

==Which spacecraft are identified==

* Entities with scan classes "CLASS_NEUTRAL", "CLASS_MILITARY", "CLASS_POLICE" and "CLASS_THARGOID" are identified as spacecrafts.
* Entities with scan classes "CLASS_MILITARY", "CLASS_POLICE" and "CLASS_THARGOID" are not included in the Reference Library. Military and Police are thought to be classified information and Thargoid ships are not made by known shipmakers.
* In addition, Constrictor, ships from Aliens oxp, Black Monk Gunships, ships with the role bigTrader, Green Gecko and ships from Capisastra oxp are not included in the library.

==Information for oxp makers==

* Ships with script info "classifiedShip = true" are not included in the library.
* A ship can be declared classified from a script by calling worldScripts.tech_ref_lib.$addClassifiedRole("foo"), where "foo" is the special role of the ship.
* A ship can be declassified from a script by calling worldScripts.tech_ref_lib.$removeClassifiedRole("foo"), where "foo" is the special role of the ship.

==Requirements==
* This [[OXP]] needs Oolite v1.77.

==Credits==

* Technical drawings from Mandoman are used in the background graphics

==Installing==

* Install the OXP by copying technical_reference_library.oxp to your AddOns-folde

==Download==

Available on the Expansion Manager and here: [[Media:TechnicalReferenceLibrary-1.0.1.oxz|Technical Reference Library OXP v1.0.1]]

==Quick Facts==
{{Infobox OXPb| title = Your OXP name
|version = 1.0.1
|release = 2013-03-23
|license = CC BY-NC-SA 3.0
|features = Equipment
|category = Equipment OXPs
|author = Spara
|feedback = [http://www.aegidian.org/bb/viewtopic.php?f=4&t=13848 BB]
}}

{{equipment-OXP}}

File:TechnicalReferenceLibrary-1.0.1.oxz

2020-12-04T16:15:11Z

Dybal: Technical Reference Library OXP, v1.0.1

Technical Reference Library OXP, v1.0.1

NPC Energy Units OXP

2020-12-04T15:56:24Z

Dybal: /* Quick Facts */

== Description ==

NPC Energy Units OXP aims to make the energy units in NPC ships operational, enhancing the NPCs energy recharge rate.

For those NPC ships created with the energy units, this OXP will enable them by itself, for those ships whose energy units were granted by OXPs after the ship was spawned, this OXP makes available a function for the awarding OXP to call to enable the awarded energy unit.

This OXP also awards energy units (civilian and naval) to NPCs, based on their accuracy (the higher accuracy have greater probability of getting them) and recharge rate (the higher recharge rates have lesse probability of getting the energy units).

== Notes for OXP developers ==

This OXP makes available the following functions:

* <code>worldScripts.NPC_Energy_Units.$getShipEnergyUnit(ship)</code>

:A convenience function that returns the equipment Key for any energy unit installed on the ship, or null if the ship has none.

* <code>worldScripts.NPC_Energy_Units.$setupEnergyUnits(ship)</code>

:Updates the ship's energy recharge rate to the factory value boosted by the energy unit installed, if it's not damaged.
:Returns true if the ship's energy recharge was modified and false otherwise.

* <code>worldScripts.NPC_Energy_Units.$energyUnitDamaged(equipmentKey)</code>

:An event handler for damage to energy units, it MUST be called in the context ('this') of the ship's script, as in:

worldScripts.NPC_Energy_Units.$energyUnitDamaged.call(ship.script, equipmentKey)

:It restores the ship to its factory energy recharge rate if the equipmentKey is an energy unit and its status in the ship isn't EQUIPMENT_OK: it can be called after an energy unit is removed from the ship to reset its energy recharge rate, but that means that if the ship has a naval energy unit and this function is called with the key for an extra energy unit, the ship's energy recharge rate WILL be reset, rendering the naval energy unit non-functional.

:This OXP includes this function in NPC Equipment Damage OXP list of equipment damage handlers if that OXP is installed.

== License ==

This OXP is licensed under the [https://creativecommons.org/licenses/by-sa/4.0/legalcode CC-BY-SA 4.0].

== Aknowledgements ==

This OXP is based on Ngalo's original NPC Energy Unit.

I would rather have updated the original OXP, but although it had a CC BY-NC-SA, it didn't specify the version, so I opted to write a new one to replace it just to be in safe licensing grounds.

== Downloads ==

The latest version is available on the Expansion Manager and here: [[Media:NpcEnergyUnits-1.0.1.oxz|NPC Energy Units v1.0.1]]

== Version History ==

Version 1.0.1 (december/2020):

* Adds _alreadyGotOne array (with ships that have high energy recharge rate to emulate an energy unit) for backwards compatibility with Ngalo's version (and used by Military Shields OXP).
* Changes parameters for granting NEU and EEU to reduce probability of granting to ships with recharge rate above 6.

Version 1.0 (november/2020):

* Initial version

== Quick Facts ==

{{OXPLevel|5}}
{{IconOXP|ooVersion="1.82"|oxpCPU="Low"|oxpMEM="Low"|oxpGPU="Low"|oxpIsAPI=true|oxpIsDocumented=true}}
{{Infobox OXPb| title NPC Energy Units
|version = 1.0.1
|release = 2020-12-02
|license = CC-BY-SA 4.0
|features = Enables the NPCs energy units
|category = Mechanics OXPs
|author = [[User:Dybal|Dybal]]
|feedback = [http://www.aegidian.org/bb/viewtopic.php?f=4&t=18161 Oolite BB]
}}

== Gameplay and Balance indicator ==
[[File:Tag-colour-red.png]]

{{Mechanics-OXP}}

NPC Energy Units OXP

2020-12-04T15:56:10Z

Dybal: /* Version History */

== Description ==

NPC Energy Units OXP aims to make the energy units in NPC ships operational, enhancing the NPCs energy recharge rate.

For those NPC ships created with the energy units, this OXP will enable them by itself, for those ships whose energy units were granted by OXPs after the ship was spawned, this OXP makes available a function for the awarding OXP to call to enable the awarded energy unit.

This OXP also awards energy units (civilian and naval) to NPCs, based on their accuracy (the higher accuracy have greater probability of getting them) and recharge rate (the higher recharge rates have lesse probability of getting the energy units).

== Notes for OXP developers ==

This OXP makes available the following functions:

* <code>worldScripts.NPC_Energy_Units.$getShipEnergyUnit(ship)</code>

:A convenience function that returns the equipment Key for any energy unit installed on the ship, or null if the ship has none.

* <code>worldScripts.NPC_Energy_Units.$setupEnergyUnits(ship)</code>

:Updates the ship's energy recharge rate to the factory value boosted by the energy unit installed, if it's not damaged.
:Returns true if the ship's energy recharge was modified and false otherwise.

* <code>worldScripts.NPC_Energy_Units.$energyUnitDamaged(equipmentKey)</code>

:An event handler for damage to energy units, it MUST be called in the context ('this') of the ship's script, as in:

worldScripts.NPC_Energy_Units.$energyUnitDamaged.call(ship.script, equipmentKey)

:It restores the ship to its factory energy recharge rate if the equipmentKey is an energy unit and its status in the ship isn't EQUIPMENT_OK: it can be called after an energy unit is removed from the ship to reset its energy recharge rate, but that means that if the ship has a naval energy unit and this function is called with the key for an extra energy unit, the ship's energy recharge rate WILL be reset, rendering the naval energy unit non-functional.

:This OXP includes this function in NPC Equipment Damage OXP list of equipment damage handlers if that OXP is installed.

== License ==

This OXP is licensed under the [https://creativecommons.org/licenses/by-sa/4.0/legalcode CC-BY-SA 4.0].

== Aknowledgements ==

This OXP is based on Ngalo's original NPC Energy Unit.

I would rather have updated the original OXP, but although it had a CC BY-NC-SA, it didn't specify the version, so I opted to write a new one to replace it just to be in safe licensing grounds.

== Downloads ==

The latest version is available on the Expansion Manager and here: [[Media:NpcEnergyUnits-1.0.1.oxz|NPC Energy Units v1.0.1]]

== Version History ==

Version 1.0.1 (december/2020):

* Adds _alreadyGotOne array (with ships that have high energy recharge rate to emulate an energy unit) for backwards compatibility with Ngalo's version (and used by Military Shields OXP).
* Changes parameters for granting NEU and EEU to reduce probability of granting to ships with recharge rate above 6.

Version 1.0 (november/2020):

* Initial version

== Quick Facts ==

{{OXPLevel|5}}
{{IconOXP|ooVersion="1.82"|oxpCPU="Low"|oxpMEM="Low"|oxpGPU="Low"|oxpIsAPI=true|oxpIsDocumented=true}}
{{Infobox OXPb| title NPC Energy Units
|version = 1.0
|release = 2020-12-02
|license = CC-BY-SA 4.0
|features = Enables the NPCs energy units
|category = Mechanics OXPs
|author = [[User:Dybal|Dybal]]
|feedback = [http://www.aegidian.org/bb/viewtopic.php?f=4&t=18161 Oolite BB]
}}

== Gameplay and Balance indicator ==
[[File:Tag-colour-red.png]]

{{Mechanics-OXP}}

NPC Energy Units OXP

2020-12-04T15:55:39Z

Dybal: /* Downloads */

== Description ==

NPC Energy Units OXP aims to make the energy units in NPC ships operational, enhancing the NPCs energy recharge rate.

For those NPC ships created with the energy units, this OXP will enable them by itself, for those ships whose energy units were granted by OXPs after the ship was spawned, this OXP makes available a function for the awarding OXP to call to enable the awarded energy unit.

This OXP also awards energy units (civilian and naval) to NPCs, based on their accuracy (the higher accuracy have greater probability of getting them) and recharge rate (the higher recharge rates have lesse probability of getting the energy units).

== Notes for OXP developers ==

This OXP makes available the following functions:

* <code>worldScripts.NPC_Energy_Units.$getShipEnergyUnit(ship)</code>

:A convenience function that returns the equipment Key for any energy unit installed on the ship, or null if the ship has none.

* <code>worldScripts.NPC_Energy_Units.$setupEnergyUnits(ship)</code>

:Updates the ship's energy recharge rate to the factory value boosted by the energy unit installed, if it's not damaged.
:Returns true if the ship's energy recharge was modified and false otherwise.

* <code>worldScripts.NPC_Energy_Units.$energyUnitDamaged(equipmentKey)</code>

:An event handler for damage to energy units, it MUST be called in the context ('this') of the ship's script, as in:

worldScripts.NPC_Energy_Units.$energyUnitDamaged.call(ship.script, equipmentKey)

:It restores the ship to its factory energy recharge rate if the equipmentKey is an energy unit and its status in the ship isn't EQUIPMENT_OK: it can be called after an energy unit is removed from the ship to reset its energy recharge rate, but that means that if the ship has a naval energy unit and this function is called with the key for an extra energy unit, the ship's energy recharge rate WILL be reset, rendering the naval energy unit non-functional.

:This OXP includes this function in NPC Equipment Damage OXP list of equipment damage handlers if that OXP is installed.

== License ==

This OXP is licensed under the [https://creativecommons.org/licenses/by-sa/4.0/legalcode CC-BY-SA 4.0].

== Aknowledgements ==

This OXP is based on Ngalo's original NPC Energy Unit.

I would rather have updated the original OXP, but although it had a CC BY-NC-SA, it didn't specify the version, so I opted to write a new one to replace it just to be in safe licensing grounds.

== Downloads ==

The latest version is available on the Expansion Manager and here: [[Media:NpcEnergyUnits-1.0.1.oxz|NPC Energy Units v1.0.1]]

== Version History ==

Version 1.0 (november/2020):

* Initial version

== Quick Facts ==

{{OXPLevel|5}}
{{IconOXP|ooVersion="1.82"|oxpCPU="Low"|oxpMEM="Low"|oxpGPU="Low"|oxpIsAPI=true|oxpIsDocumented=true}}
{{Infobox OXPb| title NPC Energy Units
|version = 1.0
|release = 2020-12-02
|license = CC-BY-SA 4.0
|features = Enables the NPCs energy units
|category = Mechanics OXPs
|author = [[User:Dybal|Dybal]]
|feedback = [http://www.aegidian.org/bb/viewtopic.php?f=4&t=18161 Oolite BB]
}}

== Gameplay and Balance indicator ==
[[File:Tag-colour-red.png]]

{{Mechanics-OXP}}

File:NpcEnergyUnits-1.0.1.oxz

2020-12-04T15:50:05Z

Dybal: NPC Energy Units OXP, v1.0.1

NPC Energy Units OXP, v1.0.1

NPC Energy Units OXP

2020-12-02T13:28:20Z

Dybal: /* Notes for OXP developers */

== Description ==

NPC Energy Units OXP aims to make the energy units in NPC ships operational, enhancing the NPCs energy recharge rate.

For those NPC ships created with the energy units, this OXP will enable them by itself, for those ships whose energy units were granted by OXPs after the ship was spawned, this OXP makes available a function for the awarding OXP to call to enable the awarded energy unit.

This OXP also awards energy units (civilian and naval) to NPCs, based on their accuracy (the higher accuracy have greater probability of getting them) and recharge rate (the higher recharge rates have lesse probability of getting the energy units).

== Notes for OXP developers ==

This OXP makes available the following functions:

* <code>worldScripts.NPC_Energy_Units.$getShipEnergyUnit(ship)</code>

:A convenience function that returns the equipment Key for any energy unit installed on the ship, or null if the ship has none.

* <code>worldScripts.NPC_Energy_Units.$setupEnergyUnits(ship)</code>

:Updates the ship's energy recharge rate to the factory value boosted by the energy unit installed, if it's not damaged.
:Returns true if the ship's energy recharge was modified and false otherwise.

* <code>worldScripts.NPC_Energy_Units.$energyUnitDamaged(equipmentKey)</code>

:An event handler for damage to energy units, it MUST be called in the context ('this') of the ship's script, as in:

worldScripts.NPC_Energy_Units.$energyUnitDamaged.call(ship.script, equipmentKey)

:It restores the ship to its factory energy recharge rate if the equipmentKey is an energy unit and its status in the ship isn't EQUIPMENT_OK: it can be called after an energy unit is removed from the ship to reset its energy recharge rate, but that means that if the ship has a naval energy unit and this function is called with the key for an extra energy unit, the ship's energy recharge rate WILL be reset, rendering the naval energy unit non-functional.

:This OXP includes this function in NPC Equipment Damage OXP list of equipment damage handlers if that OXP is installed.

== License ==

This OXP is licensed under the [https://creativecommons.org/licenses/by-sa/4.0/legalcode CC-BY-SA 4.0].

== Aknowledgements ==

This OXP is based on Ngalo's original NPC Energy Unit.

I would rather have updated the original OXP, but although it had a CC BY-NC-SA, it didn't specify the version, so I opted to write a new one to replace it just to be in safe licensing grounds.

== Downloads ==

The latest version is available on the Expansion Manager and here: [[Media:NpcEnergyUnits-1.0.oxz|NPC Energy Units v1.0]]

== Version History ==

Version 1.0 (november/2020):

* Initial version

== Quick Facts ==

{{OXPLevel|5}}
{{IconOXP|ooVersion="1.82"|oxpCPU="Low"|oxpMEM="Low"|oxpGPU="Low"|oxpIsAPI=true|oxpIsDocumented=true}}
{{Infobox OXPb| title NPC Energy Units
|version = 1.0
|release = 2020-12-02
|license = CC-BY-SA 4.0
|features = Enables the NPCs energy units
|category = Mechanics OXPs
|author = [[User:Dybal|Dybal]]
|feedback = [http://www.aegidian.org/bb/viewtopic.php?f=4&t=18161 Oolite BB]
}}

== Gameplay and Balance indicator ==
[[File:Tag-colour-red.png]]

{{Mechanics-OXP}}

NPC Energy Units OXP

2020-12-02T13:05:29Z

Dybal: /* Gameplay and Balance indicator */

== Description ==

NPC Energy Units OXP aims to make the energy units in NPC ships operational, enhancing the NPCs energy recharge rate.

For those NPC ships created with the energy units, this OXP will enable them by itself, for those ships whose energy units were granted by OXPs after the ship was spawned, this OXP makes available a function for the awarding OXP to call to enable the awarded energy unit.

This OXP also awards energy units (civilian and naval) to NPCs, based on their accuracy (the higher accuracy have greater probability of getting them) and recharge rate (the higher recharge rates have lesse probability of getting the energy units).

== Notes for OXP developers ==

This OXP makes available the following functions:

* <code>worldScripts.NPC_Energy_Units.$getShipEnergyUnit(ship)</code>

:A convenience function that returns the equipment Key for any energy unit installed on the ship, or null if the ship has none.

* <code>worldScripts.NPC_Energy_Units.$setupEnergyUnits(ship)</code>

:Updates the ship's energy recharge rate to the factory value boosted by the energy unit installed, if it's not damaged.
:Returns true if the ship's energy recharge was modified and false otherwise.

* <code>worldScripts.NPC_Energy_Units.$energyUnitDamaged(equipmentKey)</code>

:An event handler for damage to energy units, it MUST be called in the context ('this') of the ship's script, as in:

worldScripts.NPC_Energy_Units.$energyUnitDamaged.call(ship.script, equipmentKey)

:It restores the ship to its factory energy recharge rate if the equipmentKey is an energy unit and its status in the ship isn't EQUIPMENT_OK: it can be called after an energy unit is removed from the ship to reset its energy recharge rate, but that means that if the ship has a naval energy unit and this function is called with the key for an extra energy unit, the ship's energy recharge rate WILL be reset, rendering the naval energy unit non-functional.

:This OXP includes this function in NPC Equipment Damage OXP list of equipment damage handlers if that OXP is installed.

== License ==

This OXP is licensed under the [https://creativecommons.org/licenses/by-sa/4.0/legalcode CC-BY-SA 4.0].

== Aknowledgements ==

This OXP is based on Ngalo's original NPC Energy Unit.

I would rather have updated the original OXP, but although it had a CC BY-NC-SA, it didn't specify the version, so I opted to write a new one to replace it just to be in safe licensing grounds.

== Downloads ==

The latest version is available on the Expansion Manager and here: [[Media:NpcEnergyUnits-1.0.oxz|NPC Energy Units v1.0]]

== Version History ==

Version 1.0 (november/2020):

* Initial version

== Quick Facts ==

{{OXPLevel|5}}
{{IconOXP|ooVersion="1.82"|oxpCPU="Low"|oxpMEM="Low"|oxpGPU="Low"|oxpIsAPI=true|oxpIsDocumented=true}}
{{Infobox OXPb| title NPC Energy Units
|version = 1.0
|release = 2020-12-02
|license = CC-BY-SA 4.0
|features = Enables the NPCs energy units
|category = Mechanics OXPs
|author = [[User:Dybal|Dybal]]
|feedback = [http://www.aegidian.org/bb/viewtopic.php?f=4&t=18161 Oolite BB]
}}

== Gameplay and Balance indicator ==
[[File:Tag-colour-red.png]]

{{Mechanics-OXP}}

NPC Energy Units OXP

2020-12-02T13:02:31Z

Dybal: /* Quick Facts */

== Description ==

NPC Energy Units OXP aims to make the energy units in NPC ships operational, enhancing the NPCs energy recharge rate.

For those NPC ships created with the energy units, this OXP will enable them by itself, for those ships whose energy units were granted by OXPs after the ship was spawned, this OXP makes available a function for the awarding OXP to call to enable the awarded energy unit.

This OXP also awards energy units (civilian and naval) to NPCs, based on their accuracy (the higher accuracy have greater probability of getting them) and recharge rate (the higher recharge rates have lesse probability of getting the energy units).

== Notes for OXP developers ==

This OXP makes available the following functions:

* <code>worldScripts.NPC_Energy_Units.$getShipEnergyUnit(ship)</code>

:A convenience function that returns the equipment Key for any energy unit installed on the ship, or null if the ship has none.

* <code>worldScripts.NPC_Energy_Units.$setupEnergyUnits(ship)</code>

:Updates the ship's energy recharge rate to the factory value boosted by the energy unit installed, if it's not damaged.
:Returns true if the ship's energy recharge was modified and false otherwise.

* <code>worldScripts.NPC_Energy_Units.$energyUnitDamaged(equipmentKey)</code>

:An event handler for damage to energy units, it MUST be called in the context ('this') of the ship's script, as in:

worldScripts.NPC_Energy_Units.$energyUnitDamaged.call(ship.script, equipmentKey)

:It restores the ship to its factory energy recharge rate if the equipmentKey is an energy unit and its status in the ship isn't EQUIPMENT_OK: it can be called after an energy unit is removed from the ship to reset its energy recharge rate, but that means that if the ship has a naval energy unit and this function is called with the key for an extra energy unit, the ship's energy recharge rate WILL be reset, rendering the naval energy unit non-functional.

:This OXP includes this function in NPC Equipment Damage OXP list of equipment damage handlers if that OXP is installed.

== License ==

This OXP is licensed under the [https://creativecommons.org/licenses/by-sa/4.0/legalcode CC-BY-SA 4.0].

== Aknowledgements ==

This OXP is based on Ngalo's original NPC Energy Unit.

I would rather have updated the original OXP, but although it had a CC BY-NC-SA, it didn't specify the version, so I opted to write a new one to replace it just to be in safe licensing grounds.

== Downloads ==

The latest version is available on the Expansion Manager and here: [[Media:NpcEnergyUnits-1.0.oxz|NPC Energy Units v1.0]]

== Version History ==

Version 1.0 (november/2020):

* Initial version

== Quick Facts ==

{{OXPLevel|5}}
{{IconOXP|ooVersion="1.82"|oxpCPU="Low"|oxpMEM="Low"|oxpGPU="Low"|oxpIsAPI=true|oxpIsDocumented=true}}
{{Infobox OXPb| title NPC Energy Units
|version = 1.0
|release = 2020-12-02
|license = CC-BY-SA 4.0
|features = Enables the NPCs energy units
|category = Mechanics OXPs
|author = [[User:Dybal|Dybal]]
|feedback = [http://www.aegidian.org/bb/viewtopic.php?f=4&t=18161 Oolite BB]
}}

== Gameplay and Balance indicator ==
[[File:Tag-colour-violet.png]]

{{Mechanics-OXP}}

NPC Energy Units OXP

2020-12-02T13:01:39Z

Dybal: /* Quick Facts */

== Description ==

NPC Energy Units OXP aims to make the energy units in NPC ships operational, enhancing the NPCs energy recharge rate.

For those NPC ships created with the energy units, this OXP will enable them by itself, for those ships whose energy units were granted by OXPs after the ship was spawned, this OXP makes available a function for the awarding OXP to call to enable the awarded energy unit.

This OXP also awards energy units (civilian and naval) to NPCs, based on their accuracy (the higher accuracy have greater probability of getting them) and recharge rate (the higher recharge rates have lesse probability of getting the energy units).

== Notes for OXP developers ==

This OXP makes available the following functions:

* <code>worldScripts.NPC_Energy_Units.$getShipEnergyUnit(ship)</code>

:A convenience function that returns the equipment Key for any energy unit installed on the ship, or null if the ship has none.

* <code>worldScripts.NPC_Energy_Units.$setupEnergyUnits(ship)</code>

:Updates the ship's energy recharge rate to the factory value boosted by the energy unit installed, if it's not damaged.
:Returns true if the ship's energy recharge was modified and false otherwise.

* <code>worldScripts.NPC_Energy_Units.$energyUnitDamaged(equipmentKey)</code>

:An event handler for damage to energy units, it MUST be called in the context ('this') of the ship's script, as in:

worldScripts.NPC_Energy_Units.$energyUnitDamaged.call(ship.script, equipmentKey)

:It restores the ship to its factory energy recharge rate if the equipmentKey is an energy unit and its status in the ship isn't EQUIPMENT_OK: it can be called after an energy unit is removed from the ship to reset its energy recharge rate, but that means that if the ship has a naval energy unit and this function is called with the key for an extra energy unit, the ship's energy recharge rate WILL be reset, rendering the naval energy unit non-functional.

:This OXP includes this function in NPC Equipment Damage OXP list of equipment damage handlers if that OXP is installed.

== License ==

This OXP is licensed under the [https://creativecommons.org/licenses/by-sa/4.0/legalcode CC-BY-SA 4.0].

== Aknowledgements ==

This OXP is based on Ngalo's original NPC Energy Unit.

I would rather have updated the original OXP, but although it had a CC BY-NC-SA, it didn't specify the version, so I opted to write a new one to replace it just to be in safe licensing grounds.

== Downloads ==

The latest version is available on the Expansion Manager and here: [[Media:NpcEnergyUnits-1.0.oxz|NPC Energy Units v1.0]]

== Version History ==

Version 1.0 (november/2020):

* Initial version

== Quick Facts ==

{{OXPLevel|5}}
{{IconOXP|ooVersion="1.82"|oxpCPU="Low"|oxpMEM="Low"|oxpGPU="Low"|oxpIsAPI=true|oxpIsDocumented=true}}
{{Infobox OXPb| title NPC Energy Units
|version = 1.0
|release = 2020-12-02
|license = CC-BY-SA 4.0
|features = Enables the NPCs energy units
|category = Mechanics OXPs
|author = [[User:Dybal|Dybal]]
|feedback = [http://www.aegidian.org/bb/viewtopic.php?f=4&t=18161 Oolite BB]
}}

NPC Energy Units OXP

2020-12-02T12:58:04Z

Dybal: /* Aknowledgements */

== Description ==

NPC Energy Units OXP aims to make the energy units in NPC ships operational, enhancing the NPCs energy recharge rate.

For those NPC ships created with the energy units, this OXP will enable them by itself, for those ships whose energy units were granted by OXPs after the ship was spawned, this OXP makes available a function for the awarding OXP to call to enable the awarded energy unit.

This OXP also awards energy units (civilian and naval) to NPCs, based on their accuracy (the higher accuracy have greater probability of getting them) and recharge rate (the higher recharge rates have lesse probability of getting the energy units).

== Notes for OXP developers ==

This OXP makes available the following functions:

* <code>worldScripts.NPC_Energy_Units.$getShipEnergyUnit(ship)</code>

:A convenience function that returns the equipment Key for any energy unit installed on the ship, or null if the ship has none.

* <code>worldScripts.NPC_Energy_Units.$setupEnergyUnits(ship)</code>

:Updates the ship's energy recharge rate to the factory value boosted by the energy unit installed, if it's not damaged.
:Returns true if the ship's energy recharge was modified and false otherwise.

* <code>worldScripts.NPC_Energy_Units.$energyUnitDamaged(equipmentKey)</code>

:An event handler for damage to energy units, it MUST be called in the context ('this') of the ship's script, as in:

worldScripts.NPC_Energy_Units.$energyUnitDamaged.call(ship.script, equipmentKey)

:It restores the ship to its factory energy recharge rate if the equipmentKey is an energy unit and its status in the ship isn't EQUIPMENT_OK: it can be called after an energy unit is removed from the ship to reset its energy recharge rate, but that means that if the ship has a naval energy unit and this function is called with the key for an extra energy unit, the ship's energy recharge rate WILL be reset, rendering the naval energy unit non-functional.

:This OXP includes this function in NPC Equipment Damage OXP list of equipment damage handlers if that OXP is installed.

== License ==

This OXP is licensed under the [https://creativecommons.org/licenses/by-sa/4.0/legalcode CC-BY-SA 4.0].

== Aknowledgements ==

This OXP is based on Ngalo's original NPC Energy Unit.

I would rather have updated the original OXP, but although it had a CC BY-NC-SA, it didn't specify the version, so I opted to write a new one to replace it just to be in safe licensing grounds.

== Downloads ==

The latest version is available on the Expansion Manager and here: [[Media:NpcEnergyUnits-1.0.oxz|NPC Energy Units v1.0]]

== Version History ==

Version 1.0 (november/2020):

* Initial version

== Quick Facts ==

{{OXPLevel|5}}
{{IconOXP|ooVersion="1.82"|oxpCPU="Low"|oxpMEM="Low"|oxpGPU="Low"|oxpIsAPI=true|oxpIsDocumented=true}}
{{Infobox OXPb| title NPC Energy Units
|version = 1.0
|release = 2020-12-02
|license = CC-BY-SA 4.0
|features = Enables the NPCs energy units
|category = Mechanics OXPs
|author = [[User:Dybal|Dybal]]
|feedback = [http://aegidian.org/bb/viewtopic.php?f=4&t=9772 Oolite BB]
}}

NPC Energy Units OXP

2020-12-02T12:52:04Z

Dybal: /* License */

NPC Energy Units OXP

2020-12-02T12:51:40Z

Dybal: /* Notes for OXP developers */

NPC Energy Units OXP

2020-12-02T12:50:48Z

Dybal: /* Notes for OXP developers */

NPC Energy Units OXP

2020-12-02T12:50:34Z

Dybal: Created page with "== Description == NPC Energy Units OXP aims to make the energy units in NPC ships operational, enhancing the NPCs energy recharge rate. For those NPC ships created with the..."

File:NpcEnergyUnits-1.0.oxz

2020-12-02T12:43:59Z

Dybal: NPC Energy Units OXP v1.0

NPC Energy Units OXP v1.0

N-Shields

2020-12-02T12:21:55Z

Dybal: /* Quick Facts */

== Description ==
Gives NPCs highly customizable shields, with the default setting (as in [[CustomShields]]) being a 'fair' emulation of the player's shields.

Features:

- Fair shield recharge code (CustomShields didn't charge shields until energy banks were full)

- Acts as a hub for handling damage to NPCs, calling damage handlers from other OXPs after the shields are depleted and the damage reach the ship's hull, providing better compatibility for other OXPs with shipTakingDamage overrides

- Thargoids get dorsal/ventral shields. Support for other very non-standard shield configurations was attempted but removed in version 0.7 to simplify the code.

- More customisable colours. The default multicolour set goes from green down to red for standard shields, extending to blue/purple with upgrades.

- New visual effects based on explosions.plist for shields and unshielded hits.

- Awards Shield Cycler for a percentage of the ships that don't have them, configures Shield Booster and Military Shield Booster for NPCs that have them, apply shield recharge enhancements from Energy Grid (civillian and naval) for ships that have them.

== Settings in N-Shields.js scripts ==

There are some settings that can be modified in N-Shields script no change tnhe OXP behaviour:

* <code>this._NPC_shields = true;</code>
:Switch simulated shields on or off. If false, visual effects will be drawn based on energy level.

* <code>this._Thargoid_shields = true;</code>
:As above, but applies to Thargoids.

* <code>this._Thargoid_energyReduction = true;</code>
:Reduce Thargoids' energy banks to balance their new shields.

* <code>this._NPC_flasherColours = 1;</code>
:Pre-defined flasher list to use for standard NPC shields.
:Options:
::0: "_multicolour1", simple and bright
::1: "_multicolour2", slightly different colours, reduced alpha when low
::2: "_multicolour3", reverse colour order (red high, blue low)
::3: "_green", the Thargoid default (but can be used for other NPCs too)
::4: "_blue", various shades of blue

* <code>this._Thargoid_flasherColours = 3;</code>
:Colour for Thargoid shields, options as above.

* <code>this._flasherScale = 1;</code>
:Scale factor for flasher effects.

== Notes for OXP developers ==

=== scriptInfo properties ===

N-Shields looks for the following ship's scriptInfo properties:
* <code>npc_shields = "no";</code>
: N-Shields ignores the ship and doesn't do anything.

* <code>NShields_flasherKeys = ("myRed1", "myRed2", "myRed3", "myRed3", "myRed4");</code>
: A list of partial effectdata.plist keys, which will be prefixed with "N-Shields_flasher_" to obtain the full key for each flasher or other visualEffect.
: Ordered from lowest shield level to highest in 32-point increments.

* <code>NShields_flasherPreset = 3;</code>
: Number indicating one of the pre-defined flasher lists.
: See above for available options.

* <code>max_shield_aft = 128;</code>
* <code>max_shield_forward = 128;</code>
* <code>shield_recharge_aft = 2.0;</code>
* <code>shield_recharge_forward = 2.0;</code>
: Customise shield levels and recharge rates for this ship.
: The example above shows the standard default shields.
: Note that these can apply to player ships as well as NPCs.
: For Thargoid vessels, use 'upper' and 'lower' instead of 'forward' and 'aft'.

* <code>NShields_energyReduction = 128;</code>
: Specify an energy-bank reduction which will be applied when shields are set up.
: This is intended for two purposes:
::1) For mission ships, to prevent already-difficult opponents becoming impossible
::2) For ships which are 'supposed' to have strong shields, but 'fake it' with bigger energy banks when N-Shields is not installed.

* <code>NShields_exploders = ("NShields-explode-ring-red")</code>
: Custom exploder effect list. The example would make your ship spawn red(ish) ring explosions when its shields are hit.

* <code>NShields_protect_subentities = "no";</code>
: If defined as shown, shields will not protect frangible subentities on this ship.
: The subentities may be left exposed, or given their own shield configurations like any other ship.

The script_info keys "NShields_config" and "NShields_colours" are no longer supported.

=== Compatibility with other shipTakingDamage handler overrides ===

N-Shields provides an array onto which other OXPs can push their NPC ''shipTakingDamage'' handlers instead of actually overriding the handler in the ship script. Functions in this array will imitate the player's world-script ''shipTakingDamage'' handler; that is, they are called for every hit but with the 'amount' parameter only conveying damage which actually penetrated the shields (0 if the hit was entirely absorbed by shields). This approach ensures your handler will be called in the same manner regardless of OXP loading order and avoids any need for your OXP to detect which shield was hit and whether it's still up.

There are two ways to use this feature:

:1) In your script's ''startUp'' handler:

if (worldScripts.NShields && worldScripts.NShields.$shipHasShields(ship)) {
worldScripts.NShields._damageHandlers.push(my_shipTakingDamage_override)
} else {
//apply your handler override directly here
}

::Replace ''my_shipTakingDamage_override'' with your handler name.
::This approach applies your handler to all ships which have simulated shields, but not to those which don't. If you need to choose which ships get the handler yourself, use the other option:

:2) In your script's ''shipSpawned'' handler, once you have decided that a ship should get your ''shipTakingDamage'' override:

if (worldScripts.NShields && worldScripts.NShields.$shipHasShields(ship)) {
if (!ship.script._NShields_damageHandlers)
//set up the array if N-Shields hasn't run its shipSpawned handler yet
ship.script._NShields_damageHandlers = [];
ship.script._NShields_damageHandlers.push(my_shipTakingDamage_override)
} else {
//apply your handler override directly here
}

::Replace ''my_shipTakingDamage_override'' with your handler name.

=== function to configure NPC ship ===

N-Shields makes available to other OXPs a function to configure the NPC's shields after awarding of any defense-related equipment to it:

worldScripts.NShields.$configureShip(ship)

This idempotent (i.e. can be called several times without adverse effects) function will configure the ship's shields taking into account any script_info properties defined and the equipments isntalled in the ship, like Shield Booster, Military Shield Enhancement, Energy Grid, Shield Cycler, etc.

== Downloads ==
latest version available on the Expansion Manager and here: [[Media:N-Shields-1.0.1.oxz|N-Shields v1.0.1]]

[http://wiki.alioth.net/img_auth.php/b/b0/N-Shields_0.7.oxz N-Shields 0.7] {{#downloads:N-Shields_0.7.oxz}} downloads

[http://wiki.alioth.net/img_auth.php/2/2d/N-Shields.oxz N-Shields 0.6.4] downloaded {{#downloads:N-Shields.oxz}} times

== Version History ==

1.0.1 (by Dybal)
* Doesn't add shields to scoopable "ships" (that includes all variations of escape capsules, even if their primary role happens to be different from escape-capsule).
* Fixes bugs that broke idempotency of $configureShip (leading to infinite loops at damage handling if $configureShip was called twice on the same ship).
* Fixes bug that led to "invulnerable ship" if the ship's script had its own shipTakingDamage event handler.

1.0 (by Dybal)
* Drops support for Shield Cycler (and Shield Cycler Next) 1.x for NPCs.
* Creates idempotent function for OXPs to call to configure a NPC's shields.
* Encapsulates modifications of ship's energy to verify for NaN before assigning a value into ship.energy (to prevent "invulnerable ship" bug).
* Adds delay to shipSpawned before setting up the ship to allow other OXPs' shipSpawned to award equipments.
* Configures shield recharge rate with Energy Grid (civilian and naval) upgrades if the NPC has them installed.
* Configures both Military Shield Enhancement and Shield Enhancer for NPCs.
* Doesn't award Shield Cycler to NPCs that have Shield Equalizer.
* Fixes bugs in handling of damage to subentities.
* Standardizes script object properties names: functions references start with '$' (except event handlers), everything else starts with '_';

0.7.1
* Fixed missing "use strict" in N-Shields.js.
* Removed Ship Configuration compatibility script entry from world-scripts.plist (the actual script was removed in 0.7.0).
* Reduced Thargoids' max shields (and compensatory energy reduction) slightly.

0.7
* Removed support for unusual/configurable shield types, except dorsal/ventral which now applies to Thargoids only, in order to simplify the scripts.
* Changed flashers from Ship entities to VisualEffects.
* Pre-defined flasher colour options: 3x Multicolour, Green, Blue.
* Hemisphere glow effects removed.
* New script_info keys NShields_flasherPreset, NShields_flasherKeys, max_shield_forward etc. to replace the now-unsupported NShields_colours, NShields_config.
* Config interface now works correctly (requires Oolite 1.83 or higher and Library OXP).
* Improved efficiency of hit-location code.
* Tentative support for Shield Cyclers on NPCs.

0.6.4
* Fixed bug in $locateHit cloaked-attacker handling (missing a ".position" or two).

0.6.3
* Fixed some bugs in NPC Equipment Damage compatibility code

0.6.2
* Fixed bug in manifest (missing "}").

0.6.1
* Added correctly functioning shipconfig version check and fixed small variable non-declaration in $drawSparks

0.6
* Added user-friendly configuration options via Library OXP.
* Hemisphere glow effects now work, although they still look awful.
* Added compatibility with NPC Equipment Damage OXP.

0.5.4
* Removed non-functioning version check; tested & corrected quaternion multiplication.

0.5.3
* Added version check in NShields-shipconfig-compatibility.js as requested by phkb

0.5.2
* Attempt to fix buggy aft shield effect orientation by using quaternion multiplication. Untested due to oolite-trunk launching error.

0.5.1
* Fixed bug in subentity shielding code which didn't check whether a shipTakingDamage handler had been stored before trying to call it
* Added hemisphere glow effects (disabled by default because very under-debugged & not really working yet)

0.5
* Added explosion-based shield effects.

0.4
* Improved recharge code for fore/aft shields works more like the core player version.
* Correct handling of heat damage (hopefully?).
* $locateHit now attempts to identify a cloaked attacker if the parameter passed is null.
* Added dorsal/ventral shield configuration option and changed Thargoid default to use this.
* Fixed bug in $configureShieldsFromArray which caused Thargoid shield config failure.

0.3
* New features: Player shield effects, NPC shields protect subentities, spark effects for unshielded hits.
* Support for Ship Configuration OXP's shield upgrades/downgrades.
* Fixed bug in recharge code which resulted in excessive energy drain.
* Not released.

0.2
* Extensive re-write implementing some configuration options.
* 'single' and 'fore/aft' shield types supported.
* Damage handler array added for compatibility with other OXPs.
* Not released.

0.1
* Very basic shield simulation. Not released.

== Quick Facts ==

{{OXPLevel|4}}
{{IconOXP|ooVersion="1.81"|oxpCPU="Medium"|oxpMEM="Low"|oxpGPU="Low"|oxpIsAPI=true|oxpIsDocumented=true|oxpIsConfigurable=true}}
{{Infobox OXPb| title N-Shields
|version = 1.0.1
|release = 2020-12-02
|license = CC-BY-SA 3.0
|features = Provides shields for NPCs.
|category = Mechanics OXPs
|author = [[User:Ngalo|NGalo]]
|feedback = [http://www.aegidian.org/bb/viewtopic.php?f=4&t=18127 Oolite BB]
}}

== Gameplay and Balance indicator ==
[[File:Tag-colour-red.png]]

== Links ==

[http://wiki.alioth.net/index.php/User:Ngalo Commander Ngalo's other OXPs]

{{equipment-OXP}}

N-Shields

2020-12-02T12:21:33Z

Dybal: /* Version History */

== Description ==
Gives NPCs highly customizable shields, with the default setting (as in [[CustomShields]]) being a 'fair' emulation of the player's shields.

Features:

- Fair shield recharge code (CustomShields didn't charge shields until energy banks were full)

- Acts as a hub for handling damage to NPCs, calling damage handlers from other OXPs after the shields are depleted and the damage reach the ship's hull, providing better compatibility for other OXPs with shipTakingDamage overrides

- Thargoids get dorsal/ventral shields. Support for other very non-standard shield configurations was attempted but removed in version 0.7 to simplify the code.

- More customisable colours. The default multicolour set goes from green down to red for standard shields, extending to blue/purple with upgrades.

- New visual effects based on explosions.plist for shields and unshielded hits.

- Awards Shield Cycler for a percentage of the ships that don't have them, configures Shield Booster and Military Shield Booster for NPCs that have them, apply shield recharge enhancements from Energy Grid (civillian and naval) for ships that have them.

== Settings in N-Shields.js scripts ==

There are some settings that can be modified in N-Shields script no change tnhe OXP behaviour:

* <code>this._NPC_shields = true;</code>
:Switch simulated shields on or off. If false, visual effects will be drawn based on energy level.

* <code>this._Thargoid_shields = true;</code>
:As above, but applies to Thargoids.

* <code>this._Thargoid_energyReduction = true;</code>
:Reduce Thargoids' energy banks to balance their new shields.

* <code>this._NPC_flasherColours = 1;</code>
:Pre-defined flasher list to use for standard NPC shields.
:Options:
::0: "_multicolour1", simple and bright
::1: "_multicolour2", slightly different colours, reduced alpha when low
::2: "_multicolour3", reverse colour order (red high, blue low)
::3: "_green", the Thargoid default (but can be used for other NPCs too)
::4: "_blue", various shades of blue

* <code>this._Thargoid_flasherColours = 3;</code>
:Colour for Thargoid shields, options as above.

* <code>this._flasherScale = 1;</code>
:Scale factor for flasher effects.

== Notes for OXP developers ==

=== scriptInfo properties ===

N-Shields looks for the following ship's scriptInfo properties:
* <code>npc_shields = "no";</code>
: N-Shields ignores the ship and doesn't do anything.

* <code>NShields_flasherKeys = ("myRed1", "myRed2", "myRed3", "myRed3", "myRed4");</code>
: A list of partial effectdata.plist keys, which will be prefixed with "N-Shields_flasher_" to obtain the full key for each flasher or other visualEffect.
: Ordered from lowest shield level to highest in 32-point increments.

* <code>NShields_flasherPreset = 3;</code>
: Number indicating one of the pre-defined flasher lists.
: See above for available options.

* <code>max_shield_aft = 128;</code>
* <code>max_shield_forward = 128;</code>
* <code>shield_recharge_aft = 2.0;</code>
* <code>shield_recharge_forward = 2.0;</code>
: Customise shield levels and recharge rates for this ship.
: The example above shows the standard default shields.
: Note that these can apply to player ships as well as NPCs.
: For Thargoid vessels, use 'upper' and 'lower' instead of 'forward' and 'aft'.

* <code>NShields_energyReduction = 128;</code>
: Specify an energy-bank reduction which will be applied when shields are set up.
: This is intended for two purposes:
::1) For mission ships, to prevent already-difficult opponents becoming impossible
::2) For ships which are 'supposed' to have strong shields, but 'fake it' with bigger energy banks when N-Shields is not installed.

* <code>NShields_exploders = ("NShields-explode-ring-red")</code>
: Custom exploder effect list. The example would make your ship spawn red(ish) ring explosions when its shields are hit.

* <code>NShields_protect_subentities = "no";</code>
: If defined as shown, shields will not protect frangible subentities on this ship.
: The subentities may be left exposed, or given their own shield configurations like any other ship.

The script_info keys "NShields_config" and "NShields_colours" are no longer supported.

=== Compatibility with other shipTakingDamage handler overrides ===

N-Shields provides an array onto which other OXPs can push their NPC ''shipTakingDamage'' handlers instead of actually overriding the handler in the ship script. Functions in this array will imitate the player's world-script ''shipTakingDamage'' handler; that is, they are called for every hit but with the 'amount' parameter only conveying damage which actually penetrated the shields (0 if the hit was entirely absorbed by shields). This approach ensures your handler will be called in the same manner regardless of OXP loading order and avoids any need for your OXP to detect which shield was hit and whether it's still up.

There are two ways to use this feature:

:1) In your script's ''startUp'' handler:

if (worldScripts.NShields && worldScripts.NShields.$shipHasShields(ship)) {
worldScripts.NShields._damageHandlers.push(my_shipTakingDamage_override)
} else {
//apply your handler override directly here
}

::Replace ''my_shipTakingDamage_override'' with your handler name.
::This approach applies your handler to all ships which have simulated shields, but not to those which don't. If you need to choose which ships get the handler yourself, use the other option:

:2) In your script's ''shipSpawned'' handler, once you have decided that a ship should get your ''shipTakingDamage'' override:

if (worldScripts.NShields && worldScripts.NShields.$shipHasShields(ship)) {
if (!ship.script._NShields_damageHandlers)
//set up the array if N-Shields hasn't run its shipSpawned handler yet
ship.script._NShields_damageHandlers = [];
ship.script._NShields_damageHandlers.push(my_shipTakingDamage_override)
} else {
//apply your handler override directly here
}

::Replace ''my_shipTakingDamage_override'' with your handler name.

=== function to configure NPC ship ===

N-Shields makes available to other OXPs a function to configure the NPC's shields after awarding of any defense-related equipment to it:

worldScripts.NShields.$configureShip(ship)

This idempotent (i.e. can be called several times without adverse effects) function will configure the ship's shields taking into account any script_info properties defined and the equipments isntalled in the ship, like Shield Booster, Military Shield Enhancement, Energy Grid, Shield Cycler, etc.

== Downloads ==
latest version available on the Expansion Manager and here: [[Media:N-Shields-1.0.1.oxz|N-Shields v1.0.1]]

[http://wiki.alioth.net/img_auth.php/b/b0/N-Shields_0.7.oxz N-Shields 0.7] {{#downloads:N-Shields_0.7.oxz}} downloads

[http://wiki.alioth.net/img_auth.php/2/2d/N-Shields.oxz N-Shields 0.6.4] downloaded {{#downloads:N-Shields.oxz}} times

== Version History ==

1.0.1 (by Dybal)
* Doesn't add shields to scoopable "ships" (that includes all variations of escape capsules, even if their primary role happens to be different from escape-capsule).
* Fixes bugs that broke idempotency of $configureShip (leading to infinite loops at damage handling if $configureShip was called twice on the same ship).
* Fixes bug that led to "invulnerable ship" if the ship's script had its own shipTakingDamage event handler.

1.0 (by Dybal)
* Drops support for Shield Cycler (and Shield Cycler Next) 1.x for NPCs.
* Creates idempotent function for OXPs to call to configure a NPC's shields.
* Encapsulates modifications of ship's energy to verify for NaN before assigning a value into ship.energy (to prevent "invulnerable ship" bug).
* Adds delay to shipSpawned before setting up the ship to allow other OXPs' shipSpawned to award equipments.
* Configures shield recharge rate with Energy Grid (civilian and naval) upgrades if the NPC has them installed.
* Configures both Military Shield Enhancement and Shield Enhancer for NPCs.
* Doesn't award Shield Cycler to NPCs that have Shield Equalizer.
* Fixes bugs in handling of damage to subentities.
* Standardizes script object properties names: functions references start with '$' (except event handlers), everything else starts with '_';

0.7.1
* Fixed missing "use strict" in N-Shields.js.
* Removed Ship Configuration compatibility script entry from world-scripts.plist (the actual script was removed in 0.7.0).
* Reduced Thargoids' max shields (and compensatory energy reduction) slightly.

0.7
* Removed support for unusual/configurable shield types, except dorsal/ventral which now applies to Thargoids only, in order to simplify the scripts.
* Changed flashers from Ship entities to VisualEffects.
* Pre-defined flasher colour options: 3x Multicolour, Green, Blue.
* Hemisphere glow effects removed.
* New script_info keys NShields_flasherPreset, NShields_flasherKeys, max_shield_forward etc. to replace the now-unsupported NShields_colours, NShields_config.
* Config interface now works correctly (requires Oolite 1.83 or higher and Library OXP).
* Improved efficiency of hit-location code.
* Tentative support for Shield Cyclers on NPCs.

0.6.4
* Fixed bug in $locateHit cloaked-attacker handling (missing a ".position" or two).

0.6.3
* Fixed some bugs in NPC Equipment Damage compatibility code

0.6.2
* Fixed bug in manifest (missing "}").

0.6.1
* Added correctly functioning shipconfig version check and fixed small variable non-declaration in $drawSparks

0.6
* Added user-friendly configuration options via Library OXP.
* Hemisphere glow effects now work, although they still look awful.
* Added compatibility with NPC Equipment Damage OXP.

0.5.4
* Removed non-functioning version check; tested & corrected quaternion multiplication.

0.5.3
* Added version check in NShields-shipconfig-compatibility.js as requested by phkb

0.5.2
* Attempt to fix buggy aft shield effect orientation by using quaternion multiplication. Untested due to oolite-trunk launching error.

0.5.1
* Fixed bug in subentity shielding code which didn't check whether a shipTakingDamage handler had been stored before trying to call it
* Added hemisphere glow effects (disabled by default because very under-debugged & not really working yet)

0.5
* Added explosion-based shield effects.

0.4
* Improved recharge code for fore/aft shields works more like the core player version.
* Correct handling of heat damage (hopefully?).
* $locateHit now attempts to identify a cloaked attacker if the parameter passed is null.
* Added dorsal/ventral shield configuration option and changed Thargoid default to use this.
* Fixed bug in $configureShieldsFromArray which caused Thargoid shield config failure.

0.3
* New features: Player shield effects, NPC shields protect subentities, spark effects for unshielded hits.
* Support for Ship Configuration OXP's shield upgrades/downgrades.
* Fixed bug in recharge code which resulted in excessive energy drain.
* Not released.

0.2
* Extensive re-write implementing some configuration options.
* 'single' and 'fore/aft' shield types supported.
* Damage handler array added for compatibility with other OXPs.
* Not released.

0.1
* Very basic shield simulation. Not released.

== Quick Facts ==

{{OXPLevel|4}}
{{IconOXP|ooVersion="1.81"|oxpCPU="Medium"|oxpMEM="Low"|oxpGPU="Low"|oxpIsAPI=true|oxpIsDocumented=true|oxpIsConfigurable=true}}
{{Infobox OXPb| title N-Shields
|version = 1.0
|release = 2020-11-27
|license = CC-BY-SA 3.0
|features = Provides shields for NPCs.
|category = Mechanics OXPs
|author = [[User:Ngalo|NGalo]]
|feedback = [http://www.aegidian.org/bb/viewtopic.php?f=4&t=18127 Oolite BB]
}}

== Gameplay and Balance indicator ==
[[File:Tag-colour-red.png]]

== Links ==

[http://wiki.alioth.net/index.php/User:Ngalo Commander Ngalo's other OXPs]

{{equipment-OXP}}

N-Shields

2020-12-02T12:21:04Z

Dybal: /* Downloads */

== Description ==
Gives NPCs highly customizable shields, with the default setting (as in [[CustomShields]]) being a 'fair' emulation of the player's shields.

Features:

- Fair shield recharge code (CustomShields didn't charge shields until energy banks were full)

- Acts as a hub for handling damage to NPCs, calling damage handlers from other OXPs after the shields are depleted and the damage reach the ship's hull, providing better compatibility for other OXPs with shipTakingDamage overrides

- Thargoids get dorsal/ventral shields. Support for other very non-standard shield configurations was attempted but removed in version 0.7 to simplify the code.

- More customisable colours. The default multicolour set goes from green down to red for standard shields, extending to blue/purple with upgrades.

- New visual effects based on explosions.plist for shields and unshielded hits.

- Awards Shield Cycler for a percentage of the ships that don't have them, configures Shield Booster and Military Shield Booster for NPCs that have them, apply shield recharge enhancements from Energy Grid (civillian and naval) for ships that have them.

== Settings in N-Shields.js scripts ==

There are some settings that can be modified in N-Shields script no change tnhe OXP behaviour:

* <code>this._NPC_shields = true;</code>
:Switch simulated shields on or off. If false, visual effects will be drawn based on energy level.

* <code>this._Thargoid_shields = true;</code>
:As above, but applies to Thargoids.

* <code>this._Thargoid_energyReduction = true;</code>
:Reduce Thargoids' energy banks to balance their new shields.

* <code>this._NPC_flasherColours = 1;</code>
:Pre-defined flasher list to use for standard NPC shields.
:Options:
::0: "_multicolour1", simple and bright
::1: "_multicolour2", slightly different colours, reduced alpha when low
::2: "_multicolour3", reverse colour order (red high, blue low)
::3: "_green", the Thargoid default (but can be used for other NPCs too)
::4: "_blue", various shades of blue

* <code>this._Thargoid_flasherColours = 3;</code>
:Colour for Thargoid shields, options as above.

* <code>this._flasherScale = 1;</code>
:Scale factor for flasher effects.

== Notes for OXP developers ==

=== scriptInfo properties ===

N-Shields looks for the following ship's scriptInfo properties:
* <code>npc_shields = "no";</code>
: N-Shields ignores the ship and doesn't do anything.

* <code>NShields_flasherKeys = ("myRed1", "myRed2", "myRed3", "myRed3", "myRed4");</code>
: A list of partial effectdata.plist keys, which will be prefixed with "N-Shields_flasher_" to obtain the full key for each flasher or other visualEffect.
: Ordered from lowest shield level to highest in 32-point increments.

* <code>NShields_flasherPreset = 3;</code>
: Number indicating one of the pre-defined flasher lists.
: See above for available options.

* <code>max_shield_aft = 128;</code>
* <code>max_shield_forward = 128;</code>
* <code>shield_recharge_aft = 2.0;</code>
* <code>shield_recharge_forward = 2.0;</code>
: Customise shield levels and recharge rates for this ship.
: The example above shows the standard default shields.
: Note that these can apply to player ships as well as NPCs.
: For Thargoid vessels, use 'upper' and 'lower' instead of 'forward' and 'aft'.

* <code>NShields_energyReduction = 128;</code>
: Specify an energy-bank reduction which will be applied when shields are set up.
: This is intended for two purposes:
::1) For mission ships, to prevent already-difficult opponents becoming impossible
::2) For ships which are 'supposed' to have strong shields, but 'fake it' with bigger energy banks when N-Shields is not installed.

* <code>NShields_exploders = ("NShields-explode-ring-red")</code>
: Custom exploder effect list. The example would make your ship spawn red(ish) ring explosions when its shields are hit.

* <code>NShields_protect_subentities = "no";</code>
: If defined as shown, shields will not protect frangible subentities on this ship.
: The subentities may be left exposed, or given their own shield configurations like any other ship.

The script_info keys "NShields_config" and "NShields_colours" are no longer supported.

=== Compatibility with other shipTakingDamage handler overrides ===

N-Shields provides an array onto which other OXPs can push their NPC ''shipTakingDamage'' handlers instead of actually overriding the handler in the ship script. Functions in this array will imitate the player's world-script ''shipTakingDamage'' handler; that is, they are called for every hit but with the 'amount' parameter only conveying damage which actually penetrated the shields (0 if the hit was entirely absorbed by shields). This approach ensures your handler will be called in the same manner regardless of OXP loading order and avoids any need for your OXP to detect which shield was hit and whether it's still up.

There are two ways to use this feature:

:1) In your script's ''startUp'' handler:

if (worldScripts.NShields && worldScripts.NShields.$shipHasShields(ship)) {
worldScripts.NShields._damageHandlers.push(my_shipTakingDamage_override)
} else {
//apply your handler override directly here
}

::Replace ''my_shipTakingDamage_override'' with your handler name.
::This approach applies your handler to all ships which have simulated shields, but not to those which don't. If you need to choose which ships get the handler yourself, use the other option:

:2) In your script's ''shipSpawned'' handler, once you have decided that a ship should get your ''shipTakingDamage'' override:

if (worldScripts.NShields && worldScripts.NShields.$shipHasShields(ship)) {
if (!ship.script._NShields_damageHandlers)
//set up the array if N-Shields hasn't run its shipSpawned handler yet
ship.script._NShields_damageHandlers = [];
ship.script._NShields_damageHandlers.push(my_shipTakingDamage_override)
} else {
//apply your handler override directly here
}

::Replace ''my_shipTakingDamage_override'' with your handler name.

=== function to configure NPC ship ===

N-Shields makes available to other OXPs a function to configure the NPC's shields after awarding of any defense-related equipment to it:

worldScripts.NShields.$configureShip(ship)

This idempotent (i.e. can be called several times without adverse effects) function will configure the ship's shields taking into account any script_info properties defined and the equipments isntalled in the ship, like Shield Booster, Military Shield Enhancement, Energy Grid, Shield Cycler, etc.

== Downloads ==
latest version available on the Expansion Manager and here: [[Media:N-Shields-1.0.1.oxz|N-Shields v1.0.1]]

[http://wiki.alioth.net/img_auth.php/b/b0/N-Shields_0.7.oxz N-Shields 0.7] {{#downloads:N-Shields_0.7.oxz}} downloads

[http://wiki.alioth.net/img_auth.php/2/2d/N-Shields.oxz N-Shields 0.6.4] downloaded {{#downloads:N-Shields.oxz}} times

== Version History ==

1.0 (by Dybal)
* Drops support for Shield Cycler (and Shield Cycler Next) 1.x for NPCs.
* Creates idempotent function for OXPs to call to configure a NPC's shields.
* Encapsulates modifications of ship's energy to verify for NaN before assigning a value into ship.energy (to prevent "invulnerable ship" bug).
* Adds delay to shipSpawned before setting up the ship to allow other OXPs' shipSpawned to award equipments.
* Configures shield recharge rate with Energy Grid (civilian and naval) upgrades if the NPC has them installed.
* Configures both Military Shield Enhancement and Shield Enhancer for NPCs.
* Doesn't award Shield Cycler to NPCs that have Shield Equalizer.
* Fixes bugs in handling of damage to subentities.
* Standardizes script object properties names: functions references start with '$' (except event handlers), everything else starts with '_';

0.7.1
* Fixed missing "use strict" in N-Shields.js.
* Removed Ship Configuration compatibility script entry from world-scripts.plist (the actual script was removed in 0.7.0).
* Reduced Thargoids' max shields (and compensatory energy reduction) slightly.

0.7
* Removed support for unusual/configurable shield types, except dorsal/ventral which now applies to Thargoids only, in order to simplify the scripts.
* Changed flashers from Ship entities to VisualEffects.
* Pre-defined flasher colour options: 3x Multicolour, Green, Blue.
* Hemisphere glow effects removed.
* New script_info keys NShields_flasherPreset, NShields_flasherKeys, max_shield_forward etc. to replace the now-unsupported NShields_colours, NShields_config.
* Config interface now works correctly (requires Oolite 1.83 or higher and Library OXP).
* Improved efficiency of hit-location code.
* Tentative support for Shield Cyclers on NPCs.

0.6.4
* Fixed bug in $locateHit cloaked-attacker handling (missing a ".position" or two).

0.6.3
* Fixed some bugs in NPC Equipment Damage compatibility code

0.6.2
* Fixed bug in manifest (missing "}").

0.6.1
* Added correctly functioning shipconfig version check and fixed small variable non-declaration in $drawSparks

0.6
* Added user-friendly configuration options via Library OXP.
* Hemisphere glow effects now work, although they still look awful.
* Added compatibility with NPC Equipment Damage OXP.

0.5.4
* Removed non-functioning version check; tested & corrected quaternion multiplication.

0.5.3
* Added version check in NShields-shipconfig-compatibility.js as requested by phkb

0.5.2
* Attempt to fix buggy aft shield effect orientation by using quaternion multiplication. Untested due to oolite-trunk launching error.

0.5.1
* Fixed bug in subentity shielding code which didn't check whether a shipTakingDamage handler had been stored before trying to call it
* Added hemisphere glow effects (disabled by default because very under-debugged & not really working yet)

0.5
* Added explosion-based shield effects.

0.4
* Improved recharge code for fore/aft shields works more like the core player version.
* Correct handling of heat damage (hopefully?).
* $locateHit now attempts to identify a cloaked attacker if the parameter passed is null.
* Added dorsal/ventral shield configuration option and changed Thargoid default to use this.
* Fixed bug in $configureShieldsFromArray which caused Thargoid shield config failure.

0.3
* New features: Player shield effects, NPC shields protect subentities, spark effects for unshielded hits.
* Support for Ship Configuration OXP's shield upgrades/downgrades.
* Fixed bug in recharge code which resulted in excessive energy drain.
* Not released.

0.2
* Extensive re-write implementing some configuration options.
* 'single' and 'fore/aft' shield types supported.
* Damage handler array added for compatibility with other OXPs.
* Not released.

0.1
* Very basic shield simulation. Not released.

== Quick Facts ==

{{OXPLevel|4}}
{{IconOXP|ooVersion="1.81"|oxpCPU="Medium"|oxpMEM="Low"|oxpGPU="Low"|oxpIsAPI=true|oxpIsDocumented=true|oxpIsConfigurable=true}}
{{Infobox OXPb| title N-Shields
|version = 1.0
|release = 2020-11-27
|license = CC-BY-SA 3.0
|features = Provides shields for NPCs.
|category = Mechanics OXPs
|author = [[User:Ngalo|NGalo]]
|feedback = [http://www.aegidian.org/bb/viewtopic.php?f=4&t=18127 Oolite BB]
}}

== Gameplay and Balance indicator ==
[[File:Tag-colour-red.png]]

== Links ==

[http://wiki.alioth.net/index.php/User:Ngalo Commander Ngalo's other OXPs]

{{equipment-OXP}}

File:N-Shields-1.0.1.oxz

2020-12-02T12:17:32Z

Dybal: N-Shields OXP, v1.0.1

N-Shields OXP, v1.0.1

Target Autolock OXP

2020-11-30T16:41:23Z

Dybal: /* Quick Facts */

==Overview==
A little OXP that offers a software upgrade to the standard [[Scanner_Targeting_Enhancement|scanner targeting enhancement]] (which is of course required). This adds the functionality that if the ship is attacked by surprise, or any other situation where there is currently no target set, then the attacking ship is automatically targeted.

The modification is designed for bounty hunters and other hard-edged combat veterans to enable swift location of the hostile craft using the Scanner Targeting Enhancement's directional arrow and/or more simple usage of missiles and other ordnance. Note that this update offers ''target lock'' not ''laser lock''; that kind of aiming still needs to be done manually.

Available from all good tech 13+ systems for the small price of 200 credits.

STOP PRESS!

It has recently been announced that this piece of equipment has been upgraded and improved, with the ship's current target (no matter how acquired) being highlighted on the scanner in grey/blue.

==Requirements==
This OXP requires at least test version 1.79 of Oolite.

==Download==
Available on the Expansion Manager and here: [[Media:TargetAutolockPlus-1.14.oxz|Target Autolock Plus v1.14]].

==Version History==

21/04/2009 - Version 1.00
* Initial release.

19/08/2009 - Version 1.01
* Minor script tweak to deal with attacker getting destroyed before autolock.

14/04/2010 - Version 1.10
* Update for scanner colour marking. Now requires Oolite v1.74 or higher.

15/04/2010 - Version 1.10
* Added scanner colour-marking of current target.

23/06/2010 - Version 1.11
* Scanner colour markers now easier to change in script. Also script check for self-locking included

13/02/2011 - Version 1.12
* Removal of upper limit, to allow running with 1.75

25/11/2020 - Version 1.13
* Updated license to remove the "Thargoid clauses" after Thargoid allowed modification when retired from maintaining his OXps (http://aegidian.org/bb/viewtopic.php?f=4&t=17085).
* Discards the use of a mission variable to indicate the equipment installation in the player ship and keeps the purchased equipment.
* Resets the highlighting of the target in the scanner if Scanner Target Enhancement is damaged.

30/11/2020 - Versiion 1.14
* Fixes typo that prevented resetting scanner when target is lost
* Some optimizations to avoid repeatedly setting up the target scanner display colors.

==Quick Facts==
{{OXPLevel|0}}
{{IconOXP|ooVersion="1.79"|oxpCPU="Low"|oxpMEM="Low"|oxpGPU="Low"}}

{{Infobox OXPb| title = Tracker
|version = 1.14
|release = 2020-11-30
|features = Automatic targetting of attackers.
|license = CC BY-NC-SA 3.0
|category = Equipment
|author = [[User:Thargoid|Thargoid]]
|download = [[#Download|See Download]]
|feedback = [http://aegidian.org/bb/viewtopic.php?f=4&t=6025 BB-Link]
}}

==Gameplay and Balance indicator==
[[Image:tag-colour-blue.png]]

==Links==
*[[User:Thargoid|Thargoid's OXP page]].

{{equipment-OXP}}{{weapon-OXP}}

Target Autolock OXP

2020-11-30T16:41:08Z

Dybal: /* Version History */

==Overview==
A little OXP that offers a software upgrade to the standard [[Scanner_Targeting_Enhancement|scanner targeting enhancement]] (which is of course required). This adds the functionality that if the ship is attacked by surprise, or any other situation where there is currently no target set, then the attacking ship is automatically targeted.

The modification is designed for bounty hunters and other hard-edged combat veterans to enable swift location of the hostile craft using the Scanner Targeting Enhancement's directional arrow and/or more simple usage of missiles and other ordnance. Note that this update offers ''target lock'' not ''laser lock''; that kind of aiming still needs to be done manually.

Available from all good tech 13+ systems for the small price of 200 credits.

STOP PRESS!

It has recently been announced that this piece of equipment has been upgraded and improved, with the ship's current target (no matter how acquired) being highlighted on the scanner in grey/blue.

==Requirements==
This OXP requires at least test version 1.79 of Oolite.

==Download==
Available on the Expansion Manager and here: [[Media:TargetAutolockPlus-1.14.oxz|Target Autolock Plus v1.14]].

==Version History==

21/04/2009 - Version 1.00
* Initial release.

19/08/2009 - Version 1.01
* Minor script tweak to deal with attacker getting destroyed before autolock.

14/04/2010 - Version 1.10
* Update for scanner colour marking. Now requires Oolite v1.74 or higher.

15/04/2010 - Version 1.10
* Added scanner colour-marking of current target.

23/06/2010 - Version 1.11
* Scanner colour markers now easier to change in script. Also script check for self-locking included

13/02/2011 - Version 1.12
* Removal of upper limit, to allow running with 1.75

25/11/2020 - Version 1.13
* Updated license to remove the "Thargoid clauses" after Thargoid allowed modification when retired from maintaining his OXps (http://aegidian.org/bb/viewtopic.php?f=4&t=17085).
* Discards the use of a mission variable to indicate the equipment installation in the player ship and keeps the purchased equipment.
* Resets the highlighting of the target in the scanner if Scanner Target Enhancement is damaged.

30/11/2020 - Versiion 1.14
* Fixes typo that prevented resetting scanner when target is lost
* Some optimizations to avoid repeatedly setting up the target scanner display colors.

==Quick Facts==
{{OXPLevel|0}}
{{IconOXP|ooVersion="1.79"|oxpCPU="Low"|oxpMEM="Low"|oxpGPU="Low"}}

{{Infobox OXPb| title = Tracker
|version = 1.13
|release = 2020-11-27
|features = Automatic targetting of attackers.
|license = CC BY-NC-SA 3.0
|category = Equipment
|author = [[User:Thargoid|Thargoid]]
|download = [[#Download|See Download]]
|feedback = [http://aegidian.org/bb/viewtopic.php?f=4&t=6025 BB-Link]
}}

==Gameplay and Balance indicator==
[[Image:tag-colour-blue.png]]

==Links==
*[[User:Thargoid|Thargoid's OXP page]].

{{equipment-OXP}}{{weapon-OXP}}

Target Autolock OXP

2020-11-30T16:40:39Z

Dybal: /* Download */

==Overview==
A little OXP that offers a software upgrade to the standard [[Scanner_Targeting_Enhancement|scanner targeting enhancement]] (which is of course required). This adds the functionality that if the ship is attacked by surprise, or any other situation where there is currently no target set, then the attacking ship is automatically targeted.

The modification is designed for bounty hunters and other hard-edged combat veterans to enable swift location of the hostile craft using the Scanner Targeting Enhancement's directional arrow and/or more simple usage of missiles and other ordnance. Note that this update offers ''target lock'' not ''laser lock''; that kind of aiming still needs to be done manually.

Available from all good tech 13+ systems for the small price of 200 credits.

STOP PRESS!

It has recently been announced that this piece of equipment has been upgraded and improved, with the ship's current target (no matter how acquired) being highlighted on the scanner in grey/blue.

==Requirements==
This OXP requires at least test version 1.79 of Oolite.

==Download==
Available on the Expansion Manager and here: [[Media:TargetAutolockPlus-1.14.oxz|Target Autolock Plus v1.14]].

==Version History==

21/04/2009 - Version 1.00
* Initial release.

19/08/2009 - Version 1.01
* Minor script tweak to deal with attacker getting destroyed before autolock.

14/04/2010 - Version 1.10
* Update for scanner colour marking. Now requires Oolite v1.74 or higher.

15/04/2010 - Version 1.10
* Added scanner colour-marking of current target.

23/06/2010 - Version 1.11
* Scanner colour markers now easier to change in script. Also script check for self-locking included

13/02/2011 - Version 1.12
* Removal of upper limit, to allow running with 1.75

25/11/2020 - Version 1.13
* Updated license to remove the "Thargoid clauses" after Thargoid allowed modification when retired from maintaining his OXps (http://aegidian.org/bb/viewtopic.php?f=4&t=17085).
* Discards the use of a mission variable to indicate the equipment installation in the player ship and keeps the purchased equipment.
* Resets the highlighting of the target in the scanner if Scanner Target Enhancement is damaged.

==Quick Facts==
{{OXPLevel|0}}
{{IconOXP|ooVersion="1.79"|oxpCPU="Low"|oxpMEM="Low"|oxpGPU="Low"}}

{{Infobox OXPb| title = Tracker
|version = 1.13
|release = 2020-11-27
|features = Automatic targetting of attackers.
|license = CC BY-NC-SA 3.0
|category = Equipment
|author = [[User:Thargoid|Thargoid]]
|download = [[#Download|See Download]]
|feedback = [http://aegidian.org/bb/viewtopic.php?f=4&t=6025 BB-Link]
}}

==Gameplay and Balance indicator==
[[Image:tag-colour-blue.png]]

==Links==
*[[User:Thargoid|Thargoid's OXP page]].

{{equipment-OXP}}{{weapon-OXP}}

File:TargetAutolockPlus-1.14.oxz

2020-11-30T16:39:19Z

Dybal: Target Autolock Plus OXP, v1.14

Target Autolock Plus OXP, v1.14

Flying Dutchman OXP

2020-11-27T18:20:03Z

Dybal: /* Download */

{{Semantic Infobox ShipStats Oolite| title=Flying Dutchman
|image = [[image:Wireframecobra.jpg|300px]]
|dimensions = 130 x 30 x 80
|width = 130m
|height = 30m
|length = 80m
|capacity = Loot
|capacityext = Argh!
|maxspeed = 0.4 LM
|maneuverability = Roll: 2.0 Pitch: 1.0
|energybanks = Infinite
|energyrecharge = Infinite
|gunmounts = Fore, Aft Port, Starboard
|missileslots = 4
|shieldboost = Yes
|milshields = Yes
|hyperspace = Yes
|isoxp = OXP
|isplayer = No
|baseprice = N/A
}}
== Introduction ==

'...and, inevitably, as the chronometers count down the seconds to midnight and the windows of the station's bar grow dark as the planet blocks out the light of the star, the old timers sit nearer together and begin to trade tales of 'The Phantom Cobra'. Some claim that it's the ghost of Commander Peter Jameson, reported lost at the end of the last Thargoid War, others that it is simply a manifestation of all those lost souls who were trapped in the trackless depths of interstellar space. One common story is the trail of bad luck and hideous deaths that follow in the wake of the ship's sightings...'

== Overview ==

This OXP introduces the small possibility to encounter a ghost ship, the tale of which is sung in shady bars (and in the news, if they have nothing else to report). After an introduction, which will eventually be triggered if you just fly around a little, you can meet the ship itself. Find out whether the tales and stories contain a grain of truth...

== Featured Ships ==

Griff's Wireframe Cobra triggered and inspired this OXP. It's the sole ship contained in it.

== Minimum Requirements ==

Flying_Dutchman.oxp v 1.7 requires at least Oolite beta 1.75.

== Installation ==

Move or copy the file Flying_Dutchman.oxp from the download folder to the AddOns folder inside the Oolite main folder. Restart Oolite.

== Download ==

Available on the Expansion Manager and here: [[Media:FlyingDutchman-1.7.oxz|Flying Dutchman v1.7]]

{{ship-OXP}}

File:FlyingDutchman-1.7.oxz

2020-11-27T18:17:13Z

Dybal: Flying Dutchman OXP, v1.7

Flying Dutchman OXP, v1.7

SniperLock

2020-11-27T17:49:22Z

Dybal: /* Equipment Details */

== Introduction ==

CommonSense 'Outside-the-Box' Design Studios Ltd. is happy to announce the latest design in software upgrades for use in all ranges of space vessels. SniperLock software allows for more accurate targetting by enabling longer dwell times on targets. This OXP authored by CommonSenseOTB Dec. 17, 2011.

== Overview ==

SniperLock software acts as an intermediary between you and your ship. When you have a great shot lined up on your currently selected target, in either the forward view or the aft view, the software temporarily takes micro-control over the ships attitude thrusters to keep the ship lined up on target. The override lasts for
a fraction of a second and provided the pilot continues to aim, the software can then re-lock again and again. The pilot may override the lock-on by simply pushing slightly on the pitch or yaw controls. The best way to use this software upgrade is not to think about it. Fly and aim normally and the system will automatically micro-correct any minor misalignment in your aim. Fire a laser burst at the beginning of each lock-on for most effective results. SniperLock software is not perfect and there may be a slight lag as the target is tracked.
Sudden evasive movements and fuel injecting by the target may break the lock-on. Also, due to liability issues, the software will only initiate lock-on with targets over 5km distant to avoid the possibility of collisions. SniperLock software and control interface works with most other targetting systems and heads-up-displays. Any odd behaviour should be reported to the software arm of CommonSense 'Outside-the-Box' Design Studios Ltd., of which SniperLock is a wholly owned
subsidiary.

When you want to keep the bad guys out of arms reach, get SniperLock. Legal in all 8 sectors.

== Customizability ==

For those with drifting joysticks, disabilities, unnaturally poor aim, and for other reasons, you now have the option of adjusting how accurate you have to aim to get a lock, how much force you have to apply to the controls to force an unlock, and how long the lock will last.

== SniperLock Plus ==

An upgrade version, SniperLock Plus, has become available to deal with the issue of off-centre weapons.

Standard SniperLock aligns the centreline of the ship with the centre of the target. If the weapon mount in that facing is offset from the centre line more than the target's "thickness" in the offset direction, that will guarantee a miss. With Standard SniperLock, the only recourse for those ships would be to roll the ship so the target's widest dimension is aligned with the offset direction.

SniperLock Plus takes into account the weapon mount offset and aligns the weapon position with the target's centre.

== Equipment Details ==

===SniperLock===
*Tech Level - 12.
*Cost - 500 credits.
*Required Equipment to operate - Scanner Targetting Enhancement.

===SniperLock Plus===
*Tech Level - 13.
*Cost - 1500 credits, with a rebate of SniperLock price if installed.
*Required Equipment to operate - Scanner Targetting Enhancement.

== OXP Requirements ==

*[[Oolite]] version 1.75.3+ due to CTD frame callback issues in previous oolite versions.
*Sniperlock software requires scanner targetting enhancement to be installed to operate.
*Can be used with most heads-up-display systems.
*Works in either Forward view or Aft view mode.
*Compatible with target tracker.
*No dependancies.

== Download ==

SniperLock is available on the Expansion Manager and here: [[Media:Oolite.oxp.CommonSenseOTB.SniperLock.oxz|SniperLock v1.0]]

SniperLock Plus is available on the Expansion Manager an here: [[Media:SniperLockPlus-1.0.oxz|SniperLock Plus v1.0]]

{{equipment-OXP}}
[[Category:Oolite expansion packs]]

SniperLock

2020-11-27T17:49:03Z

Dybal: /* Download Information */

== Introduction ==

CommonSense 'Outside-the-Box' Design Studios Ltd. is happy to announce the latest design in software upgrades for use in all ranges of space vessels. SniperLock software allows for more accurate targetting by enabling longer dwell times on targets. This OXP authored by CommonSenseOTB Dec. 17, 2011.

== Overview ==

SniperLock software acts as an intermediary between you and your ship. When you have a great shot lined up on your currently selected target, in either the forward view or the aft view, the software temporarily takes micro-control over the ships attitude thrusters to keep the ship lined up on target. The override lasts for
a fraction of a second and provided the pilot continues to aim, the software can then re-lock again and again. The pilot may override the lock-on by simply pushing slightly on the pitch or yaw controls. The best way to use this software upgrade is not to think about it. Fly and aim normally and the system will automatically micro-correct any minor misalignment in your aim. Fire a laser burst at the beginning of each lock-on for most effective results. SniperLock software is not perfect and there may be a slight lag as the target is tracked.
Sudden evasive movements and fuel injecting by the target may break the lock-on. Also, due to liability issues, the software will only initiate lock-on with targets over 5km distant to avoid the possibility of collisions. SniperLock software and control interface works with most other targetting systems and heads-up-displays. Any odd behaviour should be reported to the software arm of CommonSense 'Outside-the-Box' Design Studios Ltd., of which SniperLock is a wholly owned
subsidiary.

When you want to keep the bad guys out of arms reach, get SniperLock. Legal in all 8 sectors.

== Customizability ==

For those with drifting joysticks, disabilities, unnaturally poor aim, and for other reasons, you now have the option of adjusting how accurate you have to aim to get a lock, how much force you have to apply to the controls to force an unlock, and how long the lock will last.

== SniperLock Plus ==

An upgrade version, SniperLock Plus, has become available to deal with the issue of off-centre weapons.

Standard SniperLock aligns the centreline of the ship with the centre of the target. If the weapon mount in that facing is offset from the centre line more than the target's "thickness" in the offset direction, that will guarantee a miss. With Standard SniperLock, the only recourse for those ships would be to roll the ship so the target's widest dimension is aligned with the offset direction.

SniperLock Plus takes into account the weapon mount offset and aligns the weapon position with the target's centre.

== Equipment Details ==

SniperLock
*Tech Level - 12.
*Cost - 500 credits.
*Required Equipment to operate - Scanner Targetting Enhancement.

SniperLock Plus
*Tech Level - 13.
*Cost - 1500 credits, with a rebate of SniperLock price if installed.
*Required Equipment to operate - Scanner Targetting Enhancement.

== OXP Requirements ==

*[[Oolite]] version 1.75.3+ due to CTD frame callback issues in previous oolite versions.
*Sniperlock software requires scanner targetting enhancement to be installed to operate.
*Can be used with most heads-up-display systems.
*Works in either Forward view or Aft view mode.
*Compatible with target tracker.
*No dependancies.

== Download ==

SniperLock is available on the Expansion Manager and here: [[Media:Oolite.oxp.CommonSenseOTB.SniperLock.oxz|SniperLock v1.0]]

SniperLock Plus is available on the Expansion Manager an here: [[Media:SniperLockPlus-1.0.oxz|SniperLock Plus v1.0]]

{{equipment-OXP}}
[[Category:Oolite expansion packs]]

SniperLock

2020-11-27T17:48:38Z

Dybal: /* Download Information */

== Introduction ==

CommonSense 'Outside-the-Box' Design Studios Ltd. is happy to announce the latest design in software upgrades for use in all ranges of space vessels. SniperLock software allows for more accurate targetting by enabling longer dwell times on targets. This OXP authored by CommonSenseOTB Dec. 17, 2011.

== Overview ==

SniperLock software acts as an intermediary between you and your ship. When you have a great shot lined up on your currently selected target, in either the forward view or the aft view, the software temporarily takes micro-control over the ships attitude thrusters to keep the ship lined up on target. The override lasts for
a fraction of a second and provided the pilot continues to aim, the software can then re-lock again and again. The pilot may override the lock-on by simply pushing slightly on the pitch or yaw controls. The best way to use this software upgrade is not to think about it. Fly and aim normally and the system will automatically micro-correct any minor misalignment in your aim. Fire a laser burst at the beginning of each lock-on for most effective results. SniperLock software is not perfect and there may be a slight lag as the target is tracked.
Sudden evasive movements and fuel injecting by the target may break the lock-on. Also, due to liability issues, the software will only initiate lock-on with targets over 5km distant to avoid the possibility of collisions. SniperLock software and control interface works with most other targetting systems and heads-up-displays. Any odd behaviour should be reported to the software arm of CommonSense 'Outside-the-Box' Design Studios Ltd., of which SniperLock is a wholly owned
subsidiary.

When you want to keep the bad guys out of arms reach, get SniperLock. Legal in all 8 sectors.

== Customizability ==

For those with drifting joysticks, disabilities, unnaturally poor aim, and for other reasons, you now have the option of adjusting how accurate you have to aim to get a lock, how much force you have to apply to the controls to force an unlock, and how long the lock will last.

== SniperLock Plus ==

An upgrade version, SniperLock Plus, has become available to deal with the issue of off-centre weapons.

Standard SniperLock aligns the centreline of the ship with the centre of the target. If the weapon mount in that facing is offset from the centre line more than the target's "thickness" in the offset direction, that will guarantee a miss. With Standard SniperLock, the only recourse for those ships would be to roll the ship so the target's widest dimension is aligned with the offset direction.

SniperLock Plus takes into account the weapon mount offset and aligns the weapon position with the target's centre.

== Equipment Details ==

SniperLock
*Tech Level - 12.
*Cost - 500 credits.
*Required Equipment to operate - Scanner Targetting Enhancement.

SniperLock Plus
*Tech Level - 13.
*Cost - 1500 credits, with a rebate of SniperLock price if installed.
*Required Equipment to operate - Scanner Targetting Enhancement.

== OXP Requirements ==

*[[Oolite]] version 1.75.3+ due to CTD frame callback issues in previous oolite versions.
*Sniperlock software requires scanner targetting enhancement to be installed to operate.
*Can be used with most heads-up-display systems.
*Works in either Forward view or Aft view mode.
*Compatible with target tracker.
*No dependancies.

== Download Information ==

SniperLock is available on the Expansion Manager and here: [[Media:Oolite.oxp.CommonSenseOTB.SniperLock.oxz|SniperLock v1.0]]

SniperLock Plus is available on the Expansion Manager an here: [[Media:SniperLockPlus-1.0.oxz|SniperLock Plus v1.0]]

{{equipment-OXP}}
[[Category:Oolite expansion packs]]

SniperLock

2020-11-27T17:41:03Z

Dybal: /* Equipment Details */

== Introduction ==

CommonSense 'Outside-the-Box' Design Studios Ltd. is happy to announce the latest design in software upgrades for use in all ranges of space vessels. SniperLock software allows for more accurate targetting by enabling longer dwell times on targets. This OXP authored by CommonSenseOTB Dec. 17, 2011.

== Overview ==

SniperLock software acts as an intermediary between you and your ship. When you have a great shot lined up on your currently selected target, in either the forward view or the aft view, the software temporarily takes micro-control over the ships attitude thrusters to keep the ship lined up on target. The override lasts for
a fraction of a second and provided the pilot continues to aim, the software can then re-lock again and again. The pilot may override the lock-on by simply pushing slightly on the pitch or yaw controls. The best way to use this software upgrade is not to think about it. Fly and aim normally and the system will automatically micro-correct any minor misalignment in your aim. Fire a laser burst at the beginning of each lock-on for most effective results. SniperLock software is not perfect and there may be a slight lag as the target is tracked.
Sudden evasive movements and fuel injecting by the target may break the lock-on. Also, due to liability issues, the software will only initiate lock-on with targets over 5km distant to avoid the possibility of collisions. SniperLock software and control interface works with most other targetting systems and heads-up-displays. Any odd behaviour should be reported to the software arm of CommonSense 'Outside-the-Box' Design Studios Ltd., of which SniperLock is a wholly owned
subsidiary.

When you want to keep the bad guys out of arms reach, get SniperLock. Legal in all 8 sectors.

== Customizability ==

For those with drifting joysticks, disabilities, unnaturally poor aim, and for other reasons, you now have the option of adjusting how accurate you have to aim to get a lock, how much force you have to apply to the controls to force an unlock, and how long the lock will last.

== SniperLock Plus ==

An upgrade version, SniperLock Plus, has become available to deal with the issue of off-centre weapons.

Standard SniperLock aligns the centreline of the ship with the centre of the target. If the weapon mount in that facing is offset from the centre line more than the target's "thickness" in the offset direction, that will guarantee a miss. With Standard SniperLock, the only recourse for those ships would be to roll the ship so the target's widest dimension is aligned with the offset direction.

SniperLock Plus takes into account the weapon mount offset and aligns the weapon position with the target's centre.

== Equipment Details ==

SniperLock
*Tech Level - 12.
*Cost - 500 credits.
*Required Equipment to operate - Scanner Targetting Enhancement.

SniperLock Plus
*Tech Level - 13.
*Cost - 1500 credits, with a rebate of SniperLock price if installed.
*Required Equipment to operate - Scanner Targetting Enhancement.

== OXP Requirements ==

*[[Oolite]] version 1.75.3+ due to CTD frame callback issues in previous oolite versions.
*Sniperlock software requires scanner targetting enhancement to be installed to operate.
*Can be used with most heads-up-display systems.
*Works in either Forward view or Aft view mode.
*Compatible with target tracker.
*No dependancies.

== Download Information ==

[http://www.box.com/s/84vese73crjyt4vkmk6j SniperLockv1] by CommonSenseOTB. [http://aegidian.org/bb/viewtopic.php?f=4&t=11357 Try here] to post comments or for more information.

{{equipment-OXP}}
[[Category:Oolite expansion packs]]

SniperLock

2020-11-27T17:39:41Z

Dybal: /* SniperLock Plus */

== Introduction ==

CommonSense 'Outside-the-Box' Design Studios Ltd. is happy to announce the latest design in software upgrades for use in all ranges of space vessels. SniperLock software allows for more accurate targetting by enabling longer dwell times on targets. This OXP authored by CommonSenseOTB Dec. 17, 2011.

== Overview ==

SniperLock software acts as an intermediary between you and your ship. When you have a great shot lined up on your currently selected target, in either the forward view or the aft view, the software temporarily takes micro-control over the ships attitude thrusters to keep the ship lined up on target. The override lasts for
a fraction of a second and provided the pilot continues to aim, the software can then re-lock again and again. The pilot may override the lock-on by simply pushing slightly on the pitch or yaw controls. The best way to use this software upgrade is not to think about it. Fly and aim normally and the system will automatically micro-correct any minor misalignment in your aim. Fire a laser burst at the beginning of each lock-on for most effective results. SniperLock software is not perfect and there may be a slight lag as the target is tracked.
Sudden evasive movements and fuel injecting by the target may break the lock-on. Also, due to liability issues, the software will only initiate lock-on with targets over 5km distant to avoid the possibility of collisions. SniperLock software and control interface works with most other targetting systems and heads-up-displays. Any odd behaviour should be reported to the software arm of CommonSense 'Outside-the-Box' Design Studios Ltd., of which SniperLock is a wholly owned
subsidiary.

When you want to keep the bad guys out of arms reach, get SniperLock. Legal in all 8 sectors.

== Customizability ==

For those with drifting joysticks, disabilities, unnaturally poor aim, and for other reasons, you now have the option of adjusting how accurate you have to aim to get a lock, how much force you have to apply to the controls to force an unlock, and how long the lock will last.

== SniperLock Plus ==

An upgrade version, SniperLock Plus, has become available to deal with the issue of off-centre weapons.

Standard SniperLock aligns the centreline of the ship with the centre of the target. If the weapon mount in that facing is offset from the centre line more than the target's "thickness" in the offset direction, that will guarantee a miss. With Standard SniperLock, the only recourse for those ships would be to roll the ship so the target's widest dimension is aligned with the offset direction.

SniperLock Plus takes into account the weapon mount offset and aligns the weapon position with the target's centre.

== Equipment Details ==

SniperLock
*Tech Level - 12.
*Cost - 500 credits.
*Required Equipment to operate - Scanner Targetting Enhancement.

== OXP Requirements ==

*[[Oolite]] version 1.75.3+ due to CTD frame callback issues in previous oolite versions.
*Sniperlock software requires scanner targetting enhancement to be installed to operate.
*Can be used with most heads-up-display systems.
*Works in either Forward view or Aft view mode.
*Compatible with target tracker.
*No dependancies.

== Download Information ==

[http://www.box.com/s/84vese73crjyt4vkmk6j SniperLockv1] by CommonSenseOTB. [http://aegidian.org/bb/viewtopic.php?f=4&t=11357 Try here] to post comments or for more information.

{{equipment-OXP}}
[[Category:Oolite expansion packs]]

SniperLock

2020-11-27T17:32:16Z

Dybal: /* Customizability */

== Introduction ==

CommonSense 'Outside-the-Box' Design Studios Ltd. is happy to announce the latest design in software upgrades for use in all ranges of space vessels. SniperLock software allows for more accurate targetting by enabling longer dwell times on targets. This OXP authored by CommonSenseOTB Dec. 17, 2011.

== Overview ==

SniperLock software acts as an intermediary between you and your ship. When you have a great shot lined up on your currently selected target, in either the forward view or the aft view, the software temporarily takes micro-control over the ships attitude thrusters to keep the ship lined up on target. The override lasts for
a fraction of a second and provided the pilot continues to aim, the software can then re-lock again and again. The pilot may override the lock-on by simply pushing slightly on the pitch or yaw controls. The best way to use this software upgrade is not to think about it. Fly and aim normally and the system will automatically micro-correct any minor misalignment in your aim. Fire a laser burst at the beginning of each lock-on for most effective results. SniperLock software is not perfect and there may be a slight lag as the target is tracked.
Sudden evasive movements and fuel injecting by the target may break the lock-on. Also, due to liability issues, the software will only initiate lock-on with targets over 5km distant to avoid the possibility of collisions. SniperLock software and control interface works with most other targetting systems and heads-up-displays. Any odd behaviour should be reported to the software arm of CommonSense 'Outside-the-Box' Design Studios Ltd., of which SniperLock is a wholly owned
subsidiary.

When you want to keep the bad guys out of arms reach, get SniperLock. Legal in all 8 sectors.

== Customizability ==

For those with drifting joysticks, disabilities, unnaturally poor aim, and for other reasons, you now have the option of adjusting how accurate you have to aim to get a lock, how much force you have to apply to the controls to force an unlock, and how long the lock will last.

== SniperLock Plus ==

== Equipment Details ==

SniperLock
*Tech Level - 12.
*Cost - 500 credits.
*Required Equipment to operate - Scanner Targetting Enhancement.

== OXP Requirements ==

*[[Oolite]] version 1.75.3+ due to CTD frame callback issues in previous oolite versions.
*Sniperlock software requires scanner targetting enhancement to be installed to operate.
*Can be used with most heads-up-display systems.
*Works in either Forward view or Aft view mode.
*Compatible with target tracker.
*No dependancies.

== Download Information ==

[http://www.box.com/s/84vese73crjyt4vkmk6j SniperLockv1] by CommonSenseOTB. [http://aegidian.org/bb/viewtopic.php?f=4&t=11357 Try here] to post comments or for more information.

{{equipment-OXP}}
[[Category:Oolite expansion packs]]

File:SniperLockPlus-1.0.oxz

2020-11-27T17:26:08Z

Dybal: Dybal uploaded a new version of File:SniperLockPlus-1.0.oxz

SniperLock Plus OXP, v1.0