Akeran IRC Command Reference

(HTTP commands)

CreateDeleteDiplomacyInformationLocationMagicMaintenanceOffenseSystemTrade
armtransfer
build
buybuild
buyconstruct
buyritual
buytrain
construct
found
newplayer
ritual
train
cancel
disband
declare
diplomacy
plmodify
plreplace
plview
balance
help
infobuild
infomap
infospell
infounit
map
mapc
mapt
oqlist
playerlist
top
current
incity
inmarket
mamove
move
msmove
outcity
rmove
scmove
stepmove
addoffering
buylearn
buyoffering
cast
fbuylearn
flearn
lcast
learn
lrecast
recast
research
scancel
startresearch
study
addgoods
armaddgoods
armbehaviour
armcopyorder
armdelorder
armexec
armmode
armreorder
armsetgoods
armsettimes
armwait
citycopyorder
citydelorder
cityexec
citymode
cityreorder
citysettimes
citywaitend
citywaitstart
eaddgoods
earmaddgoods
earmsetgoods
esetgoods
eunitbuy
eunitsell
renamecity
setgoods
setkeptgoods
setlimitgoods
settle
attack
besiege
setorder
setorders
spy
bufferevent
dcc
devalidate
done
email
glog
log
logme
mailevent
maillog
mailpassword
password
register
sendmsg
time
validate
citybuy
citysell
market
setbuyprices
setsellprices
settradelimits
setwantedgoods
tax
unitbuy
unitsell

HELP

Display the help

          help [subject]
Command Type: InformationCan be used: Anywhere
This command show the help files.

DCC

Ask the bot to send you a DCC Chat

          dcc
Command Type: SystemCan be used: Anywhere
This command ask the bot to send you a DCC Chat.

VALIDATE

Validate yourself in the game

          validate <password> [code]
Command Type: SystemCan be used: Anywhere
This command allows you to validate your player when you arrive on channel #akeran. Unless you're validated, you won't be able to send commands to the bot, thus making it impossible for you to play- This prevents players from changing to your nick and using your player when you're not on IRC.
Note:Validation is automatic when a register command is issued, but the DONE command must still be issued before leaving.

DEVALIDATE

Devalidate yourself on the current media

          devalidate
