code test_robot
{
   ...
   if(arg1)
   {
      // здесь temp еще не видна
      long temp;
      ...// работа с temp
   }
   else
   {
     // здесь temp уже не видна.
     long temp1;// эта переменная займет в памяти место temp
     ...// работа с temp1
   }
   // здесь не видны ни temp ни temp1.
  
}

   Оборудование определяется перед кодом скрипта:

equipment
{
   front scaner;             // спереди - сканер
   left gun;                     // слева - ракетница
   right assembler;      // справа - сборщик
   back scaner;            // сзади - сканер
} 

   Далее следует сам код.

 Написание кода.

  Точка входа программы, управляющей роботом- функция main(). Она должны быть объявлена в коде любого робота. При этом написание кода вне функций не допускается.

В скрипте робота вы можете использовать базовые языковые средства, как то метки и условные переходы:

code test
{
   void main(){
loop:
    step;
    if(m_x>0) goto loop;
    right;
    goto loop;
  }
} 

В большинстве случаев для тех же целей лучше подходят конструкции if( ){ }else{ } и for(;;){ } :

code test
{
 var personal{long i;}
 void main(){
   for(;;)
   {
      for(i=0;i<10;i++)step;
      if(m_x>100) right;
         else left;
      if(i!=10)step;
    }
  }
}

   Так же для удобства написания кода и возможности создания обработчиков вы можете использовать функции. Общий вид объявления функции как в С. Может возвращать значение и иметь до 31 параметра (если надо больше- пишите). Пока единственный доступный тип- long.

long test_step()
{
   step;
   return ret_step;
}

void test_right(long side)
{
   long i;
   for(i=0;i<side;i++) right;
}

Вызвать функцию можно, просто указав ее имя:  test(); 
Допускается вложенный вызов. Досрочный выход из текущей функции осуществляется командой return; Если функция возвращает значение, ее можно использовать в произвольных выражениях, в т.ч. в параметре if. Например, допустимы следующие выражения: arg1+=test(arg2+10); если конечно функция test определена как long test(long a);

Написание выражений.

    В качестве параметров  операторов if и for, а так же в основном коде можно использовать произвольные выражения. Значение, принятое в качестве параметра условного выражения, считается истиной, если оно не равно нулю, и ложью в противном случае. Логические операторы возвращают значение 1, если выражение истинно, иначе 0 . В настоящий момент доступны следующие операторы (перечислены в порядке уменьшения приоритета при группировке):

Для указания любого другого порядка вычислений применяется оператор круглая скобка (), группирующий операнды. Как и в С не выделяется отдельного логического типа данных. Вы можете спокойно писать выражения типа a=b!=c, что будет воспринято как a=(b!=c) и a будет присвоено значение 1, если b!=c и 0 в противном случае. Также нет никаких ограничений на оператор присвоения. Ничто не мешает написать, скажем, так: a=b=c=d=1 или if((a=b+c)>=3) step;

 Комментарии.

Комментарии так же из С. Строчный // комментарий
 исключает из компиляции ту часть строки, которая стоит не левее его, и /*многострочный
  коментарий*/, позволяющий исключить из компиляции большие куски текста.

 Обмен информацией.

Для организации эффективной обороны и нападения роботы должны обмениваться информацией. Для этого в игре существует два механизма: через глобальные переменные и напрямую. С глобальными переменными все ясно: один (или несколько) роботов меняют глобальные переменные, а остальные наблюдают их значения и делают выводы. Напрямую информацию можно передавать двумя способами: посредством отправки сообщения или изменяя common переменные другого робота. Доступ осуществляется по уникальному идентификатору (m_robid для самого робота). Это фактически номер робота в порядке создания. У базового робота идентификатор равен нулю. Робот получает эти характеристики, просто посмотрев на другого робота. При этом независимо от командной принадлежности заполняется поле v_robid - идентификатор увиденного робота.

Изменить или получить common переменную другого робота можно двумя функциями: setcomm(id,dest,value) и getcomm(id,src,var), где dest и src- common- переменные робота с идентификатором id, а value и var- соответственно источник и приемник значения.

Сообщения посылаются роботу при помощи функции postevent(id,MSG_ID), где MSG_ID- идентификатор сообщения. В каждом коде можно поставить обработчик на любое объявленное сообщение. Для этого в блоке кода необходимо создать функцию - обработчик, а в начале программы зарегистрировать сообщение и сопоставить ему обработчик:

sethandler(TM_TEST,onTest);  // регистрируем сообщение TM_TEST
                             // и сопостовляет ему функцию onTest()
code test
{
  void onTest()  // это объявление обработчика
  {
     step;
  }
}
code test2
{
  void main(){
   postevent(v_robid,TM_TEST); // посылаем увиденному роботу
                                               // сообщение TM_TEST.
  }
}

 Вам не следует подставлять вместо идентификатора сообщения константу в явном виде. Система сама сопоставит идентификатору уникальную константу и произведет замену по тексту.

 Стандартные события.

   Сейчас определены только четыре пары обработчик- событие. Это:

