Marine Repairs and Training [TC][AP][ALP]

[DrBullwinkle]

.

Marine Repairs (and Training) v2



Features

• Marines will repair the ship that they are on, or any ship docked to the ship that they are on.
  
• Marines will repair any station or complex that they are docked to.
  
• New! Marines will spacewalk to repair targeted ship (when you press the hotkey).
  
• Marines receive on-the-job training while they are doing repairs.
  
• Training Fee is about the same as vanilla training, but the training is much faster (during repairs only).
  
• Marines with higher skill levels in Mechanical and Engineering do repairs more quickly.
  
• Faster repairs for stations and large ships; at a cost.
  
• Default cost for full-hull repair varies from about 10% to about 40% of the cost of a new ship. While substantial, Marine Repairs are still less expensive than repairing at a shipyard.
  
• Training, Pricing, and Repair Speed are customizable in the t file. You can even make Marine Repairs "free" if you want.
  
• If Nividium, Microchips or Hull Plating are in the cargo hold of the ship being repaired, then they will be consumed first; before credits. Optionally, resource-only mode (no credits) can be set in the t file.
  

(Thanks to kurush for the ideas for complexes and T&M costs, and to Aegyen, Vayde, Troubleshooter11, JoelR, Xannn, and others for their suggestions and test reports. And, of course, to Tatakau for the original version, on which this is based.)


Recommended

Use with Mobile Mining Mk2 (MM Mk2) and Detector for terrific synergy! Detector finds Nividium rock clusters, MM Mk2 mines it, and Marine Repairs fix your ships and train your marines when ships get damaged during routine mining operations.

Compatibility

Works for TC and AP. Should be compatible with most stuff.

If you ask me whether it works with XRM, I'm going to tell you to punch yourself for asking.

(it does!)

Requirements

X3TC or X3AP
Marines
Damaged ship, station, or complex

How to Install

1) Install as Archive with the Plugin Manager or manually.
. . (If this is your first time, see Installation Tips: Plugin Manager (PM), LV's Tutorial, Artificial Life Plugins (ALP's))

2) Turn on the Artificial Life Plugin (ALP) in the Gameplay Options. (Press Esc, then look in the lower left corner of your screen for the menu).

3) Set up the optional hotkey for Marines Repair Target in the Interface section of your Controls menu (Press Esc until you see the menus).

How to Use

There are many ways to use Marine Repairs, but the marines do their job automatically, as long as the AL Plugin is "On".
Here is one example:
1) Put some marines in a TL.
2) Dock a damaged fighter. The marines will automatically repair the fighter.

Another example:
1) Dock a TL or TP carrying marines at a damaged complex (Advanced Complex Hub mod will dock a TL). The marines will automatically repair the complex.

Another example (New!):
Target damaged ship and press the optional Marines Repair Target hotkey.

Configuration Options

The t file contains several options that you can use to configure the way that this script works.
The options all have comments. I hope that the descriptions are clear. If not, then please ask so that I can clarify them in a future release:

id="301" -- Number of points of training boost per repair cycle . Default = Minimum = 1
id="302" -- Percent chance of training on any given repair cycle . Reduces the amount of training per cycle. (Due to engine math limitations, anything from 50% to 99% is the same as 50%.) Default = 10.
id="303" -- Training cost per repair. Default = 25,000 which is 2.5 million / 100, or the cost for training 1 point in all skills.
id="304" -- Repair cost per hull point. Default = 8. This is a different formula than shipyard; full repairs average 10-40% of new ship cost.
id="305" -- Station Repair Effectiveness Multiplier. Stations repair faster because their hulls are very thick. Default = 50.
id="306" -- Station Repair Cost Percentage. Station Repair costs are multiplied times this percentage factor. Default = 15%.
id="307" -- Hugeship Repair Cost Percentage. Hugeship (M1, M2, M0) Repair costs are multiplied times this percentage factor. Default = 60%.
id="308" -- Hugeship Hull Definition. Number of hull points which define "Hugeship" for cost calculation. Default = 1,400,000.
id="309" -- Consume Hull Plating if available. Default = yes.
id="310" -- Consume MicroChips if available. Default = yes.
id="312" -- Consume Nividium if available . Default = yes.
id="311" -- Consume resources ONLY (do not use cash). Resources must be in the cargo bay of the ship being repaired. Default = no.
id="313" -- Nividium value . Default = 24200
id="314" -- Microchip value . Default = 15200
id="315" -- Hull Plating value . Default = 26800

id="404" -- Marines get Fight training , in addition to other skills (yes/no: case sensitive). Default = no
id="410" -- Total Effectiveness Multiplier . Default = 2. Higher = Faster Repairs
id="411" -- Total Effectiveness Divisor . Default = 1. Higher = Slower Repairs

