Гравці, модератори й адміністратори¶
Гравці, модератори й адміністратори — ролі, від яких залежить, хто що може робити з грою та ботом. Своєю грою керують її учасники, а будь-якою грою сервера — модератори. Канал збору ігор, канал історії ігор і роль модератора задає адміністратор сервера.
Навіщо потрібні ролі¶
Ролі розділяють, хто керує однією грою, а хто — усім сервером. Бот сам ролей не видає: він перевіряє, чи записана людина в гру, які в неї права Discord і чи має вона роль модератора сервера. Що вам доступно, залежить від чотирьох речей:
- Участь у грі — учасник гри керує своєю грою від збору до результату: виганяє гравців, стартує, обирає нації, завершує або перериває гру. Те саме місце в грі дає змогу змінювати її на сайті.
- Права модератора — модератор керує будь-якою грою сервера, навіть якщо сам у ній не грає. Ще він ставить панель гри й таблицю лідерів, вмикає журнал подій і налаштовує сповіщення про збір.
- Право «Керувати сервером» — з ним адміністратор сервера задає канал збору ігор, канал історії ігор і роль модератора.
- Власник бота — той, хто веде CivBot і діє для всіх серверів одразу.
Створити гру, записатися в збір і подивитися статистику може будь-хто на сервері. На сервері, з яким працює сайт, будь-хто ще може відкрити профіль гравця на сайті через пункт «Профіль на сайті».
Що входить¶
| Роль | Хто це | Що може |
|---|---|---|
| Будь-хто на сервері | Кожен, хто є на сервері Discord, де працює бот | Створює гру на панелі гри, записується в збір, дивиться статистику |
| Учасник гри | Гравець, що записався в збір | Керує цією грою від збору до результату |
| Творець гри | Гравець, який створив гру на панелі гри | Те саме, що й інші учасники гри |
| Модератор | Власник сервера, учасник сервера з правом Discord «Адміністратор» або з роллю модератора | Керує будь-якою грою сервера, ставить панель гри й таблицю лідерів, налаштовує журнал подій і сповіщення про збір |
| Адміністратор сервера | Учасник сервера з правом Discord «Керувати сервером» | Задає канал збору ігор, канал історії ігор і роль модератора командою /guild config |
| Власник бота | Той, хто веде CivBot; не залежить від сервера | Починає й закриває сезон, задає коефіцієнт виграшу, рейтингові події й особисті значки рангу |
| Відвідувач сайту | Людина, що відкрила сайт CivBot | Гість бачить головну сторінку й може спробувати сейв; хто увійшов через Discord, бачить ігри й профілі |
Одна людина може мати кілька ролей. Модератор, який записався в збір, стає ще й учасником гри. Власник сервера водночас і модератор, і адміністратор сервера.
Хто такий модератор¶
Модератором бот вважає кожного, хто:
- є власником сервера;
- має право Discord «Адміністратор»;
- має роль модератора сервера.
Роль модератора на сервері одна. Її обирає адміністратор сервера командою /guild config. Людям на сервері цю роль видають у налаштуваннях Discord, як будь-яку іншу роль. Подробиці — Підключення CivBot до сервера.
Хто такий адміністратор сервера¶
Адміністратор сервера — учасник сервера з правом Discord «Керувати сервером». Лише з цим правом можна виконати команду /guild config: нею задають канал збору ігор, канал історії ігор і роль модератора. Власник сервера й учасники сервера з правом «Адміністратор» мають право «Керувати сервером» автоматично.
Право «Керувати сервером» саме по собі модератором не робить. Щоб ставити панель гри й таблицю лідерів, потрібне право «Адміністратор» або роль модератора. Подробиці — Панель гри.
Хто такий власник бота¶
Власник бота — той, хто веде CivBot. Сезон спільний для всіх серверів, тому лише власник бота починає й закриває його, модератори сервера цього не роблять. Він також задає коефіцієнт виграшу, вмикає рейтингові події й призначає особисті значки рангу. Власник бота не є роллю сервера: її не видають у налаштуваннях Discord. Модератор може лише переглянути сезони командами /season list і /season info. Подробиці — Сезони.
Хто що може у зборі¶
До старту гравці збираються на картці збору в каналі збору ігор.
| Дія | Хто може |
|---|---|
| Створити гру кнопкою «FFA» чи «Duel» на панелі гри | Будь-хто на сервері |
| Записатися в збір або вийти з нього | Будь-хто на сервері |
| Вигнати гравця кнопкою «Вигнати» | Учасник гри або модератор |
| Скасувати збір кнопкою 🗑️ | Учасник гри або модератор |
| Позначити готовність кнопкою «Готовий» | Учасник гри, лише за себе |
| Забанити нації кнопкою «Бани» | Учасник гри, лише за себе |
| Стартувати кнопкою «Старт з драфтом націй» чи «Старт без драфту націй» | Учасник гри або модератор, коли кнопки ввімкнені |
| Додати Steam-посилання кнопкою «Steam посилання» | Учасник гри або модератор |
| Покликати гравців кнопкою «Сповістити про збір» | Учасник гри або модератор, якщо в нього немає обмежувальної ролі |
Модератор може задати в налаштуваннях сповіщень про збір обмежувальну роль: хто її має, той сповіщень не надсилає. Подробиці — Налаштування сповіщень про збір.
Вигнаний гравець може знову записатися в збір. Якщо на сервері ввімкнено журнал подій, бот записує туди кожне вигнання й скасування збору.
Хто що може після старту¶
Після старту гра триває в треді гри. Її кнопками й меню користуються учасники гри та модератори.
| Дія | Хто може |
|---|---|
| Обрати нації в меню «Вибрати хто за яку націю грає» | Учасник гри або модератор, за всіх гравців |
| Призначити націю в повідомленні «Призначення націй» | Учасник гри або модератор, будь-якому гравцеві |
| Обмінятися слотами в меню «Запити на обмін між гравцями» | Учасники гри FFA, за взаємним запитом |
| Надіслати Steam-посилання в тред гри окремим повідомленням | Будь-хто, хто може писати в тред гри |
Завершити гру командою /гра завершити (/game finish) |
Учасник гри або модератор; на сайті — лише гравець гри |
| Перервати гру кнопкою «Скасувати гру» | Учасник гри або модератор |
Оновити картку гри командою /гра оновити (/game refresh) |
Будь-хто на сервері |
Хто виконує команди¶
| Дія | Хто може |
|---|---|
Поставити панель гри командою /moderator panel |
Модератор |
Поставити таблицю лідерів командою /leaderboard show |
Модератор |
Опублікувати таблицю минулого сезону командою /leaderboard season |
Модератор |
Увімкнути чи вимкнути журнал подій командою /guild log_channel |
Модератор |
Налаштувати, переглянути чи вимкнути сповіщення про збір командами /guild notifications configure, /guild notifications status і /guild notifications disable |
Модератор |
Переглянути список сезонів і картку активного сезону командами /season list і /season info |
Модератор |
Задати ідентифікатор гри Steam командою /guild steam_game_id |
Модератор |
Задати канал збору ігор, канал історії ігор і роль модератора командою /guild config |
Адміністратор сервера |
Дивитися статистику командами /stats show і /nations stats |
Будь-хто на сервері |
Знайти ігри, у яких разом грали вказані гравці, командою /search games_by_players |
Будь-хто на сервері |
| Отримати приватне посилання на профіль гравця пунктом «Профіль на сайті» в меню застосунків учасника сервера | Будь-хто на сервері, з яким працює сайт |
Пошук ігор за гравцями є і на сайті: подробиці — Ігри на сайті. Профіль гравця описано на сторінці Профіль гравця.
Усі команди з параметрами зібрано на сторінці Команди бота.
Хто що може на сайті¶
Сайт працює з одним сервером Discord, і ця таблиця стосується його ігор. Свою роль на сайті визначає те, чи ви ввійшли через Discord і чи маєте місце в грі.
| Дія | Хто може |
|---|---|
| Спробувати сейв на головній сторінці | Будь-хто, навіть гість |
| Бачити список ігор, сторінку гри та профіль гравця | Той, хто ввійшов через Discord |
| Завершити гру, обрати націю місцю, прикріпити сейв, зіставити гравців сейву | Гравець гри, тобто той, хто має місце в ній |
| Знайти лобі в Steam кнопкою «Приєднатись до гри», у перші 48 годин після старту | Гравець гри |
Модератор без місця в грі на сайті лише дивиться: цих кнопок йому не показують. Керувати такою грою він може в Discord, зокрема /гра завершити і вибір націй у треді гри. Закриту гру з сайту змінити не можна: на сторінці гри стоїть «Гру закрито …», і кнопок змін там немає. Подробиці — Сторінка гри.
З чим пов'язане¶
- Гра — учасник керує своєю грою, модератор — будь-якою грою сервера; подробиці — Гра.
- Панель гри — ставить її модератор, а кнопками «FFA» і «Duel» користуються всі; подробиці — Панель гри.
- Журнал подій — у ньому видно, хто вигнав гравця, скасував збір, перервав гру чи обмінявся слотами; подробиці — Журнал подій.
- Сповіщення про збір — налаштовує їх модератор, а надсилають учасники гри й модератори; подробиці — Налаштування сповіщень про збір.
- Підключення бота — адміністратор сервера задає канал збору ігор, канал історії ігор і роль модератора; подробиці — Підключення CivBot до сервера.
- Сайт — гру на сайті змінюють лише її гравці, а модератор без місця в грі лише дивиться; подробиці — Сторінка гри.
Правила¶
Творець гри керує грою нарівні з іншими учасниками¶
Творець гри — гравець, який натиснув «FFA» чи «Duel» на панелі гри й обрав тип гри. Бот одразу записує його в збір і показує його ім'я та аватар угорі картки збору. Окремих прав творець не має. Вигнати гравця, стартувати чи скасувати збір може будь-який учасник гри. Якщо творець вийде зі збору кнопкою «Вхід | Вихід», керувати збором він уже не зможе, хіба що він модератор. Подробиці — Створення гри й збір гравців.
Модератор керує будь-якою грою свого сервера¶
Щоб керувати грою, модераторові не треба в неї записуватися. Він робить у грі все те саме, що й її учасники, крім готовності, банів і обміну слотами. Подробиці — Створення гри й збір гравців, Тред гри.
Готовність, бани й обмін слотами кожен робить лише за себе¶
Кнопка «Готовий» позначає готовність лише того, хто її натиснув. У меню кнопки «Бани» гравець банить нації за себе. Обмін слотами відбувається, коли двоє гравців FFA вибрали одне одного в меню «Запити на обмін між гравцями». Ці дії доступні лише гравцям, записаним у гру. Модератор, який сам не грає, за інших їх не робить. Подробиці — Бани, Вибір націй і обмін слотами.
Нації за всіх гравців обирає будь-який учасник гри або модератор¶
У грі з драфтом меню «Вибрати хто за яку націю грає» задає нації одразу всім гравцям. Кожен вибір у цьому меню замінює всі попередні. У грі без драфту кнопки повідомлення «Призначення націй» дають обрати націю будь-якому гравцеві. Обидва способи доступні кожному учасникові гри й модераторам. Подробиці — Вибір націй і обмін слотами.
Кнопки старту вмикаються однаково для всіх¶
Кнопки «Старт з драфтом націй» і «Старт без драфту націй» вмикаються за двох умов. У зборі має бути щонайменше 3 гравці у FFA або 2 у Duel, і кожен із них натиснув «Готовий». Доти кнопки вимкнені для всіх, і для модераторів теж. Коли кнопки ввімкнені, стартувати може будь-який учасник гри або модератор. Подробиці — Старт гри.
Кнопками гри, крім «Вхід | Вихід», користуються лише учасники й модератори¶
Усі кнопки й меню картки збору та картки гри, крім «Вхід | Вихід», натискають лише учасники цієї гри й модератори. Іншим бот приватно відповідає «У вас немає доступу до цієї дії.» Таку відповідь ви отримаєте, якщо:
- натиснули кнопку чи меню гри, у якій не граєте, і ви не модератор;
- натиснули «Готовий» у зборі, куди не записані, навіть якщо ви модератор;
- надіслали сповіщення з вікна «Сповістити про збір» у зборі, де не граєте, і ви не модератор: вікно відкривається будь-кому, а права бот перевіряє, коли ви його надсилаєте.
Подробиці — Повідомлення бота.
Завершити чи перервати гру можна без згоди інших гравців¶
Команду /гра завершити виконує учасник гри або модератор, а на сайті гру завершує лише гравець гри. Після завершення гра одразу отримує стан «Завершена»: підтвердження інших гравців бот не просить. Кнопка «Скасувати гру» в треді гри відкриває вікно «Cancel game confirmation»: воно завжди англійською. У його полі «Cancel game» можна вказати причину до 100 символів, але це необов'язково. Після надсилання вікна гра отримує стан «Перервана», і згода інших гравців теж не потрібна. Подробиці — Завершення гри, Переривання гри.
Що може піти не так¶
- Після натискання кнопки бот пише «У вас немає доступу до цієї дії.» Ви не учасник цієї гри й не модератор або натиснули «Готовий» у зборі, куди не записані. Запишіться в збір кнопкою «Вхід | Вихід» або попросіть учасника гри чи модератора.
/guild notifications configure,/guild notifications statusчи/guild notifications disableвідповідає «У вас немає доступу до цієї дії.» Ці команди виконує лише модератор. Попросіть модератора або отримайте роль модератора в адміністратора сервера./moderator panelабо/guild log_channelвідповідає «Moderator role not set. Please contact server administrator.» На сервері ще не задано роль модератора, а у вас немає права «Адміністратор». Попросіть адміністратора сервера задати роль модератора командою/guild configі видати її вам./moderator panelабо/guild log_channelвідповідає «You are not moderator.» Роль модератора на сервері задано, але у вас її немає, як і права «Адміністратор». Попросіть адміністратора сервера видати вам роль модератора./leaderboard showабо/leaderboard seasonвідповідає «You must be a moderator to use this command.» Таблиці лідерів публікує лише модератор. Попросіть про це модератора або отримайте роль модератора в адміністратора сервера./гра завершитивідповідає «You are not in this lobby.» Ви не учасник цієї гри й не модератор. Завершити цю гру може її учасник або модератор./guild configвідповідає «You don't have permissions to do that!». Для цієї команди потрібне право Discord «Керувати сервером». Відповідь зникає через 3 с. Попросіть адміністратора сервера виконати команду.- «Профіль на сайті» відповідає «Сайт не показує ігри цього сервера.» Пункт діє лише на сервері, з яким працює сайт. Якщо в гравця ще немає ігор на сайті, бот відповідає «У цього гравця ще немає ігор на сайті.»
- Кнопки старту вимкнені навіть для модератора. У зборі замало гравців або хтось не натиснув «Готовий»: біля його імені на картці збору немає ✅. Попросіть гравців без ✅ натиснути «Готовий».