Towbar

Towbar

Make money from derelict ships.

Pilots often eject when lost a fight and left behind an almost destroyed ship. You do not need to destroy ships anymore for bounty due to you will get instantly when the pilot ejects.

Your HUD can show the Derelict status of your target if Detectors OXP or NumericHUD v3.11 OXP installed or you insert the insertintohudlegends.plist file from the Towbar OXP into your hud.plist.

If you apporach a derelict ship in 100m (or hurtle into) with low speed difference (below 10) then the towbar will lock it, see in the aft view (F2).

You can tow ships with maximum 1.6 times more mass than your ship, others can be mined with Ship Miner only (see below).

Can not use Injectors without a special equipment and pitch rate very low when towing (the $TowbarSlowTurn variable in towbar.js can be set to false on computers where controls goes jerky when tow a ship).

Pull into a dock in the current system to sell the hull as a large amount of alloys.

Ship		Mass	Alloys	Approximated credits
Adder   	11	3	100
Moray    	40	12	400
Cobra Mk I	47	14	500
Fer-de-Lance	51	15	500
Asp     	59	18	600
Cobra Mk III	186	56	1800
Boa     	192	58	1900
Python  	222	67	2200
Anaconda	430	80	2600

The payment calculated from the alloy price at the station where you sell it, plus 0-2t Computers depending on the ship size. Largest ships can give maximum 80t alloys only due to the inner space.

Alloys will not added to the market because the ship sold to a dealer who pay instantly but disassemble later (and to avoid fill up the 127t limit of the market), but cargo will be added. If the market is full with this cargo then the remains will be sold at half price or discarded if you set $TowbarLimit127t to true in towbar.js.

You will get a few hundred credits for each saved equipments and weapons also.

Military Laser worth 1-2 thousands but probably the fight was harder to get it.

All saved cargo worth the current price at the station.

Some ships (with high version numbers in ShipVersion OXP so the durable ones) hold much more valuable cargo than others.

With HardShips OXP you can get more equipments as you can see in this image:

Compliments

You can get the following compliments:

• 1000 credits: Nice work.
• 3000 credits: Well done!
• 5000 credits: Excellent!

Usage

Be careful when attacking a ship: slow your fire when the exhaust plume changes (or throwing sparks with CustomShields OXP) to avoid blowing it and stop immediately when you see the Escape capsule. Then touch the derelict ship slowly to lock it to the towbar.

Reduce the pitch and yaw movements when towing due to there are a small but increasing chance to break the towbar or the towed ship, heavier ship break sooner. A few tips:

• Approach the derelict ship in the direction of your next movement, usually head to the Station to reduce turning with mass.
• Stop your ship before turn to cause less pressure to the towbar.

Do not go to a sightseeing tour: the status of the ship degrading over time when moving, so you can earn more credits if you deliver faster. You will be informed about flying parts to remember this. Losing less at low speeds but your haul are in safe only if your ship is stopped.

If the towbar is destroyed then you can buy another and go back to the ship, just find the "D" (derelict) beaconCode on your Advanced Space Compass. Telescope OXP show it also in the main scanner from any range.

If you are too slow then pirates will blow up the ship for the cargo, hunters for the bounty or Thargoids for sure.

Not all derelict ship in the system has beaconCode due to the signal transmitter placed when the towbar locked on.

You can change the towed ship if your ship touch another derelict ship.

If you initiate a hyperjump then the towbar will release the towed ship. This means that you must sell the ship in the same system where you get it.

You can release the towed ship by prime Towbar (Shift+N) and press activate (n). The just released ship can be relocked by another activate (within 200m).

The towed ship is vulnerable, suggested to avoid combat situations until delivered.

Largest towed ships facing into your aft weapon so you can not fire backward or you will destroy it. If you must then release it by double "h" keypress (start and stop a hyperjump) and pick up later. Before this you must set a target system and has enough fuel for the jump.

Do not engange fight when towing a ship to avoid too many steering which break the towbar. If you must then release the towed ship and pick up after the battle.

