[SCR] Commodity Logistics Software [2009-11-22 - X3TC 3.2.04]

The place to discuss scripting and game modifications for X³: Terran Conflict and X³: Albion Prelude.

Moderators: Moderators for English X Forum, Scripting / Modding Moderators

Post Reply
sky669
Posts: 1145
Joined: Thu, 22. Feb 07, 11:10
x3tc

[SCR] Commodity Logistics Software [2009-11-22 - X3TC 3.2.04]

Post by sky669 » Tue, 4. Nov 08, 11:49


Commodity Logistics Software MK1 and MK2
(Version 3.2.04 - 22. November 2009)

[ external image ]

[ external image ] [ external image ] [ external image ]

Overview Commodity Logistics Software MK1 and MK2

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.
It also allows the pilot to plan a route. The pilot is instructed to follow a given route and make commodity transfers at each intermediate stop. This enables the pilot to carry out specific tasks within the company and buy/sell at different stations. The route will be followed repeatedly until the pilot receives new orders.
  • ...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
  • ...instruct the pilot to follow a given route and set the corresponding commodity transfer orders for each intermediate stop. This enables the pilot to fulfil special tasks within the company or even at different stations. The route will be followed repeatedly until the pilot receives new orders
  • ...the pilot will use the Jump Drive 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
[ external image ] [ external image ] [ external image ] [ external image ]

[ external image ] [ external image ] [ external image ] [ external image ]

[ external image ] [ external image ] [ external image ]



Installation Commodity Logistics Software MK1 and MK2

Download

-> Commodity Logistics Software MK1 and MK2 (Version 3.2.04)
-> Necessary "Libraries" (Version 3.4.04)(you must install them, reinstall them during updating !) V3.4.04
If the 'Libraries'-Link is broken, it means, Lucike has just updated the libraries. In this case - until I updated the links here, you can also download them here.

Don't bother, the name of the zip-file are german. Once installed, you have the english version.

-> Description Commodity Logistics Software MK1 and MK2 (PDF) ...still to come...

Prerequisites : X³ Terran Conflict Version 2.1(not compatible with X³ Reunion) !!


Activation of script editor

This not essential, but you should note that it will set your game to ***modified*** automatically.

If the script editor is activated, special script information will be displayed. Some players don't like this / maybe getting a bit confused. It is possible to use un-signed scripts without activating the script editor; this involves making changes to the init-files. However, even in this case you'll still get a ***modified*** game.

Installation

Just copy all the files from the zip-folder to your X3-TC directory. You will find the directories '\scripts..\' and '\t\..' in your installation directory. In the zip-file you'll also find some other directories and files, copy these into your X3-TC-directory as well, you may need them for administration and/or de-installation, later.

De-installation

In your X3-TC directory you'll find a file called '\scripts.uninstall\..' - from this file, copy 'setup.plugin.goods.delivery.pck' into your script-directory (\scripts\..). Run the game, load your latest game and the de-installation will be executed automatically. Once it's finished, you will be informed you via your log (-after about 10 to 20 seconds). Now save the game and you're done..

Deleting the scripts should be done using the batch-file 'Delete all Commodity Logistics Software Scripts.bat', located in your X3-TC main directory. After running this file, all of the CLS script-files will be deleted.

Important: You should not delete script files by yourself, they're part of your saved games.

Updating an older script version

Just copy all of the files from the zip-folder into your X3-TC directory, they are named '\scripts..\' and '\t\..'. In the zip-file you'll also find some other directories and files, copy these into your X3-TC-directory, as you may need them for administration and de-installation at a later stage. The newer ones will over-write the older files.

Please don't forget also to reinstall the libraries !!

A batch-file called 'Delete old Commodity Logistics Software Scripts.bat' is located within the file, 'scripts.delete\..'. Using this, you can delete old and unused scripts. If you don't want to do this, it's ok, but it will help you to keep your scripts-directory nice and tidy.

Any ships using the option 'Inform me, when the task is fulfilled' will inform you automatically, because they stop using their current scripts and restart the new ones. So, for all other purposes you can ignore these log-entries.


Description Commodity Logistics Software MK1

Tasks

The software supports the pilot by coordinating his internal production logistics. It will enable him to collect orders from different consumers within your enterprise and coordinate them with chosen suppliers. Thus, it is possible to deliver the products from several suppliers of a single resource to different consumers.

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.

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 10% full. Put 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, nobody starts out as an expert. Additionally, he might participate in special training courses by utilizing his trading computer extension. These training courses are offered in the pilot's homebase at certain time intervals.


