# Підручник з &ksirk;

## Вступ

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

Ось знімок вікна &ksirk; Знімок вікна

У поточній версії, &ksirk; є грою за участі декількох гравців, можливістю грати мережею та з комп’ютерним інтелектом. (подробиці можна прочитати у файлі `TODO`)

У цій документації ви знайдете лише основні відомості, які потрібні для того, щоб розпочати гру. Будь ласка, зверніть увагу на підказки та повідомлення у смужці стану, щоб отримати повнішу інформацію.

Метою гри є звичайне завоювання світу... Ця мета досягається нападом на ваших сусідів за допомогою ваших армій. Миролюбна гра, чи не так? :-)

## Користування &ksirk;

### Як грати у &ksirk;

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

- Ви можете підвести вказівник миші до краю вікна, — програма почне гортати карту у відповідному напрямку.

- Ви можете скористатися коліщатком миші: без натискання клавіші-модифікатора воно гортає карту у вертикальному напрямку, а за натискання клавіші &Alt; — у горизонтальному.

- Ви можете скористатися клавішами зі стрілочками на клавіатурі

#### Як розпочати гру

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

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

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

- Починає нову гру.

Створити стандартну гру мережею TCP/IP

- Розпочати нову гру за допомогою комплексу інтернет-протоколів.

Приєднатися до стандартної гри мережею TCP/IP

- Долучитися до створеної іншим користувачем гри за допомогою комплексу інтернет-протоколів.

Завантажити…

- Використовуйте для завантаження раніше збереженої гри.

Вийти

- Можливо, зрештою ви зовсім не бажаєте грати?

Якщо ви натиснете кнопку Нова локальна гра, програма відкриє перед вами діалогове вікно Властивості нової гри, у якому ви зможете обрати кількість гравців, шкірку (або тему) гри, тип гри (підкорення мети або особлива мета) і нарешті, чи будуть у гру грати гравці з мережі, чи лише локальні гравці. Нові теми гри можна отримати за допомогою натискання кнопки Отримати нові шкірки….

Діалогове вікно нової гри Діалогове вікно нової гри

Щоб розпочати гру мережею, натисніть кнопку Створити стандартну гру мережею TCP/IP у початковому вікні програми. Після натискання цієї кнопки ви зможете обрати параметри мережевої гри: кількість локальних гравців і порт TCP, на якому програма очікуватиме на з’єднання.

Діалогове вікно параметрів гри мережею Діалогове вікно параметрів гри мережею

Після цього мережеві гравці зможуть приєднувати до гри за допомогою кнопки Приєднатися до стандартної гри мережею TCP/IP на вступному вікні. Їм слід буде вказати IP або назву вузла та порт, які було раніше встановлено вами.

Діалогове вікно приєднання до гри мережею Діалогове вікно приєднання до гри мережею

Кожне з’єднання буде позначено новим рядком у таблиці Гравці, розташованій під мініатюрою карти.

Рядок нового гравця Рядок нового гравця

Припустімо, що ви не змінювали типовий параметрів, а просто натиснули кнопку Далі. Тоді вам слід буде вказати параметри для двох гравців почергово. Для кожного з них ви оберете ім’я, націю і, якщо забажаєте, вкажете пароль, щоб ніхто інший, окрім вас, не зміг грати за відповідного гравця після завантаження гри за вашої відсутності. Нарешті, ви зможете вказати, хто гратиме за цього гравця: комп’ютер чи людина.

Діалогове вікно налаштування гравця Діалогове вікно налаштування гравця

Далі, після натискання кнопки Почати, якщо ви обрали гру з метою, буде показано мету для кожного з гравців, перед якою буде показано повідомлення, щоб інші гравці не змогли підглянути вашу мету у грі.

Повідомлення попередження про мету гри Повідомлення попередження про мету гри Діалогове вікно показу мети Діалогове вікно показу мети

#### Розподіл

На початку гри країни розподілено між всіма гравцями. У кожній країні розміщено одну армію (це показано зображенням піхотинця). У кожного з гравців є декілька армій, які він може розмістити у свої країнах під час свого ходу (їх присутність буде позначено за допомогою назви і прапора у смужці стану). Зауважте, що п’ятьом арміям відповідає кіннотник, десятьом — гармата.

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

