Version 2.00 - Download here - courtesy of Xai Corp
You will need to update X3:R to version 2.5 in order to use this script, as it requires Mission Director functionality.
This script will allow you to transfer wares by means of a GUI-like interface between any two player owned ships docked at the same location. (I'm muscling in on B-O'Fs territory a bit here... sorry mate!) It works with all wares on the ship including equipped items and software/upgrades (except inbuilt software such as Trade Software Mk1 on TSs.) A plug for B-O'Fs script by way of compensation - his script is still more versatile than this one.
This is a (fairly radical) metamorphosis of the Software and Upgrade Transfer script, which is now so different I decided it needed both a new name and its own thread. (I will keep that version available, although I likely won't develop it further.) For this release, I've tried to make the interface as informative and easy to use as possible. In some ways, I like it more than the standard transfer interface! I'd be interested to hear anyones opinion on how to improve it.
Big thanks to SymTec Ltd and B-O'F, for their libraries (STLs Incoming Question Handler, and B-O'Fs Numeric Entry library,) both of which are used by this script.
Piccy of the interface used:
From the readme:
Readme wrote:Universal Ware Transfer v2.00 by eladan
This package will allow you to transfer wares between any two ships docked at the same location by means of a GUI-like interface.
Upon installation of this script, the command "Universal Transfer Wares" will be made available in the General menu of the command console. Upon running this command on any ship you own, if conditions are met for a transfer to take place (the ship is docked, and there is a ship to transfer to,) you will receive an incoming message. The incoming message, when opened, will show a numbered list of the ships which are docked in the same location. Selecting the number next to the ship you would like to transfer to will open another screen where a combined list of all wares (equipment, normal wares, software and upgrades) on both ships is displayed down the center of the screen, one ware per line. The amount of each ware belonging to the ship the command was run on is listed to the left side of the corresponding ware, and the amount of each ware belonging to the ship selected for transfer is listed to the right of the coresponding ware.
To the top left, three lines display the name of the ship the command was run on, its ID for further identification, and the maximum cargo class it can carry, as well as the current free cargo space. The top right has three lines similarly displaying the same information for the second, selected ship. The middle top displays the currently selected mode of transfer, with the transfer mode being a selectable button. Clicking on the button will cycle the mode through five available modes - transfer in units of 1 (default,) units of 10, units of 100, units of 1000, or numeric entry.
Each line of wares will allow you to (virtually - see below) transfer amounts back and forth between the two ships by means of two 'add' buttons. As long as conditions allow the transfer to take place, the button will be selectable. The button to the left of the ware will transfer wares in amounts determined by the current mode to the left side ship (and subtract a similar amount from the right side ship.) The reverse is true for the button to the right of the ware. If a transfer is selected which would transfer more than is available on the ship being transferred from, or if the receiving ship doesn't have enough cargo space to accept all items being transferred, the amount which could legally be transferred will be moved instead. Wares where the entire line is coloured red indicates that one of the ships has a maximum cargo class too small to be able to transfer any of that ware. If the 'numeric entry' mode is selected, clicking on one of the 'add' buttons will bring up a calculator-like keypad which will allow you to enter the amount you would like to transfer.
The colours of the numbers of wares on each ship indicate whether the amount was the original amount which was present prior to transfer (the number is grey,) there is more now than prior to transfer (number is green,) or less than prior to transfer (number is red.) Installed equipment for each ship is indicated by (eq) next to the appropriate ware for that ship.
If there are too many wares to fit on one screen, buttons to the bottom left and right labelled 'Next Page' and 'Previous Page' will allow you to navigate through all the wares available.
All transfers are virtual transfers only, until the 'end transfer' button is selected. Transfers are remembered when you change page using next and previous buttons. To get back to the state that existed prior to any changes, selecting the 'clear' button will reset all amounts to what they were originally. Selecting 'clear' then 'transfer selected' is equivalent to canceling the transfer.
If the 'add' button next to a ware is unselectable, one of the following conditions is true.
- The transferring ship doesn't have any of that ware on board
- The receiving ship doesn't have the cargo space to accept even 1 unit of that ware
- The ware being transferred is an upgrade or software, and the ship already has that upgrade/software.
This script uses SymTec Ltds excellent Incoming Question Handler library, as well as B-O'Fs Numeric entry lib, which also relies on the same library.
Q: It doesn't work! What do I do?
A: If you are trying to do a transfer, and all conditions are met, but it still doesn't work, you may need to reset the mission director. You do this by hitting the <Enter> key on the number pad when not docked, then clicking on the "reset mission director" button near the bottom. You may then need to save and reload.
Resources used: textfile and page id 8250, General Command 24
v2.00 - Radical overhaul, rereleased as Universal Ware Transfer
v1.00 - Initial release as Software and Upgrade Transfer