Quick start
  1. Equip a TS class transporter with navigational software MK1 and Commodity Logistics Software MK1
  2. Assign a homebase
  3. From your ships Trading Menu, choose 'Start internal Commodity Logistics', then select product and price with the command 'Homebase products'
  4. From your ships Trading Menu, choose 'Start internal Commodity Logistics', and select a number of stations with the command 'Suppliers and Consumers'
  5. Choose the command 'Start internal commodity logistics' in your ships Trading Menu.
Pilot qualification

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 Jump Drive 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.


Equipment and Prerequisites
  • A small class ship/transporter (M3, M4, M5, M8, TM, TS, TP or TL) or a ship of the corvette class (M6)
  • 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)
  • Navigation Command Software MK1
  • Jump Drive (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)
  • Commodity Logistics Software MK1
Usage (Logistics for factories, equipment docks and TL class transporters):

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 navigational 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 only visible, if there is a pilot on the vessel or the ship is docked, in order a pilot can enter the vessel.


Main Menu

[ external image ]

All of the configurations can be entered from here.


Trader settings

[ external image ]

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 menupoint 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 already 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 will change all the data settings back to their defaults.


Homebase products

[ external image ]

In this list you'll find all the products you can collect from suppliers and deliver to consumers.

Products

[ external image ]

Here you can see all the products of the homebase. The menu point '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 menu point will delete the whole product list.


Supplier and Consumer

[ external image ]

Here you can view and change the existing lists of suppliers and consumers. It doesn't matter in which order the consumers are being selected. 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

[ external image ]

Here you get an overview over all your suppliers. You also can add a new supplier - and delete existing ones.

Add Supplier

After chosing 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

[ external image ]

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.
Delete 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

[ external image ]

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 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 has a lack from minimum 5 percent. 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.

Freigther cargo bay
Producers will be visited if the CLS-Pilot can fill his cargo-bay at least with this percentual number. Setting this option to 101 % will disable this condition.

Fly to supplier exceptionally
The pilot normally visits the suppliers in that order you entered the stations. But he also can visit suppliers in order to their storage space filled.

Dock with ship only in the same sector
Is the delivery target a ship, and this jumps away right before the CLS-pilot reaches it, the pilot will skip his current job.

Wait for request signal
Is delivery target 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 will change all the data settings back to their defaults.


Jump Drive settings

[ external image ]

The pilot can use the modern Jump Drive technology once he is at least Cargo Messenger. Here you can change the conditions under which the Jump Drive is to be used.

Use Jump Drive
In normal conditions, pilots don't use the Jump Drive. You can change this here.

Jump Drive energy
If you don't change this order, the pilot will hold a Jump Drive energy reserve of 10 percent of his cargo space. If his journeys are very short or very long, you can change his Jump Drive energy reserve here.

Minimum jump range
To conserve jump-drive energy you can set your pilot a minimum-jump-range.

Restore defaults
This will change all the data settings back to their defaults.


Automatic naming

[ external image ]

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...

[ external image ]

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 will change all the data settings back to their defaults.


Configure reports

[ external image ]

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 was completing 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 'log8000.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 ypu expect him to do - please post it... then it's easier for me to help you...

Restore defaults
This will change all the data settings back to their defaults.


Data storage

[ external image ]

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

[ external image ]

Here you can choose stored data to assign to another pilot.

Save data
Here you can save the actual pilots 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.

Jump Drive: If a Jump Drive 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.

Travel Drive: If a travel drive is installed, the pilot will supply himself with energy from the homebase. He also buys energy from other sources.

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 Jump Drive or travel drive, 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 Jump Drive.

Headquarter: If the pilot works for the headquarter, the size of his vessels cargo space is automatically the limitation of the cargo space in the headquarter. This rule is applied for every product. The Dock Ware 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.


Overview Commodity Logistics Software MK2

Overview

This software allows the pilot to plan a route. The pilot is instructed to follow a given route and the corresponding commodity transfer orders for each intermediate stop entered. This enables the pilot to fulfil special tasks within the company or even at different stations. The route entered will be followed repeatedly until the pilot receives new orders.

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.

Over time the pilot will learn to use this software more efficiently, nobody starts out as an expert. Additionally, he might participate in special training courses by utilizing his trading computer extension. Those training courses are offered in the pilot's homebase at certain time intervals.