Розподіл армій Розподіл армій

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

Перерозподіл Повторний цикл

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

Кінець перерозподілу Завершено

- Перерозподіл завершено, і гру можна продовжувати.

#### Битва

Після перерозподілу починається сам хід. Кожен з гравців почергово може виконати такі дії:

Наступний гравець Наступний гравець

- Завершити хід поточного гравця і передати хід наступному гравцеві.

Атака 1 Атака 2 Атака 3 Атакувати одною, двома або трьома арміями Автоатака Автоматична атака

- Щоб атакувати, перетягніть війська за допомогою вказівника миші з однієї країни до іншої. У відповідь програма покаже контекстне меню із наведеними вище пунктами.

  Меню нападу Меню нападу

  Щоб можна було атакувати з країни X країну Y за допомогою x армій, має бути виконано 2 умови:

  - ці дві країни мають бути сусідніми;

  - у країні X має бути принаймні x+1 армія перед атакою.

  Якщо атака можлива, за потреби, буде показано діалогове вікно для гравця, який захищається. За допомогою цього вікна гравець зможе обрати, чи бажає він захищатися однією, чи двома арміями і чи надасть він змогу вирішити це питання комп’ютерові.

  Після того, як гравець, що захищається зробить свій вибір, відбудеться битва. Її опис подано нижче.

  Діалогове вікно захисту Діалогове вікно захисту

Пересувати армії Пересунути армії з однієї країни до іншої

- Це остання дія під час ходу гравця. За її допомогою можна пересунути декілька армій з однієї країни до іншої, сусідньої з першою. Щоб обрати ці дві країни, будь ласка, скористайтеся перетягуванням і скиданням, як під час атаки. Після вибору двох країн буде показано повзунок, за його допомогою ви зможете обрати кількість армій, які залишаться після пересування у кожній з країн.

#### Наслідки битви

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

Показ результатів атаки Показ результатів атаки

Після того, як кількість армій у країні, яка захищається, досягне 0, право володарювання над країною переходить до гравця, який здійснював атаку: на карті країни буде встановлено прапор цього гравця, а у самій країні розквартировано одну з армій, які здійснювали атаку. Програма також покаже повзунок «Пересунути армії», як під час пересування наприкінці ходу.

Повзунок вторгнення Повзунок вторгнення

#### Кінець ходу

Щоб завершити ваш поточний хід, якщо ви не бажаєте пересувати армії, скористайтеся кнопкою Наступний гравець, розташованою на панелі інструментів.

Після того, як всі гравці зроблять власні ходи, хід гри вважається завершеним. Після цього кожному з гравців, залежно від кількості країн, якими цей гравець володіє, буде додатково надано певну кількість армій: по одній на кожні три країни, за мінімальної кількості у три країни. Крім того, бонусні армії отримають гравці-володарі континентів, кількість бонусних армій залежить від континенту. Кількості армій для типової шкірки:

#### Бонуси за континентами

Континент | Бонус
Північна Америка | 5
Південна Америка | 2
Європа | 5
Африка | 3
Азія | 7
Тихоокеанський регіон | 2

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

## Довідка щодо команд

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

#### Кнопки

Вийти Вийти

- Завершує роботу програми.

Нова гра Нова гра

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

## Довідник розробника для &ksirk;

Для отримання документації щодо програмного інтерфейсу, будь ласка, завітайте на сайт за адресою 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

Переклад українською: Юрій Чорноіван yurchor@ukr.net

&underFDL; &underGPL;

## Встановлення

### Налаштування

За допомогою пункту меню Параметри Налаштувати &ksirk;… можна відкрити вікно, яке надасть вам змогу:

Діалогове вікно налаштувань Діалогове вікно налаштувань

- увімкнути або вимкнути відтворення звуків;

- встановити швидкість спрайтів (від повільної до миттєвої);

- увімкнути або вимкнути контекстну довідку, яку буде показано у підказках;

- увімкнути показ або приховати кількість армій у кожній з країн. На наступному знімку вікна ви можете бачити карту з показаною кількістю армій у країні.

  Показ кількості армій Показ кількості армій

&documentation.index;