    FreedroidRPG: README
   ----------------------

0. Содержание
=========
  1. Введение
  2. Установка и игра.
  3. Основные элементы управления
  4. Известные проблемы
  5. Разрешение экрана
  6. ЧЗВ
     - Разное
     - Графика
     - Звук
     - Редактор уровней и разработка
  7. Контактные данные
  8. Лицензия


1. Введение
================
 Игра поведает историю о мире, разрушенном в результате конфликта
 роботов и их хозяев людей. Играйте за Такса, получившего задание
 спасти мир от кровавого восстания ботов, не знающих пощады.
 Вы можете выбирать, каким путём следовать: на свободе выбора
 построено в игре всё.

 FreedroidRPG включает систему боя в реальном времени с ближним и 
 дальним оружием, чем-то похожую на несвободную игру Diablo.
 Есть новейшая система программ, которые можно запустить, чтобы
 управлять роботами-врагами, меняя их поведение, либо улучшить 
 свои характеристики. Вы можете использовать около 150 различных 
 предметов, сражаться с бесчисленными врагами на пути к своей судьбе.
 Продвинутая система диалогов обеспечивает фон истории и погружение
 в отыгрывание ситуаций.

 Игра завершена, полностью играбельна и обеспечивает около 10 часов
 веселья. Она всё ещё активно разрабатывается, помощь приветствуется
 во многих областях. Люди имеющие или пытающиеся получить навыки
 программирования, создания карт или письма найдут FreedroidRPG
 захватывающим, быстро развивающимся проектом для полного самовыражения. 


2. Установка и игра.
==================
 Последний стабильный выпуск и сборки для Windows / Mac OS X: ftp://ftp.osuosl.org/pub/freedroid/
 Для общих инструкций по установке, пожалуйста, смотрите файл INSTALL, расположенный в той же папке, что и этот файл.
 Для дополнительной информации, пожалуйста, посмотрите также INSTALL.freedroidRPG
 Необходимые для сборки пакеты зависят от вашего дистрибутива. Они перечислены в INSTALL.freedroidRPG
 В основном, вам нужно просто выполнить

    ./configure
    make
    make install

 Если не хотите устанавливать игру, не запускайте «make install», а просто перейдите в подкаталог src/ и выполните
    ./freedroidRPG
 Для дополнительных опций выполните "freedroidRPG --help" (в терминале) для получения списка опций командной строки.


3. Управление
============
 Движение
 
  Управление в игре осуществляется мышью. Щёлкайте левой кнопкой по месту, куда хотите перейти.
  Удерживайте кнопку, чтобы двигаться в том направлении. Зажатая клавиша CTRL позволит бежать.

 Атака

  Щелчок левой кнопкой по врагу приведёт к тому, что Такс приблизится к дроиду и атакует его
  текущим оружием. Если экипирована пушка, то Такс начнёт стрелять в дроида с места.

 Особые функции

  Щелчок правой кнопкой мыши применяет выбранное умение или программу.

 Клавиши по умолчанию (большинство можно переназначить во внутриигровой раскладке — F1)

  Escape     ... Главное меню
  F1         ... Горячие клавиши
  F2         ... Полноэкранный режим (только в Linux)
  F3         ... Быстрое сохранение
  F4         ... Загрузка быстрого сохранения
  F5-F12     ... Быстрый выбор из восьми программ

  I          ... Инвентарь
  C          ... Панель персонажа
  S          ... Панель умений/программ
  Пробел      ... Закрыть все открытые панели
  Q          ... Журнал заданий
  0—9        ... Слоты 0—9 для быстрого вызова из инвентаря

  P ... Пауза
  (Удерживая) A     ... Атаковать, оставаясь на той же позиции
  (Удерживая) Shift ... Сохранять выбранную цель при движении
  Tab ... Включить автокарту (если доступна)

  R ... Перезарядить оружие
  (Удерживая) Ctrl ... Бег
  U ... Переключить режим постоянного бега.

  (Удерживая) X ... Показать имена предметов на земле
  Z ... Переключить режим показа имён предметов на земле
  T ... Переключение прозрачности стен при приближении Такса
  Ctrl+ Q ... Выйти из игры
  Ctrl + G ... Переключение захвата ввода (предотвращает выход курсора за окно игры)
  Print ... Сделать снимок экрана (сохраняется в папку ./.freedroid_rpg/ в домашнем каталоге)

  Стрелки ... Движение
     Вверх ... Север
     Вниз ... Юг
     Вправо ... Восток
     Влево ... Запад