Quick start
  1. Equip a TS class transporter with Navigation Software MK1 and Commodity Logistics Software MK2
  2. Choose "Add/remove intermediate stops" in the Additional Ship Commands Menu of the ship, select the method of attaching to the waypointlist (0 = add the new entry to the end of the existing list), choose the target station, the product, the price and the number of products to deal with (a number below 0 means selling/unloading)
  3. Choose in the ships Trading Menu "Start external commodity logistics"
Pilot qualifications

Apprentice
The apprentice is able to use up to 4 stops in total in the tour. 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 use up to 6 stops in total in the tour. Additionally, he will be able to deliver commodities to equipment docks and trading stations. The courier gets a wage of 20 credits per mizura flown, paid after completing each trip.
Supplier
The supplier is able to use up to 10 stops in total in the tour. Additionally, he will be able to supply large ships. He buys in the current sector fight drones and equips his ship with more speed and agility. The supplier gets a wage of 25 credits per mizura flown, payable upon completion of each trip.
Cargo Messenger
The cargo messenger is able to use up to 15 stops in total in the tour. He is also able to use modern Jump Drive 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 use up to 20 stops in total in the tour. 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 not restricted in the amount of stops in his tour. 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.


Equipment and Prerequisites:
  • A small class ship/transporter (M3, M4, M5, M8, TM, TS, TP or TL) or a ship of the corvette class (M6)
  • 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 behaviour on contact with the enemy)
  • Navigation Command Software MK1
  • Jump Drive (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)
  • Commodity Logistics Software MK2
Usage (Logistics for factories, equipment docks and TL class transporters)

The main command is initiated over the Trade Menu. The command "Start external commodity logistics" is visible when you install Commodity Logistics SoftwareMK1 and Navigation SoftwareMK1 in the ship and have assigned a homebase. The command "Start external commodity logistics" also includes the possibilities of configuration.

Important : The command is only visible, if there is a pilot on the vessel or the ship is docked, in order a pilot can enter the vessel.


Main Menu

[ external image ]

All of the configurations can be entered from here.


Trader settings

[ external image ]

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 menupoint 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 already 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 will change all the data settings back to their defaults.


Waypoints

[ external image ]

You can add additional waypoints in this menu. Even an overview with the different stops is included.
At every stop you can assign not only one waypoint. The number of stops is limited by experience/status of the pilot.

Adding a station with waypoints

First, choose 'Add station' and then - like always - choose sector and station.

[ external image ]

Then select the task for this station. Buying or selling is on every station possible, loading or unloading only on stations belonging to your enterprise. Refueling your freigther with Jump Drive energy is only possible on stations, which are selling energy cells. You even can tell the pilot, just to dock on a station. Then he will wait for 1 mizura, till he continues.

[ external image ]

Once you've chosen buying, selling, loading or unloading, you choose in the next step the product to deal with. When buying or selling, you can choose all products, with loading/unloading only resources.

[ external image ]

While selecting the price, you have different possibilities. Either manually, or the minimum/average/maximum price of the product, you've chosen in the previous step.

[ external image ]

Last step - choose the amount of ware to transfer. Like in the previous step you have different options - either manual input (also up to...), full or half cargospace. While buying or selling, you cannot choose half cargospace.


Removing a station

[ external image ]

Select 'Cut or remove station', then 'Remove station'.

Adding a waypoint at a station/stop

[ external image ]

You'll get this menu by choosing a waypoint. For adding a waypoint at a special station, choose the corresponding point of the menu.
The other steps are similar to the inputs while adding a station (Adding a station with waypoints)

Editing a waypoint of a station

[ external image ]

You'll get this menu by choosing a waypoint. For editing a waypoint at a special station, choose the corresponding point of the menu.
The other steps are similar to the inputs while adding a station (Adding a station with waypoints)

Deleting a waypoint of a station

[ external image ]

You'll get this menu by choosing a waypoint. For deleting a waypoint from a special station, choose the corresponding point of the menu.

Cut a station and paste it anywhere else

[ external image ]

First, choose "Cut or remove station", then "Cut station". The station will be removed and copied to a clipboard.

[ external image ]

A new point from the menu will get visible, if there is a station in the clipboard. Choose "Insert station", and the station from the clipboard will be inserted to this position. The clipboard will be deleted.

Cut a waypoint and paste it anywhere else

[ external image ]

You'll get this menu by choosing a waypoint. Now choose "Cut waypoint". The waypoint willbe removed and copied to a clipboard.

[ external image ]

A new point from the menu will get visible, if there is a waypoint in the clipboard. Choose "Insert waypoint", and the waypoint from the clipboard will be inserted to this position. The clipboard will be deleted.