Command Type: SystemCan be used: Anywhere
This command will de-validate your player on the media you send the command when you do not want to use this media to play (for example the DCC you where waiting for is now available so you don't need the 'channel' media. If you play only via dcc the de-validate is done automatically when the connection is closed.
if you don't play via dcc : DON'T FORGET TO DO IT BEFORE LEAVING.

DONE

Devalidate yourself from the game

          done
Command Type: SystemCan be used: Anywhere
This command will de-validate your player when you're done with the game, preventing other players from changing to your nick and using your player while you're not on IRC. If you play only via dcc the de-validate is done automatically when the connection is closed.
if you don't play via dcc : DON'T FORGET TO DO IT BEFORE LEAVING.

REGISTER

Register yourself in the game

          register <email> <user_password>
Command Type: SystemCan be used: Anywhere
This command allows you to register you in the Akeran Game Master. This command must be used before doing a newplayer.

PASSWORD

Change your password

          password <new_password>
Command Type: SystemCan be used: Anywhere
This command allows you to change the password you use to gain access to the game. Don't forget to change your password after a newplayer and write it down-Forgotten or lost passwords can be send at the registered e-mail address with the command 'mailpassword'. You may change the password at any time after you're validated.

MAILPASSWORD

Mail your password to your registered e-mail address

          mailpassword
Command Type: SystemCan be used: Anywhere
This command allows you to send your paswword to your registered e-mail address.

EMAIL

Consult/Change your registered e-mail address

          email [new_email]
Command Type: SystemCan be used: Anywhere
This command allows you to view or change the e-mail used by akeran when you ask him to send you a mail (ex : mailpassword)

MAILEVENT

Modify the list of event types send to you by e-mail

          mailevent { list of <mail_type> }
Command Type: SystemCan be used: Anywhere
This command allows you to change the type of events send to you will by e-mail. If the mail type is not prefixed the mail type will be added to the list. If the mail type is prefixed by "-", the mail type will be removed.
Example :
mailevent msg : Add 'msg' mail type
mailevent -msg : Remove 'msg' mail type
The following mail types are available:
annoucements : Akeran Annoucements (low traffic)
msg : A message from another user
diplomacy : A peace or war declaration from another user
battle : A battle in which you are involved
battledetails : The details about a battle (each round)
magic : The research of a spell is finished
armymagic : Unit's magic commands: study, learn, cast, recast
endofage : A player is (or no longer is) the potential winner
armytrading : A unit is transfering or trading goods
otherstrading : Another player has bought or sell goods in one of your cities
armymove : An army's movement events
othersmoves : Other player's army movements witnessed by your units
spy : Spy events (your units and enemy detected while trying to spy one of your cities)
foundsettle : A settler has founded a new city or settled into an existing city
cityorder : A city order has been executed (trade or construction)
scouting : A unit has scouted a province
loyalty : A unit of yours is loosing moral and/or is deserting (lack of supply)
newplayers : New player events
playersend : Player's end events: players killed, players retiring...
messenger : A messenger arriving in one of your cities (high traffic)

BUFFEREVENT

Modify the list of buffered event types that you will retreive upon login

          bufferevent { list of <buffer_event> }
Command Type: SystemCan be used: Anywhere
This command allows you to change the type of events that you will retreive upon login. If the event type is not prefixed the event type will be added to the list. If the event type is prefixed by "-", the event type will be removed.
Example :
bufferevent battle : Add 'battle' to the buffered event list
bufferevent -battle : Remove 'battle' the buffered event list
The following event types are available:
annoucements : Akeran Annoucements (low traffic)
msg : A message from another user
diplomacy : A peace or war declaration from another user
battle : A battle in which you are involved
battledetails : The details about a battle (each round)
magic : The research of a spell is finished
armymagic : Unit's magic commands: study, learn, cast, recast
endofage : A player is (or no longer is) the potential winner
armytrading : A unit is transfering or trading goods
otherstrading : Another player has bought or sell goods in one of your cities
armymove : An army's movement events
othersmoves : Other player's army movements witnessed by your units
spy : Spy events (your units and enemy detected while trying to spy one of your cities)
foundsettle : A settler has founded a new city or settled into an existing city
cityorder : A city order has been executed (trade or construction)
scouting : A unit has scouted a province
loyalty : A unit of yours is loosing moral and/or is deserting (lack of supply)
newplayers : New player events
playersend : Player's end events: players killed, players retiring...
messenger : A messenger arriving in one of your cities (high traffic)

SENDMSG

Send a message to another player

          sendmsg <target> <message>
Command Type: SystemCan be used: Anywhere
This command allows you to send a message to another player if he or she isn't currently on IRC. The player you sent the message to will receive the message the next time he or she validate.

LOG

Show the log of a province

          log [page_nb] [page_size]
Command Type: SystemCan be used: Anywhere
All major events of the past few weeks are saved to a log. This command allows you to consult the events arrived in the province of your current location.
page_nb : the page number (numbered form the end) to consult (the default is '0' : end of the log)
page_size : the number of events in each page

GLOG

Show the global log (events older than 2 days)

          glog [page_nb] [page_size]
Command Type: SystemCan be used: Anywhere
All major events of the past few weeks are saved to this log. This command allows you to consult those events.
page_nb : the page number (numbered form the end) to consult (the default is '0' : end of the log)
page_size : the number of events in each page

LOGME

Show the contents of your log

          logme [page_nb] [page_size]
Command Type: SystemCan be used: Anywhere
All major events of the past few weeks are saved to a log. This command allows you to consult your events.
page_nb : the page number (numbered form the end) to consult (the default is '0' : end of the log)
page_size : the number of events in each page

MAILLOG

Send your log to your registered e-mail address

          maillog
Command Type: SystemCan be used: Anywhere
This command allows you to send your log to your registered e-mail address.

TIME

Show the current GMT time, next moon and season time

          time
Command Type: SystemCan be used: Anywhere
This command shows you the current GMT time and when will occur the next new moon and the next new season.

NEWPLAYER

Create a new player

          newplayer <race> <province> <city_name>
Command Type: Create(Player)Can be used: Anywhere
This command allows you to create a new player.
race : The race of the inhabittants of your first city, one of : Dwarves, Elves, Nomads, Draconians and Humans
province : the province you want to settle in. The province names can be seen in the Akeran Map (http://www.akeran.org/Map.html).
Note that each province can have at most fifteen cities. To know which race can settle in a particular province, use the INFOMAP command.

PERSON

Show your status

          person
Command Type: Status(Player)Can be used: Anywhere
This command allows you to see your title, the list of cities you control, your alignment, a rough approximation of your status in the face of your god(grace), and other vital statistics of your player.

COUNSELLOR

Measure the abilities of another player to your own

          counsellor <nick>
Command Type: Status(Player)Can be used: Anywhere
This command will measure the abilities of another player to your own, then show whether you can attack him or her without losing grace. This can prove to be useful in uncertain situations-Using this command before you engage an unknown enemy is an especially healthy habit.

BALANCE

Show the number of inhabitants belonging to each god

          balance
Command Type: Information(Players)Can be used: Anywhere
This command show the number of inhabitants belonging to each god.

TOP

Show the 5 first scores of Akeran

          top
Command Type: Information(Players)Can be used: Anywhere
This command shows the 5 first scores of Akeran.

PLAYERLIST

List all the players

          playerlist
Command Type: Information(Players)Can be used: Anywhere
This command allows you to list all the players.

PLVIEW

View all the player lists

          plview
Command Type: DiplomacyCan be used: Anywhere
This command allows you to view all the player lists.

PLMODIFY

Modify a player list

          plmodify <player_list> { list of <player> }
Command Type: DiplomacyCan be used: Anywhere
This command allows you to modify a player list. If the player name is not prefixed the player will be added to the list. If the player name is prefixed by "-", the player will be removed.
A player list can contain player names or special names:
all : all players
peace : players with whom you have a peace treaty
neutral : players with whom you have neither a peace treaty nor a war
war : players with whom you have a declared war
blockades : players which are blocking your army

PLREPLACE

Modify a player list by replacing it's content

          plreplace <player_list> { list of [player] }
Command Type: DiplomacyCan be used: Anywhere
This command allows you to replace the content of a player list.
A player list can contain player names or special names:
all : all players
peace : players with whom you have a peace treaty
neutral : players with whom you have neither a peace treaty nor a war
war : players with whom you have a declared war
blockades : players which are blocking your army

CADVISOR

Consideration (Grace, Honor and Popularity) Advisor

          cadvisor
          pcadvisor
          ccadvisor
Command Type: Status(Player)Can be used: Anywhere
This command allows you to know what influence your different considerations (Grace/Honor/Popularity). The numbers displayed in this command are only a rough evaluation of each kind of influence on the consideration.

DIPLOMACY

Show your diplomacy status

          diplomacy
Command Type: DiplomacyCan be used: Anywhere
Show the diplomacy status with all the others players.

DECLARE

Change your diplomacy state toward another player (Peace or War)

          declare <player> <state>
Command Type: DiplomacyCan be used: Anywhere
Change your diplomacy state toward another player (Peace or War). If you want to cancel your peace treaty offer (not a signed peace treaty), use the special state 'neutral'.

MARKET

Show the price of a market

          market [location]
Command Type: TradeCan be used: Anywhere
This command shows you the tariffs of the regional market nearest to the location you specified. This location may be a province name, a city you own or an army halt location.

INFOMAP

Show the informations on a map location

          infomap [location]
Command Type: Information(Location)Can be used: Anywhere
This command shows you the information on a particular map square.

INFOBUILD

Show the informations on a building

INFOUNIT

Show the informations on a unit

INFOSPELL

Show the informations on a spell

          infobuild <building/unit/spell>
          infounit <building/unit/spell>
          infospell <building/unit/spell>
Command Type: InformationCan be used: Anywhere
This command shows you the characteristics of a type of building or unit and what is required to construct it.
Note : instead of typing the full name, you can just type the first letters that do not conflict with another building or unit. Example : infobuild hu ir means infobuild human ironmine This syntax also works for all the commands that have a 'building/unit' parameter.
The "Needed Buildings" field is especially important, as it displays the type of building(s) required to train the indicated type of building/unit. The numbers of goods show what goods are required to build that building/unit, as well as the production points that must be allocated.

CURRENT

Change the current location

          current <location>
Command Type: LocationCan be used: Anywhere
This command changes the location of your "current square." This is the location that you're currently sending commands to, which may be a city or a realm. Remember that many of the commands you enter will be sent only in relation to the current square.

VIEW

View the location details

          view [location]
Command Type: Status(City)Can be used: Anywhere
This command has three uses, depending on the location. If the location is a city you own, it will show the statistics of that city. If the location is a city you don't own, it will show the name of the owner and the defending buildings. If the location is a realm, this command displays a list of all the cities in that realm and the names of their owners.

FVIEW

View all the location details

          fview [location]
Command Type: Status(City)Can be used: Anywhere
This command has three uses, depending on the location. If the location is a city you own, it will show the statistics of that city. If the location is a city you don't own, it will show the name of the owner and the defending buildings. If the location is a realm, this command displays a list of all the cities in that realm and the names of their owners.

CVIEW

Change the current location and view the location details

          cview <location>
Command Type: Status(City)Can be used: Anywhere
This command is mainly an alias that do a 'current' and a 'view' in one command.

REVIEW

List the units of this location

          review [location]
Command Type: Status(Unit)Can be used: Anywhere
This command will show the units that are in the current square or in location, their statistics, their army and their position (inside / outside / besieging a city).

CREVIEW

Change the current location and list the units of this location

          creview <location>
Command Type: Status(Unit)Can be used: Anywhere
This command is mainly an alias that do a 'current' and a 'review' in one command.

OQLIST

List all your order queues

          oqlist
Command Type: Information(Player)Can be used: Anywhere
This command allows you to list all your order queues.

FOUND

Found a new city

          found [order_mode] { <army> or list of <unit> } <city_name>
Command Type: Create(City)Can be used: In a province
This command will use one settler in your army to found a new city. City founding takes 1 Action point to complete.
city_name : the name of your new city
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)
Note that your army moved into the new city for protection. Also remember that only ONE settler is allowed in the army to found a new city.

SETTLE

Transfer the population of a settler to one of your cities

          settle [order_mode] { <army> or list of <unit> }
Command Type: Maintenance(City)Can be used: In a city you own
This command will use the settlers from army or the list of units to transfer population to one of your city. Population transfers take 1 Action point to complete.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)