Build up your reputation by salvaging more ships, missions will require qualification.

Cost: 100.0 Cr.
Techlevel: 1

Laser Reductor

Reduce your Laser power to minimal if targeted ship is derelict to save it from exploding after forced to eject. You will get a "Derelict!" message with a "bloop" sound when your target is ejected to warn you to stop your fire.

Your first 10 hit will be reduced only, which mean a full second with a continuously fired beam laser. Most pilots are able to release the fire button within a second after warning sound started, if you not then increase the $TowbarMaxReduct variable in towbar.js.

When you step over this limit a "Laser Reductor disabled" message arrive and you can destroy your target to finish your mission. You can turn off reductor also by pirme (Shift-N) and activate (n) Towbar when no towed ship nor derelict within 200m.

Suggested to install "Derelict" display into you HUD by either Detectors OXP, NumericHUDv3.11 or following instructions in insertintohudlegends.plist file to get another visual warning.

Cost: 100.0 Cr.
Techlevel: 5

Ship Miner

Complex robots can transfer the valuable parts of the towed ship to your cargo store but this take some time.

Mining go ahead in the following order:

1. Cargo: stronger ships tend to hold more valuable packages. Fuel transferred in this step also.

2. Computers: from the built-in electronics, usually 1 or 2t depending on the ship size.

3. Machinery: from mining equipments and lasers, in equal value.

4. Alloys: dismantle the hull into pieces but only the smaller ones can fit into the scoop (max. 10t).

Mining will stop by default when cargo transfer done assuming you want to tow the ship into a station.

To continue prime Towbar (Shift+N) and press mode (b), but this suggested only if you do not plan to tow the ship back to any dock.

• Set back to "Offline" or "Cargo only" setting if you plan to tow a ship again.
• The "Cargo only" mode is suggested due to can lose cargo from the towed ship when moving but cannot from your store.
• The "Up to full" mode will mine until there are free space in your ship, others are leaved in the mined ship.
• The "Salvager" mode will drop out all inner parts into the space to finish the whole mining and increase your salvager reputation regardless of your store is full.

Cargo check need some time in ships with 0t cargo also due to the cabin safe can contain valuables. Mining will be stopped in steering, speed changing, injecting and torus travel so processing when stopped or travel straight at constant normal speed.

Parcels

Sometimes you can found parcels when finished cargo transfer. Urgent ones need to deliver to the main station within a few minutes. The message what you get and your ship's manifest screen (F5F5) show the remaining time. Do not use autodock (Shift+C) due to it need 20 minutes regardless from looks like instantly and you will arrive too late.

Your parcel reputation will not decrease if you do not arrive in time due to you are not who undertaken delivery (parcels will be removed from manifest screen when expired to avoid penalty). Install Display reputation OXP to track your progress, you will get more payout for the same work if you earn higher reputation.

To find shortest route of normal parcels you should buy Advanced Navigational Array equipment, go to the galactic chart (F6F6), hold down "^" (Shift+6) then click on destination (marked with green diamond). Hold with Ctrl also to show fastest route if time is not enough. Press F1 then "`" to review your timelimit in your communcations log in hours. Manifest screen (F5F5) show it in days but in the galactic chart (F6F6) you see times of routes in hours.

Traps

Some ships are equipped with a self-destruct trap and a mistake during Fuel transfer can end up with a blast also. These can cause large damage to your ship depending on the size of the towed ship. After you gained more and more salvaging experience you can prevent these problems more and more times. With ShipVersion OXP you usually can mine ships safely below and at your salvager level.

Towbar will not autolock if a trap can kill you due to the target is too large or your energy is low. You can override this by priming and activating Towbar but you risk to start a new game. There is always a small chande to fall into a trap, sometimes an Elite Salvager can make mistakes also so avoid overriding and wait until your energy and shields are recharged, buy Shield Boosters or a larger ship with more energy banks.

Ship mining is not 100% safe, towed ships can explode from the meddling in rare cases which surely destroy the miner.

Finished mining counted as the ship is salvaged which increase your reputation, so you can save towing time if money is less important.