Generate waypoints

This function enables the software generating waypoints automatically. First choose the sector, from where this process should be started, and the (maximum) number of jumps.
After this step, choose the wares, task, price and the amount to transfer.
Now the CLS will search for all the stations fitting your input and will add the results to the list of your waypoints.


Supply conditions

[ external image ]

Minimum delivery amount for collecting
Pilot only flies to a waypoint, if he can at least collect 5% of the wanted amount. Change this setting here.

Minimum delivery amount for delivering
Pilot only flies to a waypoint, if he can at least deliver 5% of the wanted amount. Change this setting here.

Dock with ship only in the same sector
Is the delivery target a ship, and this jumps away right before the CLS-pilot reaches it, the pilot will skip his current job.

Wait for request signal
Is delivery target a TL, CLS pilot can wait for a request signal, telling the pilot if the target needs his products. The target ship must be able sending this radio messages.

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 will change all the data settings back to their defaults.


Jump Drive settings

[ external image ]

The pilot can use the modern Jump Drive technology once he is at least Freighter Pilot 2nd class. Here you can change the conditions under which the Jump Drive is to be used.

Use Jump Drive
In normal conditions, pilots don't use the Jump Drive. You can change this here.

Jump Drive energy
If you don't change this order, the pilot will hold a Jump Drive energy reserve of 10 percent of his cargo space. If his journeys are very short or very long, you can change his Jump Drive energy reserve here.

Minimum jump range
To conserve jump-drive energy you can set your pilot a minimum-jump-range.

Restore defaults
This will change all the data settings back to their defaults.


Automatic naming

[ external image ]

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

[ external image ]

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 will change all the data settings back to their defaults.



Configure reports

[ external image ]

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 was completing 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 'log8000.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 ypu expect him to do - please post it... then it's easier for me to help you...

Restore defaults
This will change all the data settings back to their defaults.


Data storage

[ external image ]

You want more than one pilot to fulfil a task, you can save his working data here, in order to provide it to other pilots.

Load data
Here you can choose stored data/assign stored data to a pilot.

[ external image ]

Here you can choose stored data to assign to another pilot.

Save data
Here you can save the actual pilots 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.

Jump Drive: If a Jump Drive 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.

Travel Drive: If a travel drive is installed, the pilot will supply himself with energy from the homebase. He also buys energy from other sources.

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 Jump Drive or travel drive, 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 Jump Drive.

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 start the software at the trading station you might get lucky and receive qualified pilots from the very beginning.


Global Administration of Commodity Software MK1 and MK2

[ external image ]

The global administration an overview from all you CLS-Pilots. You can not only send settings to all the other pilots, but aswell make changes on certain pilots.

There are 2 ways to start global administration. You can define a hotkey, and you can reach it over the command 'General' (???) in your ship-commands, once your ship is docked.


Global Adminstration

[ external image ]

Global Administration gives you the possibility to send one ore more settings to all the CLS-pilots

[ external image ]

Therefor you choose the dataslot, 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.

[ external image ]

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 shoud get or not.

[ external image ] [ external image ]

[ external image ]

Even a reorganisation of all your dataslots 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 positon. Slots, you can choose, are shown in 'Yellow'.

[ external image ]

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.


Technical Data Commodity Logistics Software Mk1 and Mk2

Language file
8001-L044.xml (ID 8001)
8001-L049.xml (ID 8001)

Command-Slots (Changing Command Slots (German))
COMMAND_TYPE_TRADE_17 (417)
COMMAND_TYPE_TRADE_18 (418)
COMMAND_TYPE_CUSTOM_17 (717)
COMMAND_TYPE_CUSTOM_18 (718)
COMMAND_TYPE_CUSTOM_19 (719)

Object Task
Global (Restart)
Ship Tasks 0, 40 and 41

Official Shorts
"die WLS"
"the CLS"


< Keywords: ScripterLucike, Scripts, Commodity Logistic software, Loop, Logistic, supply, automatic buying selling >
Last edited by sky669 on Sun, 22. Nov 09, 14:55, edited 71 times in total.

sky669
Posts: 1145
Joined: Thu, 22. Feb 07, 11:10
x3tc

Post by sky669 » Tue, 4. Nov 08, 11:49

Download

-> Commodity Software MK1 and MK2 (Version 3.2.04)
-> Commodity Software MK1 and MK2 (Version 3.2.03)
-> Commodity Software MK1 and MK2 (Version 3.2.02)
-> Commodity Software MK1 and MK2 (Version 3.2.01)
-> Commodity Software MK1 and MK2 (Version 3.2.00)


