Итак, вы скачали иичантру. Дальше возникает вполне закономерный вопрос - как её собрать и запустить? Давайте разберёмся.

Шаг первый. Установите lua версии 5.1. В старых релизах иичантры использовался собственный луа, но теперь мы от него отказались. Lua for windows: http://code.google.com/p/luaforwindows/downloads/list, lua: http://www.lua.org/versions.html#5.1

Шаг второй. Стоит убедиться, нужно ли собирать игру. Большую часть времени на свн лежат бинарные файлы относительно свежей сборки для windows. Если вы не планируете заниматься кодом, а, скажем, просто поиграться с редактором, то этого может оказаться вполне достаточно. Тогда шаги 3 и 4 можно пропустить.

Шаг третий. Остальные библиотеки. Для сборки иичантры требуются:

1. lua 5.1 - см. выше "Шаг первый"
2. DevIL - IL, http://openil.sourceforge.net/download.php
3. zziplib - zzip, http://zziplib.sourceforge.net/download.html
Статический .lib для windows лежит в lib иичантры
4. SDL - SDL, http://www.libsdl.org/download-1.2.php
5. SDL_net - SDL_net, http://www.libsdl.org/projects/SDL_net/
6. Bass - bass, идёт в комплекте, необязателен, см. далее

Обращаем внимание на то, что большинство этих библиотек есть в репозиториях крупных дистрибутивов. Например, для ubuntu установка всех необходимых библиотек выполняется так:
apt-get install liblua5.1 libdevil-dev libsdl2.1-dev libsdl-net1.2-dev libzzip-dev

Шаг четвёртый. Компиляция. Обычно на свн имеются проекты для Microsoft Visual Studio 2008 и 2010, готовый makefile и CMakeLists.txt для использования cmake.

1. Сборка с помощью Visual Studio 2008/2010
В проекте есть несколько конфигураций. Точно работают DebugStatic, ReleaseStatic, Editor.
Необходимо добавить пути к установленным библиотекам или в настройки студии или в настройки проекта. Если вы не знаете, как это делать, то настоятельно рекомендую узнать. В VS2010 также можно просто положить их в $(SolutionDir)..\..\libs, где $(SolutionDir) - папка new_engine.

2. Сборка с помощью Makefile
Поддерживается несколько целей: release (по умолчанию), release_nosound, debug, debug_nosound, editor, valgrind.
Таргеты *_nosound собираются без библиотеки Bass (для тех, у кого по каким-либо причинам эта библиотека не рабоатет).
Перед сборкой разных целей желательно выполнить make clean.
Платформозависимые пути к библиотекам задаются в блоке для соответсвующей платформы в файле iichantra.Makefile в переменных INCLUDES, LDLIBS, LDFLAGS и т.п.
Поддерживается сборка на платформах Linux и Darwin (MacOs). Платформа определяется с помощью uname -s.

3. Сборка с помощью CMake
Правильная работа файлов, сгенерированных cmake может потребовать дополнительной настройки.

Шаг пятый. Запуск. Если не произошло ошибок, то бинарные файлы должны были сгенерироваться в директории bin.




So you have downloaded iiChantra. How do you build and un it? In four relatively simple steps.

Step 1. Install lua5.1. Old iiChantra releases used its own modified lua library, but not anymore. You will first need to install it. Lua for windows: http://code.google.com/p/luaforwindows/downloads/list, lua: http://www.lua.org/versions.html#5.1

Step 2. Decide if you even need to build iiChantra. Most of the time you can find recent windows binaries in the bin directory of the svn repository. If you don't need to change the code and just want to, say, use the map editor, it could be enough. If so, skip steps 3 and 4.

Step 3. Install other libraries. To build iiChantra you will need:

1. lua5.1 - if you didn't install this one then shame on you, why did you skip step 1?
2. DevIl - IL, http://openil.sourceforge.net/download.php
3. zziplib - zzip, http://zziplib.sourceforge.net/download.html
You can also find a static .lib for windows inside the lib directory of iiChantra, so you don't need to build it yourself
4. SDL 1.2 - SDL, http://www.libsdl.org/download-1.2.php
5. SDL_net - SDL_net, http://www.libsdl.org/projects/SDL_net/
6. Bass - bass, comes with iiChantra and is optional (more on that in step 4)

Note that most of thies libraries can be found in major linux distributions repositories. For example. installing all necessary libraries on ubuntu would like like this:
apt-get install liblua5.1 libdevil-dev libsdl1.2-dev libsdl-net1.2-dev libzzip-dev

Step 4. Building iiChantra. In our code repository you can usually find Microsoft Visual Studio 2008 and 2010 solution files, a makefile and CMakeLists.txt for using cmake.

1. Building with Visual Studio
You can use solution targets to build normal game (ReleaseStatic, Release Dynamic), debug version (DebugStatic, DebugDynamic) and the map editor (Editor).
You will need to add the paths to the libraries you installed to either solution properties or studio properties. If you don't need how to do that you should read how to install and use libraries elsewhere. With Visual Studio 2010 solution you can also place all of them to $(SolutionDir)..\..\libs where $(SolutionDir) is a directory containg the solution file.

2. Building with makefile
Using makefile you can build several targets: release (default), release_nosound, debug, debug_nosound, valgrind
Targets with _nosound do not use the Bass library, use it if for some reason it doesn't work.
Before changing build target it is recomended to clean up by running make clean.
Platform-dependent library paths are stored in iichantra.Makefile variables INCLUDES, LDLIBS, LDFLAGS and others. Supported platforms are Linux and Darwin (MacOS), the one to use is determined by using uname -s.

3. Building with CMake
Proper work of generators created with cmake may or may not require some additional steps.

Step 5. Running iiChantra. If everything went well, binary files can now be found insinde bin directory.

