[X3TC Bonus Plugin] Commodity Logistics Software MK1 (CLS1)

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

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

[X3TC Bonus Plugin] Commodity Logistics Software MK1 (CLS1)

Post by jlehtone » Sat, 24. Apr 10, 20:16

Commodity Logistics Software MK1

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

Image

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
Image

Quick Start
  1. Equip a TS class transporter with Navigation Commands Software MK1 and Commodity Logistics Software MK1
  2. Assign a homebase
  3. From your ship's Trading Menu, choose ``Start internal Commodity Logistics'', then select product and price with the command ``Homebase products''
  4. From your ship's 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 ship's Trading Menu.
Image

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.

Image

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)
Main Menu

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.

Image

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.

Image

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.
Last edited by jlehtone on Wed, 2. Jun 10, 21:43, edited 3 times in total.

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

Post by jlehtone » Tue, 27. Apr 10, 16:05

Updated by Bonuspack 4.1.01.
Last edited by jlehtone on Wed, 2. Jun 10, 22:25, edited 1 time in total.

User avatar
kayahr
Posts: 321
Joined: Sat, 12. Apr 08, 20:33
x4

Post by kayahr » Wed, 28. Apr 10, 07:43

The list of "prerequisites" also lists a TL. But the documentation only says that TL pilots must be at least cargo messenger. Everything else in the doc only mentions TLs as a TARGET. So please tell me: The TL can't dock to normal stations and complexes and the doc also says that it can't be used with equipment docks. So where can this be useful? Or is the TL using freight drones or M3 freighters to load and unload the ship? That would be great!

SoBo
Posts: 34
Joined: Sat, 30. Jan 10, 16:02
x3tc

Post by SoBo » Tue, 4. May 10, 14:57