4. Известные проблемы
================
 Основное
   * Часть оружия ближнего и дальнего боя, взятого Таксом, пока использует анимацию лазерных мечей и винтовок,
	 в том числе при атаке. Если вы подкованы в 3D-моделировании, пожалуйста, помогите нам это исправить.
   * Когда во время запуска в режиме OpenGL что-нибудь перекрывает окно FreedroidRPG,
	 фоновые изображения выглядят очень странно. Если вы щёлкните один из пунктов меню, всё вернётся
	 к задуманному виду.
   * После сворачивания игры в режиме OpenGL с открытым статичным всплывающим окном по Alt+Tab экран становится чёрным.
	 Нажатие горячей клавиши для закрытия всплывающего окна перерисует и вернёт изображение на экран.

 Mac
   *Открытие файлов: по умолчанию в OS X (в. 10.6) макс. количество открытых файлов — 256. Это может вызвать ошибки
	 при загрузке картинок: «Функция: get_iso_image_from_file_and_path. Не удалось загрузить изображение
	 /usr/local/share/freedroidrpg/graphics/obstacles/<filename>.png»
	 Решение:
		1) Проверьте лимит открытых файлов: $ ulimit -n
		2) Введите новый лимит открытых файлов: $ ulimit -n 2048
	(проблема #2913487)
   * Отрисовка шрифтов: Если шрифты не отображаются в главном меню с SDL или в режиме OpenGL игра крашится
	с ошибкой «Функция: PutCharFont. У поверхности символа 46 НУЛЕВОЙ указатель!»,
	проверьте настройки дисплея и установите цветовой профиль sRGB.
	(проблемы #2913485 и #2913484)
   * SDL, установленный из MacPorts: SDL, установленный из MacPorts будет отсылать FreedroidRPG неверную информацию
	о порядке байтов, если ваш процессор в режиме big-endian (PowerPC), поэтому цвета могут быть неправильными,
	и вы, вероятно, не сможете начать новую игру из-за краха FreedroidRPG.
	Исправляется это изменением с правами суперпользователя в файле /opt/include/SDL/SDL_config.h строки
		#define SDL_BYTEORDER=1234
	на
		#define SDL_BYTEORDER=4321
	После изменения и сохранения файла пересоберите FreedroidRPG, и она должна работать правильно.
	Использование SDL, собранного из исходников, вместо сборки MacPorts тоже сработает.

 Linux
   * Pulseaudio: При использовании SDL-pulseaudio у вас может отсутствовать звук. Это не из-за ошибки
	 во FreedroidRPG, а из-за незрелости самого Pulseaudio и её плагинов. Мы рекомендуем использовать,
	 например, SDL-esd или SDL-alsa, пока эта проблема не будет устранена.
   * Видеокарты Intel 915/945/IDG (EEE PC, нетбуки и т. д.): в Mesa 7.9-devel есть проблема, которая заставляет игру
   	 тормозить и потреблять много памяти. Это исправляется установкой и запуском «driconf», где нужно в строке 
	 «Включить тайлинг текстур» выбрать «Нет».   
   * Опция «Гамма-коррекция» может не работать из-за аппаратных и программных драйверов.


5. Разрешение экрана
=====================
 Некоторые настройки высокого разрешения скрыты и доступны только из командной строки. Они плохо протестированы,
 поэтому обычно считаются глючными и не поддерживаются. Однако они всё же могут быть многим полезны,
 особенно для широкоэкранных LCD в полноэкранном режиме

 Чтобы получить актуальный список разрешений выполните «freedroidRPG -r99».

 Некоторые известные проблемы неподдерживаемых разрешений:
	- портрет в диалогах выходит за границы;
	- световой радиус не отцентрирован;
	- неправильная прокрутка текста при разговоре с НИП.


6. ЧЗВ
============
Разные ЧЗВ:

	В.: Нужен ли мне Linux, чтобы поиграть во FreedroidRPG?
	О.: Хотя Linux крайне рекомендован для психического здоровья системного
	   администратора, у FreedroidRPG есть версия для MS Windows.
	   Отметим, что команда разработчиков FreedroidRPG не использует 
	   MS Windows, и версия для неё намного менее протестирована. Поэтому мы 
	   высоко ценим помощь и отзывы пользователей Windows.

	В.: Как подписаться или отписаться от почтовой рассылки?
	О.: у FreedroidRPG два списка рассылки. Один для обсуждения вещей, связанных
	   с FreedroidRPG, другой - список автоматически создаваемых журналов изменений 
	   с нашего сервера разработки, который обычно интересен только самим разработчикам.
	   В любом случае, вы можете подписаться, отписаться или изменить членство
			на следующей странице:
	   http://sourceforge.net/mail/?group_id=54521


ЧЗВ о графике:

	В.: Игра *ужасно* тормозит в моей системе Windows при использовании режима OpenGL.
	О.: Возможно, причина связана с драйверами OpenGL, поставляемыми с вашей
	   операционной системой от Майкрософт. Эти драйверы не используют аппаратное ускорение
	   и поэтому жутко медленные. Вам необходимо скачать и установить настоящие 
	   драйверы OpenGL для своей видеокарты. Обычно их можно загрузить 
	   с официальной страницы производителя графических чипов, например, Nvidia, AMD/ATI и т. д.
	   etc. Note, that if you do absolutely cannot get OpenGL working reliably on your
	   system, you can still run the game in pure SDL output mode. For this, you
	   must either use a 'MS-DOS command line prompt' and type

	   freedroidRPG -n 

	   inside this command line, or you can also make a link to freedroidRPG.exe
	   and then edit the link properties and add the -n after freedroidRPG.exe in
	   the link properties dialog box.

	В.: Игра *ужасно* тормозит на моём ПК с Linux при включённом OpenGL.
	A: The reason for this might be that you're not using hardware accelerated OpenGL.
	   Software OpenGL should be avoided.  If you don't have hardware-accelerated
	   OpenGL on your system (because e.g. your graphics card manufacturer doesn't
	   make suitable Linux drivers), you might be much better off when disabling
	   OpenGL support altogether.  For this, you can use command line switch -n,
	   i.e type

	   freedroidRPG -n

	   to start the game with OpenGL output disabled.  Graphics will revert to
	   pure SDL mode.
	Q: I run Linux with multiple monitors in TwinView (Xinerama) mode, however fullscreen
	   mode is centered over the break between the two monitors. I would rather it be
	   centered on one of the screens.
	A: To have the game use only one monitor for fullscreen mode, do the following:
	   1)  Make certain you use SDL version >=1.2.14.
	   2)  Set the environmental variable "SDL_VIDEO_FULLSCREEN_DISPLAY" to the number corresponding to
			the monitor you wish to use: 0 is your first display, 1 is your second, etc.

	   If that does not work you may have to add single-monitor metamodes to your xorg.conf file.
	   Изменения xorg.conf требуют перезапуска X-сервера, прежде чем они вступят в силу.

