<?xml version="1.0" encoding="utf-8"?><!DOCTYPE article  PUBLIC '-//OASIS//DTD DocBook XML V4.4//EN'  'http://www.docbook.org/xml/4.4/docbookx.dtd'><article><articleinfo><title>CategoryGeneralGoals</title><revhistory><revision><revnumber>6</revnumber><date>2012-10-22 01:24:06</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>5</revnumber><date>2012-09-26 23:37:08</date><authorinitials>Romulus</authorinitials></revision><revision><revnumber>4</revnumber><date>2012-08-26 03:51:46</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>3</revnumber><date>2012-08-21 02:58:38</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>2</revnumber><date>2012-08-21 02:58:23</date><authorinitials>Inanna</authorinitials><revremark>Renamed from 'CategoryAccountGoals'.</revremark></revision><revision><revnumber>1</revnumber><date>2012-08-21 02:29:32</date><authorinitials>Inanna</authorinitials></revision></revhistory></articleinfo><para>This section of goals includes any goals that affect your entire account as well as a few misc. goals that do not fit into another specific category. </para><para><orderedlist><listitem><ulink url="http://guide.neatportal.com/wiki/CategoryGeneralGoals/wiki/Abandon">Abandon</ulink></listitem><listitem><ulink url="http://guide.neatportal.com/wiki/CategoryGeneralGoals/wiki/Obsolete">Obsolete</ulink></listitem><listitem><ulink url="http://guide.neatportal.com/wiki/CategoryGeneralGoals/wiki/Research">Research</ulink></listitem><listitem><ulink url="http://guide.neatportal.com/wiki/CategoryGeneralGoals/wiki/SchedulePolicy">SchedulePolicy</ulink></listitem></orderedlist><!--The macro FullSearchCached caused an error and should be blacklisted. It returned the data '

