Створення гри й збір гравців¶

Гравець створює гру на панелі гри, і бот публікує картку збору в каналі збору ігор. На картці гравці записуються в збір, банять нації й натискають «Готовий», а коли гравців досить і всі готові, гру стартують.

Учасники¶

Творець гри — обирає на панелі гри режим і тип гри й одразу стає першим гравцем збору.
Гравець — записується в збір, банить нації, натискає «Готовий» і може вигнати гравця, скасувати збір чи стартувати гру.
Модератор — може вигнати гравця, скасувати збір, додати Steam-посилання чи стартувати гру, навіть якщо сам не грає.
Бот — публікує картку збору, оновлює її після дій гравців і прибирає збір, у якому 3 години ніхто не натискав кнопок.

Кроки¶

sequenceDiagram
    participant G as Творець гри
    participant B as Бот
    participant O as Інші гравці
    G->>B: натискає «FFA» чи «Duel» на панелі гри
    B-->>G: надсилає повідомлення «Оберіть тип гри», видиме лише йому
    G->>B: натискає «Vanilla», «Patch» чи «KEK»
    B-->>G: публікує картку збору в каналі збору ігор
    Note over B: творець гри — перший гравець збору
    O->>B: натискають «Вхід | Вихід»
    B-->>O: додає їх на картку збору
    G->>B: натискає «Готовий»
    O->>B: натискають «Готовий»
    B-->>O: ставить ✅ біля кожного готового гравця
    Note over B: гравців досить і всі готові — кнопки старту вмикаються

Режим гри. Творець гри натискає на панелі гри кнопку «FFA» або «Duel»: FFA — гра кожного проти кожного на 3–6 гравців, Duel — гра двох. Бот надсилає йому повідомлення «Оберіть тип гри», яке бачить лише він. Подробиці — Панель гри.
Тип гри. Протягом 60 с творець натискає «Vanilla», «Patch» або «KEK». Тип LEK для нових ігор недоступний. Повідомлення з кнопками типів зникає.
Картка збору. У каналі збору ігор спершу з'являється анімований значок очікування, а за мить — картка збору, де творець гри вже записаний першим гравцем. Якщо панель гри стоїть в іншому каналі, бот надсилає творцеві посилання на картку, яке бачить лише він; посилання зникає через 60 с.
Запис гравців. Інші гравці записуються кнопкою «Вхід | Вихід». Якщо гравців бракує, а на сервері налаштовано сповіщення, учасник збору може покликати їх кнопкою «Сповістити про збір». Подробиці — Сповіщення про збір.
Бани. Кожен гравець може забанити нації кнопкою «Бани»: до двох у FFA, до трьох у Duel. Бани необов'язкові й старту не заважають. Подробиці — Бани.
Steam-лобі. Учасник збору чи модератор може додати на картку посилання на лобі в Steam кнопкою «Steam посилання». Подробиці — Steam-посилання.
Готовність. Кожен гравець натискає «Готовий», і біля його імені з'являється ✅.
Старт. Коли гравців досить для режиму і всі готові, вмикаються кнопки «Старт з драфтом націй» і «Старт без драфту націй». Під час старту картка збору зникає, а бот створює тред гри в каналі історії ігор. Подробиці — Старт гри.

Картка збору¶

Картка збору — повідомлення бота в каналі збору ігор, де видно склад збору й бани. Угорі картки стоять ім'я й аватар творця гри. Вони лишаються там, навіть якщо творець вийшов зі збору або його вигнали. Нижче — заголовок із режимом, типом, кількістю гравців і станом, наприклад «FFA Patch 4 🚦Збір». У Duel кількості гравців у заголовку немає: «Duel Vanilla 🚦Збір». Номера гра ще не має: його дає старт. Смуга картки жовта.

Під заголовком стоїть рядок «Автовидалення через …». Подробиці — Скасування й автовидалення.

Далі йдуть гравці, від вищого рангу до нижчого. Біля кожного гравця видно:

