# Руководство пользователя &ksirk;

## Введение

&ksirk; — это компьютерная версия известной стратегии. Существуют также коммерческая и свободно распространяемые версии, но Gaël de Chalendar создал эту игру изначально в качестве упражнения для изучения C++, и её разработка дошла до текущей версии (более подробная информация содержится в файле `README`).

Это снимок экрана &ksirk; Снимок экрана

В текущей версии &ksirk; имеет возможности мультиплеера с ИИ (подробнее: `TODO` ).

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

Цель игры проста: покорить мир, атакуя своих соседей с помощью армии.

## Использование &ksirk;

### Игра в &ksirk;

Предварительное примечание: карту возможно прокручивать тремя способами:

- Поместить курсор около границы окна, и карта прокрутится сама в этом направлении;

- Использовать колесо мыши: без каких-либо модификаторов оно позволит прокрутить карту вертикально, а при зажатой клавише &Alt; — горизонтально;

- Использовать клавиши со стрелками.

#### Начало игры

При запуске &ksirk; отобразится главное меню.

Главное меню &ksirk; Главное меню

Новая локальная игра

- Начинает новую игру.

Новая стандартная игра через сеть TCP/IP

- Начинает новую игру с помощью протокола TCP/IP.

Присоединиться к стандартной игре через сеть TCP/IP

- Позволяет присоединиться к уже созданной игре с помощью протокола TCP/IP.

Загрузить...

- Позволяет загрузить ранее сохранённую игру

Выйти

- Позволяет выйти из игры

При нажатии кнопки Новая локальная игра отобразится диалог Свойства новой игры, позволяющий выбрать количество игроков, используемое игровое поле, тип игры (с целью захватить другие страны или с другой целью) и режим игры — онлайн или по локальной сети. Кнопка Загрузить новые игровые поля... позволит загрузить новые игровые поля.

Диалог новой игры Диалог новой игры

Чтобы начать игру через сеть TCP/IP, воспользуйтесь пунктом меню Новая стандартная игра через сеть TCP/IP на изначальном экране. После нажатия на эту кнопку появится возможность выбирать параметры сети: количество локальных игроков и TCP-порт, на котором будет производиться ожидание соединения.

Диалог параметров сетевой игры Диалог параметров сетевой игры

Игроки по сети смогут подключиться с помощью кнопки Присоединиться к стандартной игре через сеть TCP/IP на экране приветствия и указав IP-адрес или имя хоста и номер порта, который пользователь только что установил.

Диалог подключения к сетевой игре Диалог подключения к сетевой игре

Каждое подключение обозначается новой строкой в таблице Игроки под миниатюрой карты.

Строка нового игрока Строка нового игрока

Предположим, что были оставлены параметры по умолчанию и нажата кнопка Далее. Затем будет произведена настройка для двух игроков, одного за другим. Каждому следует выбрать имя, нацию и, при желании, пароль, чтобы никто кроме этого пользователя не смог использовать этого игрока при перезагрузке этой сохранённой игры. Здесь также возможно указать, является ли этот игрок ИИ или человеком.

Диалог параметров игрока Диалог параметров игрока

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

Предупреждение об отображении цели Предупреждение об отображении цели Диалог с отображением цели Диалог с отображением цели

#### Распределение

В начале игры страны распределены между всеми игроками. Сначала каждая страна имеет одну армию (представлена пехотинцами). У каждого игрока есть несколько армий, которые он может распределить между своими странами в свой ход (обозначается наличием их имени и их флага в строке состояния). Обратите внимание, что пять армий представлены кавалеристом, а 10 — пушкой.

Чтобы поместить армию на одну из своих стран, щёлкните по стране левой кнопкой мыши. Чтобы удалить армию, щёлкните по ней правой кнопкой мыши. Обратите внимание: нельзя удалить больше армий, чем было размещено.

Размещение армий Размещение армий

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

Перераспределение Переставить

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

Конец перераспределения Готово

- Перераспределение закончено, и возможно продолжить игру.

#### Бой

После перераспределения начинается ход. Каждый игрок осуществляет действия в свой ход. Он может:

Следующий игрок Следующий игрок

- Закончить ход. Начнётся ход следующего игрока.

