[Script]Dock Upgrade Manager 3.048[Updated 15:30 GMT 06/05/07]

[Shovinus]

=====================
Dock Upgrade Manager 3.048
=====================

Dock Upgrade Manager SPK (Link down)
Dock Upgrade Manager ZIP

Hosting provided by Aerukath (thank you)

SPK Requires Cycrows script installer to install which can be found here:
Cycrows Script Installer

• 3.048
  ->Fixed DUM disappearing from station command console
  3.047
  ->Fixed problem with the manual engine tunings and rudder optimisation occuring if you have more tunings than normally possible.
  3.046
  ->Fixed read errors in .spk caused by Cyrows script installer
  ->Fixed Al texts
  3.045
  ->Added options to AL menu so that you can choose whether the DUM is active at the HQ or SY (by default both are off)
  3.040
  -> Fixed problem with engine tunings not being installed
  -> Fixed shields being added when the shield bays are already full
  -> Removed log of equipment added from sublog to stop flooding of log book which increases time it takes to open
  3.039
  -> Add option in ship commands so that you can install Engine and Rudder Upgrades manually rather than only with auto upgrade
  -> Blanked out option to auto upgrade one ship when not docked at one of your equipment docks or other upgrading station.
  3.031
  -> New setable jump range added for calling idle ships to dock
  -> New Docking Upgrade added : Once active it will install upgrades according to your groups in all ship types automatically, and keep checking to see if any new ships need upgrading, i.e. those that dock or when you change the custom settings or buy new licenses.
  3.027
  -> Fixed pageid problem for some people (those who had not installed this before)
  3.026
  -> Removed Autodock Command running on ships already docked at the target station to stop multiple messages from ships with "Notify me when order completed" active being sent to the player.
  -> Setup should now work regardless of previous installs
  -> Engine Tuning and Rudder Optimisation are now not installed at the station, but in the memory, i.e. you can use them with auto-upgrader but no interactition is possible manually, to stop people being able the abuse the ability and put multiple installs on a ship far greater than the ships normal amount.
  -> Command Slot Added for Shipyards for compatability with Player Owned Shipyards script
  -> Uninstall script added to hopefully get rid of HotKeys and command slots once uninstalled (will not work with previous installs "sorry")
  3.021
  Data lost

Orginal Scripts:
Wolfs AutoUpgrader
Shovinus' Equipment Installer

The below information is now becoming old although it gives good guide on how most of the script works if you need more help please ask, I will update the screenshots and info once I reach version 3.5, or feel it is complete (or enough people ask for help)

========
Information
========

The Dock Upgrade Manager is a merged version of Delta Wolf's Auto Upgrader and my Equipment Installer, although, so much work has been done on it that it barely resembles its parent scripts (alot of nip and tuck:)).
My original concept was to create a script that would allow users the same benefits as the other races have when using equipment docks and trading stations, after all considering the cost of both the above items it seemed stupid that all they did was give you extra storage space.
So I created a script that allowed you to purchase licenses so you could stock the upgrades
Then gomle showed me wolf's script and said it would be a good idea if we merged them, as they had alot in common, so I did, and I'm glad he suggested it.

What it does:
It allows you to purchase licenses for upgrades to be used at your Docks (HQ/Equipment Docks/Trading Stations) (You need to activate HQ and SY options in Al settings)
Upgrades your ships from customisable lists
Stocks upgrades automatically at your stations
Calls all inactive ships to a player chosen station
Upgrades shields to the max amount from your stores (must be activated first in the customiseable options, found at the bottom of the list)
Allows you to customise 3 different class groups of ship for upgrade
Lets you view all your currently owned Licenses
Gives detailed reports when you auto upgrade ships.


=====================
Using Dock Upgrade Manager:
=====================


======
HotKeys
======

Go to the bottom of the interface tab in controls
Show All Licenses
Deactivate Autostockers
[ external image ]

Show All Licenses: Displays all the licenses you own across the universe
[ external image ]

Deactivate Autostockers: Turns off all active Automatic Restockers, displays a message for each station that is turned off
[ external image ]


=========================
Dock Upgrade Manager Main Menu
=========================

Simply select "Dock Upgrade Manager" from the commands list
[ external image ]

This will bring up the welcome message
[ external image ]

Click ok to continue to the main menu
[ external image ]