ЧЗВ о звуке:

	В: Звук не работает в игре. Я ничего не слышу.
	О: 1.) Убедитесь, что звук есть в других приложениях. Если вы
		    ничего не слышите, когда пытаетесь воспроизвести mp3 или ogg аудиофайл,
		    значит, звук на вашем компьютере не настроен и эта
		    проблема не зависит от freedroidRPG. В таком случае, вы должны установить
		    звуковую карту сначала
	   2.)  See if you have the SDL_mixer libraries installed. You might want
		    to use "locate SDL_mixer" and see if you get a lot of results.  If
		    not, then the missing SDL_mixer library is the problem.
		    Also check if you have libogg and libvorbis installed.
	   3.)  If you're compiling from source, make sure the ./configure script has
		    properly detected the SDL_mixer library. Just look at the ./configure
		    output. There should be a line like:

		      checking for Mix_ChannelFinished in -lSDL_mixer... yes

		    Если же вы получили что-то вроде

		      checking for Mix_ChannelFinished in -lSDL_mixer... no

		    значит скрипт ./configure не обнаружил у вас установленный
		    SDL_mixer. Возможно, вы захотите убедиться, что пакеты SDL_mixer и
		    SDL_mixer_devel установлены или установить SDL_mixer из исходников.
		    Вы можете скачать всё отсюда:

		      http://www.libsdl.org/projects/SDL_mixer/

		    If you compiled from source, you'll have to recompile now, because the
		    previous compile didn't include the sound module of FreedroidRPG. If
		    the SDL_mixer stuff is installed properly, it should work after the
		    recompile.

	В.: У меня запаздывает звук. Кажется, что всё несколько рассинхронизировано. 
	A: There might be a sound daemon running on your system.  Many window managers
	   like e.g. KDE start a sound daemon by default upon start up. To get rid of
	   the most common sound daemons, you can try (best as root)

	   killall -9 artsd
	   killall -9 esd
	   killall -9 yiff
	   killall -9 pulseaudio

	   После этого вы можете заново запустить FreedroidRPG. Задержка звука
	   должна исчезнуть.