' which caused the docbook-formatter to choke. Please file a bug.--> </para><section><title><ulink url="http://guide.neatportal.com/wiki/CategoryGeneralGoals/wiki/Abandon">Abandon</ulink></title><section><title>Abandon Goal</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage: </para></entry><entry colsep="1" rowsep="1"><para>config abandon:[switch] </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example: </para></entry><entry colsep="1" rowsep="1"><para>config abandon:1 </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Default: </para></entry><entry colsep="1" rowsep="1"><para>config abandon:0 </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Switch: </para></entry><entry colsep="1" rowsep="1"><para>0 = off</para><para>1 = on </para></entry></row></tbody></tgroup></informaltable><para>This goal tells the bot that you are planning to abandon this city. The bot will destroy all troops, wall defenses, and queues in the city and will lower loyalty by levying and adjusting the tax rate upwards. The bot will not perform comforting actions on the city with this goal set. This is useful when you plan to give a city away or abandon it. The bot will not automatically abandon the city once it reaches 0 loyalty. </para><caution><para><emphasis role="strong">WARNING</emphasis> </para><para>You should run <ulink url="http://guide.neatportal.com/wiki/CategoryGeneralGoals/wiki/EvacuateTown#">EvacuateTown</ulink> in the scripts window before you set this goal! </para><para>Be sure to move out All heroes as well </para></caution></section><section><title>Abandon Script</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage: </para></entry><entry colsep="1" rowsep="1"><para>abandon XXX,YYY </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example: </para></entry><entry colsep="1" rowsep="1"><para>abandon 111,222 </para></entry></row></tbody></tgroup></informaltable><para>This script tells the bot to abandon the valley at 111,222. </para></section></section><section><title><ulink url="http://guide.neatportal.com/wiki/CategoryGeneralGoals/wiki/Obsolete">Obsolete</ulink></title><para>All of the following goals still function within the bot. They have been replaced by a more powerful or functional goal however. If you are updating your goals, or writing them from scratch, you should not use these. They may be removed from the bot at a future date. </para><section><title>BallsUsed</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage:</para></entry><entry colsep="1" rowsep="1"><para>ballsused npc1s,npc2s,npc3s,npc4s,npc5s</para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example:</para></entry><entry colsep="1" rowsep="1"><para>ballsused 25,50,170,250,500 </para></entry></row></tbody></tgroup></informaltable><para>This directive is being phased out in lieu of the more powerful <ulink url="http://guide.neatportal.com/wiki/CategoryGeneralGoals/wiki/NpcTroops#">NpcTroops</ulink> goal. </para></section><section><title>NoAbandonFlats</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage:</para></entry><entry colsep="1" rowsep="1"><para>noabandonflats flat1 flat2 [...] flatX</para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example:</para></entry><entry colsep="1" rowsep="1"><para>noabandonflats 111,222 111,333 111,444 </para></entry></row></tbody></tgroup></informaltable><para>This directive is now obsolete. Please use <ulink url="http://guide.neatportal.com/wiki/CategoryGeneralGoals/wiki/ExcludeList#">ExcludeList</ulink> instead. </para></section><section><title>Npc10Heroes</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage:</para></entry><entry colsep="1" rowsep="1"><para>npc10heroes hero-string</para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example:</para></entry><entry colsep="1" rowsep="1"><para>npc10heroes hero-string </para></entry></row></tbody></tgroup></informaltable><para>This directive tells the bot which heroes may be used to farm level 10 npcs. It is being phased out in lieu of the more powerful <ulink url="http://guide.neatportal.com/wiki/CategoryGeneralGoals/wiki/NpcHeroes#">NpcHeroes</ulink> goal. </para><para>See <ulink url="http://guide.neatportal.com/wiki/CategoryGeneralGoals/wiki/HeroString#">HeroString</ulink> for details on how to set up the hero string for this goal. </para></section><section><title>Npc10List</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage:</para></entry><entry colsep="1" rowsep="1"><para>npc10list npc1 npc2 npc3 npc4</para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example:</para></entry><entry colsep="1" rowsep="1"><para>npc10list 111,222 111,333 111,444 </para></entry></row></tbody></tgroup></informaltable><para>This directive is being phased out in lieu of the more powerful <ulink url="http://guide.neatportal.com/wiki/CategoryGeneralGoals/wiki/NpcLimits#">NpcLimits</ulink> goal. </para></section><section><title>Npc10Troops</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage:</para></entry><entry colsep="1" rowsep="1"><para>npc10troops troops_to_send</para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example:</para></entry><entry colsep="1" rowsep="1"><para>npc10troops a:90000,wo:2000,w:2000,s:4000,t:2000 </para></entry></row></tbody></tgroup></informaltable><para>This directive is being phased out in lieu of the more powerful <ulink url="http://guide.neatportal.com/wiki/CategoryGeneralGoals/wiki/NpcTroops#">NpcTroops</ulink> goal. </para></section><section><title>Npc10Limit</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage:</para></entry><entry colsep="1" rowsep="1"><para>npc10limit troops_to_have</para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example:</para></entry><entry colsep="1" rowsep="1"><para>npc10limit a:390000,s:50000 </para></entry></row></tbody></tgroup></informaltable><para>This directive is being phased out in lieu of the more powerful <ulink url="http://guide.neatportal.com/wiki/CategoryGeneralGoals/wiki/NpcLimits#">NpcLimits</ulink> goal. </para></section><section><title>Npc10ExcludeList</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage:</para></entry><entry colsep="1" rowsep="1"><para>npc10excludelist npc1 npc2 npc3 npc4</para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example:</para></entry><entry colsep="1" rowsep="1"><para>npc10excludelist 111,222 111,333 111,444 </para></entry></row></tbody></tgroup></informaltable><para>This directive is being phased out in lieu of the more powerful <ulink url="http://guide.neatportal.com/wiki/CategoryGeneralGoals/wiki/ExcludeList#">ExcludeList</ulink> goal. </para></section><section><title>NpcExcludeList</title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage:</para></entry><entry colsep="1" rowsep="1"><para>npcexcludelist npc1 npc2 npc3 npc4</para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example:</para></entry><entry colsep="1" rowsep="1"><para>npcexcludelist 111,222 111,333 111,444 </para></entry></row></tbody></tgroup></informaltable><para>This directive is being phased out in lieu of the more powerful <ulink url="http://guide.neatportal.com/wiki/CategoryGeneralGoals/wiki/ExcludeList#">ExcludeList</ulink> goal. </para></section></section><section><title><ulink url="http://guide.neatportal.com/wiki/CategoryGeneralGoals/wiki/Research">Research</ulink></title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage:</para></entry><entry colsep="1" rowsep="1"><para>research type:level[type:level,type:level]</para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example:</para></entry><entry colsep="1" rowsep="1"><para>research lo:5</para><para>research lo:5,ho:5,com:4 </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Techs:</para></entry><entry colsep="1" rowsep="1"><para>agriculture - ag</para><para>lumbering - lu</para><para>masonry - mas</para><para>mining - mi</para><para>metal casting - met</para><para>informatics - in</para><para>military science - ms</para><para>military tradition - mt</para><para>ironworking - ir</para><para>logistics - lo</para><para>compass - com</para><para>horseback riding - ho</para><para>archery - ar</para><para>stockpile - st or sp</para><para>medicine - med</para><para>construction - con</para><para>engineering - en</para><para>machinery - mac</para><para>privateering - pr </para></entry></row></tbody></tgroup></informaltable><para>As with troop and build goals, the bot will perform research goals line by line in sequential order. In the 1st example above, the bot will research logistics to level 5. In the 2nd example above, the bot will research logistics to level 5, horseback riding to level 5, and compass to level 4. </para><para>The bot will automatically build and upgrade any buildings necessary to complete research goals.  </para><para>By default the bot sets <emphasis>config research:1</emphasis> internally if you have any research goal lines present. If you wish to disable all researching for a city temporarily, instead of adding a // or # to each research line, you can simply add <emphasis>config research:0</emphasis> to goals. </para><caution><para>WARNING!!!  </para><para>If you specify research goals that require a level 10 building, the bot WILL use your Michelangelo scripts to upgrade buildings to level 10 first! </para></caution><para>Be sure to only specify upgrades to level 10 research for military science, metal casting, horseback riding, lumbering, mining, privateering, and masonry in an unconverted npc10, or in cities with those buildings already at level 10 (e.g., a city with a level 10 warehouse for stockpiling 10) unless you're willing to spend your scripts. </para><para>As of the 3096 public release, you are able to use conditions in goals. Conditions are checks to see if certain buildings or research targets are met first, and if so then to perform some research task. For example, if I wanted to research privateering only if the academy was already level 10: </para><itemizedlist><listitem override="none"><screen><![CDATA[research ?a:10?pr:10]]></screen></listitem></itemizedlist><para>Looks confusing, but I promise it's not. The stuff inside the ??s is the condition. So we're checking above &quot;if the academy is level 10, then research privateering to level 10&quot;.  </para><para>You're able to mix in both research and building conditions in the goal, like so: </para><itemizedlist><listitem override="none"><screen><![CDATA[build ?met:10,w:10?q:0:0,ws:0:0]]></screen></listitem></itemizedlist><para>The above says if metal casting is level 10 and walls are level 10 then demolish all quarries and the workshop. Of course, this is a build goal and not a research goal, but I couldn't really think of a practical application to show you a research goal using both =) </para><para>Now, just to throw in a bit of confusion for you... the ?condition?goal can be written in reverse too as goal?condition?. The following both mean the same thing: </para><itemizedlist><listitem override="none"><screen><![CDATA[research ?ho:10?st:0:0
research st:0:0?ho:10?]]></screen></listitem></itemizedlist><para>The above two lines both say &quot;if horseback riding is level 10, demolish the stable completely&quot;. </para><para>It is important to note when using conditions in research or build goals, you must use &quot;st&quot; for stable and &quot;sp&quot; for stockpiling. You may still use &quot;st&quot; for stockpiling in pure research goals without conditions. </para><para>If you would like even more precise control over research order along with building order, check out the <ulink url="http://guide.neatportal.com/wiki/CategoryGeneralGoals/wiki/Plan#">Plan</ulink> goal. </para></section><section><title><ulink url="http://guide.neatportal.com/wiki/CategoryGeneralGoals/wiki/SchedulePolicy">SchedulePolicy</ulink></title><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para>Usage: </para></entry><entry colsep="1" rowsep="1"><para>schedulepolicy start_time end_time [start_time end_time start_time end_time] </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>Example: </para></entry><entry colsep="1" rowsep="1"><para>schedulepolicy 06:00 12:00</para><para>schedulepolicy 06:00 12:00 17:00 23:00 </para></entry></row></tbody></tgroup></informaltable><para>This policy will tell the bot to start and stop performing actions during certain times of the day. </para><para>In the first example above, the bot would run from 6AM to 12 noon, and stop the rest of the time. </para><para>In the second example above, the bot would run from 6AM to 12 noon, stop, then run again from 5PM to 11PM. </para><!--rule (<hr>) is not applicable to DocBook--><para> <ulink url="http://guide.neatportal.com/wiki/CategoryGeneralGoals/wiki/CategoryGoals#">CategoryGoals</ulink> </para></section></article>