===================
Option 1 : Auto Upgrade ships
===================

Select "Auto Upgrade Ships" to go to the group selection question, this is where you can choose which set of ships to install upgrades in.
[ external image ]

When you have selected the group, the upgrades that can be installed will be installed, and you will be shown a report like this one. You will also be told if there were upgrades that weren't installed correctly, and if there were shields not installed (If you have activated the shields option for that group)
[ external image ]


===========================
Option 2 : Customise Upgrade Groups
===========================

This option allows you to view which groups install which upgrades, and to customise them as you like, first you will need to choose which group you wish to customise
[ external image ]

Then you can customise that group as you see fit
[ external image ]


====================
Option 3 : Purchase A License
====================

Inorder to upgrade anything (excluding shields which are just taken from your stock) with the upgrader you need to have purchased the license for the ware at the dock you want to use the ware at.
[ external image ]

Once you have purchased a license you can't sell it again so think carefully before you go off buying every license in every dock when you don't have that much money. Once successfully purchased you will recieve a message confirming your purchase.
[ external image ]


============================
Option 4 : Activate/Deactivate AutoDock
============================

Auto dock allows you to quickly and easily dock all your inactive ships in the universe at a dock so they can be upgraded within a certain jumprange, that you can set yourself
[ external image ]
[ external image ]

Deactivate AutoDock will not stop those ships that have already started towards the station, but will stop further ships that become inactive from flying to the station you selected.
[ external image ]

================================
Option 5 : Activate/Deactivate Docking Upgrade
================================

Clicking this option will automatically upgrade any of your ships at the station you selected the option from
[ external image ]

Clicking again will stop ships being automatically upgraded
[ external image ]

======================
Option 6 : Activate AutoRestock
======================

This restocks any ware for which you have purchased licenses so you can manually upgrade ships, beware though that if you try and install too many of an item in a ship, you will be charged for the wasted items as well as the successfully installed items, be especially carefull when installing cargo bay extensions.
[ external image ]

Once active you will recieve a message confirming it has been activated at this station, and you will no longer have the option to activate it in the menu for that station until you deactivate it via the hotkey.
[ external image ]
[ external image ]


============
Upgrading 1 Ship
============

You can upgrade one ship at a time if it is docked at a station (even one not owned by you). If you are docked at another race's equipment dock it will see which upgrades they have and install them according to your group lists. You do this by going to the ships additional command slots
[ external image ]

You can also upgrade manually engine tunings and rudder optimisation on 1 ship at a time by going to Upgrade Engine/Rudder and upgrading from the following menu
[ external image ]


============
Command Slots
============

Note: Those listed in green are used by the DUM the others are used by a different script

1145 Shipyard Manager
1147 Dock Upgrade Manager
1245 Upgrade This Ship
1246 Upgrade Engine/Rudder
1260 Auto Transfer To Shipyard

=======
Page Ids
=======

7006


Thanks to:
Delta Wolf : Letting me mod his script to be used with mine
ChemODun : Russian Translation
Alot of help with cleaning up the script and displaying results
B-O'F : Alot of help while scripting
Cyrow : For his Plugin Manager, Help files and help in early processes.
Gomle : Idea to join equipment installer with wolf's auto upgrader
LV : Initial help displaying results

anyone else who has helped me as I scripted this


Most of the comments below are from previous versions of the script, just because there is a comment stating a problem, does not mean it still applies to this version, infact at the time of writing this there were no adverse comments.

[reinhart_menken]

I'm afraid I'm still not very clear on how the combined version works, though I know how the seperate version work. If I were to add an equipment other than the ones limited in the Auto-Upgrade (such as maybe...weapons), then it would be automatically installed as well? Let's say I add HEPT, 25MJ shield, and softwares to one of my equipment docks, they can all be automatically installed?

Does this support wares added by other scripts or just vanilla wares? Thanks!

[gomle]

Thanks Shovinus

I have found a couple of bugs

1. There is no option in the installer to actually install the rudder and engine tuning. The code may be there, but the text to show the option to choose to install them (text and installbutton) is not there. Thus this also results in me getting stucked in that install message, I can not click it out. So I can not see any new messages coming in, it only says "1 more message" or "2 more messages", but I can not read them, because I am stuck in your installer message. To get out of your installer message, I actually had to install some software I already had installed, just to get out of the message, as there where no other option.