Редактор уровней и ЧЗВ разработчика:

	В.: Есть ли в игре редактор уровней?
	О.: Да, у нас есть редактор уровней интегрированный во FreedroidRPG. Он доступен
       из главного меню или при выполнении команды

		  freedroidRPG -e

       Чтобы было легче разобраться, все кнопки имеют подсказки.
       Поиграйте с ним немного самостоятельно и не стесняйтесь попросить помощи
       в IRC или списке рассылки.

	В.: Как мне получить последнюю разрабатываемую версию игры?
	О.: Это очень просто, когда используется Linux:
	      git clone https://gitlab.com/freedroid/freedroid-src.git
	   Если же вы используете Windows, мы рекомендуем, например 
	      http://www.collab.net/downloads/giteye?CID=tigris
	   Если у вас всё ещё возникают проблемы, лучше снова обсудить это с людьми
	   в списке рассылки freedroid-discussion или же спросить на IRC-канале.

	В.: Хочу помочь с разработкой FreedroidRPG. Что мне сделать в первую очередь?
	О.: Во-первых, рекомендуем прочесть http://www.freedroid.org/developer-area/contribute/
	   Во-вторых, свяжитесь с нами. Это возможно через IRC (см. «Контакты» ниже)
	   или при помощи списка рассылки freedroid-discussion.
	   Следующее, что нужно сделать, - получить последнюю разрабатываемую версию игры
	   из git, а затем либо сразу сделать небольшой патч, либо обсудить вашу
	   масштабную задумку с людьми в списке рассылке или на IRC,
	   чтобы удостовериться, все ли разработчики идут в одном направлении и
	   знают, что происходит и кто над чем работает.


7. Контакты
===========
 Веб-сайт      ................ http://www.freedroid.org
 Страница с исходниками   ..... https://gitlab.com/groups/freedroid
 IRC-канал     ................ #freedroid на irc.freenode.net или
								http://webchat.freenode.net/?channels=freedroid (требует Javascript)
 Список рассылки .............. freedroid-discussion@lists.sourceforge.net
 Багтрекер     ................ http://bugs.freedroid.org/


8. Лицензия
===========
 Сама игра лицензирована под GPL. Некоторые другие инструменты используют более либеральную лицензию, 
 пожалуйста, посмотрите файл FILES, расположенный в той же папке, что и данный файл.
