== Get your references right ==
<<TableOfContents>> <<BR>> <<BR>>  This is not going to be a complete list of available references in NEAT. Look at it as a getting-started guide. For the total list use Dismayed's list at [[References]]. <<BR>>

This guide is discontinued. While it  still works there are a lot of new scripting possibilities. A lot of  references can be written differently as well. <<BR>> <<BR>>

=== How to use a reference ===
<<BR>>  All references are based on the following format:

reference {operator} value <<BR>> <<BR>>  Every valid reference will return a value in the log tab if preceeded by echo.

If you try to grab a reference that does not exist it will give a 1069 error.

An example is trying to echo the heroname from marching army number 6 when you have only got 5 armies marching. <<BR>> <<BR>> <<BR>>  e.g.:

echo m_context.sellPrice(0) will show you the current price of food<<BR>>  To make it easier on the eyes you can add a comment on what it is in front<<BR>>

e.g.:

echo "food is now sold for " + m_context.sellPrice(0) <<BR>> <<BR>>

To use this reference in a script you need a comparable, an ifgoto or an ifgosub command and a label to go to. <<BR>> <<BR>>  e.g.: <<BR>>  ifgoto (m_context.sellPrice(0) < 5) buyfood <<BR>>  That will tell the bot to find a label named buyfood if the price of food is less than 5. <<BR>>  Next step is tying the two parts together: <<BR>> <<BR>>  1: label checkfoodprice<<BR>>  2: ifgoto ( m_context.sellPrice(0) < 5 ) buyfood<<BR>>  3: loop <<BR>>  <<BR>>  4: label buyfood<<BR>>  5: buy food 9999999 5<<BR>>  6: goto checkfoodprice<<BR>>  <<BR>>  A simple script like that will keep checking the price of food and post a bid every time it drops below 5. <<BR>> Make sure to get your spelling right. Scripts are case sensitive. If the reference is fieldId, fieldid or FieldId won't work.<<BR>> The same applies for correct spacing. Miss a space and your reference won't work. <<BR>><<BR>> Correct way ->  ifgoto ( m_context.sellPrice(0) < 5 ) buyfood<<BR>> Wrong way   ->  ifgoto ( m_context.sellPrice(0) < 5) buyfood<<BR>> Wrong way   ->  ifgoto ( m_context.sellPrice(0) < 5 ) buyfood<<BR>> Wrong way   ->  ifgoto (  m_context.sellPrice (0)< 5) buyfood<<BR>> Wrong way   ->  ifgoto (m_context.sellPrice(0) <5 ) buyfood<<BR>> Wrong way   ->  ifgoto (m_context.sellPrice (0)<5) buyfood<<BR>> <<BR>> Taking the time to write references properly the first time around can save you hours and days of debugging later.

<<BR>> <<BR>> <<BR>>

=== What is Array? ===
<<BR>> <<BR>>  Basically it is the number in the list. You can refer to the number in the list by changing the array number: <<BR>> <<BR>>  e.g. 1: echo m_city.cityManager.tradesArray[0].resType <<BR>>  where 0 is the first in the list and 9 is the last in the market window. <<BR>> <<BR>> <<BR>>

=== Market references ===
<<BR>> <<BR>> <<BR>>  If you just want to check the prices for the various resources use the following lines. <<BR>>  echo "sellPrice food " + m_context.sellPrice(0)

echo "buyPrice food " + m_context.buyPrice(0)<<BR>> The first line will check the current sell price on food posted in the market and the second will check the highest posted bid. <<BR>><<BR>>   To differentiate between resources you can replace 0 with 1, 2, or 3 for wood, stone, and iron respectively.  <<BR>>  You can also type the res name out as shown below.  <<BR>>  echo "–sellPrice food " + m_city.cityManager.sellPrice(food) <<BR>> <<BR>>  You can check for the amount being traded with the following line: <<BR>>  echo m_city.cityManager.tradesArray[0].amount <<BR>> <<BR>>  What is being traded? To see the resource name being traded use this: <<BR>>  echo m_city.cityManager.tradesArray[0].resourceName<<BR>>  The following will return the resnumber being traded.  <<BR>>  echo m_city.cityManager.tradesArray[0].resType<<BR>> <<BR>>  Is it buying or selling?  <<BR>>  echo m_city.cityManager.tradesArray[0].tradeTypeName<<BR>>echo m_city.cityManager.tradesArray[0].tradeType<<BR>>  1 means selling, 0 means buying <<BR>> <<BR>>  What price is being used in the trade? <<BR>> echo m_city.cityManager.tradesArray[0].price<<BR>> <<BR>>  Curious about what evony calls your trade?<<BR>>echo m_city.cityManager.tradesArray[0].id<<BR>> <<BR>>  How much has it moved so far? <<BR>>echo m_city.cityManager.tradesArray[0].dealedAmount<<BR>>echo m_city.cityManager.tradesArray[0].dealedTotal<<BR>> <<BR>>

=== War references ===
<<BR>>

==== Incoming enemies ====
<<BR>> Do we have incoming armies?<<BR>>echo m_city.cityManager.hasEnemyArmies<<BR>>  This line returns either True or False. <<BR>>echo m_city.cityManager.hasEnemyArmiesWithin(60)<<BR>> This one lets you check if they are closer than 60 seconds.<<BR>> <<BR>> How many attacks are coming?<<BR>>echo m_city.cityManager.NumberOfRealAttacks<<BR>> <<BR>> What is the attackers lordname, cityname and alliance?<<BR>>echo m_city.cityManager.enemyArmies[0].king<<BR>>echo m_city.cityManager.enemyArmies[0].startPosName<<BR>>echo m_city.cityManager.enemyArmies[0].alliance<<BR>> <<BR>> Check if enemy is carrying resources:<<BR>>echo m_city.cityManager.enemyArmies[0].resource.food<<BR>> echo m_city.cityManager.enemyArmies[0].resource.wood<<BR>> echo m_city.cityManager.enemyArmies[0].resource.stone<<BR>> echo m_city.cityManager.enemyArmies[0].resource.iron<<BR>> <<BR>> Check what troops enemy is sending:<<BR>> echo m_city.cityManager.enemyArmies[0].troop.peasants<<BR>> echo m_city.cityManager.enemyArmies[0].troop.militia<<BR>> echo m_city.cityManager.enemyArmies[0].troop.scouter<<BR>> echo m_city.cityManager.enemyArmies[0].troop.pikemen<<BR>> echo m_city.cityManager.enemyArmies[0].troop.swordsmen<<BR>> echo m_city.cityManager.enemyArmies[0].troop.archer<<BR>> echo m_city.cityManager.enemyArmies[0].troop.lightCavalry<<BR>> echo m_city.cityManager.enemyArmies[0].troop.heavyCavalry<<BR>> echo m_city.cityManager.enemyArmies[0].troop.carriage<<BR>> echo m_city.cityManager.enemyArmies[0].troop.ballista<<BR>> echo m_city.cityManager.enemyArmies[0].troop.batteringRam<<BR>> echo m_city.cityManager.enemyArmies[0].troop.catapult<<BR>> <<BR>> What hero is the enemy sending (lvl, name)?<<BR>> echo m_city.cityManager.enemyArmies[0].heroLevel<<BR>> echo m_city.cityManager.enemyArmies[0].hero<<BR>>

----
CategoryHowTo