Атака 1 Атака 2 Атака 3 Атака одной, двумя или тремя армиями Автоматическая атака Автоматическая атака

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

  Меню атаки Меню атаки

  Чтобы страна X напала на страну Y с помощью x армий, должны быть выполнены 2 условия:

  - две страны должны быть соседями;

  - страна X должна иметь не менее x+1 армий перед атакой.

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

  После того, как защищающийся игрок сделает свой выбор, произойдёт сражение и будут просчитаны его итоги.

  Диалог защиты Диалог защиты

Перемещение армий Переставить армии из одной страны в другую

- Это последнее действие на ходу игрока. Оно предоставляет возможность переместить некоторые армии из одной его страны в соседнюю страну. Чтобы сделать это, воспользуйтесь той же механикой перетаскивания, что и при атаке. Когда будут выбраны обе страны, отобразится ползунок, на котором можно будет выбрать, сколько армий будет находиться в каждой стране.

#### Результат боя

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

Отображение результатов атаки Отображение результатов атаки

Если количество армий защищающегося государства достигнет 0, владение этой страной перейдёт к атакующему: будет установлен флаг победившего, и одна из армий будет перемещена в новую страну. Ползунок перемещения армий отображается для передвижений в конце хода.

Ползунок вторжения Ползунок вторжения

#### Конец хода

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

После того, как все сделают свой выбор, ход закончится. Некоторые армии распределяются между игроками в зависимости от стран, которыми они владеют: по 1 на каждую группу из трёх стран, минимум 3. Также есть разные бонусы для игроков, владеющих целыми континентами. Значения бонусов для стандартного игрового поля:

#### Бонус за счёт континентов

Континент | Приз
Северная Америка | 5
Южная Америка | 2
Европа | 5
Африка | 3
Азия | 7
Область Тихого океана | 2

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

## Список команд

### Главное окно &ksirk;

#### Кнопки

Выйти из игры Выйти

- Закрывает программу.

Новая игра Новая игра

- Начинает новую игру. Появится диалог с запросом количества игроков. После этого у каждого игрока будет запрошено его имя с помощью другого диалога.

## Руководство разработчика &ksirk;

Для получения документации об API обратитесь к https://api.kde.org/. Она была полной, но в настоящее время немного устарела. В файлах реализации `.cpp` нет комментариев.

Обратите внимание, что изначально эта игра была разработана для &Windows; с помощью Borland C++ и WinG. Игра затем была перенесена на &Java; перед преобразованием на C++ и &kde;. Сначала был использован французский язык и смесь французского и английского для названий идентификаторов (имён классов, методов и так далее). Также французский язык использовался в комментариях. После того, как было принято решение распространять эту игру, разработчик решил перевести всё на английский язык, несмотря на то, что он не является носителем языка. Если у вас есть какие-то предложения по исправлению англоязычных комментариев в коде или в этой документации, свяжитесь с автором.

## Создание новых игровых полей

&ksirk; поставляется вместе с редактором игровых полей `ksirkskineditor`, позволяющим редактировать все данные игрового поля, пока графика (карта, спрайты и так далее) доступны в файле &SVG;. Более подробная информация содержится в руководстве &i18n-ksirkskineditor;.

## Вопросы и ответы

&reporting.bugs; &updating.documentation;

## Авторские права и лицензия

&ksirk;

Авторские права на программу: Gaël de Chalendar kleag@free.fr, 2002-2012 гг.

Авторские права на программу: Nemanja Hirsl nemhirsl@gmail.com, 2013 г.

Участники: Robin Doer, &Albert.Astals.Cid;, Michal Golunski (перевод на польский).

Авторские права на документацию: Gaël de Chalendar kleag@free.fr, 2002-2008 гг.

Перевод на русский язык: Мария Шикуноваtranslation-team@basealt.ru

&underFDL; &underGPL;

## Установка

### Настройка

Пункт меню Настройка Настроить &ksirk;... открывает диалог, позволяющий:

Настройка параметров Настройка параметров

- включать или выключать звуки ;

- установить скорость спрайтов (от медленной до средней) ;

- включить или отключить контекстную справку, отображаемую во всплывающих окнах ;

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

  Отображение количества армий Отображение количества армий

&documentation.index;