✅, якщо гравець натиснув «Готовий»;
зірки рангу, по одній за кожен ранг (у гравця рангу 0 зірок немає);
згадку гравця та його ім'я;
під ним — рядок «Бани:» з емодзі забанених ним націй, якщо він щось забанив.

Бани кожного гравця на картці збору бачать усі. Подробиці про зірки — Ранги й зірки.

Якщо до збору додали Steam-посилання, воно стоїть унизу картки окремим блоком.

Кнопки збору¶

Під карткою збору дев'ять кнопок у три ряди. Перший ряд — «Вхід | Вихід», «Вигнати» і 🗑️, другий — «Бани», «Готовий» і «Старт з драфтом націй», третій — «Старт без драфту націй», «Steam посилання» і «Сповістити про збір».

«Вхід | Вихід» — записує вас у збір, а повторне натискання виписує. Натиснути може будь-хто на сервері.
«Вигнати» — прибирає гравця зі збору. Подробиці — Вигнання гравця.
🗑️ — кнопка без підпису, яка одразу скасовує збір. Подробиці — Скасування й автовидалення.
«Бани» — відкриває меню націй, яке бачите лише ви. Банять лише учасники збору. Подробиці — Бани.
«Готовий» — ставить або знімає ✅ біля імені того, хто натиснув.
«Старт з драфтом націй» і «Старт без драфту націй» — стартують гру. Обидві вимкнені, доки гравців замало або хтось не готовий. Подробиці — Старт гри.
«Steam посилання» — додає на картку посилання на лобі в Steam. Подробиці — Steam-посилання.
«Сповістити про збір» — кличе гравців через канал сповіщень, якщо на сервері налаштовано сповіщення. Подробиці — Сповіщення про збір.

Хто може натискати кнопки збору — Керують збором учасники й модератори.

Вигнання гравця¶

Кнопка «Вигнати» відкриває меню «Виберіть гравця для вигнання», яке бачите лише ви. У ньому всі гравці збору, крім вас. Виберіть гравця, і він зникне з картки збору разом зі своїми банами.

Вигнати можна й творця гри. Вигнаному гравцеві бот нічого не пише. Він може знову записатися кнопкою «Вхід | Вихід», але повернеться неготовим і без банів.

Якщо на сервері ввімкнено журнал подій, бот записує туди, хто кого вигнав. Подробиці — Журнал подій.

Скасування й автовидалення¶

Кнопка 🗑️ без підпису скасовує збір одразу, без підтвердження. Картка зникає з каналу збору ігор. Номера гра не отримує, і в історію ігор вона не потрапляє. У журнал подій, якщо його ввімкнено, бот записує «🗑️ [Збір] Гру скасовано».

Збір, у якому 3 години ніхто не натискав кнопок, зникає сам. Бот видаляє картку з каналу й нікому про це не пише. Натискання кнопки збору починає відлік 3 годин заново, навіть якщо картка після нього не змінюється, як-от коли меню «Бани» відкрили й закрили. Рядок «Автовидалення через …» бот перераховує лише тоді, коли оновлює картку, тож збір може протриматися довше, ніж показує цей рядок.

Гру, що вже стартувала, так скасувати не можна. Її переривають кнопкою «Скасувати гру» в треді гри. Подробиці — Переривання гри.

Steam-посилання¶

Кнопка «Steam посилання» додає на картку збору посилання на лобі Civilization V у Steam. Кнопка відкриває вікно англійською «Set Steam Lobby Link» з полем «Steam Lobby Link».

Посилання починається з steam://joinlobby/, а за ним ідуть три числа через скісну риску. Вставте в поле лише посилання, без іншого тексту. На посилання іншого вигляду бот відповідає англійською «Invalid Steam lobby link», і картка не змінюється.

Прийняте посилання з'являється внизу картки збору окремим блоком із підписом «посилання додано:». Нове посилання замінює попереднє. Після старту посилання лишається на картці гри в треді гри. Там його змінюють, надіславши нове посилання окремим повідомленням. Подробиці — Тред гри.