The "Empty" word in the ship name mean the cargo is transferred already, the "Mined" word mean finished mining. Your HUD can show these words also with NumericHUD v3.11 or by following the instructions in insertintohudlegends.plist. Derelict ships get light blue lollipop in the scanner when targeted, Empty get blue and Mined get dark blue.

If you want to sell the parts in other system then you must mine the ship before jump due to there is not possible to construct a tool which can avoid the explosion of a badly damaged ship in hyperspace.

You should mine also if you are very far away from any dock to avoid losing many parts on the long way, but if the Station is near then you can get more credits by towing.

If you mining a heavy ship which has more than 1.6 times in mass than your ship then you anchored and cannot move regardless of your speed settings. If you touch the controls during mining a heavy ship then released immediately to avoid breaking the towbar.

Ship Miner can fit into large ships over 130t only and the mined parts need many cargo space, except if you found valuable cargo (Gold, Platina or Gem-stones).

Cost: 20000.0 Cr.
Techlevel: 5

Ship Miner Assistant

Additional transporter bots can help to reduce mining time and increase safety. The possibilities of flying or destroying parts are about the half of the original. Also can catch large parts when towing before flying out from the towed ship.

Cost: 20000.0 Cr.
Techlevel: 11

Towbar Compatible Injectors

Enable Injectors when towing a ship. Costly due to need stronger towbar holders and new exhaust tubes to the gases evade the towed ship.

The towed ship losing more parts if the speed is higher so you can earn the same money only but can save time. Torus Drive is the only exception from the speed rule so suggested to use as soon as possible. Do not steer your ship when injecting otherwise towbar will be unstable more times faster.

Cost: 20000.0 Cr.
Techlevel: 11

Towbar Repair Bot

Can fix a broken towbar, but one time only. Repair will start automatically when needed and take about a minute.

Can not repair a destroyed towbar which can happen almost as often as break so better if always apply Towbar Stabilizer and start repair in the last resort only.

Cost: 1000.0 Cr.
Techlevel: 5

Towbar Stabilizer

Use when towbar being unstable to prevent damages and the possible explosion of the towed ship. Occupy an empty pylon, launch as a mine. Buy more if you plan to tow heavy ships for long range.

Can not fix a broken or destroyed towbar, nor resurrect the towed ship after an explosion caused by the unstable towing, so use before these problems occurs.

Cost: 200.0 Cr.
Techlevel: 5

Tug Drone

Launch as a fire and forget missile to a derelict ship and you are done with the work. Guided by the local authorities which charge 50% commission but pay instantly when hit the target.

Will drop out the cargo and pay for the ship only so you must scoop if not transported with Ship Miner before launched the Tug Drone. GalCop defend Tugs but need to known by all pirates that Tugs never transport cargo to reach a tolerable safety level (is not worth to attack it).

Deep Space Dredger OXP provide Salvage Missile which can autopilot a derelict ship with cargo. In this case you must escort it until reach a Dredger which is much harder because pirate ambushes, but can pay more due to avoid commission.

Tug Drone can fit into large ships only (over 130t). Do not target small ships which pay less than the cost of the Tug Drone. You must aim exactly to the target (with red box) to launch the drone, green target lock is not enough.

The rotating ship model cannot be displayed in the sell salvage screen during flight, and your ship is moving while you read it so press enter shortly to reduce the blind fly time.

Cost: 1000.0 Cr.
Techlevel: 5

Salvager License

GalCop regulates ship salvaging at main stations; you must buy a license from your initial earnings, which is automatically deducted. You will only receive payments for the cargo after you have pooled the full 20000 credits for the yearly license. You must buy new license every year. Once you have a Salvager License you, must pay tax from the ship hull and equipment based on the government.

Government		Tax
Anarchy 		0 %
Feudal			5 %
Multi-Governmental	10 %
Dictatorship		15 %
Communist		20 %
Confederacy		25 %
Democracy		30 %
Corporate State 	35 %

