Diff for "SendResources" - NEAT Portal Wiki

Diff for "SendResources"

Differences between revisions 15 and 16

Usage:	sendresources coords resType localAmount remoteAmount minBatch maxBatch 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.

Since a picture speaks a thousand words...

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 destination, resource type, local amount, and remote amount are required.
The minimum and maximum batch sizes and troop type to use for sending are optional. If only specifying one number for the batch size, then it's considered to be the maximum amount NOT the minimum amount. If you do not specify either a maximum or minimum batch amount, then it will send as much or as little as it is able to send in order to keep the local and remote amounts correct.
You may use a * in place of numbers for the local or remote amounts or the minimum or maximum batch sizes, to indicate that the amounts don't matter.
The bot will not put the sending city below the local amount. You must have OVER this amount in order to send some. The exception is in case you use a * for the local amount, then it will send regardless of the local amount.
The bot will not put the receiving city above the remote amount. You must have BELOW this amount in order to send some. The exception is in case you use a * for the remote amount, then it will send regardless of the remote amount.
If you specify a minimum batch and that amount would put the sending city below it's localAmount, or the receiving city above it's remoteAmount, then it will not send yet. It will wait until the batch size is ok to send. If you use a * for the minimum batch then the bot will send any amount it decides to.
If the receiving city is critically low on something (the bot considers 50% or less of the remoteAmount to be critically low) then it will ignore the minimumBatch and send less to get resources there faster.
The bot takes into account resources that will be arriving before the transport could when calculating how much is needed at the receiving city.

CategoryAllGoals CategoryResourceGoals

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

-  ⇤ ← Revision 15 as of 2014-08-30 19:08:17 → 
  Size: 2860
  Editor: Inanna
  Comment:
+   ← Revision 16 as of 2014-08-30 19:26:40 → ⇥
  Size: 3242
  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 coords type local_min remote_min min_batch max_batch trooptype ||
+||<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 resType localAmount remoteAmount minBatch maxBatch troopType ||
 Line 7:
+Since a picture speaks a thousand words...

{{http://i.imgur.com/EQjiAdo.png}}
-Line 11:
+Line 15:
- * The bot will not put the sending city below the '''local_min amount'''.
+ * The destination, resource type, local amount, and remote amount are required.
-Line 13:
+Line 17:
- * The bot will not put the receiving city above the '''remote_min amount'''.
+ * The minimum and maximum batch sizes and troop type to use for sending are optional. If only specifying one number for the batch size, then it's considered to be the maximum amount NOT the minimum amount. If you do not specify either a maximum or minimum batch amount, then it will send as much or as little as it is able to send in order to keep the local and remote amounts correct.
-Line 15:
+Line 19:
- * 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.
+ * You may use a * in place of numbers for the local or remote amounts or the minimum or maximum batch sizes, to indicate that the amounts don't matter.
-Line 17:
+Line 21:
- * 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).
+ * The bot will not put the sending city below the local amount. You must have OVER this amount in order to send some. The exception is in case you use a * for the local amount, then it will send regardless of the local amount.
-Line 19:
+Line 23:
- * 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.
+ * The bot will not put the receiving city above the remote amount. You must have BELOW this amount in order to send some. The exception is in case you use a * for the remote amount, then it will send regardless of the remote amount.
-Line 21:
+Line 25:
- * If you do NOT specify either a maximum or minimum batch amount, then it will send as it sees fit to.
+ * If you specify a minimum batch and that amount would put the sending city below it's localAmount, or the receiving city above it's remoteAmount, then it will not send yet. It will wait until the batch size is ok to send. If you use a * for the minimum batch then the bot will send any amount it decides to.
-Line 23:
+Line 27:
- * 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.
+ * If the receiving city is critically low on something (the bot considers 50% or less of the remoteAmount to be critically low) then it will ignore the minimumBatch and send less to get resources there faster.
-Line 25:
+Line 29:
- * 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.
+ * The bot takes into account resources that will be arriving before the transport could when calculating how much is needed at the receiving city.