History :

Version 3.2.04 - 22. November 2009
  • A CLS1-pilot sometimes ignored a HQ with limitations defined by the dock-ware-manager. Solved.
  • Several minor improvements
Version 3.2.03
  • With CLS1, a pilot with multiple destinations and same product was flying sometimes to all consumers. Solved.
  • Several minor improvements
Version 3.2.02
  • With CLS2, all the routines for minimum transport amounts got improved. Now you can define the minimum transport amounts for delivering and for collecting separated.
  • Several minor improvements
Version 3.2.01
  • Jumping into sectors with transorbital accelerators is not possible anymore. Instead pilots can use 'Jump Beacons'.
  • Several minor improvements
Related Topics : Jump Beacons, Military Transport, MEFOS Weapon System

Version 3.2.00
  • Added global management
  • Conditions for supplying ships/flying to ships altered.
  • Several minor improvements
Version 3.1.11 + 3.1.12
  • Adaption to the bonus-package
  • Several minor corrections
  • t-files were sometimes not loaded correctly - solved
Version 3.1.09 + 3.1.10
  • Sometimes it caused problems, when Aldrin was connected to the universe and lateron, this connection was disabled. Solved.
  • Corrected some minor mistakes in the analysis-log.
  • Pilots with the rank 'Cargo messenger' - and higher - can use TL's.
  • CLS pilots will eject their vessel just before getting destroyed. You have to rescue your pilots manually.
  • CLS-pilots .. Ils parlez francais. (but I do not ;-) )
    ---
  • A pilot, who could dock a vessel to a carrier, but there was no docking bay free, did not deliver his goods to the carrier - even a transporter device was installed. Solved.
  • Some other improvements - like always...
Version 3.1.08 - 17. April 2009
  • CLS-Pilots can jump into sectors without a jump-gate (Aldrin !)
  • Like always - some minor improvements
  • CLS-Pilots will wait 20 seconds, if delivering-target is a vessel. So they wait until this target has finished the jump.
Version 3.1.07 - 08. March 2009
  • CLS1 - improvements of collecting wares routines (3.1.06)
  • Some minor improvements (3.1.06)
  • CLS1 - optimization in collecting intermediate products
  • Analysis log improved, especially when working together with dock-ware-manager
Version 3.1.05 - 08. January 2009
  • CLS2 pilots can load ressources / unload products in your factorys
  • CLS2 - configuring 'load/unload'-waypoints, you won't be asked about the price
  • In the menu 'Supply conditions' you will find a new menu-point for stopping the CLS at certain conditions
  • CLS1 started to fly, when he could fill his cargo-room, even the stations-conditions were not fulfilled. Now you can alter such conditions...
Version 3.1.04 - 10. December 2008
  • Supplying moving targets - like TL's... - got improved again. Sometimes target ships did not stop - done
  • Debug message deleted
  • Big working lists in CLS2 were cutted sometimes - done
Version 3.1.03 - 3. December 2008
  • Supplying moving targets - like TL's... - got improved. Target Ships will wait longer
  • The target ship was jumping before the CLS pilot could reach it - the pilot still has a plan
  • Generating waypoints got improved. It's possible now, selecting only npc-stations or only own stations.
  • Optimized several routines
1. December 2008
Added some stuff in the operation manual. Especially supply conditions at CLS2, and more options, if your pilots are working together with TL's.

Version 3.1.01 - 27. November 2008
  • With CLS2 you can define a minimum transfer amount
  • While supplying ships, your pilots can take care if the target is in a combat situation
  • While supplying ships, the pilot can wait for a request
Information minimum transfer amount
Till now, your CLS2 pilot was flying all the time, he didn't care if there were enough products on stock or the target station was full or empty with a special product. Now you can also define this percentual-numbers in the menu 'Supply conditions'.

Version 3.1.00 - 27. November 2008
  • Phase beta is finished
  • Optimization from different ...things...
  • Apprentices can supply the HQ aswell
  • Added version info to the libraries
Information - libraries version info
The libraries are a collection of different 'routines' making your pilots working. It's used from CLS, CAG, EST, Mefos, SRD and Prospektor - short, most of Lucike's script. Without this libraries, you'll get an error.
Please make sure, always you are updating one of this scripts, also update this libraries...


Version 3.beta.08 - 23. November 2008
  • Generating waypoints got improved. Especially in special sectors...