• sethandler(TM_CREATE,onCreate);
• sethandler(TM_TICK,onTick);
• sethandler(TM_HIT,onHit);
• sethandler(TM_DIE,onDie);

Эти события создаются при соответствующих обстоятельствах. Если вы знаете, о чем еще нужно уведомлять робота - пишите.

При вызовах функций onHit и onDie заполняется поле m_hitside, указывающее на стороны роботы, в которую попала ракета. Из функции onHit() можно быстро отреагировать на атаку, из onDie() разве что написать завещание...

onTick() вызывается каждый такт.

onCreate() вызывается при создании робота. Эта функция выполняется первой (если она объявлена).

Все обработчики вызываются так, словно их вызвали из текущего места в скрипте, то есть основной скрипт не продолжит выполняться, если обработчик не завершится. А квота машинного времени одна на весь такт, так что если в onTick() вы будете вызывать функцию step; то основной скрипт ВООБЩЕ НИКОГДА не будет выполняться.

В заключение замечу, что очередь сообщений имеет 64 места. Остальные сообщения не принимаются. Если нужно больше - пишите, увеличу. Сейчас это для контроля ошибок.

Библиотеки функций.

   Для выполнения одинаковых действий разными роботами предусмотрены библиотечные роботы. Это чисто логическая единица, так что строить их не надо. Для того, чтобы сделать робота библиотекой, достаточно назвать его library:

code library
{
   ...
}

Функции, определенные в этом коде, доступны всем роботам колонии. Код не может иметь персональные переменные и не может обращаться к персональным переменным других роботов. Всю необходимую информацию можно передавать через глобальные и общие (common) переменные, а так же в параметрах функций.

Наследование скриптов.

   Возможна ситуация, когда группа роботов выполняет сходные действия и может быть описана одним и тем же скриптом с небольшими изменениями в зависимости от типа робота. Например, скрипты всех боевых роботов могут быть одинаковыми вне зависимости от их типа. Для упрощения кода в этой ситуации введена возможность наследования скрипта. Для указания, что данный тип роботов наследует скрипт другого робота (например с именем parent), в код наследующего робота необходимо вставить инструкцию:
script parent; // parent- имя робота, скрипт которого наследуется
Для различения скриптом типа текущего робота введены переменные m_name - имя текущего робота (указанное в заголовке code ...), m_type - полный тип текущего робота и m_10power - удесятеренная мощность робота. Если в наследующем роботе не указать оборудование, оно будет унаследовано, а если указать- нет.

Пример:
code child
{
   type rush;
   script parent;
}

code parent
{
   type warrior;
   void main()
   {
     if(m_name==child) {...}
     else {...}
     ...
   }
}

 Информация о внешнем мире.

Систематизируем те источники информации о внешнем мире (в том числе о себе), которые предоставлены роботу.
   1. Собственное положение в пространстве.
Роботу передаются его абсолютные координаты(m_x и m_y), направление(m_direct).
   2. Личные данные.
Команда, к которой принадлежит робот- всегда равна 0. Собственный идентификатор(m_robid).
Собственный уровень энергии(m_e). 
Количество перевозимого металла(m_carriedmetal).
   3. Информация о колонии.
Общее количество металла, которым обладает колония(m_metal).
Количество металла в виртуальном хранилище(m_freemetal).
Количество поддерживаемых электростанциями мест(m_support).
Количество свободных мест(m_freesupport).
   3. Информация о видимом объекте.
Тип объекта(v_objtype). Это может быть:
  -wall(стена),
  -robot(робот),
  -lab(фабрика),
  -outofmap(граница мира),
  -metal(металл).
Полный тип объекта(v_type). Возможные значения приведены в таблице ниже по тексту.

Для видимых роботов (далее фабрики входят в это понятие) и стен известна команда(v_comm), уровень энергии(v_e). Для роботов известен тип оборудования на видимой стороне(v_equip)-может принимать значения nothing, scan, gun и factory. Так же для любого робота известен его идентификатор(v_robid).

При строительстве вы указываете полный тип объекта(b_type), затем во время строительсва получаете значение в переменную ret_create. Это может быть error(по каким-либо обстоятельствам строительство прервано), success(объект построен и обладает максимальным кол-вом жизней), или processed(строительство прошло успешно, но объект еще не достроен). Если в b_type передать значение repair, то робот будет чинить объект, расположенный с соответствующей стороны. В ret_create все возвращается по тем же принципам.

Следует обметить, что, чиня фабрику, производящую объект и имеющую полную энергию, вы на самом деле чините этот объект. Так как фабрика имеет достаточно большой периметр, то один объект может строиться одновременно 13(с учетом фабрики) юнитами. Так что при наличии большого кол-ва юнитов скорость строительства можно заметно увеличить. А для ускорения производства любого объекта вовсе не обязательно уметь его создавать.

 Типы объектов.

