YAT AI Improved Version
=========================

First release V1
----------------

Attentions:

Restarting Traders is required for this update for the new AI improvement.

This MOD CANT BE USED WITH YET ANOTHER MOD ORIGINAL VERSION TOGETHER! YOU NEED TO TURN OFF THE ORIGINAL VERSION.

AI change:(all the change only effect ships in the YAT list)

1.Change the prefer list of buyoffer, to supply the buyoffer of player buildership first.(vanilla is random from all builderships)

2.Change prefer list for buying goods for buildership, they will concern your buildership first, then others.

3.Change the restriction of relativeprice for buyoffer. your trader will sell the goods with an unitprice above 90% of averageprice(relativeprice) ,they will create a list which contained the buyoffer with highest income with unitprice above 90% averageprice(relativeprice) and all other buyoffers with unit price above 120% averageprice. then choose random from the list.
(if i restrict to the highest profit, there will be a problem that they go always too far for a hight profit, and make it too risky, because you will loose all your money in the manager account if your ship is destroyed)

4.Experimental:disarmed the restrict to not allowed reserveable goods
list: bofu, energycells, foodrations, water
These goods cant be reserved by npc ships as vanilla

Other change:
New functions:
1.Your ships will execute the trading order once you orderd to do(sell/buy). They will return to free trade after complete all the trading orders.

2.Your ships will snap new offers from the station they trade with.

3.Your ships will make the zone known to you after trade with the station. Miner will make the zone known to you after reach the mining destination

4.The trade will improve a little relation with the faction you trade with(a very good idea from autotrader mod)

Bug fixed:

1.you can not add null null null ships to your list anymore.

2.destroyed traders/miners will not be shown as null null null ships in the overviewlist, which will cause a problem that you cant remove/config the ships if they listed after the null null null ships.

3.money transfer after selecting the range should not freeze the menus any more.

4.remove ships menu is ready to use now.

5.After remove the ship from the list, they will confirm your new trading orders correctly.

Known Issue:





Yet Another Trader v1.1
=========================

Update to v1.1
----------------

Fixed for XR 3.00
Some protection added for selling, repairing, upgrading YAT ships - they will be auto removed from YAT control and must be restarted after the operation.
Starting new trader/miner takes you automatically to the budget window for the captain.
adding /t files but not fully finished, please excuse interim text errors

Update to v1.0
----------------

First Workshop release
Fixed for 2.50 changes - M traders + miners now included
Workshop release requires at leat X Rebirth 2.50 to install. 2.20 version is available from Nexus.

Update to v0.1.4
----------------

Restarting Traders is required for this update for the > 20 million credit limit fix to be applied.

