Difference between revisions of "Repair Bots OXP"

From Elite Wiki
(Updating BB links)
 
(29 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
[[File:Srs.png|thumb|right|250px|[[Vimana HUD]] icon for SRS Repair NanoBots]]
 +
[[File:Missile, ECM hardened missile, Quirium Cascade Mine, Repair Bots, Salvage Missile.png|thumb|right|250px|missile bay icons: Missile, ECM-hardened missile, Quirium cascade bomb, '''Repair nanobots''', Salvage missile]]
 
==Overview==
 
==Overview==
As any commander on the go knows, there is nothing more frustrating than having valuable and necessary equipment getting broken in-flight, usually just before you really need it. So the researchers at the Aquarian Shipbuilding Corporation's ships equipment division have taken the repair nanobots used on a large scale for station repairs, and adapted them for standard ship usage.
+
As any commander on the go knows, there is nothing more frustrating than having valuable and necessary equipment getting broken in-flight, usually just before you really need it. So the researchers at the [[Aquarian Shipbuilding Corp. HQ|Aquarian Shipbuilding Corporation]]'s ships equipment division have taken the repair nanobots used on a large scale for station repairs, and adapted them for standard ship usage.
  
 
It also now provides a second piece of equipment - the fully mountable repair system. This is true ship's damage control, available to any ship that doesn't already have it built-in. It uses advanced repair bots to control and repair any broken equipment that happens on the ship in-flight.
 
It also now provides a second piece of equipment - the fully mountable repair system. This is true ship's damage control, available to any ship that doesn't already have it built-in. It uses advanced repair bots to control and repair any broken equipment that happens on the ship in-flight.
Line 38: Line 40:
 
==Download==
 
==Download==
  
[[Media:RepairBots-2.11.oxz|RepairBots_2.11.oxz]] (downloaded {{#downloads:RepairBots-2.11.oxz}} times).
+
[[Media:RepairBots_2.15.oxz|RepairBots_2.15.oxz]] (downloaded {{#downloads:RepairBots_2.15.oxz}} times).
  
 
Old versions:
 
Old versions:
 +
 +
[[Media:RepairBots-2.14.oxz|RepairBots_2.14.oxz]] (downloaded {{#downloads:RepairBots-2.14.oxz}} times).
 +
 +
[[Media:RepairBots-2.13.oxz|RepairBots_2.13.oxz]] (downloaded {{#downloads:RepairBots-2.13.oxz}} times).
 +
 +
[[Media:RepairBots-2.12.oxz|RepairBots_2.12.oxz]] (downloaded {{#downloads:RepairBots-2.12.oxz}} times).
 +
 +
[[Media:RepairBots-2.11.oxz|RepairBots_2.11.oxz]] (downloaded {{#downloads:RepairBots-2.11.oxz}} times).
  
 
[[Media:RepairBots_2.10.oxz|RepairBots_2.10.oxz]] (downloaded {{#downloads:RepairBots_2.10.oxz}} times).
 
[[Media:RepairBots_2.10.oxz|RepairBots_2.10.oxz]] (downloaded {{#downloads:RepairBots_2.10.oxz}} times).
  
==Supported OXP Equipment==
+
==Tweaks==
 +
*[https://bb.oolite.space/viewtopic.php?p=253573#p253573 Souping-up the Repair-bots] (2017)
 +
*You might find [[How to tweak OXZ's]] helpful!
  
 +
==Notes for OXP developers==
 
The new and improved repair bots have a chance to repair anything installed on the ship. Any OXP writer who wishes to alter this for their own OXP simply needs to add the line:
 
The new and improved repair bots have a chance to repair anything installed on the ship. Any OXP writer who wishes to alter this for their own OXP simply needs to add the line:
  
Line 51: Line 64:
  
 
into their equipmentInfo.plist file entry for the equipment in question - replacing X with the numerical value between 0 (never repaired) and 1 (always repaired). If no such entry is made the repair chance will be based on the equipment's tech level.
 
into their equipmentInfo.plist file entry for the equipment in question - replacing X with the numerical value between 0 (never repaired) and 1 (always repaired). If no such entry is made the repair chance will be based on the equipment's tech level.
 +
 +
Other OXPs can also temporarily inhibit Repair Bots from repairing an equipment through the use of the disabling/enabling equipment functions described bellow.
 +
 +
 +
;<code>worldScripts["Repair System"].$disableEquipment(eqKey, who, why)</code>
 +
:<code>eqkey</code>: string, equipment key
 +
:<code>who</code>: string, identifies the caller
 +
:<code>why</code>: string, describes the reason why the equipment is disabled
 +
 +
:Sets the equipment as DAMAGED and inserts it in the disabled equipment list (equipment in th disabled list is not repaired)
 +
 +
 +
;<code>worldScripts["Repair System"].$enableEquipment(eqKey, who)</code>
 +
:<code>eqkey</code>: string, equipment key
 +
:<code>who</code>: string, identifies the caller
 +
   
 +
:Removes the caller from the disablers of the equipment and if there is no disabler left, sets the equipmenty status to OK
 +
  
 
==Version History==
 
==Version History==
25/09/2008 - Version 0.99
+
05/12/2023 - Version 2.15
  - pre-release version with some OXP equipment support (more to follow). Inclusion of chance of failure for more complex equipment (above equipment tech level 8) and lowering of price to 3000 credits
+
* Fixed extraneous value in equipment.plist in the definition for EQ_REPAIRBOTS_REMOVER.
05/09/2008 - Version 0.10
+
* Added escape character to % in equipment.plist.
  - beta test release.
+
* Spelling corrections.
.
+
 
10/11/2008 - Version 1.00, script update for v1.72 compatability.
+
17/08/2022 - Version 2.14
02/09/2009 - Version 1.10, ditto for v1.73.
+
*Changes the to remove the "Thargoid clauses" after Thargoid allowed modification when retired from maintaining his OXPs (https://bb.oolite.space/viewtopic.php?f=4&t=17085).
17/05/2010 - Version 2.00, update for v1.74 (only) - now uses script to scan players equipment, so can fix anything not explicitly in the exclusion list. Also new addition of the repair system
+
*Fixes typo that prevented resuming operation after a low energy period (thanks to cag and UK_Eliter!).
13/02/2011 - Version 2.01, removal of upper limit, to allow running with 1.75
+
 
02/04/2011 - Version 2.02, superb new pylon icon for the repair bot cannister, by Eldon.
+
04/10/2020 - Version 2.13
02/11/2011 - Version 2.03, script speed hack courtesy of Capt. Murphy.
+
*Energy thresholds are now proportional to the ship's maxEnergy and not absolute: repair stops when energry drops to 20% and resumes when it reaches 40%.
03/11/2011 - Version 2.04, further optimisation by Eric Walch.
+
*Self-repair, i.e., repairing the Repair System Controller, consumes 2 charges.
19/03/2012 - Version 2.05, corrected error in script - thanks to Cmdr Cheyd.
+
*ew functions for other OXPs tell Repair Systems that an equipment is disabled, i.e., it's damaged but should not be repaired. This allows OXPs to inhibit Repair Systems actions on a given equipment during a period of time, while the probabilities in the scriptInfo are "hard-coded", i.e., can't be changed by scripts.
09/05/2012 - Version 2.06, made repair system require 2t of cargo space ready for v1.77 implementation. Also will only work for 10 repairs before needing a recharge.
+
 
03/06/2012 - Version 2.07, removing minor glitch so remaining charges only show on F5 manifest screen when the Repair System is actually installed - thanks to JazHaz for the heads-up.
+
14/09/2020 - Version 2.12
23/07/2012 - Version 2.08, small bugfix to cope better with selling of ships and persistence of mission variables.
+
*checks for repair controller existence before starting the repair system.
07/08/2012 - Version 2.09, temporary removal of requirement for 2t cargo due to bug in 1.76.1 (rollback of v2.06 in part)
+
 
xx/xx/2012 - Version 2.10, requirement now for 1.77. Restored the 2t space requirement. Also added an 0.5s delay to activation on damage, to allow other scripts to run first (OXP equipment self-repair and also realistic damage OXP).
+
24/08/2020 - Version 2.11
24/08/2020 - Version 2.11, introduced Repair System Light, with 5 charges taking 1 TC of cargo space, and Recharge 5-Pack; introduced energy cost while repairing, with minimum of one energy bank to work. (Dybal)
+
*introduced '''Repair System Light''', with 5 charges taking 1 TC of cargo space, and Recharge 5-Pack.
 +
*introduced energy cost while repairing, with minimum of one energy bank to work. (Dybal)
 +
 
 +
xx/xx/2012 - Version 2.10
 +
*requirement now for 1.77. Restored the 2t space requirement.
 +
*also added an 0.5s delay to activation on damage, to allow other scripts to run first (OXP equipment self-repair and also realistic damage OXP).
 +
 
 +
07/08/2012 - Version 2.09
 +
*temporary removal of requirement for 2t cargo due to bug in 1.76.1 (rollback of v2.06 in part).
 +
 
 +
23/07/2012 - Version 2.08
 +
*small bugfix to cope better with selling of ships and persistence of mission variables.
 +
 
 +
03/06/2012 - Version 2.07
 +
*removing minor glitch so remaining charges only show on F5 manifest screen when the Repair System is actually installed - thanks to JazHaz for the heads-up.
 +
 
 +
09/05/2012 - Version 2.06
 +
*made repair system require 2t of cargo space ready for v1.77 implementation.
 +
*also will only work for 10 repairs before needing a recharge.
 +
 
 +
19/03/2012 - Version 2.05
 +
*corrected error in script - thanks to Cmdr Cheyd.
 +
 
 +
03/11/2011 - Version 2.04
 +
*further optimisation by Eric Walch.
 +
 
 +
02/11/2011 - Version 2.03
 +
*script speed hack courtesy of Capt. Murphy.
 +
 
 +
02/04/2011 - Version 2.02
 +
*superb new pylon icon for the repair bot cannister, by Eldon.
 +
 
 +
13/02/2011 - Version 2.01
 +
*removal of upper limit, to allow running with 1.75.
 +
 
 +
17/05/2010 - Version 2.00
 +
*update for v1.74 (only) - now uses script to scan players equipment, so can fix anything not explicitly in the exclusion list.
 +
*also new addition of the repair system.
 +
 
 +
02/09/2009 - Version 1.10
 +
*ditto for v1.73.
 +
 
 +
10/11/2008 - Version 1.00
 +
*script update for v1.72 compatability.
 +
 
 +
25/09/2008 - Version 0.99
 +
*pre-release version with some OXP equipment support (more to follow).  Inclusion of chance of failure for more complex equipment (above equipment tech level 8) and lowering of price to 3000 credits.
 +
 
 +
05/09/2008 - Version 0.10
 +
*beta test release.
 +
 
 +
==Quick Facts==
 +
{{OXPLevel|0}}{{IconOXP|ooVersion="1.79"|oxpCPU="Average"|oxpMEM="Average"|oxpGPU="Low"|oxpIsAPI=true|oxpIsDocumented=true}}
 +
{{Infobox OXPb| title = Repair Bots
 +
|version = 2.15
 +
|release = 2023-12-05
 +
|features = self-repair
 +
|license = CC BY-NC-SA 3
 +
|category = Equipment OXPs
 +
|author = [[User:Thargoid|Thargoid]]
 +
|download = [[Media:RepairBots-2.11.oxz|Download]]
 +
|feedback = [https://bb.oolite.space/viewtopic.php?f=4&t=20722& BB-Link]
 +
}}
 +
 
 +
== Gameplay and Balance indicator ==
 +
[[File:Tag-colour-violet.png]]
  
 
==Links==
 
==Links==
 
* [[User:Thargoid|Thargoid's OXP page]].
 
* [[User:Thargoid|Thargoid's OXP page]].
 +
* [https://bb.oolite.space/viewtopic.php?f=4&t=20722 BB Thread] (2020)
 +
* [https://bb.oolite.space/viewtopic.php?f=4&t=18033 BB Thread] (2016)
 +
* [https://bb.oolite.space/viewtopic.php?f=4&t=5034 BB Thread] (2008)
 +
 +
*[https://bb.oolite.space/viewtopic.php?p=242642#p242642  Disembodied's 2015 post] about making damage temporarily fixable
 +
*[https://www.youtube.com/watch?v=atVVe-QYCv4 A more sophisticated approach] (2022 - YouTube ad: An overview of ship maintenance operations in ASG (parts wear, repairs, replacement, and related best policies).
 +
 +
=== Other relevant oxp's ===
 +
*[https://bb.oolite.space/viewtopic.php?f=2&t=8812 Capsule Self-Repair] (2010) - repairs damaged Escape Capsules (don't forget to change "www.box.net" to "app.box.net")
 +
*[https://bb.oolite.space/viewtopic.php?f=4&t=13592 External Repair System for subentities]. GGShinobi (2013) Alpha release. (for [[Imperial Courier (Oolite)|rotating nacelles]], [[Z GrOovy HPC pack|landing gear]], ''etc''!)
 +
*[[CustomShields]] - see damage to one's own and enemy ships
 +
*[[HardShips]] - extra armouring which protects the ship and equipment
 +
 +
 
{{equipment-OXP}}
 
{{equipment-OXP}}
 +
 +
[[Category:Oolite_expansion_packs]]

Latest revision as of 07:45, 18 March 2024

Vimana HUD icon for SRS Repair NanoBots
missile bay icons: Missile, ECM-hardened missile, Quirium cascade bomb, Repair nanobots, Salvage missile

Overview

As any commander on the go knows, there is nothing more frustrating than having valuable and necessary equipment getting broken in-flight, usually just before you really need it. So the researchers at the Aquarian Shipbuilding Corporation's ships equipment division have taken the repair nanobots used on a large scale for station repairs, and adapted them for standard ship usage.

It also now provides a second piece of equipment - the fully mountable repair system. This is true ship's damage control, available to any ship that doesn't already have it built-in. It uses advanced repair bots to control and repair any broken equipment that happens on the ship in-flight.

Usage

As standard, the repair 'bots are packaged in a small container which is specially designed to keep them dormant until their services are required. Due to Galcop rules this container is not allowed to be stored within the vessel itself, so the standard solution is to mount it on an empty missile pylon, with the added bonus that the standard missile arming and launching sequence can be used to activate and release the 'bots.

When activated the 'bots perform a scan of the vessels systems, and by comparing what they find with their in-build blueprints they can identify which (if any) system or systems are damaged. From this they will select which item they want to repair (this is limited to a single item as a further Galcop mandated safety measure to prevent runaway replication) and proceed to attempt work on it.

Please note that whilst these useful little creatures won't stop to take coffee breaks or chat-up the pilot's girlfriend, they are only as reliable as their in-built blueprints. So for more complicated systems and for some variant items sold by various companies, there is a chance that they will not be able to fully repair all items before their mandatory limited lifespan expires. In this case the usage of an additional cannister or two of 'bots may assist with the problem.

Now featuring a lovely new pylon icon for the bots, courtesy of Eldon.

STOP-PRESS! - following some heavy lobbying by the transport haulers oonion, Galcop have relaxed their rules about storage of the nanobots. So the ASC are now very proud to announce the introduction of their patent Repair System. Built into the workings and systems of the customer ship, it automatically attempts to repair any broken equipment using its own supply of bots. No missile pylons have to be sacrificed to the gods of fixing stuff, but consumes one energy unit per second while effecting repairs, going dormant if there is only one energy bank available and re-starting when the ship has to two full energy banks again.

There are two versions available: the standard one occupies 2t of cargo space and holds nanobots to effect up to ten repairs, and a light version that occupies 1t of cargo sapce and holds nanobots for 5 repairs. The recharge packs of nanobots come in two sizes, a 10-pack for up to ten repairs and a 5-pack for up to 5 repairs.

Repair System Standard:
  Cost: 12000 Cr.
  Techlevel: 11
Repair System Light: Cost: 10000 Cr. Techlevel: 12
Repair System Recharge, 10-Pack: Cost: 1000 Cr. TechLevel: 9
Repair System Recharge, 5-Pack: Cost: 600 Cr. Techlevel: 9
Repair Nanobots (pylon mounted): Cost: 3000 Cr. Techlevel: 9

Requirements

This OXP requires at least test version 1.74 of Oolite.

Download

RepairBots_2.15.oxz (downloaded 0 times).

Old versions:

RepairBots_2.14.oxz (downloaded 0 times).

RepairBots_2.13.oxz (downloaded 0 times).

RepairBots_2.12.oxz (downloaded 0 times).

RepairBots_2.11.oxz (downloaded 0 times).

RepairBots_2.10.oxz (downloaded 6245 times).

Tweaks

Notes for OXP developers

The new and improved repair bots have a chance to repair anything installed on the ship. Any OXP writer who wishes to alter this for their own OXP simply needs to add the line:

script_info = { thargoidRepairBotChance = X; };

into their equipmentInfo.plist file entry for the equipment in question - replacing X with the numerical value between 0 (never repaired) and 1 (always repaired). If no such entry is made the repair chance will be based on the equipment's tech level.

Other OXPs can also temporarily inhibit Repair Bots from repairing an equipment through the use of the disabling/enabling equipment functions described bellow.


worldScripts["Repair System"].$disableEquipment(eqKey, who, why)
eqkey: string, equipment key
who: string, identifies the caller
why: string, describes the reason why the equipment is disabled
Sets the equipment as DAMAGED and inserts it in the disabled equipment list (equipment in th disabled list is not repaired)


worldScripts["Repair System"].$enableEquipment(eqKey, who)
eqkey: string, equipment key
who: string, identifies the caller
Removes the caller from the disablers of the equipment and if there is no disabler left, sets the equipmenty status to OK


Version History

05/12/2023 - Version 2.15

  • Fixed extraneous value in equipment.plist in the definition for EQ_REPAIRBOTS_REMOVER.
  • Added escape character to % in equipment.plist.
  • Spelling corrections.

17/08/2022 - Version 2.14

  • Changes the to remove the "Thargoid clauses" after Thargoid allowed modification when retired from maintaining his OXPs (https://bb.oolite.space/viewtopic.php?f=4&t=17085).
  • Fixes typo that prevented resuming operation after a low energy period (thanks to cag and UK_Eliter!).

04/10/2020 - Version 2.13

  • Energy thresholds are now proportional to the ship's maxEnergy and not absolute: repair stops when energry drops to 20% and resumes when it reaches 40%.
  • Self-repair, i.e., repairing the Repair System Controller, consumes 2 charges.
  • ew functions for other OXPs tell Repair Systems that an equipment is disabled, i.e., it's damaged but should not be repaired. This allows OXPs to inhibit Repair Systems actions on a given equipment during a period of time, while the probabilities in the scriptInfo are "hard-coded", i.e., can't be changed by scripts.

14/09/2020 - Version 2.12

  • checks for repair controller existence before starting the repair system.

24/08/2020 - Version 2.11

  • introduced Repair System Light, with 5 charges taking 1 TC of cargo space, and Recharge 5-Pack.
  • introduced energy cost while repairing, with minimum of one energy bank to work. (Dybal)

xx/xx/2012 - Version 2.10

  • requirement now for 1.77. Restored the 2t space requirement.
  • also added an 0.5s delay to activation on damage, to allow other scripts to run first (OXP equipment self-repair and also realistic damage OXP).

07/08/2012 - Version 2.09

  • temporary removal of requirement for 2t cargo due to bug in 1.76.1 (rollback of v2.06 in part).

23/07/2012 - Version 2.08

  • small bugfix to cope better with selling of ships and persistence of mission variables.

03/06/2012 - Version 2.07

  • removing minor glitch so remaining charges only show on F5 manifest screen when the Repair System is actually installed - thanks to JazHaz for the heads-up.

09/05/2012 - Version 2.06

  • made repair system require 2t of cargo space ready for v1.77 implementation.
  • also will only work for 10 repairs before needing a recharge.

19/03/2012 - Version 2.05

  • corrected error in script - thanks to Cmdr Cheyd.

03/11/2011 - Version 2.04

  • further optimisation by Eric Walch.

02/11/2011 - Version 2.03

  • script speed hack courtesy of Capt. Murphy.

02/04/2011 - Version 2.02

  • superb new pylon icon for the repair bot cannister, by Eldon.

13/02/2011 - Version 2.01

  • removal of upper limit, to allow running with 1.75.

17/05/2010 - Version 2.00

  • update for v1.74 (only) - now uses script to scan players equipment, so can fix anything not explicitly in the exclusion list.
  • also new addition of the repair system.

02/09/2009 - Version 1.10

  • ditto for v1.73.

10/11/2008 - Version 1.00

  • script update for v1.72 compatability.

25/09/2008 - Version 0.99

  • pre-release version with some OXP equipment support (more to follow). Inclusion of chance of failure for more complex equipment (above equipment tech level 8) and lowering of price to 3000 credits.

05/09/2008 - Version 0.10

  • beta test release.

Quick Facts

Levelindicator0.png
0-{{{2}}}

Minimum Oolite versionCPU usage averageMemory usage averageGPU usage lowisAPIisDocumented

Version Released License Features Category Author(s) Feedback
2.15 2023-12-05 CC BY-NC-SA 3 self-repair Equipment OXPs Thargoid BB-Link

Gameplay and Balance indicator

Tag-colour-violet.png

Links

Other relevant oxp's