SPY

Spy a city of another player

          spy [order_mode] { <army> or list of <unit> }
Command Type: Offense(City)Can be used: In a city of another player
This command allow you to spy another city with a spying unit in order to detect the defending units. Spying a city requires 4 Action points.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)

RENAMECITY

Rename one of your cities

          renamecity <city> [new_name]
Command Type: Maintenance(City)Can be used: In a city you own
This command allow you to rename one of your cities. If you don't put the new_name, this command will show the cost of the 'renamecity' in this city. You can rename a city only once 10 seasons after having taken the city from another player or after it's creation.

CITYREORDER

Change the execution order of the orders

          cityreorder <city> <queue_nb> { list of <order> }
Command Type: Maintenance(City)Can be used: Anywhere
This command allows you to change the execution order of the orders. The order numbers specified will be put at the beginning of the order list. The omitted numbers will be put at the end of the order list in their respective orders.

CITYCOPYORDER

Copy some orders from one order queue to another one

          citycopyorder <city_src> <queue_nb_src> <city_dest> <queue_nb_dest> { list of <order> }
Command Type: Maintenance(City)Can be used: Anywhere
This command allows you to copy selected orders from the first order queue to the second order queue.

CITYDELORDER

Remove orders from a city

          citydelorder <city> <queue_nb> { list of <order> }
Command Type: Maintenance(City)Can be used: Anywhere
This command allows you to remove orders from a city.

CITYSETTIMES

Set the number of times of the orders of a city

          citysettimes <city> <queue_nb> <nb_times> { list of <order> }
Command Type: Maintenance(City)Can be used: Anywhere
This command allows you to set the number of times of the orders of a city.

CITYEXEC

Execute the orders of a city

          cityexec <city> <queue_nb>
Command Type: Maintenance(City)Can be used: Anywhere
This command allow you to execute the orders of the city.

CITYMODE

Change the execution mode of the orders

          citymode <city> <queue_nb> <mode>
Command Type: Maintenance(City)Can be used: Anywhere
This command allows you to change the execution modes of the orders.
activation : This parameter can be :
run : the orders are executed immediately (max 5 at a time)
step : the orders are executed immediately one by one
stop : the orders are not executed (useful for planning)

CITYWAITSTART

Order your city to wait before executing other orders

          citywaitstart [order_mode] <city> <queue_nb> <nb_seasons>
Command Type: Maintenance(City)Can be used: Anywhere
This command allows you to order your city to wait 'nb_seasons' seasons before executing the other orders.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)

CITYWAITEND

Order your city to wait before executing other orders

          citywaitend [order_mode] <city> <queue_nb> <nb_seasons>
Command Type: Maintenance(City)Can be used: Anywhere
This command allows you to order your city to wait 'nb_seasons' seasons before executing the other orders.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)

CITYBUY

Buy goods in one of your city

          citybuy [order_mode] { list of <good_type> <good_number> }
          citybuy [order_mode] { list of <good_number> <good_type> }
Command Type: TradeCan be used: In a city you own
This command allows you to buy goods and have them delivered to one of your cities. The goods are bought at the local market.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)

CITYSELL

Sell goods from one of your city

          citysell [order_mode] { list of <good_type> <good_number> }
          citysell [order_mode] { list of <good_number> <good_type> }
Command Type: TradeCan be used: In a city you own
This command allows you to sell goods from one of your city. The goods are sold at the local market.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)

CONSTRUCT