Version 3.beta.07 - 17. November 2008
  • Pilots got 'degraded' while setting training courses to NO. Solved
  • The data slots got a reorganisation a last time. Therefor all the old data-slots will be deleted.
  • New names of the pilots, when participating on training courses
Version 3.beta.06 - 15. November 2008
  • Improved 'Analysis to log'
  • CLS2-Pilots can load/unload their vessel.
  • The pilots promoted even when they should not - solved.
  • Problems with TLs solved.
  • ReadText error - solved.
  • Overview of the pilots expenses improved.
Version 3.beta.03 - 4. November 2008
  • Improved 'Analysis to log'
  • French and Italian players can use now this english-version
Version 3.beta.02 - 3. November 2008
  • 1st official release
Last edited by sky669 on Sun, 22. Nov 09, 14:53, edited 45 times in total.

sky669
Posts: 1145
Joined: Thu, 22. Feb 07, 11:10
x3tc

Post by sky669 » Tue, 4. Nov 08, 11:49

to give you a very short overview over this software...

(the threads for cls in x3r you can find here CLS1 and CLS2 here. (thanks, jlehtone...) lot's of ideas...)

this software helps you doing product-redistribution (?) inside your company.
like in real life - you have a company with a lot of storage-places all over your country/world. there is no sense, if one storage place is full with a certain product, and all the others are empty.

so, in x3tc you have e.g. a komplex, where a million of crystals are produced for nothing (or just for selling...).
now, if you have another 5 energy-producers (energy-factorys ?), which need crystals, you can tell a vessel delivering the crystals from your mega-crystal-komplex to the others...

this is the internal commodity software.

with the external you can plan a route. means telling a freigther going to here, doing something, going to there, doing something .... and so on.
it's useful, when you want a npc-factory being delivered all time with resources... like a satellite-factory, tell your freigther, where to get the resources (and up to which price he should buy) - energy, majaglit, and the other stuff - and he will deliver all the time the factory.... you even can tell him, when the price for the output is ok for you, then he buys the stuff....

ok ?
Last edited by sky669 on Wed, 5. Nov 08, 14:43, edited 1 time in total.

ThisIsHarsh
Posts: 1135
Joined: Sun, 19. Oct 08, 18:46
x3tc

Post by ThisIsHarsh » Tue, 4. Nov 08, 12:04

This looks interesting, but I wonder, can you give examples of situations where this software would be useful?

XFree
Posts: 62
Joined: Fri, 22. Jun 07, 16:37
x3tc

Post by XFree » Tue, 4. Nov 08, 12:40

Great script but I wonder : if i'm a french player and playing with a 33 language parameter. How can I play with this script because language files are not in .XML but in .PCK and don't know HOW to open a .PCK.
Any idea?

User avatar
Lucike
Posts: 12969
Joined: Sun, 9. May 04, 21:26
x4

Post by Lucike » Tue, 4. Nov 08, 12:47

XFree wrote:Any idea?
After work I can clone the English language file, but you can open PCK files with a gz-packer (WinZip, WinRAR or 7-Zip).
Image

User avatar
enenra
Posts: 7150
Joined: Fri, 8. Apr 05, 19:09
x4

Post by enenra » Tue, 4. Nov 08, 12:50

XFree wrote:Great script but I wonder : if i'm a french player and playing with a 33 language parameter. How can I play with this script because language files are not in .XML but in .PCK and don't know HOW to open a .PCK.
Any idea?
The new .pck-Format can be opened with WinZIP or 7-ZIP. Just open it as an archive, extract the file and then add ".xml" at the end. ;)

User avatar
Lucike
Posts: 12969
Joined: Sun, 9. May 04, 21:26
x4

Post by Lucike » Tue, 4. Nov 08, 12:56

ThisIsHarsh wrote:This looks interesting, but I wonder, can you give examples of situations where this software would be useful?
... and I wonder, that you don't know what is the CLS. :) :D
sky669 wrote:this software helps you doing product-redistribution (?) inside your company.
like in real life - you have a company with a lot of storage-places all over your country/world. there is no sense, if one storage place is full with a certain product, and all the others are empty.

so, in x3tc you have e.g. a komplex, where a million of crystals are produced for nothing (or just for selling...).
now, if you have another 5 energy-producers (energy-factorys ?), which need crystals, you can tell a vessel delivering the crystals from your mega-crystal-komplex to the others...

this is the internal commodity software.

