Version: 3.3.02 (2010-06-02)
Scripter: Lucike
Abbreviation: the CLS MK1
Thread for development version
Bonuspack index

Overview
This software supports the pilot in coordinating his internal production logistics. It will enable a pilot to collect orders from different consumers within your enterprise and coordinate them with chosen suppliers. Therefore, it is possible to deliver the products from several suppliers of a single resource to different consumers.
Consumers will generally be sorted and supplied according to how urgently they need the wares. Stations will only be considered for a delivery if they have less than 95% of the storage space filled. The same principle applies to your producers, who will only be allowed to ship wares if their stores are at least 5% full. Put in a different way, stations will not receive wares if they are almost full, and suppliers will not send out wares if they are almost empty.
Over time the pilot will learn to use this software more efficiently, because nobody starts out as an expert. Additionally, he might participate in special training courses. These training courses are offered in the pilot's homebase at certain time intervals.
The software was originally developed by an Argon software engineer and as such is being sold in every Argon Equipment Dock. It is also available in the Trading Station located in Herron's Nebula.
- Collect orders from different consumers within your enterprise and coordinate them with chosen suppliers
- Deliver products from several suppliers of a single resource to different consumers
- ...the pilot will use the Jumpdrive technology, and even take care of his/your ship.
- ...the pilot will communicate with other pilots, paying close attention to the commercial radio network and will not enter any sectors in which enemy ships have been reported

Quick Start
- Equip a TS class transporter with Navigation Commands Software MK1 and Commodity Logistics Software MK1
- Assign a homebase
- From your ship's Trading Menu, choose ``Start internal Commodity Logistics'', then select product and price with the command ``Homebase products''
- From your ship's Trading Menu, choose ``Start internal Commodity Logistics'', and select a number of stations with the command ``Suppliers and Consumers''
- Choose the command ``Start internal Commodity Logistics'' in your ship's Trading Menu.

Pilot qualifications
Apprentice
The apprentice is able to collect one product from one supplier and to deliver it to up to three consumers (excluding equipment docks and trading stations). The apprentice is carrying out his probationary period in your enterprise and doesn't get a salary during this time.
Courier
The courier is able to collect two products from up to two suppliers and deliver them to up to five consumers. Additionally, he will be able to deliver commodities to equipment docks and trading stations. The courier receives a wage of 10 credits per Mizura flown, paid after completing each trip.
Supplier
The supplier is able to collect three products from up to three suppliers and deliver them to up to five consumers. Additionally, he will be able to supply TL class ships. He will also equip his ship with more speed and agility, and fighter drones if they can be purchased in the current sector. The supplier receives a wage of 15 credits per Mizura flown, paid on completion of each trip.
Cargo Messenger
The cargo messenger is able to distribute four products from five suppliers to ten consumers. He is also able to use modern Jumpdrive technology to move around more quickly. The cargo messenger is paid a wage of 30 credits per Mizura flown, paid after each trip.
Forwarding Agent
The forwarding agent is able to distribute five products from five suppliers to ten consumers. Furthermore, he pays close attention to the commercial radio network and will not enter any sectors in which enemy ships have been reported. The forwarding agent is paid a wage of 35 credits per Mizura flown, paid after each trip.
Logistician
The logistician is able to distribute a unlimited number of products from ten suppliers to twenty consumers. Furthermore, he will repair his ship on his own by visiting a shipyard if necessary. The logistician is paid a wage of 40 credits per Mizura flown, payable after each trip.