Build/Train/Enchant a building/unit/ritual in one of your city

BUILD

Build a building in one of your cities

TRAIN

Train a unit in one of your cities

RITUAL

Start a ritual in one of your cities

          construct [order_mode] <building/unit/spell> [production/mana] [number] { list of [priority] }
          build [order_mode] <building/unit/spell> [production] [priority]
          train [order_mode] <building/unit/spell> [production] [number] { list of [priority] }
          ritual [order_mode] <building/unit/spell> [mana] [priority]
Command Type: Create(City)Can be used: In a city you own
This command allows you to build structures to increase the growth of a city. These buildings can produce goods, train new types of units that are stronger than milice, or affect other factors. This command allows you to train milice, settlers, and other units as you build the facilities for them. The units training will be finished after the new season and will be stationed in the city you trained them.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)
production/mana : the number of production points (or mana) you want to allocate towards construction of the unit/building (or ritual) (default : 0). In addition, the citizens working on each building must be paid 50 gold per New Season. If that money isn't available at the beginning of the season, the building in progress will slowly crumble: it becomes "under construction," losing 15% of its production amount.
number : This parameter is significant only for unit training, it allows you to launch the training of multiple units of the same type (maximum : 5). This parameter represents the number of units you want to be trainned of that type in this city.
priority : This parameter allow you to specify in which order the unused production will be automatically allocate between all the unit/buildings in progress (default: 100, highest priority : 1 ). If you train multiple units, you can set a different priority for each one.
To be able to build buildings or train units, you'll need goods like wood, leather or iron. e.g. to build a granary, you need 5 woods that you should own before starting the construction.

BUYCONSTRUCT

Buy the necessary goods and Build/Train/Enchant a building/unit/ritual in one of your city

BUYBUILD

Buy the necessary goods and build a building in one of your city

BUYTRAIN

Buy the necessary goods and train a unit in one of your city

BUYRITUAL

Buy the necessary goods and build a building in one of your city

          buyconstruct [order_mode] <building/unit/spell> [production/mana] [number] { list of [priority] }
          buybuild [order_mode] <building/unit/spell> [production] [priority]
          buytrain [order_mode] <building/unit/spell> [production] [number] { list of [priority] }
          buyritual [order_mode] <building/unit/spell> [mana] [priority]
Command Type: Create(City)Can be used: In a city you own
This command allows you to buy all the needed goods for the construction and then construct them.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)

CANCEL

Destroy a building/unit/ritual in a city

          cancel <building/unit/spell>
Command Type: Delete(City)Can be used: In a city you own
This command destroys a built building, an established ritual or a unit/building/ritual in progress in your current city. Since each building requires maintenance, you may resort to destroying buildings when you're short of funds. If you have multiple unit of the same type under trainning, only the last one will be cancelled.

TAX

Change the tax rate of one of your cities

          tax <amount> { list of [city] }
Command Type: Trade(City)Can be used: In a city you own
This command will levy taxes on the specified city or the city in your current square.
amount : the amount of gold (1-3, or 0 for no taxes) that each member of that city's population will be charged with paying to you each New Season.
city : the target city (default = current location)
Note: If you lack grace or the population of the target city is too high or too low when larger taxes are levied, your population growth will slow to a crawl.

ADVISOR

Money Advisor

          advisor
Command Type: StatusCan be used: Anywhere
This command shows you how much gold you need to maintain all of your buildings in all of your cities. It also shows your current tax rates for each city. It helps to use this command before a new season to make sure you'll have enough gold for the calculated amount.

GADVISOR

Goods Advisor

          gadvisor
Command Type: StatusCan be used: Anywhere
This command shows you how much goods you have in your cities and armies.

PADVISOR

Production Advisor

          padvisor
Command Type: StatusCan be used: Anywhere
This command shows you how much production you have in your cities and what are the building/unit currently being produced.

SADVISOR

Supply Advisor

          sadvisor
Command Type: StatusCan be used: Anywhere
This command shows you how much supply is produced by your cities and consumed by armies.

LOCATE

Locate all your units

          locate [option] [location]
Command Type: Status(Unit)Can be used: Anywhere
This command allows you to know where your armies and units are.
option : the option can be :
all : put the army name and the type of the units (default)
army : put the army name of the units
type : put the type of the units
none : put only the number of units per location
location : If present, the command will only show the units in that location

DISBAND

Disband a list of units

          disband { <army> or list of <unit> }
Command Type: Delete(Unit)Can be used: On your own units
This command disbands a specified army or list of unit numbers in your current square. This can be useful if you can't afford the cost in food to maintain a unit.

SETKEPTGOODS

Set the number of goods that will not be allocated to in progress building/units/spells

          setkeptgoods { list of <good_type> <good_number> }
Command Type: Maintenance(City)Can be used: In a city you own
This command allows you to change the amounts of goods you do not want to automatically allocate to in progress building/units/spells. This command is especially useful to keep goods for the studies of your magical units. It can also be used to allocate only part of the available goods to a building in order to keep goods for another building/unit/spell you plan on building/training/enchanting.
Note: The kept goods will be used for an in progress building/units/spells if it would result in buying goods available in your city's stock.

SETLIMITGOODS

Set the maximum number of goods kept after a new season in one of your cities

          setlimitgoods { list of <good_type> <good_number> }
Command Type: Maintenance(City)Can be used: In a city you own
This command allows you to change the maximum amounts of goods you retain after a New Season-All goods past each limit will automatically be sold when the New Season occurs. Note that if the number of goods still exceed the good capacity of the city after this automatic selling, the excedent will be sold automatically.

SETTRADELIMITS

Set the maximum number of goods traded in one of your cities

          settradelimits { list of <good_type> <good_number> }
Command Type: Trade(City)Can be used: In a city you own
This command allows you to change the maximum amounts of goods you retain before proposing them at the trade center of you city. Another player can buy them when some of his non fighting units come to your city.

SETWANTEDGOODS

Set the maximum number of goods wanted in one of your cities

          setwantedgoods { list of <good_type> <good_number> }