Fixes from 0.1.3
Fixed another bug with credit cap set above 20,000,000 breaking at staying at 20,000,000 (I'm such a noob, fixed fully now)

Fixes from 0.1.2

Fixed bug with credit cap set above 20,000,000 breaking at staying at 20,000,000 (thanks for report DaBooz)
Fixed incorrect handling of current cargo sale for autominers stopped and set to mine a specific ware with other ware (over 50% cargo space) in hold. Excess cargo below this limit can be cleared manually or by setting the ship to auto trade and it will be sold.

Fixes from 0.1.1

Output after
Fixes from 0.1.0

Patched the logbook spam reported from failed trades.
Added missing but intended check for cleanly clearing YAT stuff from captains assigned to a new commander.
Added 50 mill and 100 mill max budget options for more advanced traders.
Started adding requirements for ai compatability patching.


What is it?
-----------

It's an auto trader + auto miner without the problems of competing for Captain command menu space, opting instead for using an extended Main Menu > 4 and custom detail monitor menus. These are modified versions of some decompiled vanilla lua rather than built with LibMJ.

Why another auto trader/miner?
------------------------------

Euclid and John Luke Picard have both written great mods. Using both I found I liked certain aspects of each and wanted them combined. The mod started life as a private version of Euclid's trader that could use any trade ship but things got out of hand... The ai for the trader is not taken from either mod.

Known Issues
------------

v0.1.2 - the following error spew will be seen when the [General] ======================================
[=ERROR=] Error in MD cue md.Notifications.PlayerFactionTradeCompleted_Actions: Property lookup failed: $trade.buyer
* Expression: $trade.buyer.owner == faction.player and $trade.seller.owner == faction.player
[General] ======================================
[General] ======================================
[=ERROR=] Error in MD cue md.Notifications.PlayerFactionTradeCompleted_Actions: Property lookup failed: $trade.seller
* Expression: $trade.buyer.owner == faction.player and $trade.seller.owner == faction.player
[General] ======================================
[General] ======================================
[=ERROR=] Error in MD cue md.Notifications.PlayerFactionTradeCompleted_Actions: Property lookup failed: $trade.buyer
* Expression: $trade.buyer.commander == $trade.seller or $trade.seller.commander == $trade.buyer
[General] ======================================
[General] ======================================
[=ERROR=] Error in MD cue md.Notifications.PlayerFactionTradeCompleted_Actions: Property lookup failed: $trade.seller
* Expression: $trade.buyer.commander == $trade.seller or $trade.seller.commander == $trade.buyer
[General] ======================================
[General] ======================================
[=ERROR=] Error in MD cue md.Notifications.PlayerFactionTradeCompleted_Actions: Property lookup failed: $trade.seller
* Expression: $trade.buyer.commander == $trade.seller or $trade.seller.commander == $trade.buyer
[General] ======================================

Only L + XL ships supported in v0.1.0, M ship support planned for update after more testing and any bug fixes for the main code.

No localisation (sorry). Soon(tm).

How to use
----------

Sidebar UI :

YAT commands are added to the Trading button

Legacy Menu :

The "Main Menu > 4 Trading" option is now "Main Menu > 4) Trade Manager" and this is the root of the controls. Nothing is added to the Captain's conversation menus. This provides the options :

1) Trading - The standard trading monitor as called by SHIFT+T
2) Trade Management - The main auto trade menu
3) Trade Overview - List of trade ships, with range, role, home zone + budget cap shown

5) (Back)
6) (Close)

Trade Management :

1) Add Ship - Choose a ship for auto trade or mining
2) Remove Ship - Remove a ship from the manager (for completeness join squad + assign commander + come back on board also trigger this).
3) Ship Config - Change the ships range, budget cap and home zone.

5) (Back)
6) (Close)

Ship Config :
Select ship from list and choose attribute

Ranges
------

Miners only choose between cluster + galaxy range as they roam the cluster in search of wares.

Budgets
-------

Captains use their own accounts to trade, so if your new trader has no cargo give them some money after adding the ship. (Property Menu > Ship > Details > Captain > Details > Current budget > Change.) You can also manually remove funds from each Captain in this way regardless of the credit cap set. I'd recommend an absolute minimum of 100,000Cr in the Captain's budget as more units bought = more profit. The credit cap defaults to 10 million for traders and 100 thousand for miners as miners only need to buy fuel. This can be set to a custom level in Ship Config options but be advised that ship loss will also lose this wallet money when the captain dies. All money in the Captain's account is automatically transferred to the player on stopping the trader/miner. The captain will transfer any excess money to you silently on sale completion so check your logbook for exact transfer amounts.

Ships + squad
-------------

The Trade Manager requires ships to be out of squad to be added. Any cargo carrying ship is eligible to auto trade or mine except Construction Vessels; split and multi cargo vessels trade their full range of wares. Mining ships reqire at least 10 drones for each mining ware type they can carry (bulk + liquid). The ships should also not be refuelling or any other task or the selection menu will not list them. "Wait", "Follow" and "None" are valid captain orders and out of squad. Mining ships yields (gather rate) are calculated from number of mining drones and quality of the drones (MkI or MkII).

Movement and fuel
-----------------

All ships use the vanilla code for moving to destination and docking to trade so pass any commentary about this to Egosoft. Your ships will auto refuel after trade completion if they have less than 1200 fuel cells left so you won't get bugged by Captains who can't make the next jump unless the Captain's wallet is empty.

Home Zone
---------

Currently only used by Miner tasked ships when trading galaxy wide. The ship will return to 'home' before looking for new resources to mine if they have finished a sale in a different cluster. Home can be set in Ship Config and defaults to the zone the ship was in when ordered to mine.

Trade info
----------

All messages from your Captains will be sent to the logbook in General section. Minimal feedback via the event monitor is given for adding new ships and config changes as it's very annoying mid fight to loose your radar just so a smug feller can tell you something you don't care about right then and there.

Uninstalling
------------

Stop all your trade/miner ships to get your money back and clear any special blackboarded info. Remove mod.