with the external you can plan a route. means telling a freigther going to here, doing something, going to there, doing something .... and so on.
UK_lawman wrote:I see there is a lot of confusion regarding CLS MK1 & MK2 & CAG..

Think of CAG as the enhanced version of Trade Command MK1 & MK2.

When using CAG for the first time on a new TS the pilot of the ship is a newbie, so he can ONLY buy resources and not sell. Its through buying resources that he will advance levels so he can not only sell but buy at the same time and also co-ordinate with his fellow homebased TS colleagues. I recommend you equip your new TS ships with a jump drive before starting them off with CAG as this often saves a lot of time later on.

CLS 1 & CLS 2 while fulfilling a specific purpose for supplying player owned factories and complex's, CAG is the one everyone should use first and foremost.

I have 7 factories that has a single TS assigned to each of them and because they use CAG they are able to supply and sell products from that factory on their own. Without CAG I would need double the TS ships to manage these factories. Large complex's would need 2 or more CAG equipped TS ships but thats still far fewer than if you were not using CAG.
Image

jlehtone
Posts: 21809
Joined: Sat, 23. Apr 05, 21:42
x4

Post by jlehtone » Tue, 4. Nov 08, 13:12

Lucike wrote:
ThisIsHarsh wrote:This looks interesting, but I wonder, can you give examples of situations where this software would be useful?
... and I wonder, that you don't know what is the the CLS. :) :D
Look at his join date. Looks like he has not felt the blessing of the SDS, its expansion to CLS Mk1 in the X2 era, and further evolution to the two scripts, CLS1 & CLS2, in X3R that I would call "raw power". :goner:

Harshly put:
These two scripts allow a great many things. Unbelievable possibilities for management. Just a minor glimpse of that might be found from the comments on the X3R CLS1 and CLS2 threads. And to add to the pain, go through this page from the pre-indexed Search too. ;)


I think the compression method is called "Deflate" and is provided by zlib (since it is included in the X3TC installation). Several compression programs do support that method. My favorite is gzip/gunzip.


Happy to see Machiel Software Corporation doing business. :D
Goner Pancake Protector X
Insanity included at no extra charge.
There is no Box. I am the sand.

Teladidrone
Posts: 644
Joined: Tue, 24. Aug 04, 11:41
x3tc

Post by Teladidrone » Tue, 4. Nov 08, 13:13

Will the CLS and CAG still share the same pilot experience?
Can we use CLS2 to train up pilots for later CAG duty again like it was in X3:R?

XFree
Posts: 62
Joined: Fri, 22. Jun 07, 16:37
x3tc

Post by XFree » Tue, 4. Nov 08, 13:17

Eh thanks all! Great work. No any kind of problem if I keep .XML language file instead of a pck?

User avatar
Lucike
Posts: 12969
Joined: Sun, 9. May 04, 21:26
x4

Post by Lucike » Tue, 4. Nov 08, 13:18

Teladidrone wrote:Will the CLS and CAG still share the same pilot experience?
Can we use CLS2 to train up pilots for later CAG duty again like it was in X3:R?
Yes, of course.
Image

User avatar
BugMeister
Posts: 13647
Joined: Thu, 15. Jul 04, 04:41
x4

Post by BugMeister » Tue, 4. Nov 08, 13:19

the software really comes into it's own when you are the owner of a station
- you no longer need to rely upon AI traders to keep the enterprise going

- you can assign your own ships to the station and give them instructions on how and where to distribute products
- you can also issue them with instructions to supply your station with any resources it may need for production..

as I see it the Mk1 version concentrates on the station itself and applies its logic according to the station's needs - hence the need for a homebase as a prerequisite

whereas the Mk2 version allows for external trading with stations other than the one you own yourself - and bases its logic solely on the customer's needs and the producers stock levels

- I assume a homebase isn't essential in this second case..??

- please correct me if I'm wrong on this - it's essential that the distinction is made..
- the whole universe is running in BETA mode - we're working on it.. beep..!! :D :thumb_up:

jlehtone
Posts: 21809
Joined: Sat, 23. Apr 05, 21:42
x4

Post by jlehtone » Tue, 4. Nov 08, 13:40

Teladidrone wrote:Will the CLS and CAG still share the same pilot experience?
I think that there is a broader question that would answer this and similar questions:

Is it possible to get a summary of differences between X3R CLS and X3TC CLS?

The way of configuration has obviously changed, thanks to better interface options in X3TC. But what else? Yes, I know, it gets hairy since some of us want to compare to the last signed X3R CLS, while others have wisely adopted the last unsigned X3R CLS.