Command Type: Trade(City)Can be used: In a city you own
This command allows you to change the amounts of goods you want to buy from other players' trading caravans. Another player can sell them to you city when some of his non fighting units come to your city.

SETSELLPRICES

Set the selling prices in one of your cities

          setsellprices { list of <good_type> <good_number> }
Command Type: Trade(City)Can be used: In a city you own
This command allows you to change the sell prices of the goods in your city. The sell prices are used when you sell goods to other players.

SETBUYPRICES

Set the buying prices in one of your cities

          setbuyprices { list of <good_type> <good_number> }
Command Type: Trade(City)Can be used: In a city you own
This command allows you to change the buy prices of the goods in your city. The buy prices are used when you buy goods from other players.

ADDGOODS

Distribute goods among your units in one of your cities

EADDGOODS

Distribute goods among your units in one of your cities (extended syntax)

          addgoods [order_mode] { <army> or list of <unit> } <good_type> <good_number>
          addgoods [order_mode] { <army> or list of <unit> } <good_number> <good_type>
          eaddgoods [order_mode] { <army> or list of <unit> } - { list of <good_number> <good_type> }
          eaddgoods [order_mode] { <army> or list of <unit> } - { list of <good_type> <good_number> }
Command Type: Maintenance(Unit)Can be used: In a city you own
This command allows you to distribute goods among your units. It is instumental for trading or delivering goods to another city of yours.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)
good_number : the number of goods to add (positive) or remove (negative)
good_type : the type of good (greenstone, herb, wood, leather, iron) or 'all'
unit : the army or the list of unit number (in the current location) that will be modified
Note : the resulting number of goods of the unit will still be in the allowed range : 0 <= value <= max value in the profile
Note 2 : Do not forget the '-', in the 'extended syntax' command has shown in the syntax to separate the unit list from the good list.

SETGOODS

Set the number of goods of your units in one of your cities

ESETGOODS

Set the number of goods of your units in one of your cities (extended syntax)

          setgoods [order_mode] { <army> or list of <unit> } <good_type> <good_number>
          setgoods [order_mode] { <army> or list of <unit> } <good_number> <good_type>
          esetgoods [order_mode] { <army> or list of <unit> } - { list of <good_number> <good_type> }
          esetgoods [order_mode] { <army> or list of <unit> } - { list of <good_type> <good_number> }
Command Type: Maintenance(Unit)Can be used: In a city you own
This command allows you to set the number of goods of your units. It is instumental for trading or delivering goods to another city of yours.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)
good_number : the number of goods to set
good_type : the type of good (greenstone, herb, wood, leather, iron) or 'all'
unit : the army or the list of unit number (in the current location) that will be modified
Note : the resulting number of goods of the unit will still be in the allowed range : 0 <= value <= max value in the profile
Note 2 : Do not forget the '-', in the 'extended syntax' command has shown in the syntax to separate the unit list from the good list.

ARMADDGOODS

Distribute goods among your units in one of your cities

EARMADDGOODS

Distribute goods among your units in one of your cities (extended syntax)

          armaddgoods [order_mode] <unit> { <target_army> or list of <target> } <good_type> <good_number>
          armaddgoods [order_mode] <unit> { <target_army> or list of <target> } <good_number> <good_type>
          earmaddgoods [order_mode] <unit> { <target_army> or list of <target> } - { list of <good_number> <good_type> }
          earmaddgoods [order_mode] <unit> { <target_army> or list of <target> } - { list of <good_type> <good_number> }
Command Type: Maintenance(Unit)Can be used: In a city you own
This command allows you to distribute goods among your units. It is instumental for trading or delivering goods to another city of yours.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)
good_number : the number of goods to add (positive) or remove (negative)
good_type : the type of good (greenstone, herb, wood, leather, iron) or 'all'
target : the target army or the list of target unit number (in the army's location)
Note : the resulting number of goods of the unit will still be in the allowed range : 0 <= value <= max value in the profile
Note 2 : Do not forget the '-', in the 'extended syntax' command has shown in the syntax to separate the unit list from the good list.

ARMSETGOODS

Set the number of goods of your units in one of your cities

EARMSETGOODS

Set the number of goods of your units in one of your cities (extended syntax)

          armsetgoods [order_mode] <army> { <target_army> or list of <target> } <good_type> <good_number>
          armsetgoods [order_mode] <army> { <target_army> or list of <target> } <good_number> <good_type>
          earmsetgoods [order_mode] <unit> { <target_army> or list of <target> } - { list of <good_number> <good_type> }
          earmsetgoods [order_mode] <unit> { <target_army> or list of <target> } - { list of <good_type> <good_number> }
Command Type: Maintenance(Unit)Can be used: In a city you own
This command allows you to set the number of goods of your units. It is instumental for trading or delivering goods to another city of yours.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)
good_number : the number of goods to set
good_type : the type of good (greenstone, herb, wood, leather, iron) or 'all'
target : the target army or the list of target unit number (in the army's location)
Note : the resulting number of goods of the unit will still be in the allowed range : 0 <= value <= max value in the profile
Note 2 : Do not forget the '-', in the 'extended syntax' command has shown in the syntax to separate the unit list from the good list.

UNITBUY

Buy goods in some of your units

EUNITBUY

Buy goods in some of your units (extended syntax)

          unitbuy [order_mode] { <army> or list of <unit> } <good_type> <good_number>
          unitbuy [order_mode] { <army> or list of <unit> } <good_number> <good_type>
          eunitbuy [order_mode] { <army> or list of <unit> } - { list of <good_number> <good_type> }
          eunitbuy [order_mode] { <army> or list of <unit> } - { list of <good_type> <good_number> }
Command Type: TradeCan be used: In a market or a city of another player
This command allows your non fighting units to buy goods from a market (a province market or a city trade center). If you specify a negative value for one of the goods, those goods will be sold. The exchange takes 1 Action point to complete.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)
Note : Do not forget the '-', in the 'extended syntax' command has shown in the syntax to separate the unit list from the good list.

UNITSELL

Sell goods from some of your units

EUNITSELL