Which file do I edit in my t folder?

I got tired of constantly looking up PageID numbers, so I decided to come up with a way to see, at a glance, which t file goes with which script or mod.

The -L099xxx file does the trick. Think of the -L099 files as "documentation"; it is merely a marker so you can easily find which file to edit.


(The reason for the funny name with the -L099 and .xml -- rather than just a .txt file -- is to trick the Plugin Manager into putting the file in the correct folder.)



The -L044 file is the English language file. So, for Marine Repairs, the full file name for the English t file is "8501-L044.xml". <-- Edit this one.

Language codes are the international dialing codes for your country:


- L007 - Russian
- L033 - French
- L034 - Spanish
- L039 - Italian
- L042 - Czech republic ?
- L044 - English
- L048 - Polish
- L049 - German

History

v2.05a (2013-04-25)
- Fixed t file for Marines Repair Target hotkey (joelR).

v2.05 (2013-04-24)
- New: Added Marines Repair Target hotkey. Marines will spacewalk to repair the targeted ship. This feature is not perfect yet, but works well enough to be useful and fun.
- Fixed a bug in .repair.single that may have miscalculated repair costs under some conditions.
- Fixed comment on id 412 in t file.

v2.04 (2012-10-18 )
- Bug Fix: Calculate costs before repairing.
- Improved cost calculation slightly.
- Added timer interval to t file for debug and testing.

v.203a (2012-10-14)
- Turned off unnecessary debug code.

v2.03 (2012-10-14)
- Fixed bug that inadvertently increased repair speed.
- Added Nividium as optional resource.
- Added ability to modify resource values (prices) in t file.
- Increased relative value of Hull Plating because of its large volume. Less Hull Plating; more repairs. (You can change it in the t file now).

v2.02 (2012-10-13)
- Added Optional resource consumption for ships. Configurable in t file. (Microchips or Hull Plating) (Troubleshooter11, JoelR)
- Fixed bug that continued to charge for training after training was complete. (Xannn)
- Fixed bug that prevented cost calculation from running on single ships.
- Subtitle and tone signals player when repairs complete. (Vayde)
- Improved training cost calculation for more accurate results.

v2.01 (2012-06-15)
- Minor bug fix: Training max = 100.

v2.00 (2012-06-14)
- Major version change to reflect feature upgrades.
- New Multiplier and Divisor in t file make it easier to customize effectiveness (speed of repairs).
(Remember that higher effectiveness means faster repairs but less training. So there is a trade-off.)
- Reduce Hugeship definition to 1.4M in t file (means faster repairs for TLs)

Version 1.12
- Fight training is optional in the t file. Default is 'no' fight training. (kurush, Aegyen)

Version 1.11
- Improved cost calculation for repairing very heavy-hull ships (M1, M2, M0). Max cost for 100% repair now about 40% of purchase price.
- Improved cost calculation for Station repairs. Cost calculation uses new Station Repair Cost Percentage (in t file).
- Increased default station effectiveness multiplier from 20 to 50 (in t file). Means: Faster repairs for stations.
- Fixed bug in training cost calculator -- should now approximate vanilla training costs.
- Now repairs more station types.

Version 1.10 Bullwinkle; first version
- Now repairs complex hubs (and stations connected to complex hubs). (kurush)
- Effectiveness improved for AP's stronger hulls (no change for TC).
- Marines can gain small amount of training with each repair. Cost is similar to vanilla training.
- Added Time and Materials charges for repairs. (kurush)
- Costs for training and repairs are configurable in the t file.

* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Links

Marine Repairs v2
Bullwinkle's List
( Marine Repairs v1.02, Classic Version is a a re-post of Tatakau's classic Marine Repairs v1.02, which now has stale links.)

.

[DrBullwinkle]

Reserved 1

[DrBullwinkle]

Reserved 2

[DrBullwinkle]

Reserved 3

[zhukov032186]

Does it work with XRM?

[DrBullwinkle]

[Aegyen]

Good, now that Zhu has that covered, I just want to know.. If I break XRM, will it repair that too?...

[DrBullwinkle]

[kurush]

[DrBullwinkle]

[kurush]

[DrBullwinkle]

I thought Cycrow's comment was ambiguous, so I went with better-safe-than-sorry.

[Osiris454]

What's the t file's name that you used so we can change some of the settings?

I've got an 8501-L044.xml and a 8501-L099 -- Marine Repairs.xml.

Do I edit both?

[DrBullwinkle]

[Osiris454]

Ah, so the duplicate file is used as a marker so you can easily find which file to edit. Clever.