Commercial Agent
(Version 3.beta.03 - 8. November 2008)
[ external image ]
[ external image ] [ external image ]
[ external image ] (coming soon!)
Commercial Agent Overview
- The Commercial Agent buys the cheapest resources and sells products at the best price in his territory. He works with factories, trade stations, and equipment docks.
- The Commercial Agent buys intermediate products for complexes not producing enough and sells overproduced intermediate products.
- The Commercial Agent trades in all the products and resources at his homebase. Individual wares can be blocked, however.
- The Commercial Agent sticks to the purchase and sale rules set by the player. A log of all purchases and sales can be generated.
- The Commercial Agent will coordinate with his counterparts from his homebase and the other factories in sector.
- The Commercial Agent keeps an eye on the financial situation of his homebase and will sell off products if the station runs low on cash.
- The Commercial Agent will change his route if he finds a good deal, but it will prefer good customers.
- The Commercial Agent can use the Jumpdrive and will repair his ship.
- The Commercial Agent keeps in contact with customers and other traders and can find prices and news in other sectors. The Economy and Supply Trader is not a fighter and avoids sectors where enemies have been reported.
The Commercial Agent's skills depend on his training rank.
[ external image ] [ external image ] [ external image ] [ external image ] [ external image ]
[ external image ] [ external image ]
Preparing Commercial Agents
The Downloads
->...
-> Libraries
(You must install these!)
Required: X³ Terran Conflict Version 1.2 (not compatible with X³ Reunion)
!!
Activating the Script Editor
Activating the script editor is not necessary for Commercial Agent. It will mark your game as ***modified***.
With the script editor activated, technical information is provided as well as normal information. This can be confusing. It is possible to run other unsigned scripts without starting the script editor. This requires a change in the script's boot file. This will mark your game as ***modified*** as well.
Installation
Simply extract the Zip into the X3TC directory like you did with the former version. Newer files should overwrite older ones. Main script files will reside in ".\scripts"- and ".\t\"-folder, all other files are for maintenance and uninstalling only.
Deinstallation
Copy file setup.plugin.economics.pck from "\scripts.uninstall\" in your X3TC folder to "\scripts". Run TC and load a saved game. Uninstallation is automatically started and finished when a message is sent to the logbook. Uninstallation takes 10 to 20 seconds from when the game was loaded. Save your game.
Run "Delete all Economy and Supply Trader Scripts.bat" found in the "\scripts.delete" folder in your TC directory. This will delete the script's files.
Important: Never just delete scripts; your savegame will look for them.
Updating to a newer version
Simply re-extract the Zip into the X3TC directory. Simply unzip into your X3TC directory. There are files in "\scripts" and "\t", as well as other folders. These other files are used for maintenance and uninstalling. You may overwrite older files.
To remove obsolete or unused files, run "Delete old Commercial Agent Scripts.bat", found in "\scripts.delete", before extracting the new zip file. This is not necessary, but will keep your script folders neater.
Ingame, nothing needs restarting. All ships and stations should run the new scripts automatically, any ships set to notify you when orders are complete will send you a message. The old script is stopped before the new script is started, and the message can be ignored.
Commercial Agent Guide
The Mission
The Commercial Agent is responsible for the sale or purchase of the assigned wares at his homebase, or the management of a client's factory.
The Commercial Agent is trained over time, and can be given more tasks after completing training courses. If training is not desired, it can be disabled. More on that later.
Quick Start
- Equip a TS Transporter with Navigation Software MK1 and Trade Command Software MK1 and MK2
- Assign Homebase
- In the Trade command menu, select "Start Commercial Representation."
The ranks
Apprentice
The apprentice will take care of purchasing resources. The apprentice is carrying out his probationary period and receives no salary.
Auxiliary Courier
The Auxiliary Courier handles not only resources, but also sells products. In addition, he can deal at Equipment Docks and Trade Stations; he can also be assigned to them. The auxiliary courier gets 20 credits per Mizura flown, paid after each flight.
Courier
The Courier coordinates with his homebase and in-sector colleagues. He also buys fighter drones from local stations and buys more speed and maneuverability upgrades. The Courier gets 25 credits per Mizura flown, paid after each flight.
Freight Pilot 2nd Class
The Freight Pilot 2nd Class can deal with not only products and resoruces, but can buy or sell a complex's intermediate products. He can also use the Jumpdrive. The Freight Pilot 2nd class gets 30 credits per Mizura flown, paid after each flight.
Freight Pilot 1st Class
The Freight Pilot 1st Class gets information about the homebase's financial situation, and can clear out his factory's products if there are not enough credits available. Also, he pays more attention to the trader radio chatter and avoids sectors where hostiles are reported. The Freight Pilot 1st Class gets 35 credits per Mizura flown, paid after each trip.
Freight Pilot
The Freight Pilot stays informed of prices during flight and will change course for a better deal. He will also repair his ship at a shipyard if required. The Freight Pilot gets 40 credits per Mizura flown, paid after each flight.
Ship Equipment
- A small class ship (M3, M4, M5, M8, TM, TS or TP) or corvette class (M6)
- Trade Command Software MK1
- Trade Command Software MK2
- Fight Command Software MK1 (optional: changes CAG behavior when encountering enemies)
- Fight Command Software MK2 (optional: changes CAG behavior when encountering enemies, in addition to Fight MK1)
- Navigation Command Software MK1
- Jump Drive (optional: can be used after special training course)
Handling
The Commercial Agent command will appear in the Trade menu. The ship requires Navigation Command Software MK1, Trade Command MK1 and MK2, and a homebase set. Then the command "Start Commercial Representation" will appear. This command will open the configuration menu.
The Main Menu
[ external image ]
All the settings are divided into groups on the main menu.
The Agent settings
[ external image ]
The Agent settings option includes not only settings but information about the agent. This menu displays current destination, homebase, service time, total flight time, as well as salary and profit information.
Delete accounting information
This will tell the pilot to delete his records. This cannot be undone, so confirmation is required.
Take Trainings
Pilots participate in training over time. Should the player wish to exclude the pilot from training courses, this command will do it.
Trader salary
If the pilot is to be paid out of an account other than the player's wallet, set that here.
Fire Trader
An unneeded pilot can be dismissed. The ship must be docked at a station and idle. This cannot be undone, so confirmation is required.
Reassign Trader
Bought a bigger ship for your pilot? Use this command to transfer him into it. Both old and new ships must be docked at the same station. After choosing this command, a list of other ships with EST pilots will appear. Choose the ship you wish to transfer to, the pilots will exchange ships, and bring along their profit record to the new ship.
Restore Defaults
This command resets all settings to their default settings.
Ware lists
[ external image ]
This list contains the wares that require special attention. The list can be a list of barred goods or a list of goods to trade.
Ware List Type
The pilot can be banned from trading the goods on the list or limited to trading only the goods on the list. Change the list mode here.
Ware list
Add or remove wares from the list here.
Restore Defaults
This command resets these settings to their default settings.
Exceptions
[ external image ]
The pilot will look in all stations and sectors in range for the needed wares. However you can mark individual sectors and stations as off-limits.
Bases
This is the list of off-limit stations. You can add or delete entries in this menu.
Sectors
This is the list of off-limit sectors. You can add or delete entries in this menu.
Only trade with satellite network sectors
Here you can tell your pilots to only trade in sectors with a satellite in them.
Only trade with non-player stations
CAG pilots will trade with NPC stations and your own stations. Here you can tell your pilot to trade only with NPC stations.
Restore Defaults
This command resets these settings to their default settings.
Trade Duties
[ external image ]
A pilot must adhere to these conditions.
Trade Duty
The pilot takes care of both buying and selling of wares. If the trader is to only buy or sell, then the command can be issued here. This is useful if the pilot is assigned to a Trade or Equipment dock.
Purchase Resources
The Agent will buy resources to fill up the homebase to this level.
Sell Products
The Agent will sell stock down to this level.
Sell Products Freighter Cargo Bay
The Agent will fill his cargohold up to this limit with product for sale. This setting does
NOT apply to the sale of intermediate goods.
Purchasing Intermediates
The Agent will buy up to this level of intermediate products.
Selling Intermediate Products
The Agent will sell down to this level of intermediate products.
Purchase stations credit balance
The agent draws from the station's account to buy resources and intermediates. The agent will not purchase anything if the station has fewer credits than this limit.
Restore Defaults
This command resets these settings to their default settings.
Station settings
[ external image ]
These settings are copied from the station settings. However, the pilot can be given different orders.
Trade Range
The range from the home sector that the agent will look for deals.
Home sector
The home sector is the center of the agent's territory. It is usually the sector the agent's homebase is in, but not always.
Restore Defaults
This command resets these settings to their default settings.
Jump Drive Settings
[ external image ]
The Agent can use the Jump drive after a special course available to experienced Agents. This menu can be used to set rules for its use.
Use Jump Drive
Here the Agent can be allowed or disallowed to use the Jumpdrive.
Jump Drive Energy
The Agent keeps 10% of his cargohold filled with energy cells for the Jump Drive. Another limit can be set here to deal with longer or shorter jumps.
Minimum Jump Range
The minimum distance that the Agent will jump.
Restore Defaults
This command resets these settings to their default settings.
Automatic Naming
[ external image ]
Renaming many ships is tedious. CAG pilots can be asked to name their own ships and add information to the ship name..
Configure automatic naming
There are many schemes for ship naming available.
Renaming settings (selection)
[ external image ]
This menu lists the renaming schemes, along with descriptions.
Ship number
If the ship is given a number, it can appear here.
Factory number
If the station is given a number, it can appear here. All of the station's ships share this number.
Restore Defaults
This command resets these settings to their default settings.
Configure Reports
[ external image ]
The CAG pilot will report many incidents. Some of these messages can be disabled.
Promotion
The CAG pilot will report successful completion of a training course. This message can be disabled here.
Enemy sightings
The CAG pilot will report enemy ships. This message can be disabled here.
Acoustic signal at message
The Agent will send silent messages by default. If a audible message is preferred, select that here.
Trade Log
The CAG pilot can enter every transaction into the player's logbook. This can be changed here.
Analysis to Log
The CAG pilot can write his profit record into the logbook. This includes his current task.
Restore Defaults
This command resets these settings to their default settings.
Data Storage
[ external image ]
If several pilots have the same orders and conditions to follow, they can be transmitted to each other.
Load Data
[ external image ]
Here you can find all of the order packets and assign them to the pilot.
Save Data
Here you can save the pilot's current orders. The packet can be named.
Delete Data
Order packets can be deleted.
More Information
JumpDrive: If a Jump Drive is used, the Agent is provided with energy cells from the homebase. He will also buy jump energy from NPC stations if required.
Travel Drive: If a Travel Drive is used, the Agent is provided with energy cells from the homebase. He will also buy jump energy from NPC stations if required.
Enemy Contact: If equipped with Fight Command MK1, the pilot will purchase Fighter drones in the current sector and upgrade his speed and manuverability. If the ship is equipped with a Jump Drive, and the pilot is experienced enough to use it, the pilot may enter unsafe sectors. If equipped with Fight Command MK2 and has Missile Defense Mosquito available, the pilot will also purchase Mosquitoes.laden kann, so wird er sich auch einen Vorrat an Moskitos zulegen.
Friend/Foe: CAG pilots do not fly in sectors belonging to a race set to "Foe." "Show as enemy if enemy to me" should be set to No. If a Jump Drive is not installed, the pilot will not fly in hostile sectors.
Satellite Networkk: The CAG pilot can be told to trade only in sectors that contain an Advanced Satellite belonging to the player.
Headquarters: If the Agent is working for the Player HQ, space is reserved in the HQ for a cargohold full of each ware. The Agent may be configured to use a differently sized space in the HQ.
Station Lock: Any station can be set as off-limits to the EST pilot. Player stations also have "CAG Trader lock" in the command console.
Important: If the CAG is working for a complex and changes are made to his homebase, he will quit and wait for new instructions.
Technical Data for Commercial Agent
Language file
8000.xml (ID 8000)
8000-L039.xml (ID 8000)
8000-L049.xml (ID 8000)
Command Slot (
Change command slots)
COMMAND_TYPE_TRADE_16 (416)
COMMAND_TYPE_CUSTOM_16 (716)
COMMAND_TYPE_STATION_16 (1116)
Object-Task
Global (restart)
Ship Task 0, 40 und 41
Offcial Abbreviation
"die HVT"
"the CAG"
< Keywords: ScripterLucike, Script, Commercial representation, Commercial Agent, Trade, Logistics, Supply, automatically buy sell >