Diff for "SendResources" - NEAT Portal Wiki

Diff for "SendResources"

Differences between revisions 14 and 15

Usage:	sendresources coords type local_min remote_min min_batch max_batch trooptype
Example:	sendresources any food 1b 100m 50m 100m sendresources TrebCity stone 30m 100m 5m * cavalry

Sendresources is used to instruct the bot to automatically transport certain resources to certain destinations when the conditions specified are met. As an example, you can tell the bot to send 10mil wood to any of your cities that fall below 5mil wood, while keeping at least 10mil in the sending city.

Sendresources tends to look more complicated than it is. The things to remember are as follows:

Coordinates to send to can be in either xxx,yyy or city name format including "any". When using a city name, the destination must be on the same account.
The bot will not put the sending city below the local_min amount.
The bot will not put the receiving city above the remote_min amount.
If you specify a minimum_batch and that amount would put the sending city below it's local_min, or the receiving city above it's remote_min, then it will not send yet. It will wait until the batch size is ok to send.
If you specify a maximum_batch and that amount would put the sending city below it's local_min, or the receiving city above it's remote_min, then it will not send the maximum amount. It will instead send a smaller amount (assuming minimum_batch allows it to).
If you do NOT specify both a minimum_batch and maximum_batch size in the goal, but do specify one number as a batch, it would treat that number as the maximum_batch with no specified minimum.
If you do NOT specify either a maximum or minimum batch amount, then it will send as it sees fit to.
If the receiving city is critically low on something (the bot considers 50% or less of the remote_min to be critically low) then it will ignore the minimum_batch and send less to get resources there in a hurry.
The bot takes into account resources that will be arriving before the transport could arrive when calculating how much is needed at the receiving city.
You can use an asterisk (*) to signify "any" amount for the local or remote minimums or the batch sizes.

CategoryAllGoals CategoryResourceGoals

SendResources (last edited 2015-01-13 06:41:49 by Inanna)

-  ⇤ ← Revision 14 as of 2014-03-03 23:32:35 → 
  Size: 3470
  Editor: Inanna
  Comment:
+   ← Revision 15 as of 2014-08-30 19:08:17 → ⇥
  Size: 2860
  Editor: Inanna
  Comment:
-Deletions are marked like this.
+Additions are marked like this.
 Line 1:
-||<tablebgcolor="#F9F9F9" tablestyle="margin:1em 1em 1em 0px;border-style:solid;border-color:rgb(170, 170, 170);color:rgb(0, 0, 0);font-family:sans-serif;font-size:13px;line-height:19.5px;text-align:start;  " tableclass="wikitable"#F2F2F2 style="border-style:solid;border-color:rgb(170, 170, 170);padding:0.2em;  ">Usage: ||<style="border-style:solid;border-color:rgb(170, 170, 170);padding:0.2em;">sendresources / coord / type / local_min / remote_min / remote_request / [trooptype] ||
||<#F2F2F2 style="border-style:solid;border-color:rgb(170, 170, 170);padding:0.2em;  ">Example: ||<style="border-style:solid;border-color:rgb(170, 170, 170);padding:0.2em;">sendresources any food 1b 100m 50m<<BR>>sendresources !OtherCity|!AnotherCity wood 30m 20m 5m cavalry<<BR>>sendresources 111,222 food 1b -1 50m<<BR>>sendresources !OtherCity food 1b 100m -1<<BR>>sendresources any food -1 100m 50m<<BR>>sendresources 111,222 food 1b -2 50m ||
+||<tablebgcolor="#F9F9F9" tablestyle="margin:1em 1em 1em 0px;border-style:solid;border-color:rgb(170, 170, 170);color:rgb(0, 0, 0);font-family:sans-serif;font-size:13px;line-height:19.5px;text-align:start;  " tableclass="wikitable"#F2F2F2 style="border-style:solid;border-color:rgb(170, 170, 170);padding:0.2em;  ">Usage: ||<style="border-style:solid;border-color:rgb(170, 170, 170);padding:0.2em;">sendresources coords type local_min remote_min min_batch max_batch trooptype ||
||<#F2F2F2 style="border-style:solid;border-color:rgb(170, 170, 170);padding:0.2em;  ">Example: ||<style="border-style:solid;border-color:rgb(170, 170, 170);padding:0.2em;">sendresources any food 1b 100m 50m 100m<<BR>>sendresources !TrebCity stone 30m 100m 5m * cavalry ||
 Line 5:
-'''coord can be in either xxx,yyy  or city name format including "any" '''
+Sendresources is used to instruct the bot to automatically transport certain resources to certain destinations when the conditions specified are met. As an example, you can tell the bot to send 10mil wood to any of your cities that fall below 5mil wood, while keeping at least 10mil in the sending city.
 Line 7:
-'''note using city name is valid within the same account'''
+Sendresources tends to look more complicated than it is. The things to remember are as follows:
 Line 9:
-Sendresources works much the same as KeepResources, except it sends a specific resource to a specific city in a specific amount.
+ * '''Coordinates''' to send to can be in either xxx,yyy or city name format including "any". When using a city name, the destination must be on the same account.
 Line 11:
-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. A value of -2 in the remote quantity may be used to keep behavior more like the KeepResources goal. Multiple cities can be designated via the | symbol, i.e., ''sendresources city1|city2|city3 food 1b 100m 50m''. All cities can be specified via 'any', i.e., ''sendresources any food 1b 100m 50m''.
+ * The bot will not put the sending city below the '''local_min amount'''.
 Line 13:
-In the 1st example above, the bot will send 50 million food to any other city on the account if !ThisCity has at least 1 billion food and another one falls below 100 million food. Since no troop-type is set, the bot will default to sending with transports.
+ * The bot will not put the receiving city above the '''remote_min amount'''.
 Line 15:
-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.
+ * If you specify a '''minimum_batch''' and that amount would put the sending city below it's local_min, or the receiving city above it's remote_min, then it will not send yet. It will wait until the batch size is ok to send.
 Line 17:
-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.
+ * If you specify a '''maximum_batch''' and that amount would put the sending city below it's local_min, or the receiving city above it's remote_min, then it will not send the maximum amount. It will instead send a smaller amount (assuming minimum_batch allows it to).
 Line 19:
-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.
+ * If you do NOT specify both a '''minimum_batch''' and '''maximum_batch''' size in the goal, but do specify one number as a batch, it would treat that number as the '''maximum_batch''' with no specified minimum.
 Line 21:
-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.
+ * If you do NOT specify either a maximum or minimum batch amount, then it will send as it sees fit to.
 Line 23:
-In the 6th example above, the bot will keep 1bil food in !ThisCity and send all excess to 111,222 in batches of at least 50 million at a time.
+ * If the receiving city is critically low on something (the bot considers 50% or less of the '''remote_min''' to be critically low) then it will ignore the '''minimum_batch''' and send less to get resources there in a hurry.

 * The bot takes into account resources that will be arriving before the transport could arrive when calculating how much is needed at the receiving city.

 * You can use an asterisk (*) to signify "any" amount for the local or remote minimums or the batch sizes.