Diff for "SendResources" - NEAT Portal Wiki

Diff for "SendResources"

Differences between revisions 1 and 22 (spanning 21 versions)

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. You can send to multiple cities by seperating the coordinates or names with a |. For example sendresources WarCity|HubCity|FarmCity food 10m 20m 1m 1m s. You cannot exclude a specific city using !cityname.
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. It 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.
By default the bot will only allow 1 mission per destination at a time in the rally. This means if this city is sending to or returning from city A then another send to city A will not happen until the existing one lands and returns. You can override this using the /slots switch. For example:

sendresources /slots=3 any food 1b 100m 50m 100m
sendresources any food 1b 100m 50m 100m /slots:2

CategoryAllGoals CategoryResourceGoals

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

-  ⇤ ← Revision 1 as of 2012-08-26 03:36:49 → 
  Size: 3401
  Editor: Inanna
  Comment:
+   ← Revision 22 as of 2015-01-13 06:41:49 → ⇥
  Size: 3862
  Editor: Inanna
  Comment:
-Deletions are marked like this.
+Additions are marked like this.
 Line 1:
-||<tablestyle="margin: 1em 1em 1em 0px; background-color: rgb(249, 249, 249); 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"style="border-style: solid; border-color: rgb(170, 170, 170); padding: 0.2em; background-color: rgb(242, 242, 242); ">Usage:||<style="border-style: solid; border-color: rgb(170, 170, 170); padding: 0.2em; ">sendresources coord type local_min remote_min remote_request [trooptype]||
||<style="border-style: solid; border-color: rgb(170, 170, 170); padding: 0.2em; background-color: rgb(242, 242, 242); ">Example:||<style="border-style: solid; border-color: rgb(170, 170, 170); padding: 0.2em; ">sendresources OtherCity 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 resType localAmount remoteAmount minBatch maxBatch 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:
-Sendresources works much the same as KeepResources, except it sends a specific resource to a specific city in a specific amount.
+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:
-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, ie: ''sendresources city1|city2|city3 food 1b 100m 50m''. All cities can be specified via 'any', ie: ''sendresources any food 1b 100m 50m''.
+Since a picture speaks a thousand words...
 Line 9:
-In the 1st example above, 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 troop-type is set, the bot will default to sending with transports.
+{{http://i.imgur.com/EQjiAdo.png}}
 Line 11:
-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.
+Sendresources tends to look more complicated than it is. The things to remember are as follows:
 Line 13:
-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.
+ * 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. You can send to multiple cities by seperating the coordinates or names with a |. For example ''sendresources !WarCity|!HubCity|!FarmCity food 10m 20m 1m 1m s''. You cannot exclude a specific city using !cityname.
 Line 15:
-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.
+ * The destination, resource type, local amount, and remote amount are required.
 Line 17:
-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.
+ * 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 19:
-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.
+ * 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. It 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.

 * By default the bot will only allow 1 mission per destination at a time in the rally. This means if this city is sending to or returning from city A then another send to city A will not happen until the existing one lands and returns. You can override this using the /slots switch. For example:

 .{{{
sendresources /slots=3 any food 1b 100m 50m 100m
sendresources any food 1b 100m 50m 100m /slots:2
}}}