Then again, why to ask when one can read the code of both old and new and do the diff in that gray matter one has in ... Then one will know.


@BugMeister: CLS1 does not concentrate on a station. It concentrates on a list of wares that must be hauled from source to sink. The homebase is an implicit source.

The CLS2 may or may not make use of homebase. In X3R version the homebase was only used for its account, and was unrelated to the work list of the pilot. Even back there (signed X3R version), the (potential) need for CLS2 homebase was not consistent between configuration of a route and running the route.

And X3R CLS2 does not care about stock status at station. It just attempts to do at the Waypoint what it is told to do. There are some usage scenarios, where some users were not quite happy about the choice the CLS2 does in that situation.
For example: if ship cannot load/buy the required amount, should it wait, or continue to the next waypoint with less than expected? If the next waypoint requires the specified amount, then it should wait. If you just want to collect from multiple sources, then the ship should continue. I do not see this discussed on the description (OP). Lucike?
Goner Pancake Protector X
Insanity included at no extra charge.
There is no Box. I am the sand.

Maahes
Posts: 872
Joined: Wed, 20. Nov 02, 15:14
x4

Post by Maahes » Tue, 4. Nov 08, 15:39

Is the functionality of CLS going to be extended to include CAG, or will CAG still be a separate script that can be installed without CLS? Is CAG even still in the pipeline? :D

sky669
Posts: 1145
Joined: Thu, 22. Feb 07, 11:10
x3tc

Post by sky669 » Tue, 4. Nov 08, 15:44

CAG is something complete different (yes, another script, can be installed as a standalone), and it will come aswell ... soon ...

shrikebtr
Posts: 62
Joined: Wed, 30. Jan 08, 02:00

Post by shrikebtr » Tue, 4. Nov 08, 16:39

It should be noted that the current versions of:

CLS (not necessary as of this, release, hurray!)
EST
and CAG

will all work with the English version, but they are currently being translated, and exist in a sort of "unsupported" state while Lucike and crew gets them ready for the English version. Take this with a grain of salt, as I am not part of the crew or involved in the process, just trying to be helpful :)

I am using CAG and EST in my game now, and both work as expected... well sort of, it can be hard to know what to "expect" when the documentation is in German, although the original documents for the X3:R version would probably help here. I happen to love the new configuration menus instead of the old system of passing variables "1 0 2" and the like.

Can't wait until the "Official" English versions of EST and CAG! Keep up the good work guys, thanks so much!

Coruskane
Posts: 849
Joined: Fri, 13. Jun 08, 13:14
x4

Post by Coruskane » Wed, 5. Nov 08, 19:56

I realise I can package it myself for my own personal use (which I am currently doing) but is there any intention to supply CLS (and ultimately CAG and EST) in spk fomat?

I have used it so far for the alphas of CLS, but I was not sure what to do vis a vis uninstalling via the uninstall .bat and so on.

sky669
Posts: 1145
Joined: Thu, 22. Feb 07, 11:10
x3tc

Post by sky669 » Wed, 5. Nov 08, 20:32

hi,

i can't tell you the future, but till now (even x3r) there was never any SPK-files from CLS, CAG, EST and so on.

but uninstalling isn't that nasty, as you think... just follow the steps from the readme and in some seconds you are done. (i personally never ever was even thinking of uninstalling this stuff ;- ) )

wolf

jlehtone
Posts: 21809
Joined: Sat, 23. Apr 05, 21:42
x4

Post by jlehtone » Wed, 5. Nov 08, 20:50

I, for one, do prefer the zip-compressed packages, because (a) I know where to put the files and how to manage them, (b) don't use huge number of scripts anyway, and (c) do not like to use additional program (no matter how wonderful) to extract from the spk format.


CAG is a separate script, although it does share some common libraries with the others. Even CLS1 and CLS2 can be considered separate, albeit tightly related.

Another script, related to CLS1 in function, is the DockWareManager. As documented, CLS1 knows to look for a set of variables, which can only be set by said script. The DWM does already exist, albeit without translated documentation so far. But I'm not sure how accessible are the station(s) in X3TC that require/benefit from the DWM functionality.


In theory, CLS2 can supply a fleet automatically. A different matter is, whether the fleet is willing to be supplied. And apparently the fleet has some stock resupply features too. But they probably lack finesse. :wink:
Goner Pancake Protector X
Insanity included at no extra charge.
There is no Box. I am the sand.

Post Reply

Return to “X³: Terran Conflict / Albion Prelude - Scripts and Modding”