Non-GalCop stations do not require a license, but charge a 50% commission. Dredgers in Deep Space Dredger OXP and Salvage Gangs in Anarchies OXP buy without commission due to processing the ship locally but pay low price for the alloys of the hull.

Cargo is never taxed or commissioned.

Salvager Missions

Your reputation counted as how many ships salveged either by delivered or fully mined it. When you reached certain levels you can get Salvager Missions (in v0.93 the first is implemented only):

Ships	Name		Level	Payout	Need Salvager License
0	First Aid	Easy	1000	No
2	Second Hand	Easy	2000	No
10	Ten Commands	Easy	10000	Yes
20	Twenty Sisters	Medium	20000	No
30	Thirty Pirates	Medium	30000	Yes
40	Forty Robbers	Medium	40000	Yes
50	Fifty Percent	Hard	50000	No
100	Hundred Tonnes	Hard	100000	Yes
200	200 Seconds	Hard	200000	No

Salvager Rankings

You can step up in your Salvager career by towing or mining derelict ships or achieve salvage missions.

As your reputation increasing you can get better rankings which shown in the Manifest screen (F5-F5).

With higher rank you can neutralize more complex traps in towed ships.

Ships	Rankings
2	Novice Salvager
4	Assistant Salvager
8	Poor Salvager
16	Below Average Salvager
32	Average Salvager
64	Above Average Salvager
128	Competent Salvager
1000	Trustworthy Salvager!
3000	Infallible Salvager!
6000	Elite Salvager!

Equipment Payout

In v0.104, Towbar started supporting "pluggable" policies to calculate the value of the equipments, weapons included, in the salvaged ship, to be implemented by other OXPs.

The reason for that can be seen in this discussion.

In v0.104, those policies overwrite the standard policy - to change policies the player has to uninstall one policy OXP and install the other policy OXP, which requires exiting the game session. Payout OXPs compatible with the v0.104 version must have a single policy packaged inside.

After v0.105, Towbar supports in-game selection of the payout policy through the Station Interfaces (F4) Config for AddOns screen. Payout OXPs compatible with v0.105 could package more than one payout policy for the player to choose, but if an OXP packages more than one policy it is not compatible with Towbar v0.104.

The OXPs that package such alternative payout policies can be found here.

Technical Informations

Depending on Oolite v1.77 and BGS OXP if you want to see nice background on the salvage screen.

Configuration

Towbar allows in-game configuration through Station Interfaces (F4) Config for AddOns for:

• TalkingShip: when true, Towbar will use Comms to send its messages to the player; otherwise the messages go to the Console.
• StartMode: start mode fo Ship Miner: 0=Offline, 1=Cargo Only, 2=Full, 3=Salvager[.
• Appearance: the Towbar equipment appearance: 0=Retractable, 1=Fixed, 2=Tractor Beam.
• EqPayout: the salvaged equipment Payout Policy to use

Other configurations can only be altered by editingtowbar.js and re-starting the game:

• $TowbarDebug = false; //will spawn a derelict ship right after undock
• $TowbarLimit127t = false; //can limit markets to the original capacity
• $TowbarMaxReduct = 10; //how many hit will be reduced by Laser Reductor on a derelict ship
• $TowbarNPCMissile = true; //NPCs with enhanced IQ: fire a missile before eject as last resort
• $TowbarSlowTurn = true; //set to false if cause jerky controls when tow a ship

Payout OXPs

Payout OXPs add alternatives to the standard salvaged equipment payout policy. Such alternatives can be pro-player, paying more for the equipment, or against player, paying less.

A Payout Policy OXP MUST:

• create a function that takes an EquipmentInfo (which might contain a weapon) object as parameter and returns its salvage price IN CREDITS;
• in the OXP's startUpComplete event handler:
  • append a reference to that function to the array worldScripts.towbar.$TowbarEquipmentPayoutHandlers;
    
  • define a property display for that function and assign a short and distinctive string to it - the first 6 characters will be used to identify the policy implemented by the function in the policy selection screen;
    
  • repeat for as many policies as wished (but bear in mind that all the policies short names will have to fit in a single line).
    

License

This work is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike License version 3.0

If you are re-using any piece of this OXP, please let me know by sending an e-mail to norbylite at gmail.

Towbar applause sound source: http://soundbible.com/1260-Auditorium-Applause.html

Towbar break sound source: bgs-c_hullbang.ogg in BGS OXP.

Towbar fireworks sound source: http://soundbible.com/693-Fireworks-Finale.html

Towbar hit derelict sound source: boop.ogg in Oolite.

Towbar lock on sound source: bgs-m_fx_shipyard1.ogg in BGS OXP.

Changelog

2020.08.31. v0.106

• Fixes a bug in the fallback code for Laser Reductor.
• Doesn't blindly remove equipments defined by other OXPs.

2020.08.29. v0.105

• Fixes bug in cargo pod script that looks at the pod's cargo space instead of the player ship's when scooped.
• Implements salvaged equipment payout policy selection in-game through Stations Interfaces (F4) Config for AddOns.
• Laser Reductor looks at EquipmentInfo.weaponInfo.damage to know the energy of the hit to be reduced (uses a fallback for core game versions that don't allow scripts retrieval of weaponInfo).
• Creates TalkingShip, StartMode and Appearance parameters in Stations Interfaces (F4) Config for AddOns.
• Implements TalkingShip, with messages in better English thanks to Nite Owl.
• Removes the "Incoming Message" speech intro for Comms messages.

2020.08.10. v0.104

• Use commodity name instead of commodity display name as cargo identification in re-spawned cargo pods (with display name as identification, the cargo couldn't be put into the player's ship manifest when the cargo pod was scooped).
• Adjusted Laser Reductor to take into account the damage rate defined for the current weapon.
• Debug code to spawn derelicts just out the station when launching now spawn near the station where the player's ship is docked instead of the main station.
• Tweaked code the awards/remove EQ_DTADER to reduce the number of times it's added/removed while targeted.
• Upped minimal Oolite version to 1.81, removed code for older versions.
• Fixed bug that used commodity display name instead of name in lost-in-transit cargo pods.
• Fixed bug that removed rotation when reducing yaw and pitch while towing (affected ILS rotation-sync).
• Fixed bug in salvaged ship payout when the ship's cargo is beyond the local market capacity.
• Re-factored salvaged equipment pricing into a function (to make it easy to overwrite it with different pricing policies through other OXPs).
• Included port and starboard weapons (if any) in the salvaged ship payout.
• Reduced payout for salvaged ship's equipment and weapons.
• Some de-referencing for performance.

2020.06.23. v0.103

• Abort sound was not playing if the tug drone can't be launched.

2020.05.05. v0.102

• Better integration with Email System, preventing unnecessary emails being sent.

2020.02.23. v0.101

• Fixed two invalid reference errors in the towbar mission script.
• Some minor spelling/grammar corrections.

2016.08.14. v0.99

• Increased payout for equipments and weapons during ship salvaging.
• Towbar is not shown by default, just when tow a ship (retractable).
• Mission failed screen appear correctly at load game when must finish without rest.
• NPC will not fire missile at point-blank range before eject, thanks to Astrobe.
• Fixed multiplied parcels, thanks to Cmd Northgate.
• Removed "x. find" from parcel messages, suggested by Cmd Northgate.
• Fixed Constrictor hunt problem, thanks to Captain Obvious.
• First mission compatible with Escort Deck, thanks to Vincentz.
• Fixed for very long ships like Worker's Commuter in Commies OXP, thanks to TheOldGamer.
• Density of small-cargo1 raised to help scoop it with small ships, thanks to Bogatyr.
• Tug Drone got collision handler, thanks to Hullblazer.
• Ship Miner default mode changed to salvager as suggested by gt52

2015.03.15. v0.98

• Player get score if force a pilot to eject.
• Small fixes for Oolite 1.81 and without BGS.

2014.09.21. v0.97

• The first mission will fail if jump out from the system, thanks to Bogatyr.
• Cleanup after first mission: Moray removed, thanks to Falcon777.
• Trumbles modified to do not take over cargo, thanks to Falcon777.

2013.12.26. v0.96

• Bugfix in Tug Drone.
• Smaller large cargo box.

2013.12.14. v0.95

• Parcels and urgent parcels can be found during ship mining.
• Minor tweaks in mining and a bugfix with Trumbles.
• Audio and message warning if hit a derelict ship to stop fire in time.
• Laser Reductor limitation adjustable in $TowbarMaxReduct.
• Illegal cargo added into some ships with bounty.

2013.12.08. v0.94

• Laser Reductor fixed and can be turned off.

2013.10.23. v0.93

• Timed bomb implemented into some derelict ships.
• Traps are leveled up with ShipVersion.
• Towbar will not autolock if a trap can be fatal.
• NPCs will stop attacking derelict ships.

2013.10.22. v0.92

• Trap ships and Fuel mining added (thanks to popsch).
• Injectors fixed when the towed ship destroyed by others.

2013.09.24. v0.91

• Give back Injectors after mission ship is delivered.
• Set $TowbarSlowTurn to false on computers where controls goes jerky when tow a ship.
• XML support in insertintohudlegends.plist.
• Effectdata.plist for Telescope OXP to show large cargo models.

2013.09.06. v0.9

• Laser Reductor, Ship Miner, Ship Miner Assistant and Tug Drone added.
• First Salvager Mission added.
• Towbar primeable to release and to change mining mode.
• Salvager Rankings displayed in F5-F5 screen (idea from Display reputation OXP).
• Deep Space Dredger and Salvage Gang buy ships without commission.
• Can lose or destroy alloys, cargo and equipments during towing and steering also.
• Flying out more t alloys and cargo in one large object instead of many 1t pieces.
• Flying equipments now scoopable as 1 or more t Machinery.
• The ship.script.$TowbarShipHealth is scalable from 0 to 1 (max. loss to no loss).
• Pitch rate less reduced with light towed ships.
• HUD can show the Derelict, Empty and Mined status of the current target.
• Pay bounty instantly when the target derelicted.
• Refund available for all equipments of this OXP.

2013.08.21. v0.8

• Chance to break the towbar or the towed ship (thanks to DaddyHoggy).
• Towbar break sound included, source: bgs-c_hullbang.ogg in BGS OXP.
• Towbar Stabilizer, Repair Bot and Towbar Compatible Injectors added.
• Towed ship get "D" (derelict) beaconCode.
• Build up reputation in missionVariables.
• Salvager License and tax system added.
• Flying alloys, cargo and equipments added.
• Ship moved to right in the sell salvage screen (thanks to Svengali and cim).

2013.08.18. v0.7

• Injectors offline and pitch rate very low when towing.
• Payment lowered.

2013.08.17. v0.6

• Lock on sound added. Source: bgs-m_fx_shipyard1.ogg in BGS OXP.
• Some ships carry much more valuable cargo than others.

2013.08.16. v0.5

• Give money for cargo also.

2013.08.15. v0.2

• Give money for equipments.

2013.08.14. v0.1

• First test files.

Download

Download Towbar-0.107.oxz (downloaded 0 times).

Towbar-0.106.oxz (downloaded 0 times).

Towbar-0.105.oxz (downloaded 0 times).

Towbar-0.104.oxz (downloaded 0 times).

Towbar_0.103.oxz (downloaded 0 times).

Towbar_0.102.oxz (downloaded 0 times).

Towbar_0.101.oxz (downloaded 0 times).

Towbar_0.99.oxz was downloaded 0 times.

Towbar_0.98.oxz was downloaded 4751 times.

Towbar_0.97.oxz was downloaded 1589 times.

Towbar_0.96.oxz was downloaded 921 times.

Quick Facts

0-{{{2}}}

Version	Released	License	Features	Category	Author(s)	Feedback
0.107	2020-06-23	CC BY-NC-SA 4.0	Introduces Salvaging.	Activities OXPs	Norby	BB-Link

Gameplay and Balance indicator