Hi, I have a problem using this script:(
I add product (Del. Wheat), but whan I want to add consumer(omicron lyrae - cahoona bakery, Rimes fact), it open universe map, i click on omicron lyrae sector and it jumps back in to - add consumer -, it is impossible for me to add any station:(
is this my mistake or some kind of bug??
THX SoBo

Kor'ah
Posts: 3312
Joined: Wed, 25. Apr 07, 15:29
x4

Post by Kor'ah » Thu, 6. May 10, 03:25

CLS1, CLS2 and CAG question.

Do all three scripts use the same rank table? So I can have a CAG play part time CLS1 pilot when the need is there.

Edit: Yes, they do share the same ranking table. This is great.
[X3] Guide to training CAG and CLS1&2 pilots
[X3T] Guide to training CAG and CLS1&2 pilots in Terran Conflict

The mercenary code
There is no right or wrong.
There is no good or evil.
There is only the will of the client, and how much they're paying.

XanII
Posts: 2403
Joined: Thu, 29. Dec 05, 15:07
x4

Command 'none' is bound to a broken script

Post by XanII » Mon, 10. May 10, 08:26

Seems like i got burned on the latest bonus pack. Apparently it broke down my unsigned EST trader script that i had previously installed.

Now when i issue the command 'none' to any ship. e.g. Set turret from 'Attack enemies' to 'None' i always get a dialog box that i recall i last time saw in the EST trader config. And all menu options are Readtext0xxxx.

So my question is this: Is there a way to check bindings in command console? '1' is now bound to this broken script. I need to undo this manualy. Other option i see is to backup saves -> kill everything and start from scratch by installing all i need/use, inlcuding those unsigned scrips and pray to a higher entity that this is not the end for my TC career.
X3:TC Heavy M6 guide : : : Let's pretend you are an addict, lets pretend that you are a X-games player... but i am repeating myself here.

User avatar
Carlo the Curious
Posts: 16999
Joined: Mon, 5. Mar 07, 22:03
x4

Post by Carlo the Curious » Mon, 10. May 10, 08:51

EST and the BP scripts shouldn't conflict, as far as I know. Do you have any others installed?

Also, seems more of a scripting issue, so over we go...

XanII
Posts: 2403
Joined: Thu, 29. Dec 05, 15:07
x4

Post by XanII » Mon, 10. May 10, 09:02

Yes, i can check in the evening if i can find which ones i have installed. I installed the latest script manager software and it failed to launch so i dont get much of an 'overview' anymore of things.
X3:TC Heavy M6 guide : : : Let's pretend you are an addict, lets pretend that you are a X-games player... but i am repeating myself here.

XanII
Posts: 2403
Joined: Thu, 29. Dec 05, 15:07
x4

Post by XanII » Wed, 12. May 10, 20:48

Here it is. i went through the hassle of having everything re-installed including the scripts. didnt fix the problem but now i got descriptions on what the script is. See picture:

http://www.limetti.com/x3screen00001.jpg

Anyone got ideas how i can get rid of this 'global administration' for CLS mk1 and 2?. it is a subfunction to theese softwares but i wonder how it got tied to command 'None' on any ship?
X3:TC Heavy M6 guide : : : Let's pretend you are an addict, lets pretend that you are a X-games player... but i am repeating myself here.

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

Post by jlehtone » Wed, 12. May 10, 21:37

Check the 'setup.plugin.com.logistics.pck'.


Merged into BP CLS1 thread, since this is "feedback", right?
(And I bet a ghost broke somewhere.)[/i]

XanII
Posts: 2403
Joined: Thu, 29. Dec 05, 15:07
x4

Post by XanII » Thu, 13. May 10, 11:47

What should i do with it? it is not in cleartext form.

Plugin manager is btw broken right now. I am unable to install the latest version and the discontinued version i failed to find when scouring through the old links.
X3:TC Heavy M6 guide : : : Let's pretend you are an addict, lets pretend that you are a X-games player... but i am repeating myself here.

User avatar
Carlo the Curious
Posts: 16999
Joined: Mon, 5. Mar 07, 22:03
x4

Post by Carlo the Curious » Thu, 13. May 10, 14:32

XanII wrote:What should i do with it? it is not in cleartext form.
Unpack it with 7zip or similar and rename it to .xml, then open it in a browser (you'll need to .xsl file from the scripts folder in the same folder as the unpacked file).

XanII
Posts: 2403
Joined: Thu, 29. Dec 05, 15:07
x4

Post by XanII » Thu, 13. May 10, 18:21

Got it here now:

http://www.limetti.com/setup.plugin.com.logistics.xml along with the .xsl stylesheet.

Line 52 and forward are ship command mappings. Cant see anything directly wrong why the command none would only be affected but otherwise all is as it should.
X3:TC Heavy M6 guide : : : Let's pretend you are an addict, lets pretend that you are a X-games player... but i am repeating myself here.

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

Post by Lucike » Thu, 13. May 10, 19:06


@XanII

I think you've an old language file (8001-L044.pck) in your language folder. Delete it and hope that it works. Why do you have installed the BP? You are a modified player.

Regards
Lucike
Image

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

Post by jlehtone » Thu, 13. May 10, 19:21

Good point. At least fetch the latest versions of scripts that are never unsigned than in BP.


Code-wise, lines 63--83 do choose the command symbols. As you see, the first option is to use symbols from page 8001, i.e. from unsigned CLS. The secondary option (that can occur only when BP is installed) is to use the hardcoded symbols. So unsigned overrides BP. Better have it the latest, or none at all.

XanII
Posts: 2403
Joined: Thu, 29. Dec 05, 15:07
x4

Post by XanII » Fri, 14. May 10, 08:29

Didnt find the language pack.

But yes, good point about the BP. I thought signed is always better than unsigned. installed bonus pack in reunion without giving too much thought about it then either. This BP got some scripts that i didnt have and i thought about 'upgrading' the rest that i have. Didnt check the version numbering.

Well atleast i can now see a path to fix this if it goes to re-installing everything again: Install basics but dont install BP, instead do the BP scripts manualy, unsigned versions one-by-one.
X3:TC Heavy M6 guide : : : Let's pretend you are an addict, lets pretend that you are a X-games player... but i am repeating myself here.

XanII
Posts: 2403
Joined: Thu, 29. Dec 05, 15:07
x4

Post by XanII » Fri, 14. May 10, 08:40

Well that didnt work. Uninstalled bonus pack via add/remove and the proceeded on to install unsigned versions of all the scripts in the bonus pack. Still command none is bound.

Next step when i got the time is to do a fresh install again and then do all steps except bonus pack install.
X3:TC Heavy M6 guide : : : Let's pretend you are an addict, lets pretend that you are a X-games player... but i am repeating myself here.

XanII
Posts: 2403
Joined: Thu, 29. Dec 05, 15:07
x4

Post by XanII » Sun, 16. May 10, 17:34

Did the whole install again. This time without bonus pack and installed unsigned scripts instead so as to make a complete install. Left out ECS mod which i suspected could also be the culprit.

Nope. There it is again.

Next up is new install with all the scripts that i know have worked in the past minus those ones that i recently added and CLS mk1 and mk2. Im making wishes here that is some other script that i recently added that made this proble and not the cls. i really need that script for my HQ.

Nevertheless there seems to be a bumpy road ahead before i can resume playing. :(
X3:TC Heavy M6 guide : : : Let's pretend you are an addict, lets pretend that you are a X-games player... but i am repeating myself here.

XanII
Posts: 2403
Joined: Thu, 29. Dec 05, 15:07
x4

Post by XanII » Sun, 16. May 10, 18:31

Debugging complete. This has nothing to do with scripts. It's 2.6 update. Both 2.5 to 2.6 or the 1.01 to 2.6. both does the same thing.

I went through the trouble of installing X3:TC + 1.01 to 2.6 update and the plan was to install one script at a time to see which one triggers this. It appears the bug is right there when i load up 2.6.

I went and rifled through my older saves and lo and behold. 2.5 saves dont have this. 2.6 are all affected.

Sigh... dont know what the best way to fix this would be. i'll probably delete the current install and copy over the original backup so to make it as it was and see if i can simply load 2.5 saves and save and then see if the problem goes away or does it duplicate itself. Otherwise i'll just have to live with 2.5 then.
X3:TC Heavy M6 guide : : : Let's pretend you are an addict, lets pretend that you are a X-games player... but i am repeating myself here.

User avatar
wysiwyg
Posts: 585
Joined: Thu, 26. Feb 04, 00:08
x4

Post by wysiwyg » Wed, 2. Jun 10, 20:52

Does the new Bonus Pack released today (02/06) fix the "auto-naming sets game to modified" issue for this and the Commercial Agent scripts?

Post Reply

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