L0- уровень, необходимый строителю чтобы создать объект;
L-уровень объекта;
T-время, необходимое commander на постройку объекта (без дефицита ресурсов). Если объект строят несколько строителей, надо сложить их мощности(P) и на это число разделить T, чтобы найти необходимое время;
M- стоимость объекта (металл). Изымается из хранилища единовременно при начале строительства;
H- столько единиц поддержки требует объект;
+H- столько единиц поддержки добавляет данный объект;
E-максималная энергия робота;
+E-скорость самовосстановления объекта. Именно на столько энергия будет повышаться каждый такт в случае повреждения. Восстанавливаются как роботы, так и стационарные объекты.
P-мощность. Учитывается при строительстве указанным выше способом. Для военных роботов это размер повреждения, которое способен нанести снаряд, выпущенный таким роботом. Если снаряд попадает в объект, энергия которого меньше мощности снаряда, то снаряд летит дальше, потеряв мощность, равную энергии того объекта. Это делает невозможной защиту при помощи того, что каждый такт возобновляется строительство объекта под ударом (естественно, с однотактовым приростом энергии). Металл для снаряда эквивалентен пустой клетке, то есть никак на него не влияет.

 Апгрейд объектов.

   Объекты более низкого технического уровня могут быть улучшены до объектов того же назначения, но более высокого технического уровня без разрушения первых. Для этого необходимо чтобы строитель достаточного технического уровня выполнил команду строительства с параметром b_type, равным типу объекта более высокого технического уровня чем тот, к которому эта команда применяется. При этом старый объект заменится новым с таким уровнем энергии, какой был бы получен после затраты того количества времени, которое было затрачено на строительство старого объекта. Например, при апгрейде fragile_wall до fortification_wall у fortigication_wall окажется 50 единиц энергии. При этом объект, полученный в результате апгрейда, будет НЕДОСТРОЕННЫМ, то есть если не продолжить строительство до накопления полного уровня энергии, получнный объект начнет разрушаться. В настоящее время определены следующие цепочки объектов для апгрейда:

fragile_wall - light_wall - fortification_wall
solar_collector - geothermal_powerplant - fusion_reactor

Следует отметить, что энергия улучшенного объекта выбирается таким образом, что мощность постройки объектов всех технических уровней не зависит от того, строится ли сразу сложный объект, или он строится ступенчато через цепочку апгрейдов.

Отладка.

   На данный момент весь отладочный инструментарий состоит из двух команд- say и stop. Команда say выводит сообщение в окне информации робота. Например, команда say "test"; выведет сообщение "test" в указанном окне. Команда stop останавливает выполнение программы в конце текущего такта, экран центрируется на роботе, вызвавшем команду и в окне информации размещается информация о нем, в том числе последнее сообщение. Чтобы остановить выполнение немедленно, следует после команды stop указать команду next(пропуск хода). Может быть удобно комбинировать эти команды, вызывая сначала команду say, а затем stop. Команда stop не переводится в псевдокод при компиляции в бинарный формат, так что ее можно не исключать из программы при отсылке на сайт. Более того, при выполнении текстового файла команда stop компилируется только при включеном режимет отладки, в противном случае она игнорируется. При этом режим отладки может распространяться только на первую команду, указанную в файле config.txt. Для включения режима отладки в конец файла config.txt приписываются символы ;d . Например: col1.txt;col2.txt;d включает режим отладки для колонии col1.txt.

Так же для отладки существует возможность вывода значения переменной или выражения. Все данные так же отображаются в окне информации. В режиме отладки работает команда d_say, определяющая имя выводимой переменной. Сама переменная должна быть записана в d_value. Текст команды d_say не будет отображаться без режима отладки и не компилируется в бинарный файл. Значение d_value выводится в окне информации только после определения строки в d_say. Команда полностью аналогична команде say.

Лимит логики.

   Во время выполнения скрипта робота считается количество операций, выполненых с начала такта. Команды step, backstep, act n, right, left, next, load и unload прерывают выполнение робота. Если количество операций за такт для робота превышает лимит ЛИЧНОЙ логики, выполнение робота так же прерывается. По умолчанию лимит личной логики 40000 команд, однако он доступен в переменной m_maxlog и может быть уменьшен. Если общее количество логических команд уже выполненных за текущий такт роботов превышает 40000, остальные роботы просто не выполняются, так что следует быть осторожнее. После выполнения всех роботов в колонии определено общее количество логических команд (ЛОГИКА). Так же для каждой колонии определен (ШТРАФ), по умолчанию равный 0. Каждый такт к значению ШТРАФ прибавляется (ЛОГИКА-20000), и если ШТРАФ станет меньше 0, то ШТРАФ обнуляется. Если ШТРАФ превысит 20000, то ШТРАФ уменьшается на 20000, а следующий такт ВСЯ КОЛОНИЯ БЕЗДЕЙСТВУЕТ. Для контроля за количеством логических операций введена переменная m_curlog, равная (ЛОГИКА+ШТРАФ-20000). Соответственно если m_curlog меньше 0, то еще есть что расходовать, но если m_curlog больше нуля, то необходимо временно приостановить выполнение сложных алгоритмов, в противном случае скоро колония остановится. При строительстве это может играть очень большую роль. Кроме того, все же старайтесь по возможности оптимальнее писать колонии, даже если они и укладываются в лимит логики.

 Основные команды.

Предопределенные переменные.

любые отзывы и предложения направляйте на robotact@mail.ru или на форум