Difference between revisions of "Resource Goals"

Revision as of 11:32, 13 June 2011

Trade

With this goal enabled, Y.A.E.B. will buy and sell resources in an attempt to gain and keep the resources you need and want in your city.

The bot will prioritize trading as follows:

• If gold to pay your heroes is under 24 hrs left, the bot will sell resources as needed (selling extra resources first) to get it up to enough. This is to prevent revolts.
• If food to pay your upkeep is under a number of days equal to the config extrafood goal - or 24 hours if not set, then it will buy food with extra gold, and if necessary sell resources (selling extra resources first) for extra gold, until it has the minimum food required. This is to prevent refuge.
• Sell extra resources for gold.
• If there are any pending builds or research in goals, it will buy and sell resources as needed to meet the requirements for the build or research.
• If resourcelimits are not yet met, the bot will use spare gold to buy the missing resources in an even amount across the board, ie - 25% of the needed food, 25% of the needed lumber, 25% of the needed stone, and 25% of the needed iron. The bot will stop buying before gold falls under 31 days left, or resourcelimits are reached.

Resourcelimits

This directive will instruct Y.A.E.B. how many of each resource you wish to keep in the city, so that it can buy and sell via config trade to achieve it. The bot is a powerful tool, but it is not a miracle worker. If you put unreachable amounts, it will not reach them. This works best if you set the limits to just a little more than what you currently have, and increase it slowly as it buys.

Keepresource

This goal will allow you to keep a specified amount of resources, and send all extra to another location. In the 1st example above, the bot will keep 1 billion food in this city, and if it gets extra it will send the extra to 111,222 in increments of at least 50 million. In the 2nd example above, the bot will keep 20 million lumber and 20 million iron, and send all extra to OtherCity in increments of at least 5 million.

Keepresource uses transports to send with, and will send as much over the "kept" amount as it has resources and transports available to send as long as it's at least the minimum quantity specified. If no quantity is specified, the bot sends any amount available.

This goal is being phased out in lieu of the newer and more powerful sendresources command.

Sendresources

Sendresources works much the same as keepresources, except it sends a specific resource to a specific city in a specific amount. A value of -1 may be used for one of the quantities to override the specific amount sent, or to disregard the local or remote minimum amount. Multiple cities can be designated via the | symbol, ie: sendresources city1|city2|city3 food 1b 100m 50m. All cities can be specified via 'any', ie: sendresources any food 1b 100m 50m.

In the 1st example, the bot will send 50 million food to OtherCity if ThisCity has at least 1 billion food and OtherCity falls below 100 million food. Since no trooptype is set, the bot will default to sending with transports.

In the 2nd example, the bot will send 5 million wood to OtherCity and/or AnotherCity if ThisCity has at least 30 million and OtherCity and/or AnotherCity has under 20 million, and it will use cavalry to transport the wood.

When -1 is used for the remote_min amount, the bot will not check what the city to send to has first, and will instead send the requested amount every time it has enough in ThisCity to meet the local_min. By using -1 this way, the bot is able to send to coordinates on another account, for example from a feeder account to a main account. In the 3rd example above, the bot is told to send 50mil at a time to 111,222, as long as ThisCity has 1 billion.

When -1 is used for the sending quantity, the bot will send however much the city can send, limited only by the transports sending it. In the 4th example, the bot will send as much food as possible from ThisCity to OtherCity, until ThisCity falls below 1bil left, or OtherCity reaches the 100mil goal.

When -1 is used for the local_min, the bot will send the quantity to the destination when it falls below remote_min, regardless of the amount in the current city, until it runs out of resources. In the above 5th example, ThisCity will send batches of 50mil food to 'any' city you own if one falls below 100mil food, regardless of how much food is in ThisCity.

Requestresources

Requestresources works just like Sendresources, except in reverse.

In the 1st example above, the bot will request 50 million food from OtherCity if ThisCity has under 100 million food and OtherCity has at least 1 billion food. Since no trooptype is set, the bot will default to sending with transports.

In the 2nd example above, the bot will request 5 million iron from 111,222 if ThisCity has under 20 million iron, regardless of how much iron is in 111,222, and it will use cavalry to transport the iron. The use of -1 is possible with requestresources exactly as detailed above with sendresources.

Warehousepolicy

This allows the bot to adjust the amount of resources stored in the warehouse. The total amount cannot exceed 100%.