2. Autorestock does not work anymore if you are located in another sector while you try to install software in a ship docked at station. So the last bug you fixed in the Equipment installer you may have forgotten to include in this script?

3. I think the autoinstaller need to be changed, so it does not autoupgrade ALL ships docked at the station. I landed some Nova's and wanted to upgrade them, but also had an Orca and a Hercules and a Hyperion and 7 Freighters docket at the same station, and looking at all the money that dissapaired from the station account when I upgraded those fighters I am sure all the other ships got upgraded too even if they already where fully upgraded. It cost some millions in wasted money that went into cargo space extention and software on all those other old ships.
I think the autoinstaller should be changed so you have to pick ONE ship to autoupgrade, instead of as it works now, it upgrades EVERY ship docked at the station.

The benefit of having autoupgrade is actually lost if you have to undock all other ships before you upgrade those who should be upgraded. Autoupgrade is to save work and time, and money, but if you have to do a truckload of work to undock other ships first, then upgrade remaining ships that should be upgraded, then dock the old ships back again, then there is no timesaver in having autoupgrade.

Hope you understand?

[gomle]

Another suggestion:

Maybe there could be different options for autoupgrade types.

Equipping pure fighters does not need the trade command software extentions as an example, so if in current version you upgrade fighters, then you waste money.

There could be one option to upgrade pure fighters, and one other option to upgrade freighters, so they get different configurations based on what software extentions they usually need?

[Shovinus]

Yes I was going to suggest to Wolf the he change his autoupgrade so you could customise it, also it should have 5 options first when you click auto install:
1) Install for all ships Will install upgrades in all landed ships
2) Install for all fighter ships Will install upgrades in all landed M5/M4/M3
3) Install for all carrier ships Will install upgrades in all landed M1/M2/M6/M7/TL
4) Install for all transporter ships Will install upgrades in all landed TS/TP
5) Select ship to install Will install upgrades in a landed ship you choose

And there should be an extra menu option in command console called Customise upgrades:
1) Customise fighter upgrades Will allow you to customise the upgrades for M3/M4/M5
2) Customise carrier upgrades Will allow you to customise the upgrades for M1/M2/M6/M7/TL
3) Customise transporter upgrades Will allow you to customise the upgrades for TS/TP
4) Display custom lists Shows you a list of all the upgrades you have chosen for each ship type

If for example you click install all ships it will check, every ship which it is installing upgrades in, and see which upgrades it should install from your list

The list you can choose from when customising would be all vanilla upgrades.

When you first recieve the software it would be configured to setup the customise lists as appropriate

Cheers for the bug report, unfortunately I dont have access to X3 now so I cant do anything about it until monday. I don't know why it doesn't work when you are out of a sector, there is actually nothing in the script that should lead to that, have you tried clicking activate autorestock again when you are out of the sector? If auto restocker stops this normally solves most problems. Next week I will have 5 days to work so I will spend all time wrangling out bugs and setting up the above options. I will of course keep needing someone to check because it is often hard to test on my computer, as it wont detect conflicts.

The auto upgrader is not my software, and the merge between our two scripts did not change his script in anyway other than making it necessary to have the licenses

[Shovinus]

This is a basic list of where mine and Wolf's scipt overlap, all the upgrades need you to acquire licenses in order for you to install them at a HQ/Equipment Docks/Trading Station.
Some can be installed by you from your stock (if it is stocked by auto restocker) and some by the Auto Upgrader, some by both.
No hardware other than upgrades requires licenses, but auto restocker and auto upgrades will not install them.
Hope this helps you all.
Vanilla Wares : License : Auto Upgrades : Autorestocker
Best Buy Locator : YES : NO : YES :
Best Selling Price Locator : YES : NO : YES :
Boost Extension : YES : NO : YES :
Cargo Bay Extension : YES : YES : YES :
Docking Computer : YES : NO : YES :
Duplex Scanner : YES : NO : YES :
Ecliptic Projector : YES : NO : YES :
Fight Command Software Mk1 : YES : YES : YES :
Fight Command Software Mk2 : YES : YES : YES :
Freight Scanner : YES : NO : YES :
Jumpdrive : YES : NO : YES :
Mineral Scanner : YES : NO : YES :
Navigation Command Software MK1 : YES : YES : YES :
Ore Collector : YES : NO : YES :
Singularity Engine Time Accelerator : YES : NO : YES :
Spacefly Collector : YES : NO : YES :
Special Command Software Mk1 : YES : YES : YES :
Trade Command Software Mk1 : YES : YES : YES :
Trade Command Software Mk2 : YES : YES : YES :
Trade Command Software Mk3 : YES : NO : YES :
Trading System Extension : YES : NO : YES :
Transport Device : YES : NO : YES :
Triplex Scanner : YES : YES : YES :
Video Enhancement Goggles : YES : NO : YES :
Engine Tuning : YES : YES : NO :
Rudder Optimisation : YES : YES : NO :

