    FreedroidRPG: ПРОЧТИМЕНЯ
   ----------------------

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, другой - список автоматически создаваемых журналов изменений 
	   с нашего сервера разработки, который обычно интересен только самим разработчикам.
	   В любом случае, вы можете подписаться, отписаться или изменить членство
			на следующей странице:
	   https://sourceforge.net/mail/?group_id=54521


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

	В.: Игра *ужасно* тормозит в моей системе Windows при использовании режима OpenGL.
	О.: Возможно, причина связана с драйверами OpenGL, поставляемыми с вашей
	   операционной системой от Майкрософт. Эти драйверы не используют аппаратное ускорение
	   и поэтому жутко медленные. Вам необходимо скачать и установить настоящие 
	   драйверы OpenGL для своей видеокарты. Обычно их можно загрузить 
	   с официальной страницы производителя графических чипов, например, Nvidia, AMD/ATI и
	   так далее. Обратите внимание, что если вы абсолютно не можете заставить OpenGL надежно работать на вашей
	   система, вы все еще можете запустить игру в чистом режиме вывода SDL. Для этого вы
	   необходимо либо использовать 'командной строкой MS-DOS ' и ввести

	   freedroidRPG -n 

	   в командной строке, либо сделать ярлык на  freedroidRPG.exe
	   а затем отредактировать свойства ссылки и добавить -n после freedroidRPG.exe в
	   в диалоговом окне свойств ярлыка.

	В.: Игра *ужасно* тормозит на моём ПК с Linux при включённом OpenGL.
	A: Причиной этого может быть то, что вы не используете аппаратное ускорение OpenGL.
	   Программного OpenGL следует избегать. Если у вас нет аппаратного ускорения
	   OpenGL в вашей системе (потому что, например, производитель вашей видеокарты этого не делает
	   драйверов под Linux), возможно, будет намного лучше при отключенной
	   совсем OpenGL. Для этого можно использовать в командной строке ключ -n, т.е. напечатайте:
	   freedroidRPG -n

	   freedroidRPG -n

	   чтобы начать игру с отключенным выводом OpenGL. Графика вернется к
	   режиму чистой SDL.
	Q: я запускаю Linux с несколькими мониторами в режиме TwinView (Xinerama), однако полноэкранный
	   режим разворачивается на оба монитора. Я бы предпочел, чтобы игра переходила в полноэкранный режим 
	   на одном из экранов.
	О: Чтобы игра использовала только один монитор для полноэкранного режима, выполните следующие действия:
	   1) Убедитесь, что вы используете SDL версии >=1.2.14.
	   2) Установите переменную среды "SDL_VIDEO_FULLSCREEN_DISPLAY" на число, соответствующее
			монитору, который вы хотите использовать: 0-это первый дисплей, 1 второй и т. д.

	   Если это не сработает, вам, возможно, придется добавить метарежимы (metamodes) для одного монитора в файл xorg.conf.
	   Изменения xorg.conf требуют перезапуска X-сервера, прежде чем они вступят в силу.

ЧЗВ о звуке:

	В: Звук не работает в игре. Я ничего не слышу.
	О: 1.) Убедитесь, что звук есть в других приложениях. Если вы
		    ничего не слышите, когда пытаетесь воспроизвести mp3 или ogg аудиофайл,
		    значит, звук на вашем компьютере не настроен и эта
		    проблема не зависит от freedroidRPG. В таком случае, вы должны установить
		    звуковую карту сначала
	   2.) Посмотрите, установлены ли библиотеки SDL_mixer. Возможно, вы захотите
		    использовать 'locate SDL_mixer' и посмотреть на вывод, должно получиться много строк. Если
		    нет, то проблема в том, отсутствует библиотека SDL_mixer.
		    Также проверьте, установлены ли библиотеки libogg и libvorbis.
	   3.) Если вы компилируете из исходников, убедитесь, что скрипт ./configure
		    корректно обнаружил библиотеку SDL_mixer. Просто посмотрите на  ./configure
		    в нем должны быть строки подобные:

		      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 из исходников.
		    Вы можете скачать всё отсюда:

		      https://github.com/libsdl-org/SDL_mixer

		     Если вы скомпилированы из исходного кода, вам придется перекомпилировать заново, потому что
		    предыдущая компиляция не включает в себя звуковой модуль FreedroidRPG. Если
		    библиотека SDL_mixer установлена корректно, все должно заработать после
		    перекомпиляции.

	В.: У меня запаздывает звук. Кажется, что всё несколько рассинхронизировано. 
	О: В вашей системе может быть звуковой деймон. Многие оконные менеджеры
	   например, KDE запускают звуковой деймон по умолчанию при собственном запуске. Чтобы избавиться от
	   наиболее распространенных звуковых деймонов, вы можете попробовать (лучше всего, с правами root)

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

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

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

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

		  freedroidRPG -e

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

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

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


7. Контакты
===========
 Веб-сайт      ................ https://www.freedroid.org
 Страница с исходниками   ..... https://codeberg.org/freedroid
 IRC-канал     ................ #freedroid на irc.libera.chat или
                                https://web.libera.chat/#freedroid
 Список рассылки .............. freedroid-discussion@lists.sourceforge.net
 Багтрекер     ................ https://bugs.freedroid.org/


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