Sell goods from some of your units (extended syntax)

          unitsell [order_mode] { <army> or list of <unit> } <good_type> <good_number>
          unitsell [order_mode] { <army> or list of <unit> } <good_number> <good_type>
          eunitsell [order_mode] { <army> or list of <unit> } - { list of <good_number> <good_type> }
          eunitsell [order_mode] { <army> or list of <unit> } - { list of <good_type> <good_number> }
Command Type: TradeCan be used: In a market or a city of another player
This command allows your non fighting units to sell goods from a market (a province market or a city trade center). If you specify a negative value for one of the goods, those goods will be bought. The exchange takes 1 Action point to complete.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)
Note : Do not forget the '-', in the 'extended syntax' command has shown in the syntax to separate the unit list from the good list.

ARMTRANSFER

Transfer units into an army

ARMMERGE

Merge two armies

          armtransfer <army> { <army> or list of <unit> }
          armmerge <army> { <army> or list of <unit> }
Command Type: Create(Army)Can be used: where you have units
This command allows you to transfer units into the army "army". <unit_list> can be either the list of unit numbers (as seen in REVIEW), ALL to transfer all units in the current location, or another army (the two armies must be in the same location) If the army exist, it must be in the same location as the current square. If the army does not exist, it will be created automatically

ARMVIEW

View the units and the orders of an army

          armview <army>
Command Type: Status(Army)Can be used: Anywhere
This command displays you your army's current location and the units that are in it. This command is useful to know which units have no movement or attack points left.

ARMREORDER

Change the execution order of the orders

          armreorder <army> { list of <order_nb> }
Command Type: Maintenance(Army)Can be used: Anywhere
This command allows you to change the execution order of the orders. The order numbers specified will be put at the beginning of the order list. The omitted numbers will be put at the end of the order list in their respective orders.

ARMCOPYORDER

Copy some orders from one order queue to another one

          armcopyorder <army_src> <army_dest> { list of <order> }
Command Type: Maintenance(Army)Can be used: Anywhere
This command allows you to copy selected orders from the first order queue to the second order queue.

ARMDELORDER

Remove orders from an army

          armdelorder <army> { list of <order> }
Command Type: Maintenance(Army)Can be used: Anywhere
This command allows you to remove orders from an army.

ARMSETTIMES

Set the number of times of the orders of an army

          armsettimes <army> <nb_times> { list of <order> }
Command Type: Maintenance(Army)Can be used: Anywhere
This command allows you to set the number of times of the orders of an army.

ARMEXEC

Execute the orders of an army

          armexec <army>
Command Type: Maintenance(Army)Can be used: Anywhere
This command allow you to execute the orders of the army.

ARMMODE

Change the execution mode of the orders

          armmode <army> [mode] [behaviour] [behaviour_target]
Command Type: Maintenance(Army)Can be used: Anywhere
This command allows you to change the execution modes of the orders.
activation : This parameter can be :
run : the orders are executed immediately (max 5 at a time)
step : the orders are executed immediately one by one
stop : the orders are not executed (useful for planning)
behaviour : This parameter can be :
unobstrusive : the army will not stop nor stop other units when encountering other players' units
wary : the army will stop or stop other units when encountering other players' units
patrol : the army will attack automatically any army belonging to a player listed as behaviour target. If the player is not in the target list, the behaviour reverts to wary
guard : this behaviour is identical to 'patrol' except that the army will never attack when moving
ambush : this army will try to ambush any army belonging to a player listed as behaviour target. When the army move or if the player is not in the target list, the behaviour reverts to discreet
behaviour_target : This parameter defines the list of players that will be the target of the behaviours 'patrol', 'guard' or 'ambush'

ARMBEHAVIOUR

Change the behaviour of the army towards other players' units

          armbehaviour <army> <behaviour> [behaviour_target]
Command Type: Maintenance(Army)Can be used: Anywhere
This command allows you to change the behaviour of the army towards other players' units.
behaviour : This parameter can be :
unobstrusive : the army will not stop nor stop other units when encountering other players' units
wary : the army will stop or stop other units when encountering other players' units
patrol : the army will attack automatically any army belonging to a player listed as behaviour target. If the player is not in the target list, the behaviour reverts to wary
guard : this behaviour is identical to 'patrol' except that the army will never attack when moving
ambush : this army will try to ambush any army belonging to a player listed as behaviour target. When the army move or if the player is not in the target list, the behaviour reverts to discreet
behaviour_target : This parameter defines the list of players that will be the target of the behaviours 'patrol', 'guard' or 'ambush'

ARMSCOUT

Scout the location of an army

          armscout [order_mode] <army>
Command Type: Status(Location)Can be used: Anywhere
This command allows you to scout the current location of your army. The scouting results are also added to your maps. The scouting takes 1 Action point to complete.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)

ARMWAIT

Order your army to wait before executing other orders

          armwait [order_mode] <army> <nb_moons>
Command Type: Maintenance(Army)Can be used: Anywhere
This command allows you to order your army to wait 'nb_moons' moons before executing the other orders.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)

INCITY

Move your units inside one of your city

          incity [order_mode] { <army> or list of <unit> }
Command Type: Location(City)Can be used: At a city you own
This command moves an army or a list of units into a city under your rule, if they are already outside its gates. When you build a wall, your units' defense will be increased when you move units inside.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)

OUTCITY

Move your units outside a city

          outcity [order_mode] { <army> or list of <unit> }
Command Type: LocationCan be used: Anywhere
This command moves an army or a list of units outside a city.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)

INMARKET

Move your non fighting units inside a market

          inmarket [order_mode] { <army> or list of <unit> }
Command Type: Location(Market)Can be used: In a market
This command moves an army or a list of units into a market, if they are already outside its gates. You need to be inmarket if you want to trade.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)

BESIEGE

Besiege a city belonging to an enemy player

          besiege [order_mode] { <army> or list of <unit> }