Це діє на сервері, з яким працює сайт CivBot: у грі, що йде, збережене посилання є й на сайті. Учасник гри, яка стартувала не більше 48 годин тому, бачить на сторінці гри кнопку «Приєднатись до гри». Вона відкриває лобі гравців цієї гри, а якщо його немає, — збережене посилання. Коли гравець натискає цю кнопку, а Steam показує інше лобі гравців гри, сайт записує його як нове посилання гри, і картка гри в треді гри теж показує вже його. Подробиці — Сторінка гри.

Правила й винятки¶

У FFA від 3 до 6 гравців, у Duel — рівно 2¶

Коли збір повний, кнопка «Вхід | Вихід» нових гравців не додає. Стартувати FFA можна з 3 гравців, Duel — лише вдвох. Ці межі однакові на всіх серверах. Подробиці — Старт гри.

Один гравець займає в зборі одне місце¶

Повторне натискання кнопки «Вхід | Вихід» не дає другого місця, а виписує зі збору. Разом із гравцем зі збору зникають його бани й готовність.

Новий гравець приходить неготовим¶

Біля імені нового гравця немає ✅. Поки він не натисне «Готовий», кнопки старту вимкнені для всіх. Так само неготовим повертається гравець, який вийшов чи був вигнаний.

Готовність кожен гравець ставить собі сам¶

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

Керують збором учасники й модератори¶

Кнопка «Вхід | Вихід» доступна будь-кому на сервері. Решту кнопок збору натискають лише учасники збору й модератори, іншим бот відповідає «У вас немає доступу до цієї дії.» Кнопка «Сповістити про збір» відкриває вікно будь-кому, а цю відповідь бот дає після підтвердження вікна. Творець гри окремих прав не має: будь-хто з учасників може вигнати гравця, скасувати збір чи стартувати гру. Хто такий модератор — Гравці, модератори й адміністратори.

Картку збору бот пише мовою сервера¶

Картка збору й підписи кнопок — мовою сервера. Повідомлення «Оберіть тип гри» і меню «Виберіть гравця для вигнання», які бачите лише ви, бот показує мовою вашого клієнта Discord. Подробиці — Мова бота.

Події збору потрапляють у журнал подій¶

Якщо на сервері ввімкнено журнал подій, бот записує туди створення гри, вхід і вихід гравців, вигнання, сповіщення про збір і скасування збору. Автовидалення збору в журнал не потрапляє. Подробиці — Журнал подій.

Що може піти не так¶

Бот відповідає «Створення гри вже в процесі...». Бот ще створює вашу попередню гру. Зачекайте кілька секунд і подивіться в канал збору ігор.
Картки немає в каналі, де ви натискали. Картки збору з'являються лише в каналі збору ігор. Якщо панель гри стоїть в іншому каналі, бот надіслав вам посилання на картку, яке бачите лише ви; воно зникає через 60 с. Канал збору ігор показує кнопка «Інформація» на панелі гри.
Кнопки старту не натискаються. У зборі замало гравців для режиму або хтось не готовий: біля його імені немає ✅. Попросіть гравців без ✅ натиснути «Готовий». Якщо бракує гравців і на сервері налаштовано сповіщення, покличте їх кнопкою «Сповістити про збір».
Бот пише, що у вас немає доступу до дії. На натискання кнопки бот відповідає «У вас немає доступу до цієї дії.» Ви не записані в цей збір: запишіться кнопкою «Вхід | Вихід» і спробуйте ще раз.
Бот відповідає англійською «Invalid Steam lobby link». Посилання має інший вигляд. Скопіюйте його повністю, від steam://joinlobby/ до останнього числа, і вставте без іншого тексту.
Картка збору зникла з каналу. Якщо гру стартували, шукайте її тред у каналі історії ігор. Якщо збір скасували або 3 години ніхто не натискав його кнопок, створіть нову гру на панелі гри.
Бот пише, що гра завершилась або була видалена. На натискання бот відповідає «Ця гра завершилась або була видалена. Створіть нову гру.» і вимикає кнопки картки: збору, до якого вона належить, уже немає. Створіть нову гру на панелі гри.