[gomle]

Your suggested modifications looks great, that would be nice improvements.

I look forward to test them.

I have discovered something strange and need to ask a question. After I installed this script, I no longer get the produced Goner Ranger ships to leave the headquarter, they are stuck there. I try to manually undock them also, but when I jump into one of them to undock manually, then I don't get access to the menu (klicking enter button on keyboard does not bring up any menu) so I can not leave the HQ. Have you any code/fix in your script that could produce such error in the Goner ships?

All other ships look to leave HQ without problem. The first Goner Ranger ship I reverse engineered and produced was able to leave the HQ, but that was before I installed this merged script of you and DeltaWolf

Thats why I suspect it could be something in this script that create the trouble, can you please take a look at it?

[Shovinus]

No there should be nothing in the script that does that, especially not so directly if anything like that were to go wrong it would stop all ships undocking not just goner rangers, and I dont believe it is part as Wolf's script, maybe you should ask someone like cycrow.

[gomle]

Thanks for your answer.

I looked at your/wolfs code, and could not see anything myself either that could be any obvious reason for the bug with just Goner ships, so I tried putting in a post in the tech support forum, but it look like they are not will ing to help as they do not support games with third party scripts installed. So I just have to live with that bug, and as you say, I don't think it has anything to do with your script.

BTW, your script is working very well now, looking forward to coming version.

[Shovinus]

Ok you may have to wait a while I'm sorry to say, something has come up and I can't script for about a week, sorry but good that everything is ok.

[Shovinus]

Zip download version now available for those who can't download cycrows installer

[reinhart_menken]

This is a great script, but I think it's lacking just a few minor things - a cancel button and a remove ware button.

It would be nice if I could just cancel my order if I changed my mind, instead of having to choose those 5 groups. And, it would also be nice if I could remove a certain upgrade that I no longer want in one of my stations (just for asthetics sake).

Otherwise this is a very useful and cool script

[Shovinus]

A cancel button would be useful i admit, but inserting a cancel into every group would mean increasing the groups (the max number of answers you can have is 5)

[LV]

then have the 5th option open up another question window with those values

[Shovinus]

currently all 5 are used there are 26 values to choose split into 5 groups each with 5 answers the last group contains 5 answers but one leads to another questions which gives a further 2 answers making a total of 26 answers if you understand, it is possible hterefore to do more, but it becomes alot more complicated, so instead next time i will make it without cancel but if you click something you have already installed it will not charge you again.

[cleggs]

got this all loaded in played the mission got the equipment installer and put in loads off goodies and saved the game .
but when i re loaded it all the insaller was gone and i was being asked to do the mission again so i did it again went through installing it again .saved then same thing happend is there a fix for this that i have missed

[LynkDead]

EDIT: Threads got merged, my post no longer applies

[Shovinus]

Updated Version: Way better please download, fully customiseable wares list with 3 differeing groups, and group installation selection, along with single ship install. ENJOY!!!!!!!

[cleggs]

thanx Shovinus i d/l and installed it works fine exept all ships owned by my hq have had there trade command mk1 removed and i cant transfer or buy another for these ships??

(i set the h/q to be able to sell all the trading extensions)

any help plz

[Shovinus]

I have no idea why that is happening, there is nothing in the script to make this happen, also it should install, not uninstall, can you give me a bit more detail about what has happened?

You do realise before it will install anything you must have purchased the necessary licenses from the Install option? have you purchased the license for this? To find out just go to the station you think it is in and see if there is the software as an option.

I will try and help you more on monday when I return home if this hasn't fixed the problem.

EDIT: Also to load wares into your station you need to activate the autorestocker.