Command Type: OffenseCan be used: When your units are at an enemy city
This command will summon an army or a list of unit number(or all units that you own in the city's square with the ALL command) to lay siege to an enemy city. While the city is under siege, the player who owns that particular city will not be able to buy any food, and production and food growth at the beginning of the New Season will be reduced(The reduction factor is based on the strength of the units assigned to siege the city). If a unit is laying siege to a city for one season or longer, the strength of that unit will be increased by 10 times for as long as its siege continues(Until that unit is moved, disbanded or destroyed). Several players can maintain a siege, and when a player attacks another player laying siege to a city, all units currently laying siege will join the battle no matter what alleigance they follow. Besieging uses 1 Action point every season.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)

STUDY

Move your units inside one of your city

          study [order_mode] { <army> or list of <unit> }
Command Type: Magic(Unit)Can be used: At a city you own
This command orders magical units to study the Magical Art in order for the unit to be able to learn spells of a higher level. The studies of the Magical Art are long so they need to study it during several seasons. The magical unit can only progress if there is a magical building of a higher magical level than the unit's current magical level. Studying uses 2 Action points every season. Every 5 points of Magic Level, the unit needs 1 GreenStone and 1 Herb to continue its studies.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)

MOVE

Move your units

          move [order_mode] { <army> or list of <unit> } <destination>
Command Type: Location(Unit)Can be used: Anywhere
This command allows you to move an army or a list of unit. 'destination' can be either a province or a city. The destination is added to the list of waypoints of an automatically created army. This army is moved along the path of the waypoints until the destination is reached, the army has used all his movement points or your army encounter an enemy army along the road. Your current square will be updated to the location where the units stopped. This chart shows the cost in MPs for each unit to move between certain squares. Note that to move to another city in the same realm, your units must move to the realm square first, then to the other city from there. __From:______To:_______Cost___ | City | Province | 4 MP | | Province | City | 4 MP | | Province | Province | 9 MP |
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)

SCMOVE

Move your units and scout the locations along the path

          scmove [order_mode] { <army> or list of <unit> } <destination>
Command Type: Location(Unit)Can be used: Anywhere
This command allows you to move an army or a list of unit and scout the locations (province and cities) along the path.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)

MAMOVE

Move your units market by market

          mamove [order_mode] { <army> or list of <unit> } <destination>
Command Type: Location(Unit)Can be used: Anywhere
This command allows you to move an army or a list of unit market by market e.g. your units will wait to have enough movement to be able to reach the next market (province or city) before moving so that your units only stop in a market. This command is particularly useful for non fighting units that are protected inside the markets.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)

MSMOVE

Move your units market by market and scout the locations along the path

          msmove [order_mode] { <army> or list of <unit> } <destination>
Command Type: Location(Unit)Can be used: Anywhere
This command allows you to move an army or a list of unit market by market and scout the locations (province and cities) along the path. e.g. your units will wait to have enough movement to be able to reach the next market (province or city) before moving so that your units only stop in a market This command is particularly useful for non fighting units that are protected inside the markets.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)

STEPMOVE

Move your units of a specific number of steps

          stepmove [order_mode] { <army> or list of <unit> } <start> <nb_step> <destination>
Command Type: Location(Unit)Can be used: Anywhere
This command allows you to move an army of a specific number of steps. 'destination' can be either a province or a city. The step destination (the location that is NbStep from Start towards Destination) is added to the list of waypoints of the army. Your army is moved along the path of the waypoints until the destination is reached, the army has used all his movement points or your army encounter an enemy army along the road.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)

RMOVE

Move your units without changing your current square

          rmove [order_mode] { <army> or list of <unit> } <location> <destination>
Command Type: Location(Unit)Can be used: Anywhere
This command allows you to move an army or a list of unit without moving your current square ("remote move"). 'start' and 'destination' can be either a province or a city. The destination is added to the list of waypoints of an automatically created army. This army is moved along the path of the waypoints until the destination is reached, the army has used all his movement points or your army encounter an enemy army along the road. This chart shows the cost in MPs for each unit to move between certain squares. Note that to move to another city in the same realm, your units must move to the realm square first, then to the other city from there. __From:______To:_______Cost___ | City | Province | 4 MP | | Province | City | 4 MP | | Province | Province | 9 MP |
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)

SETORDER

Set one battle order on a list of units

          setorder [order_mode] { <army> or list of <unit> } <plan_nb> <order_str>
Command Type: Offense(Unit)Can be used: Anywhere
This command allows you to change an order in one of the battle plan among your units. This orders will be used during a battle.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)
order_str : the new order to set, it can be :
E : Engage at maximum initiative
D3 : Defense with initiative 3
plan_nb : the number of the battle plan to change.
Note : the order initiative can not exceed the unit initiative.

SETORDERS

Set all the battle order on a list of units

          setorders [order_mode] { <army> or list of <unit> } <order_str1> <order_str2> <order_str3> <order_str4>
Command Type: Offense(Unit)Can be used: Anywhere
This command allows you to change all the orders among your units. This orders will be used during a battle.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)
orderx : the new order to set in battle plan 'x', it can be :
E : Engage at maximum initiative
D3 : Defense with initiative 3
Note : the order initiative can not exceed the unit initiative.

ATTACK

Attack an enemy player

          attack [order_mode] <player> <plan> { <army> or list of <unit> }
Command Type: OffenseCan be used: When your army is near enemy units
This command will order an army or a list of units to attack all units in its current location that belong to the specified player. Only those units in your army will attack the enemy, even if you have other units in the current location (except if you attack units besieging a city). Note that if a city is attacked and all the enemy units both inside and outside that city are completely eliminated by the attacking army, the attacking player will gain control of that city. Also note that if you attack a city of a player smaller than you (see COUNSELLOR) you will lose grace for each attack even if you don't capture the city. Attacks take 1 Action point to complete.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)
plan : The attack plan to use :
1, 2 or 3 : Use the orders from the specified attack plan
5 : Normal attack orders: melee units use 'E' as order, missile use 'Mb', others use 'D'
6 : Aggressive attack orders: melee units use 'C' as order, missile use 'Mo', others use 'D'

STARTRESEARCH

Start or modify the current spell research

          startresearch { list of <domain> } - [mode]
Command Type: MagicCan be used: Anywhere
This commands allow you to start a new research or modify the current research.
domain : domain in which the research will be done (an allegiance (Briac or Khorg) or a race name)
mode : The mode can be (only meaningful when there is a research in way) :
normal : set the next research domain (the current one is not modified) (default)
overwrite : abort the current research and start a new one