Instructions
The main command is started from the Trade Menu. The command ``Start internal commodity logistics'' is visible when you installed Commodity Logistics Software MK1 and Navigation Command Software MK1 in the ship and have assigned a homebase. The command ``Start internal commodity logistics'' also includes the possibility of further configuration.
Important: The command is visible only when there is a pilot on the vessel or the ship is docked, in order for a pilot to enter the vessel.
Equipment and Prerequisites
- A fighter, bomber, corvette or transport ship (M3, M4, M5, M8, M6, TM, TS, TP or TL), with homebase set.
- Navigation Command Software MK1
- Commodity Logistics Software MK1 (7,944 cr)
- Pilots of TL-class ships must be at least 'Cargo Messenger'
- Fight Command Software MK1 (optional: change the behaviour at contact with the enemy)
- Fight Command Software MK2 (optional: changes, additional to Fight Command Software MK1, are made to the pilot's the behaviour at contact with the enemy)
- Jumpdrive (optional: can be utilized after a special training course)
- Transporter Device (optional: used if big ships like TL class transporters are chosen as a destination and the transporter may not dock at the ship)
All of the settings can be entered from the main menu.
Trader settings
In the menu Trader Settings you can change settings, additionally you can see information about your pilot -- not only his Status and homebase, but also Time of duty, Total time, Payment rolls and his achievements.
Delete accounting information
With this option you can delete your pilot's accounting information. (NB. Once done, there's no possibility of undoing this, therefore you will be asked to confirm this step again.)
Take trainings
Normally, all the pilots will participate in special training courses enabling them to use the software more efficiently. If you don't want this facility, you can change it here.
Trader salary
The pilot's wages are paid from your main-account. You can change this here.
Fire trader
If you have no further use for this pilot you can dismiss him. The ship must be docked at any station, without any tasks. (NB. Once done, there's no possibility of undoing this, therefore you will be asked to confirm this step again.)
Reassign trader
Your pilot needs a bigger/different vessel, you can reassign him to a new ship. Both ships, the new and the old one, must be docked at the same station. After choosing this option, you'll get a list of docked candidates. Choosing a ship which has a working pilot onboard will swap the pilots. Each pilot will take all of his existing data with him to his new ship.
Restore defaults
This command resets these settings to their default values.
Homebase products
In this list you'll find all the products you can collect from suppliers and deliver to consumers.
Products
Here you can see all the products of the homebase. The option 'Add product' is only visible, if the pilot is able to work with additional products. You can delete an existing product from the pilot's listing by choosing it again.
Add product
Adds a product.
Sort ware list by ware group
Here you can sort the ware list by ware group. This is only for information/overview and will not change any behaviour of your pilot.
Sort ware list alphabetically
Here you can sort the ware list alphabetically. This is only for information/overview and will not change any behaviour of your pilot.
Delete product
This option will delete the whole product list.
Suppliers and Consumers
Here you can view and change the existing lists of suppliers and consumers. The order in which consumers are assigned does not matter -- the pilot will always visit consumers in order of urgency . However, suppliers are visited in the order in which they were assigned to the software. You can change the way in which suppliers are visited in the Supply conditions.
Supplier
Here you can get an overview of all your suppliers. You can also add a new supplier or delete existing suppliers.
Add Supplier
After choosing a sector you'll get a list of possible suppliers. You can add shown suppliers to the pilot's list one after another. So it's possible to quickly choose all of the stations in a sector. Delete an existing supplier from this list is done by choosing the supplier again.
Consumer
Here you get also an overview of all of your existing consumers. You also can add a new consumer -- and delete existing ones.
Add Consumer
After choosing a sector you'll get a list of possible consumers. You can add shown consumers to the pilot's list one after another. So it's possible to quickly choose all of the stations in a sector. Deleting an existing consumer from this list is done by choosing the consumer again.
Delete stations list
You can delete here the pilot's entire station list.
Supply conditions
Here you can change the conditions under which your pilot visits consumers and suppliers.
Minimum storage space filled -- Supplier
Normally, the pilot will collect products from suppliers if their storage space is above the minimum of 5 percent full. You can change this limit here.
Minimum storage space filled -- Consumer
The pilot always visits consumers in order of urgency, but only if the consumer's storage space is at least 5 percent below maximum. You can change this limit here. This means, the storage space of the consumer is filled with 96%, this consumer will not be served. With 94%, he will be served.
Freighter cargo bay
Producers will be visited if the CLS-Pilot can fill his cargo bay at least with this percentile number. Setting this option to 101% will disable this condition.
Fly to supplier exceptionally
The pilot normally visits the suppliers in the order that you entered the stations. This option tells him to prioritize the suppliers that are nearest to full.
Dock with ship only in the same sector
If the delivery target is a ship, and this jumps away right before the CLS-pilot reaches it, the pilot will skip his current job.
Wait for request signal
If delivery target is a TL, CLS pilot can wait for a request signal, telling the pilot if the target needs his products.
Quit working in homebase
With this option, a controlled termination of CLS is possible. The pilot will stop CLS in his homebase once his job is done.
Restore defaults
This command resets these settings to their default values.
Jumpdrive settings
The pilot can use the modern Jumpdrive technology once he is at least Cargo Messenger. Here you can change the conditions under which the Jumpdrive is to be used.
Use Jumpdrive
In normal conditions, pilots don't use the Jump Drive. You can change this here.
Jumpdrive energy
If you don't change this order, the pilot will hold a Jumpdrive energy reserve of 10 percent of his cargo space. If his journeys are very short or very long, you can change his Jumpdrive energy reserve here.
Minimum jump range
To conserve jump-drive energy you can set your pilot a minimum-jump-range.
Restore defaults
This command resets these settings to their default values.
Automatic naming
Renaming a lot of pilots manually can be hard work. By choosing the Auto-naming option, you enable the pilot to do this work for you, even providing you with some more information.
Configure automatic naming
Choose the option you like best...
Here you choose the way the pilot will rename his ship. You can see here also a description of the naming convention used.
Ship number
A ship number should appear in the ship's name. Enter the number here.
Factory number
A factory number should appear in the ship's name. Enter the number here. All the ships assigned to this station will use this number.
Restore defaults
This command resets these settings to their default values.
Configure reports
The pilot will inform you of certain events occurring during his business dealings. Some of them can be switch off here.
Promotions
The pilot will inform you when he has completed a training course successfully. You can switch this off here.
Enemy sightings
The pilot will inform you about enemy movements in the sectors he's visiting. You can switch this off here.
Acoustic signals at messages
All the pilot's messages will be sent without a sound. You can change this here.
Trade log
The pilot can write every transaction into your business log. You can switch this on here.
The log can be found in the directory where your save-games are. It's called 'log1504.txt'. Very useful to determine what your pilot is really doing the whole time...
Analysis to log
The pilot copies all his data to your business log. Also, he can report what his current activity involves.
The log can be found in the directory where your save-games are. It's called 'log1000.txt'. Very useful for analysis and why a pilot is not flying. Also, if you have any questions about CLS / about a certain pilot, cause he's not doing what you expect him to do -- please post it... then it's easier to help you...
Restore defaults
This command resets these settings to their default values.
Data storage
If you want more than one pilot fulfilling a task you can save working data here, to provide this data to other pilots.
Load data
Here you can choose stored data to assign to another pilot.
Save data
Here you can save the actual pilot's data. Also giving the data a name is possible.
Delete data
You can delete specified data.
Delete all data
You can delete all data slots.

Special Notes
Note:
You can change the lists mid-flight but the changes only become effective after the pilot has finished the current tour.
Jumpdrive:
If a Jumpdrive is installed, the pilot will supply himself with energy from the homebase. He may buy energy from other sources too, if he is not doing a chain-supply tour.
Enemy contact:
If the freighter has the Fight Command Software MK1, then the pilot may make his ship safer. He buys fight drones in the current sector and equips his ship with more speed and agility. If the experienced pilot has a Jumpdrive, then he can venture into unsafe sectors. If the freighter has the Fight Command Software MK2 and he can download the Missile defence system Mosquito, he will also buy a number of Mosquito missiles.
Transporter device:
It's possible to load TL-transporters with your freighters even when they cannot dock, so you will occasionally need the Transporter Device, which allows the pilot to transfer cargo directly to the TL-transporter. The TL must have stopped his engines, and be standing in space. If the freighter has to load a TL-transporter, and he doesn't have a transporter device, he will wait until the TL has docked to a station and follow him in order to transfer the cargo at the station itself. Sectors located far away will be only visited if the pilot has a Jumpdrive.
Headquarters:
If the pilot works for the headquarters, the size of his vessels cargo space is automatically the limitation of the cargo space in the headquarters. This rule is applied for every product. The Dockware Manager can overrule this, reserving for every product a specified cargo space.
Hint:
If you buy the Commodity Logistics Software at the software producer's offices at the Free Argon Trading Station in Herron's Nebula, the producer tries to provide qualified personnel. If you actually start the software at the trading station you might get lucky and receive qualified pilots from the very beginning.

Global Administration of CLS MK1 and MK2
The global administration provides an overview of all your CLS-Pilots. Not only can you send settings to all the other pilots, but make changes to individual pilots.
There are two ways to start global administration. You can define a hotkey, and you can reach it over the 'General' menu in your ship-commands, once your ship is docked.
Global Administration
Global Administration gives you the possibility to send one or more settings to all the CLS-pilots.
Therefore you choose the data-slot which should be sent. Of course, at least one data-slot must be stored (by any CLS-pilot). Now you can send this data-slot to all CLS-pilots with the command ``Send to all colleagues''. The command ``Send to sector colleagues'' will send the chosen data-slot only to the pilots with the same home-sector.
In the menu ``Send filter'' you'll find lots of filters, which data should be sent, and which pilots should get this information. You can filter the data-receiving pilots by type of ship, by class of ship or even by a part of the name of the ship. You also toggle between the information what should be sent. So you can define exactly what information pilots should get or not.
Even a reorganisation of all your data-slots is possible. To move a special data-slot from one position to another, first choose the slot which should be moved, then choose the new position. Slots which you can choose are shown in Yellow.
Deleting special data-slots is also possible by Global administration. Just choose the data-slot which should be deleted -- there will be no confirmation! With the command ``Delete all data'' all your slots will be deleted.