RESEARCH

Allocate mana to the current research

          research <percentage> [mana]
Command Type: MagicCan be used: Anywhere
This commands also allow you to change the percentage of mana allocated to the research (if you choose 0 as value, only the unused mana that exceed your mana pool will be used to research spells) and/or allocate some mana to the research from your mana pool.
percentage : percentage of mana allocated to the research each moon (the percentage is computed on the mana gained minus the mana ritual upkeep)
mana : mana to allocate to the current research (default = 0)

MADVISOR

Magical Advisor

          madvisor
Command Type: StatusCan be used: Anywhere
This command shows you how much mana you need to maintain all of your rituals in all of your cities. It also shows the research in progress and the in progress rituals.

LEARN

Get a magical unit to learn a new spell

          learn [order_mode] <unit> <spell>
Command Type: MagicCan be used: In a city you own
This command allow a magic unit to learn a new spell in one of your city. The city must have an established ritual for this spell so that the spell is available for learning. Learning a spell takes 2 Action points to complete.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)

FLEARN

Get a magical unit to learn a new spell

          flearn [order_mode] <unit> <spell>
Command Type: MagicCan be used: In a city you own
This command allow a magic unit to learn a new spell in one of your city. The city must have an established ritual for this spell so that the spell is available for learning.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)

BUYLEARN

Buy the necessary goods and Get a magical unit to learn a new spell

          buylearn [order_mode] <unit> <spell>
Command Type: MagicCan be used: In a city you own
This command allows you to buy all the needed goods for the learning and allow a magic unit to learn a new spell in one of your city. The city must have an established ritual for this spell so that the spell is available for learning.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)

FBUYLEARN

Buy the necessary goods and Get a magical unit to learn a new spell

          fbuylearn [order_mode] <unit> <spell>
Command Type: MagicCan be used: In a city you own
This command allows you to buy all the needed goods for the learning and allow a magic unit to learn a new spell in one of your city. The city must have an established ritual for this spell so that the spell is available for learning.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)

CAST

Cast a spell on a unit

          cast [order_mode] <unit> { <target_army> or list of <target> } <spell> [cast_power] [mana_kept]
Command Type: MagicCan be used: Where you have magical units
This command allow a magic unit to cast a spell or a rune.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)
target : The target units of the spell. Check the profile for the possible types.
cast_power : The cast power allow you to multiply the effects or the duration of the spell if it's allowed for the spell (Default: 1)
mana_kept : The percentage of mana that the magical units will keep.

LCAST

Cast a spell on a location or city

          lcast [order_mode] <unit> <spell> [cast_power] [mana_kept]
Command Type: MagicCan be used: Where you have magical units
This command allow a magic unit to cast a spell on a location or city.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)
cast_power : The cast power allow you to multiply the effects or the duration of the spell if it's allowed for the spell (Default: 1)
mana_kept : The percentage of mana that the magical units will keep.

RECAST

Recast burnout spells

          recast [order_mode] <unit> <mana_kept> { <target_army> or list of <target> }
Command Type: MagicCan be used: Where you have magical units
This command allow a magic unit to recast burnout spells. This command is useful to quickly recast all the burnout and partially used spells of your units, provided that your magic units have enough mana. All the burnout spells of the target will be recasted before any partially used spell is recasted. So, if you have enough mana to recast all the burnout spells but not all the partially used spells, at least all your burnout spells will be recasted. Nota: If the 'mana_kept' is set too high, the magical units may not have enough mana to cast a single spell even if the mana pool is full. So, it is better to set the mana kept percentage between 0 and 80.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)
mana_kept : The percentage of mana that the magical units will keep.
target : The target units on which the burnout spells and partially used spells will be recasted.

LRECAST

Recast burnout spells on a location or city

          lrecast [order_mode] <unit> <mana_kept>
Command Type: MagicCan be used: Where you have magical units
This command allow a magic unit to recast burnout spells on a location or city. This command is useful to quickly recast all the burnout and partially used spells of a location or city, provided that your magic units have enough mana. All the burnout spells of the target will be recasted before any partially used spell is recasted. So, if you have enough mana to recast all the burnout spells but not all the partially used spells, at least all your burnout spells will be recasted. Nota: If the 'mana_kept' is set too high, the magical units may not have enough mana to cast a single spell even if the mana pool is full. So, it is better to set the mana kept percentage between 0 and 80.
order_mode : The order mode can either be: (this parameter is only useful if the next parameter is an army)
+ : queue the order in the army order list or in a city order list. When the target is a city, a number can be appended to the '+' to select a different order queue
= : execute the order immediately, bypassing the army order list
* : put the order in a named order queue whose name is taken from the current location (city orders) or from the army name (army orders)
mana_kept : The percentage of mana that the magical units will keep.

SCANCEL

Cancel a casted spell on a unit

          scancel { <army> or list of <unit> } <spell>
Command Type: MagicCan be used: Where you have units
This command allow you to remove a casted spell from a unit

ADDOFFERING

Add offering to the magical buildings

          addoffering
Command Type: MagicCan be used: In a city you own
This command allow you to add some offering to the magical buildings. You need to do regular offering in your magical buildings, if you want to focus mana for your magical units. If you don't do it the amount of mana gained each moon in the city will be very small.

BUYOFFERING

Buy the necessary goods and add offering to the magical buildings

          buyoffering
Command Type: MagicCan be used: In a city you own
This command allow you to buy all the needed goods for the offering and then add the offering to the magical buildings.

MAP

View the cities and trade offers you have discovered

          map
Command Type: Information(Cities)Can be used: Anywhere
This command allow you to view all the city and trade offers you have discovered.

MAPC

View the cities you have discovered

          mapc
Command Type: Information(Cities)Can be used: Anywhere
This command allow you to view all the city you have discovered.

MAPT

View the trade offers you have discovered

          mapt
Command Type: Information(Cities)Can be used: Anywhere
This command allow you to view all the trade offers you have discovered.