Документація Guild Butler

Guild Butler веде рейди вашої гільдії в Albion Online, виплати за лут, регіри та відвідуваність просто всередині Discord — переважно кнопками, тож запам'ятовувати майже нічого не потрібно.

Рейд — це запланована групова активність в Albion Online (PvP-бій, збиральницький вихід, велика битва альянсу). Guild Butler — це Discord-бот, який веде весь цикл навколо рейду: він публікує оголошення, збирає реєстрації, стежить, хто прийшов, справедливо ділить срібло (внутрішньоігрову валюту Albion), коли рейд завершується, і керує регірами (відшкодуванням учасникам за втрачене спорядження). Офіцери тиснуть кілька кнопок; учасники — ще менше.

Цикл рейду в двох словах

Майже все в Guild Butler — це одне коло навколо того самого циклу. Ось воно від початку до кінця:

1. Оголошення — офіцер публікує рейд командою /raid або кнопкою дошки в один клік.
2. Реєстрація — учасники тиснуть кнопку своєї ролі в пості, щоб приєднатися.
3. Проведення — рейд відбувається в грі; офіцери можуть призначати ролі й проводити переклику.
4. Розрахунок — офіцер тисне 💰 Settle, вводить загальний лут, і Guild Butler ділить його.
5. Отримання виплати — частка кожного учасника потрапляє на його відстежуваний баланс; офіцер виплачує її в грі.
6. Регір (паралельно) — будь-хто, хто втратив спорядження, подає запит на регір; офіцер розглядає й зараховує його.

Знайдіть свій розділ

Ця документація охоплює три типи читачів, і кожен заголовок розділу позначено, тож ви можете переглянути лише свою частину:

• Гравці — ви приєднуєтеся до рейдів, реєструєтеся, подаєте регіри й перевіряєте свій баланс.
• Офіцери — ви оголошуєте й розраховуєте рейди, ведете збори регіру та виплачуєте людям.
• Адміни — ви налаштовуєте сервер: ролі, податки, мову й дошку рейдів.

Guild Butler ніколи не торкається вашого акаунта Albion Online й ніколи не має справи з реальними грошима — він лише веде числа всередині Discord, а офіцер надсилає справжнє срібло в грі. Бот постачається англійською та українською.

2 · Додати бота Адміни

Натисніть Add to Discord, оберіть свій сервер, і Guild Butler одразу починає працювати з розумними значеннями за замовчуванням.

1. Натисніть Add to Discord і оберіть сервер, у якому хочете бачити бота.
2. Підтвердіть запрошення на екрані авторизації Discord.
3. Ось і все — бот створює власні записи й одразу працює на безпечних значеннях за замовчуванням (без ролі учасника, попередньо задані податки, англійська, UTC).

Щоб просто спробувати, налаштовувати нічого не треба. Коли будете готові підлаштувати його під свою гільдію — роль учасника, податки, часовий пояс, мову — перейдіть до §5 Налаштування сервера через /settings.

3 · Ролі та дозволи Усі

Guild Butler має чотири рівні дозволів — Учасник, Офіцер, Адмін, Власник — і на кожен ви кваліфікуєтеся по-своєму. Вищі рівні можуть робити все, що й нижчі.

Рівень вирішує, які кнопки й команди вам дозволено використовувати. Він базується на ваших дозволах і ролях у Discord, а не на тому, що ви купуєте. Ось хто є хто:

Рівень	Як ви кваліфікуєтеся	Що ви можете робити
Учасник	Будь-хто на сервері.	Відкривати /menu, переглядати власний профіль, баланс і статистику, створювати untaxed-рейди, реєструватися, зберігати особисті шаблони, подавати регіри й оцінювати рейди.
Офіцер	Має налаштовану роль офіцера або дозвіл Discord Адміністратор.	Усе, що й учасник, а також оголошувати й розраховувати рейди, /manage, /assign, вести збори й розгляди регіру, гільдійські шаблони й пресети, сезони, виплати, банки та спільний доступ альянсу.
Адмін	Має рідний дозвіл Discord Адміністратор (це дозвіл Discord, а не роль бота).	Усе, що й офіцер, а також конфігурацію сервера: /settings, /config, /raidboard settings і профілі контенту.
Власник	Особа чи команда, що хостить бота для вас.	Керує стороною хостингу (тарифи й white-label). З цим рівнем ви рідко матимете справу напряму — його налаштовує ваша команда.

Два моменти варто запам'ятати. По-перше, будь-хто з дозволом Discord Адміністратор автоматично є ще й офіцером — тож адміни можуть вести рейди, не маючи ролі офіцера. По-друге, бути гільдійцем — це окрема ідея: вона про гроші (чи оподатковується й відстежується ваш лут), а не про те, які команди ви можете виконувати. Це ви налаштуєте в §5.

4 · Хаб /menu Усі

Наберіть /menu один раз, щоб відкрити приватну панель кнопок, підлаштовану під вас — далі майже все клацання, а не набір.

Guild Butler побудований навколо кнопок, тож слеш-команди пам'ятати доводиться рідко. Запуск /menu відкриває приватну панель (яку бачите лише ви), що вітає вас поточним балансом срібла й розкладає дії у чотири групи. Панель показує лише те, що доступне вашому рівню, тож учасники бачать менше кнопок, ніж офіцери чи адміни.

• Ви — ваш профіль, баланс, статистика, оцінки й 📊 Мій статус (особиста картка з вашим балансом, останніми виплатами та наступними рейдами, на які ви зареєстровані, кожен із живим відліком часу).
• Рейди — оголосити рейд, переглянути й керувати шаблонами, швидкі дії реєстрації.
• Економіка — баланси, виплати, банки й сезони (для офіцерів).
• Адмін — налаштування сервера й дошка рейдів (лише адміни).

Волієте звичайний список? Запустіть /commands для плаского переліку кожної команди, до якої ви маєте доступ. Але у звичайні дні /menu плюс кілька кліків — усе, що вам знадобиться.

5 · Налаштування сервера через /settings Адміни

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

Наберіть /settings, і відкриється приватний хаб (який бачите лише ви), поділений на чотири розділи, у які ви заходите:

• Сервер — роль учасника, роль офіцера, мова, часовий пояс.
• Економіка — режим податку та ставки податків/лідера.
• Рейди — ролі для пінгу та автопінг часу збору.
• Статус — дошка статусу бота й канал відгуків (див. нижче).

Усередині розділу більшість елементів — випадні списки: оберіть значення, і воно зберігається одразу, без підтвердження. Числові поля (ставки податків, частка лідера, бонус лідера) живуть за модальним вікном «Rates» розділу Економіка, у якому є кнопка Submit — там нічого не зберігається, доки ви її не натиснете. Кнопка ⬅ Назад у кожному розділі повертає вас до хаба.

Усі налаштування сервера

Ось повний перелік того, чим керує /settings. Вам не обов'язково торкатися всього — значення за замовчуванням розумні, а важливими є дві ролі вгорі.

Налаштування	Чим керує	За замовчуванням	Значення
Member role	Позначає, хто вважається гільдійцем (оподатковуваним і з відстежуваним балансом) на противагу пугу (сторонньому гравцю, який просто отримує рівну частку без відстеження). Це найважливіше налаштування на сторінці.	Не задано	Будь-яка роль сервера
Officer role	Надає повноваження офіцера (оголошувати й розраховувати рейди, вести збори регіру, керувати учасниками) тим, хто не має Discord Адміністратора.	Не задано (офіцерами є лише Адміни)	Будь-яка роль сервера
Tax mode	Кого рейд оподатковує й відстежує за балансом: за роллю (лише гільдійці, за замовчуванням), усі (кожен учасник) або ніхто (рівний поділ без податку). Задайте типове значення для сервера тут, у розділі Економіка — його також можна попередньо задати для кожного типу контенту, і кожен рейд усе одно можна оголосити в іншому режимі. Див. §12.	За роллю	За роллю · Усі · Ніхто
Language	Мова бота всюди — і в публічних повідомленнях, і у ваших приватних панелях.	English	English · Українська
Timezone	Пояс, який використовується для читання введеного вами часу рейдів. Час зберігається в UTC й показується кожному глядачеві в його місцевому часі.	UTC	Будь-який пояс IANA (напр. Europe/Kyiv)
Merchant tax %	Частка, що береться з відремонтованого паю кожного учасника й надсилається до банку Торговця (гільдійський казан для розхідників і спорядження).	10%	0–100
Regear tax %	Частка, що надсилається до банку Регіру (казан, який фінансує заміну втраченого спорядження). Він також поглинає будь-які залишки округлення під час поділу луту.	10%	0–100
Caller cut %	Скибка від усього луту (gross), що знімається зверху й передається лідеру (офіцеру, який вів рейд), перш ніж усе решта поділять.	0%	0–100
Caller bonus points	Додаткові бали відвідуваності, що нараховуються лідеру за кожен рейд, понад саму присутність. Бали визначають частки сезонних виплат.	0	Ціле число
Ping roles	Дібраний набір чипів пінгу в один клік, які можна натиснути під час публікації рейду, щоб не шукати щоразу потрібну роль.	Порожньо	0–25 ролей
Status board	Закріплена дошка (встановлюється з розділу Статус), яка показує, чи бот онлайн і яка версія запущена, перемикається на оновлення під час деплою, публікує короткі нотатки «що нового» при оновленнях і несе кнопку 💬 Відгук.	Не встановлено	Будь-який текстовий канал
Feedback channel	Куди публікуються відгуки учасників (з кнопки 💬 Відгук або /feedback), щоб їх бачили ваші офіцери.	Не задано	Будь-який текстовий канал

Рекомендований порядок налаштування

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

1. Задайте Member role — оберіть роль, яку носять ваші справжні гільдійці. Саме це відділяє гільдійців від пугів.
2. Задайте Officer role, щоб ваші офіцери могли оголошувати й розраховувати рейди без потреби в Discord Адміністраторі.
3. Оберіть свою Language, якщо працюєте не англійською.
4. Задайте свій Timezone, щоб введений час рейдів припадав на ту годину, яку ви маєте на увазі.
5. У розділі Економіка відкрийте Rates і задайте свій Merchant tax % та Regear tax %, потім натисніть Submit.
6. Так само в Економіці оберіть свій режим податку, якщо типове значення (за роллю) вам не підходить — оберіть усі, якщо весь ваш склад гільдійський, або ніхто для поділів без податку.
7. Опційно додайте Caller cut %, Caller bonus points і кілька Ping roles — до них завжди можна повернутися пізніше.

Дошка статусу та відгуки

Розділ Статус необов'язковий, але зручний. Встановіть закріплену дошку статусу бота в канал (оберіть його або дозвольте боту створити #bot-status), і вона з першого погляду покаже, чи Guild Butler онлайн і яка версія запущена. Під час деплою вона перемикається на 🟠 оновлення, потім назад на 🟢 онлайн — а при новій версії скидає в цей канал коротку нотатку «що нового».

Дошка також несе кнопку 💬 Відгук, і будь-хто може запустити /feedback. Обидва відкривають коротку форму; звіт — плюс невеликий знімок, прив'язаний до відправника (його баланс, остання активність, версія бота) — публікується в канал відгуків, який ви задаєте тут, тож офіцери бачать звіти про баги й ідеї в одному місці.

6 · Правила регіру Офіцери

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

Збір — це одна сесія регіру для одного рейду: учасники подають свої втрати, офіцери їх розглядають. Ці налаштування визначають поведінку кожного збору. Запустіть /regear settings, щоб відкрити панель.

Налаштування	Чим керує	За замовчуванням
Event category	Категорія Discord, у якій бот автоматично створює свіжий канал для кожного збору регіру, тримаючи запити охайними й окремими від основного чату.	Не задано
Review channel	Де публікуються запити регіру, щоб офіцери схвалювали чи відхиляли їх. Якщо залишити незаданим, запити потрапляють у власний канал збору.	Повертається до каналу збору
Min screenshots	Мінімальна кількість зображень-доказів, яку учасник має прикріпити на кожен предмет, перш ніж подати запит.	1
Max amount	Стеля того, скільки срібла може запросити один запит. Понад неї запит не можна подати як є.	Без ліміту
Auto-approve under	Запити нижче цієї суми срібла схвалюються автоматично — але лише перший схвалений запит учасника в цьому зборі. Усе після нього все одно потребує людини. Задайте 0, щоб повністю вимкнути автосхвалення.	0 (вимкнено)
Default conditions text	Стандартна примітка, що показується учасникам, коли вони подають запит — правила регіру вашої гільдії вашими словами.	Не задано

7 · Дошка рейдів і профілі контенту Адміни

Дошка рейдів — це постійне повідомлення з кнопками в один клік для запуску рейду. Кожна кнопка — це профіль контенту — збережений «тип рейду» (PvP, PvE тощо). Налаштуйте її через /raidboard settings, потім розмістіть у каналі через /raidboard post.

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

Поля кожного профілю

Поле	Чим керує
Label	Текст, показаний на кнопці (напр. «PvP», «ZvZ»).
Emoji	Іконка на кнопці, поряд із текстом.
Builder	Simple відкриває швидке модальне вікно (назва, час текстом, ролі); Full відкриває повний конструктор рейду.
Mode	Untaxed (рівний поділ, нічого не відстежується) або Taxed (відстежуваний лут і виплати). Кнопки режиму Taxed доступні лише офіцерам.
Tax mode	Для профілів Taxed попередньо задає, кого оподатковують — за роллю, усі або ніхто — щоб цей тип контенту завжди стартував у потрібному режимі (повертається до типового значення сервера). Див. §12.
Ping role	Роль, яку автоматично пінгують, коли рейд публікується з цього профілю.
Template	Збережений склад ролей (той самий «склад»), з якого стартує цей профіль.
Post channel	Де публікуються рейди з цього профілю, якщо відрізняється від сервера за замовчуванням.
Gather VC	Голосовий канал, у якому збираються гравці — його задання вмикає Переклику для рейду.
Enabled	Чи взагалі показується кнопка на дошці.
Order	Позиція кнопки на дошці відносно решти.

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

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

1. Запустіть /raidboard settings, щоб налаштувати профілі й загальносерверний канал публікації рейдів.
2. Підлаштуйте автоматично засіяні профілі PvP / PvE / Guild або додайте нові й задайте кожному з них текст, режим, шаблон і канал.
3. Запустіть /raidboard post у каналі, де хочете розмістити дошку.

8 · Шаблони та склади Офіцери Гравці

Шаблон (також званий складом) — це збережений іменований перелік ролей, який ви кидаєте в рейд замість того, щоб щоразу набирати весь набір.

Уявіть склад як список ролей вашого рейду для покупок — «2 Танки, 4 Хіли, 6 DPS, 1 Лідер» тощо. Збережіть його раз, використовуйте вічно. Коли ви оголошуєте рейд, ви просто обираєте склад, і кнопки реєстрації з'являються автоматично. Шаблон завжди визначає лише склад ролей — нічого про виплати, час чи оцінки на ньому немає.

Публічний vs Особистий

Кожен склад має область видимості — хто може його бачити й керувати ним. Їх дві:

• Публічний — створений офіцером і поширений на весь сервер. Це офіційні набори вашої гільдії (склад ZvZ, малогруповий склад, ганк-склад). Лише офіцери можуть створювати, редагувати чи видаляти їх.
• Особистий — будь-хто може створити, і він залишається приватним для вас. Ніхто інший його не бачить. Чудово для збереження улюбленого п'ятиманна перед оголошенням untaxed-рейду.

Коли ви запускаєте /template create, можна передати опцію область видимості (Public або Personal (only you)). Залиште її порожньою, і бот вибере за вас: офіцери отримують публічний склад, усі решта — особистий. Неофіцеру, який явно просить публічний, буде відмовлено.

Склади також позначаються тегом PvP (гравець проти гравця) або PvE (гравець проти середовища, як-от підземелля). Тег — це суто мітка для групування — він сортує склади на дошці й у менеджерах, і не більше. Ви обираєте його при створенні складу й можете перемкнути пізніше однією кнопкою (див. нижче).

Дошка шаблонів

/template board (офіцери) публікує постійну дошку в каналі — повідомлення, що лишається, тож будь-хто зможе скористатися ним пізніше. Вона перелічує ваші публічні склади, згруповані за тегом (лінія ⚔️ PvP і/або лінія 🐉 PvE), з чотирма кнопками під ними:

• ⚔️ New PvP і 🐉 New PvE — відкривають форму створення. Чи потрапить новий склад як Public або Personal, вирішується так само, як і командою: офіцер → Public, усі решта → Personal.
• 📋 Manage public — відкриває менеджер публічних шаблонів (лише офіцери).
• 👤 My templates — відкриває ваш власний особистий менеджер.

Дві кнопки менеджера відкривають приватну панель, яку бачите лише ви, тож кілька людей можуть користуватися однією дошкою одночасно, не заважаючи одне одному. Кожен склад на дошці також показує короткий підсумок структури — кількість пативзводів і слотів (наприклад 3 party · 50 slots), тож ви можете оцінити набір з першого погляду.

Синтаксис опису ролей

Коли ви будуєте склад, ви описуєте кожну роль окремим рядком або через коми. Кожен запис має таку форму:

Обов'язковим є лише Name. Частини за порядком:

• Category > — необов'язкова група, до якої належить роль, записана як Category > Name з > між ними (наприклад Tanks > Main Tank або Healers > Holy). > обрано навмисно — воно лишає / вільним для використання всередині назви ролі, тож назва з вибором зброї на кшталт Heavy mace / Hammer працює нормально. Категорії стають меню вибору групи у великих складах.
• Name — як зветься роль (до 40 символів).
• :slots — скільки людей можуть узяти цю роль, від 1 до 50. Залиште порожнім, і отримаєте 1 слот.
• :emoji — необов'язкове емодзі, показане на кнопці реєстрації. Зверніть увагу: воно живе всередині рядка ролі — окремого поля емодзі у складі немає.

Кілька опрацьованих рядків:

Кілька пативзводів

Склад не мусить бути одним плоским переліком ролей — ви можете розбити його на кілька підпативзводів (Party 1, Party 2 тощо). Кожен підпативзвод — це просто позначена група слотів ролей — уявіть один як самодостатній п'ятиманн або крило більшої сили. Так ви організовуєте ZvZ та інші великі склади в читабельні групи (Frontline party, Flank party, Ranged party), а не одну гігантську стіну ролей.

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

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

Реєстрація працює так само, лише з урахуванням пативзводів. У малому складі з кількох пативзводів кожна роль усе ще є власною кнопкою, з дописаною назвою підпативзводу, щоб не було плутанини (наприклад ⚔️ Spear · DPS). У великому (понад 20 ролей) меню просить спершу обрати підпативзвод, а потім роль усередині нього. Офіцери отримують той самий крок «спершу пативзвод», коли використовують /assign.

Стовпчики — вигляд кількох пативзводів без підпативзводів

Підпативзводи дають на картці стовпчики поруч, але вони також змінюють реєстрацію (у великому складі меню спершу просить обрати пативзвод). Якщо вам потрібен лише вигляд у стовпчик для звичайного складу з одного пативзводу — і щоб реєстрація лишалася кнопками ролей в один клік — додайте рядок columns: N будь-де в полі ролей:

columns: 1 (або відсутність рядка) — це класична картка в один стовпчик. Можна задати від 1 до 4 стовпчиків — Discord показує до трьох поруч на комп'ютері, а четвертий переносить у другий ряд. Склад, що вже використовує підпативзводи #, ігнорує columns: (його підпативзводи вже і є стовпчиками), а збережений шаблон запам'ятовує кількість стовпчиків.

Як ролі розподіляються по стовпчиках. Guild Butler обирає один із двох способів автоматично:

• За категорією — коли ви позначаєте ролі через Категорія > і категорій щонайменше стільки ж, скільки стовпчиків, кожна категорія лишається цілою й потрапляє в той стовпчик, що наразі найкоротший. Зручний наслідок: одна категорія на стовпчик, по порядку, коли кількість категорій дорівнює columns. Це ваш важіль, щоб точно обрати, що куди піде — у прикладі вище Стовпчик 1 — це вся категорія Melee, а Стовпчик 2 — вся Ranged. (Якщо категорій більше, ніж стовпчиків, менші об'єднуються для балансу.)
• За позицією — без категорій (або якщо їх менше, ніж columns) плоский перелік ділиться згори вниз на рівні суміжні частини. Тож columns: 2 для п'яти ролей ставить рядки 1–3 у перший стовпчик і рядки 4–5 у другий; columns: 3 для шести ролей дає рядки 1–2, 3–4, 5–6.

Форма створення

Створення чи редагування складу відкриває коротку форму лише з двома полями:

• Template name — коротка мітка для складу.
• Roles — одна роль на рядок, за синтаксисом опису ролей вище. Тут же ви набираєте свої заголовки пативзводів # — увесь набір, з пативзводами й усім, живе в цьому одному полі.

Ви не задаєте тег (PvP/PvE) чи область видимості (Public/Personal) усередині цієї форми — форми Discord не можуть містити такі меню. Обидва обираються перед відкриттям форми, з опції команди чи кнопки дошки/менеджера, яку ви натиснули. Тег усе ж можна змінити пізніше з менеджера. Редагування складу з кількох пативзводів проходить туди-назад чисто: форма перезаповнюється з незмінними заголовками #, а перейменування чи переупорядкування пативзводу лишає всіх, хто вже зареєструвався, на місці.

Керування складами

Є дві панелі менеджера, і працюють вони однаково:

• /template manage (офіцери) — публічна бібліотека.
• /template mine (будь-хто) — ваша особиста бібліотека.

Кожна панель перелічує ваші склади (спершу PvP, потім PvE) з однією кнопкою на склад, плюс кнопки New PvP / New PvE унизу. Натисніть склад, щоб відкрити його дії:

• ✏️ Edit — знову відкрити форму створення (назва + ролі), щоб змінити набір. Перейменування складу теж відбувається тут — окремої кнопки перейменування немає.
• Перемикач тегу — кнопка, що показує поточний тег (⚔️ PvP / 🐉 PvE); натисніть її, щоб перемкнути склад між PvP і PvE на місці.
• ⧉ Duplicate — зробити копію, зберігаючи ту саму область видимості й тег.
• 🗑️ Delete — видалити склад.
• ← Back — повернутися до списку.

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

Команди

Пресети — зберегти весь рейд

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

Дошка пресетів

Пресети живуть на власній закріпленій дошці, що оновлюється сама — жодної команди для запам'ятовування. Офіцер встановлює її раз (/preset board або /menu → 📚 Presets board і оберіть канал); після цього вона сама редагується на місці щоразу, коли пресет змінюється.

Discord

🛡️

Guild Butler✓ APPСьогодні о 20:14

📚 Бібліотека рейдів — Пресети

Пресет — це цілий збережений виклик: склад · час · режим · вимоги · пінг. Запуск у два натискання. Шаблон — це лише розкладка складу.

• Hideout Defend — 🏛️ · 🕒 20:00 · 🛡️ T8 · ⭐ · 👥×2
• CTA — Zone Blob — 🏛️ · 🛡️ T8 · 🍖 🧪 · 👥×3
• Ava Roads — 🎲 · 🛡️ T6 · 👤×7
• Faction Warfare — 🏛️ · 🕒 21:30 · 👤×15
• …та ще 22

📋 Оберіть пресет…▾

➕ Новий пресет🔎 Усі 26

Запуск у два дотики

Оберіть пресет із випадного списку, і відкриється приватна панель (яку бачите лише ви). Натисніть ▶️ Use, і конструктор рейду відкриється попередньо заповненим — збережена календарна дата відкидається й перевиводиться з того, наскільки заздалегідь був запланований пресет (пресет «на завтра» завжди припадає на завтра), тож зазвичай ви лише задаєте час і публікуєте. Скористатися пресетом може будь-хто; неофіцера безпечно зводять до звичайного оголошення без податку.

Discord

Це бачите лише ви

Керування Hideout Defend

🏛️ · 🕒 20:00 · 🛡️ T8 · ⭐ · 👥×2 · 40

▶️ Використати ✏️ Редагувати ✏️ Перейменувати ⧉ Дублювати 🗑️ Видалити

Редагувати пресет на місці

Офіцери отримують ✏️ Edit, що знову відкриває конструктор рейду на самому пресеті — змініть склад, час, вимоги чи будь-що інше через звичайні елементи конструктора, і фінальна кнопка збереже зміни назад у пресет, а не опублікує рейд. ➕ New preset на дошці будує новий з нуля так само, тож вам ніколи не доведеться публікувати рейд-одноразку лише заради того, щоб зберегти набір.

Discord

Це бачите лише ви

✏️ Редагування пресету: Hideout Defend

Режим

🏛️ З податком (роль)

Ролі

👥×2 · Tank×2 · Healer×4 · DPS… — 40

Час

20:00

Вимоги

🛡️ T8 · їжа · зілля

🧩 Ролі🕒 Час🛡 Вимоги🔔 Пінг

💾 Зберегти зміни пресету

Керуйте, переглядайте й тримайте лад

Панель також несе Rename, Duplicate і Delete (офіцери). Назви пресетів унікальні в межах сервера — спробуйте зберегти другий «CTA», і бот запропонує натомість відредагувати наявний. Коли гільдія назбирує понад 25 пресетів, кнопка 🔎 Browse all відкриває приватний посторінковий вибір, тож жоден не лишається поза досяжністю.

Discord

Це бачите лише ви

Усі пресети (26) — оберіть один:▾

◀1 / 3▶

Безпечно за замовчуванням

Конструктор рейду тримає один робочий чернетковий набір за раз, тож якщо ви посеред збірки відкриваєте пресет, бот питає, перш ніж відкинути вашу чернетку, а не втрачає її мовчки. А склад пресету фіксується знімком, коли ви його зберігаєте — редагування чи видалення шаблону, з якого він походить, ніколи не може тихо змінити те, що пресет розгортає.

Discord

Це бачите лише ви

⚠️ У вас є незбережений чернетковий рейд. Якщо продовжити, його буде відкинуто.

Відкинути й відкритиЗалишити чернетку

Волієте команди? Вони все ще працюють: /preset list, щоб переглянути, /preset manage для менеджера з випадним списком, /preset delete <name>, щоб видалити один, і /preset board, щоб (пере)встановити дошку.

9 · Оголошення рейду Офіцери Гравці

Є два способи опублікувати рейд: повний конструктор (/raid) для повного контролю й простий конструктор (кнопка на дошці рейдів) для швидкого.

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

Повний конструктор — /raid

Запустіть /raid і пройдіть панель чернетки. Можна також одразу прикріпити зображення через /raid [image].

1. Запустіть /raid, щоб відкрити чернетку.
2. Задайте Name — це обов'язково; без нього нічого не публікується.
3. Оберіть збережений шаблон (склад) або наберіть ролі самостійно за синтаксисом опису ролей із §8.
4. Оберіть режим (Untaxed або Taxed) і задайте час — дату, час збору, час старту й тривалість.
5. Додайте будь-які вимоги (тір спорядження, їжа, зілля) і медіа (посилання на білд із міткою, зображення).
6. Задайте пінг (кого сповіщати), оберіть голосовий канал збору й перемкніть оцінки.
7. Натисніть зелену кнопку Publish.

Кілька речей варто знати про повний конструктор:

• Неофіцери можуть публікувати лише Untaxed-рейди. Taxed-рейди (ті, що відстежують лут і виплачують) доступні лише офіцерам.
• Публікація — це усе-або-нічого. Якщо пост із будь-якої причини не надішлеться, усе чисто відкочується — ви не залишитеся з напівстворним рейдом.
• Вибір голосового каналу збору — це те, що вмикає Переклику пізніше (див. §11).
• Оцінки за замовчуванням вимкнені.

Простий конструктор — із дошки рейдів

Якщо на вашому сервері є дошка рейдів (набір кнопок в один клік для поширених типів рейдів), натискання кнопки відкриває коротку форму замість повної панелі. Заповніть:

• Title — назва рейду.
• Time — введений як вільний текст (будь-яке формулювання, яке зрозуміють ваші учасники).
• Description — короткий рядок про план.
• Roles — склад, за тим самим синтаксисом опису ролей.

Потім натисніть Publish. Це найшвидший спосіб виставити untaxed-рейд на дошку. Кнопки дошки, задані на режим Taxed, натомість відкривають повний конструктор і доступні лише офіцерам.

10 · Реєстрація Гравці

Займіть своє місце в рейді, натиснувши кнопку ролі в пості — і вийдіть так само легко.

Малі склади — натисніть свою роль

• Натисніть кнопку ролі для місця, яке хочете.
• Роль, яка вже заповнена, показується неактивною — натиснути її не можна.
• Повторне натискання власної ролі вивільняє цю роль і звільняє слот.

Великі склади — понад 20 ролей

Коли рейд має понад 20 ролей, кнопки на кожну з них були б незручними, тож ви натомість користуєтеся меню:

1. Натисніть 🎯 Join.
2. Оберіть категорію (групу ролей зі складу).
3. Оберіть свою роль усередині цієї категорії.

Щоб вийти з рейду великого складу, натисніть 🚪 Leave.

Лава запасних

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

Дайте лідерам знайти вас — /profile

Ваш профіль записує, які ролі ви реально можете грати — Танк, Хіл, Саппорт, Мілі, Рендж, Батлмаунт і Лідер. Задайте їх через /profile. Коли ви сидите на лаві запасних, лідери використовують ваші вказані ролі, щоб підставити вас на вільне місце — тож тримайте його актуальним.

11 · Призначення, керування й перекличка Офіцери

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

Призначити когось — /assign

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

Керувати учасником — /manage

/manage (також доступний через кнопку 🛠️ Manage у пості) відкриває керування по кожному учаснику. Для будь-якої однієї людини ви можете:

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

Перекличка

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

12 · Розрахунок луту Офіцери

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

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

Провести розрахунок

1. Натисніть кнопку 💰 Settle у пості рейду (або запустіть /settle).
2. Введіть gross срібла й оберіть результат (перемога / поразка / нічия) рейду.
3. Введіть суму ремонту — вона стягується лише з пулу учасників, ніколи з пугів.
4. Перегляньте попередній розрахунок: він показує чисту виплату кожного учасника, суму пугів і частки обох банків.
5. Натисніть Confirm, щоб зафіксувати — або спершу Recompute, якщо склад змінився й ви хочете оновити числа.

Гільдійці проти пугів, простими словами

Гільдієць — це учасник, якого рейд оподатковує й відстежує; пуг (скорочення від «pick-up group» — сторонній, який заповнив місце) отримує рівну частку без жодного відстеження. Витрати на ремонт і два гільдійські податки виходять лише з пулу учасників; пугам виплачують зверху, і вони йдуть чисто. Хто вважається гільдійцем, залежить від режиму податку рейду (нижче): у режимі за роллю це носії вашої ролі учасника; у режимі усі це кожен учасник (без пугів); у режимі без податку нікого не оподатковують і всі отримують рівну частку.

П'ять кошиків

Кожен розрахунок ділить gross рівно на п'ять кошиків. Ось вони з опрацьованим прикладом — 700 000 gross, 7 людей у групі (4 гільдійці + 3 пуги), 50 000 ремонту й 20% загального податку (10% торговцю + 10% регіру):

Кошик	Хто / що	Цей приклад
Чисті виплати учасникам	Те, що забирає додому кожен гільдієць, після ремонту й податку	по 70 000 (4 учасники = 280 000)
Пуги	Рівна частка, виплачена 3 стороннім	300 000
Ремонт	Відкладено на полагодження спорядження (лише пул учасників)	50 000
Банк Торговця	Податок торговцю на відремонтований пай учасників	35 000
Банк Регіру	Податок на регір (також поглинає залишки округлення)	35 000

Ці п'ять завжди складаються назад у gross — нічого не з'являється й не зникає. Це тотожність узгодження:

У числах: 700,000 == 300,000 + 50,000 + 280,000 + 35,000 + 35,000. Якщо попередній розрахунок колись не збалансується, розрахунок не підтвердиться.

Режими податку

Те, як оподатковується рейд, залежить від режиму податку, у якому він був оголошений. Конструктор рейду підписує вибір як Taxed (усі/роль) або Untaxed; типове значення для сервера ви задаєте в /settings → Economy (або задаєте його для кожного типу контенту), і кожен рейд може перевизначити його:

• Untaxed — простий рівний поділ gross між усіма. Нічого не оподатковується й нічого не відстежується (жодних балансів, статистики чи банків). Це колишній «casual»-поділ.
• Taxed · за роллю — за замовчуванням. Лише гільдійців (носіїв вашої ролі учасника) оподатковують і відстежують; пуги отримують рівну частку. Це повний поділ на п'ять кошиків вище.
• Taxed · усі — кожен учасник вважається гільдійцем: усіх оподатковують і відстежують за балансом, без пугів. Зручно, коли весь ваш склад гільдійський.

Окремо рейд може розраховуватися в Pool: його чисте срібло перетікає в активний сезон замість того, щоб виплачуватися одразу, аби бути поділеним пізніше за балами відвідуваності (див. §16). Pool про те, коли срібло виплачується; режим податку — про те, кого оподатковують — вони незалежні.

Припустилися помилки у звичайному гільдійському розрахунку? Запустіть /unsettle, щоб скасувати його й почати спочатку. Зверніть увагу: він може скасувати лише звичайний розрахунок — він не може забрати назад сезонну чи пул-виплату, щойно її було розподілено.

13 · Баланси та отримання виплат Усі

Кожен розрахований рейд оновлює поточну суму срібла на кожного учасника — його баланс. Учасники перевіряють свій; офіцери виплачують його з дошки.

Учасники: перевірте свій баланс

Запустіть /balance, щоб побачити свою поточну суму срібла плюс нещодавню історію реєстру — порядковий запис того, що було додано (чисті виплати рейдів, коригування) й виплачено. Ваш баланс іде вгору, коли рейди розраховуються й регіри схвалюються, і вниз, коли офіцер вам виплачує.

Офіцери: дошка виплат

Запустіть /balances, щоб відкрити дошку виплат — кожен учасник із додатним балансом. Щоб комусь виплатити:

1. Відкрийте /balances і оберіть учасника з дошки.
2. Оберіть Pay full або Other amount, щоб виплатити часткову суму (має бути ≤ їхнього поточного балансу).
3. Бот записує запис виплати в їхній реєстр і зменшує їхній баланс на цю суму.

Ручні коригування й банки

Використовуйте /adjust, щоб додати чи відняти срібло з балансу учасника вручну — зручно для виправлень чи разових бонусів. У нього є прапорець count as regear, якщо коригування слід відстежити як відшкодування регіру, а не як звичайну правку.

Запустіть /bank, щоб переглянути два гільдійські банки, які поповнюють податки: банк Торговця й банк Регіру. Це об'єднані гільдійські кошти, окремі від балансу будь-якої окремої людини.

14 · Вилучена енергія Усі

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

Ідея така: будь-який гравець може скопіювати журнал енергії своєї гільдії за період до 4 тижнів прямо з гри, а офіцер його вставляє. Бот зводить його в баланс енергії на кожного гравця (внески мінус зняття), показує на живій дошці й надсилає в ЛС повідомлення тим, хто пішов у мінус. Срібло та енергія обліковуються окремо — енергія ніколи не торкається ваших балансів срібла.

Увімкніть і встановіть консоль Офіцери

1. Запустіть /siphoned hub — панель офіцера з коротким контрольним списком «Початок роботи».
2. Натисніть 📥 Встановити консоль і оберіть канал. Бот закріпить там консоль енергії (і ввімкне відстеження).

Тримайте актуальним — вставляйте журнал

Гра пам'ятає лише ~4 тижні, тож вставляйте журнал регулярно (найкраще щодня). Будь-хто може запросити оновлення; вставляють його лише офіцери (або роль, яку ви призначите).

1. На консолі натисніть 🔄 Запросити оновлення. Якщо ви можете вставляти — відкриється тема з інструкціями; якщо ні — бот пінгне тих, хто заповнює журнал.
2. Вставте журнал з ігрового екрана Керування гільдією → Вилучена енергія (Discord автоматично прикріпить довгий текст файлом — це нормально).
3. Бот покаже попередній перегляд — скільки рядків нові, а скільки вже записано, і попередить, якщо є пропуск від останнього імпорту. Натисніть Імпортувати.
4. Позначте у списку великі зняття, що були гільдійними витратами (силові ядра, ШК тощо), щоб вони не рахувалися проти гравця, який їх узяв, потім Готово.

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

Учасники: подивіться свій баланс Гравці

Журнал говорить ігровими іменами, тож прив'яжіть своє один раз, щоб отримати особисті функції: запустіть /ign set <ваше ігрове ім'я>. Відтоді:

• Ваш баланс енергії показується на консолі (як ваше згадування), у /menu поряд зі сріблом і через /siphoned balance чи кнопку консолі ⚡ Мій баланс.
• Якщо ваш баланс іде в мінус, бот надішле вам у ЛС нагадування поповнити (щонайбільше раз на тиждень, поки ви в мінусі).
• /siphoned transfer <учасник> <сума> передає частину вашої енергії іншому учаснику; /siphoned top показує найбільших боржників.

Перехід з іншого бота Офіцери

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

1. Спершу імпортуйте журнал (Запросити оновлення → вставити → Імпортувати, як вище). Це заносить останні 4 тижні.
2. Потім /siphoned hub → 📥 Перенести баланси і вставте список балансів старого бота.
3. У списку (відсортованому від найбільших) пропустіть будь-який акаунт-«тримач боргу» — фіктивного персонажа, на якому деякі боти тримають увесь борг гільдії — щоб його фіктивний баланс не дістався справжньому гравцю. Потім Застосувати.

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

15 · Регір: запит і розгляд Усі

Регір відшкодовує учаснику спорядження, яке він втратив у рейді. Учасник подає запит із доказами; офіцер його розглядає, і схвалення зараховує кошти на баланс учасника.

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

Учасник: подати регір

1. Офіцер відкриває збір через /regear board.
2. На дошці натисніть 📸 Request regear — бот відкриває приватну гілку лише для вас.
3. Натисніть ➕ Add death для смерті з втратою спорядження або ➕ Add OC, щоб додати «off-content» рядок (спорядження, втрачене поза основним боєм).
4. Введіть суму срібла для цього предмета — скільки коштувало спорядження.
5. Скиньте свій(-ї) скриншот(и) у гілку як доказ.
6. Натисніть ✅ Submit, щойно кожен предмет має суму й принаймні мінімальну кількість скриншотів.

Офіцер: розглянути запит

Кожен поданий запит потрапляє як ембед розгляду з чотирма діями плюс відкликання:

• ✅ Approve — прийняти запит. Ви можете редагувати суми вниз перед схваленням або задати рядку 0, щоб відкинути його повністю.
• ❌ Deny — відхилити запит одразу.
• ✍️ Request info — знову відкрити гілку й попросити учасника про більше деталей чи кращі скриншоти.
• ↩️ Revoke — скасувати регір, який ви вже схвалили.

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

Коли всі запити збору оброблено, закрийте його через /regear close.

16 · Відвідуваність, оцінки та статистика Усі

Оподатковані рейди тихо будують ваш послужний список: бали відвідуваності записуються самі, оцінки — за бажанням, а /stats показує, що ви заробили і як часто з'являлися.

Бали відвідуваності

Бали відвідуваності — це простий підрахунок того, на скільки рейдів ви з'явилися. Ви ніколи не нараховуєте їх вручну — вони записуються автоматично щоразу, коли оподаткований рейд розраховано. «Оподаткований рейд» — це запуск у режимі Taxed (режими 🏛️), на відміну від неоподаткованого рейду, який є швидким, необлікованим запуском.

Кожен розрахований оподаткований рейд вартий одного бала відвідуваності; неоподатковані рейди не дають жодного. Бали походять від режиму рейду — облікований (оподаткований) контент проти неоподаткованого — а не від якогось налаштування шаблону. (Лідер може заробити кілька бонусних балів за рейд, якщо адміністратор це налаштував.) Неоподатковані рейди не відстежують геть нічого — ні балів, ні історії заробітку — тож не очікуйте, що вони тут з'являться.

Оцінки (за бажанням)

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

Чи з'являються ваші оцінки на публічній дошці — цілком ваше рішення. Ваші оцінки типово приватні. Використовуйте ці дві команди, щоб керувати цим:

Ваша статистика

Три команди зчитують цифри, залежно від того, хто ви і чий послужний список хочете побачити:

/stats caller варта пильнішого погляду, якщо ви ведете рейди. Вона підсумовує, як пройшли рейди лідера: загальний і середній валовий (срібло, яке приніс рейд), яка частка пішла на ремонт (вартість лагодження спорядження) та поєднання результатів (перемога/поразка, записані на момент розрахунку). Це чесний, зрозумілий з першого погляду показник ефективності лідера з часом.

17 · Сезони Офіцери Опційно

Сезон — це альтернативна модель виплат: замість розрахунку кожного рейду на місці лут накопичується весь сезон і виплачується за відвідуваністю в самому кінці.

Як працює сезон

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

1. Офіцер запускає /season start, щоб відкрити сезон.
2. Рейди в режимі пулу розраховують як зазвичай, але їхнє чисте срібло живить єдиний сезонний банк замість негайної виплати. Кожен учасник також заробляє бали відвідуваності.
3. Будь-хто може запустити /season status, щоб побачити поточний розмір банку та власну прогнозовану частку.
4. Офіцер запускає /season end, щоб поділити банк за балами відвідуваності та закрити сезон.

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

18 · Спільна відвідуваність альянсу Офіцери Опційно

Дві союзні гільдії можуть ділитися відвідуваністю рейдів через кордон — ніколи не сріблом, ніколи не складами — тож учасники, які б'ються пліч-о-пліч із союзником, усе одно отримують залік удома.

Що передається (а що ніколи)

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

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

Налаштування зв'язку

1. На гільдії-джерелі офіцер запускає /alliance і обирає роль, що позначає гравців союзника.
2. Бот повертає одноразовий код, що спливає за 24 години.
3. Надішліть цей код офіцеру на гільдії-підписнику.
4. Офіцер-підписник запускає /alliance, обирає Слідкувати та вставляє код.

Щойно зв'язок активний, коли гільдія-джерело розраховує рейд, будь-які учасники, що мають прив'язану роль (роль, обрану на кроці 1), зараховуються гільдії-підписнику — лише відвідуваність. Будь-яка сторона може згодом відкликати зв'язок; відкликання зупиняє майбутнє зарахування і не забирає назад те, що вже було передано.

19 · Білий лейбл і тарифи Адміни Опційно

Guild Butler повністю безкоштовний у користуванні. Єдине платне покращення сьогодні — білий лейбл — воно дозволяє боту носити власне ім'я та обличчя вашої гільдії.

Тарифи

Є два рівні, і ми чесно скажемо вам про різницю:

Тариф	Що ви отримуєте
Free	Весь бот — кожна функція рейду, розрахунку, регіру, сезону та статистики в цій документації.
Pro	Усе з Free плюс брендинг білого лейбла.

Чесно: білий лейбл — єдина платна відмінність сьогодні. Кожна функція рейду та економіки працює на Free. Перевіряйте свій тариф будь-коли за допомогою /plan show.

Що робить білий лейбл

Білий лейбл дозволяє боту перейняти ідентичність вашої гільдії замість типового брендингу Guild Butler. Є два різновиди:

• Нікнейм на спільному боті — той самий бот Guild Butler, яким користуються всі, але з нікнеймом на ваш вибір для кожного сервера.
• Повністю виділений бот — власний бот із вашим власним ім'ям та аватаром, запущений тільки для вашої гільдії.

Як увімкнути

Щойно ваш сервер на потрібному тарифі, офіцери керують брендингом однією командою:

Шлях із нікнеймом працює одразу з Discord. Повністю виділений бот — із власним ім'ям та аватаром — налаштовується разом із командою Guild Butler, оскільки для вас треба виділити окремого бота. Зверніться до команди, щоб це запустити.

20 · Веб-панель керування Усі

Веб-перегляд економіки вашої гільдії та вашої власної статистики лише для читання — увійдіть через Discord, без нового пароля.

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

1. Перейдіть на app.guild-butler.com у вашому браузері.
2. Натисніть Увійти через Discord — ви авторизуєтеся своїм наявним акаунтом Discord, тож не треба створювати новий пароль.
3. Оберіть свій сервер зі списку. З'являються лише сервери, які ви поділяєте з ботом.
4. Читайте свій перегляд: офіцери бачать огляд економіки, тренди з часом і дошку учасників; учасники бачать огляд плюс власну статистику.

Те, що бачить кожна роль, відповідає тому, що вона вже може бачити в Discord — картину балансу та виплат офіцера, власний баланс учасника (срібло, винне йому) та відвідуваність. Ніхто не бачить дані іншої гільдії, а учасники не бачать приватних цифр інших учасників.

21 · Довідник команд Усі

Кожна слеш-команда, згрупована за тим, хто нею користується. Більшості учасників це ніколи не потрібно — кнопки за /menu покривають повсякдення.

Введіть / у будь-якому каналі, щоб побачити команди, які дозволяють ваші права. Нижче кожна картка містить команду, що вона робить і хто може її запустити. Учасник = будь-хто на сервері, Офіцер = має роль офіцера або має Discord Administrator, Адмін = має Discord Administrator.

Ви

Рейди

Економіка

Адмін

22 · FAQ та усунення проблем Усі

Швидкі відповіді на поширені запитання, а потім виправлення для налаштувань, на яких люди спотикаються.

Поширені запитання

Усунення проблем

23 · Глосарій Усі

Прості визначення для кожного терміна Guild Butler та Albion Online, вжитого в цій документації, за абеткою.

Термін	Значення
Спільний доступ альянсу	Односторонній зв'язок між двома гільдіями. Гільдія-джерело ділиться своїми розрахованими рейдами, тож позначені учасники також заробляють відвідуваність у гільдії-підписнику. Передається лише відвідуваність — ніколи не срібло.
Бали відвідуваності	Бали, які учасник заробляє за появу на облікованих рейдах. Вони живлять статистику і, у сезоні, те, як ділиться пул.
Баланс	Срібло, яке гільдія наразі винна учаснику (або яке учасник винен гільдії). Зростає, коли рейди розраховуються на його користь, зменшується, коли йому виплачують.
Базова частка	Рівний шматок розрахованого луту, з якого починає кожен кваліфікований учасник, до застосування податків і відрахувань.
Лава запасних	Записаний гравець, тримається в резерві, а не активний на рейді. Гравці на лаві запасних чекають і можуть бути введені в гру.
Лідер 👑	Особа, що веде рейд. Може отримувати частку лідера та/або бонусні бали відвідуваності.
Частка лідера	Відсоток валового луту, знятий зверху на користь лідера, перш ніж решта ділиться. Типово 0%.
Казуальний / неоподаткований рейд 🎲	Розслаблений режим рейду, який може створити будь-який учасник — у боті підписаний як Untaxed. Він ділить лут порівну і не відстежує нічого — ні податків, ні відвідуваності, ні сезонного пулу.
Категорія (роль)	Групування ролей усередині складу (наприклад, танки чи хіли). У великих складах ви спершу обираєте категорію, а потім конкретну роль.
Профіль контенту / дошка рейдів	Кнопка контенту в один клік на дошці рейдів (автоматично засіяні PvP, PvE, Guild). Кожен профіль несе власний ярлик, емодзі, режим, шаблон, роль пінгу та канал.
Збір / подія	Сесія регіру. Офіцери відкривають збір; учасники подають запити на регір проти нього, часто у власному каналі чи категорії.
Ефемерне	Повідомлення Discord, яке бачите лише ви. Багато відповідей бота (як-от приватні підтвердження) ефемерні, тож вони не захаращують канал.
Валовий	Загальна вартість луту рейду до вилучення будь-яких податків, витрат на ремонт чи відрахувань.
Гільдієць 🛡️	Гравець у налаштованій ролі Учасника. Гільдійці оподатковуються й обліковуються; їхні частки живлять пул учасників.
Реєстр	Поточний запис кожного зарахування та списання з балансу учасника — розрахунків, виплат і ручних коригувань.
Пул учасників	Частина срібла розрахунку, що ділиться між кваліфікованими гільдійцями після ремонту та відрахувань зверху.
Банк торговця	Гільдійний фонд, побудований із податку торговцю — частки з відремонтованої частки кожного учасника. Використовується для гільдійних витрат.
Чисте	Те, що учасник фактично отримує від розрахунку — його базова частка після застосування ремонту та податків.
Результат	Перемога/поразка (або подібний) результат, записаний, коли ви розраховуєте рейд. Його не можна дописати пізніше, тож встановіть його на момент розрахунку.
Пуг / сторонній ⚔️	Гравець, який не в ролі Учасника гільдії. Пуги не оподатковуються й не обліковуються, і всі рахуються як пуг, поки не встановлено роль Учасника.
Ролі пінгу	Дібрані ролі Discord, пропоновані як чипи пінгу в один клік під час публікації рейду, щоб потрібні люди отримали сповіщення. 0–25 налаштовних.
Тариф	Рівень функцій, на якому сервер (наприклад, Free чи Enterprise). Сьогодні він лише обмежує функції білого лейбла.
Пресет	Збережена конфігурація рейду, яку можна повторно використати, щоб швидко збирати схожі рейди, не вводячи повторно кожне поле.
Оцінки	Опційний відгук за кожен рейд, що згортається в оцінку для учасників. Кожен учасник обирає, чи публічна його оцінка.
Регір	Відшкодування за спорядження, втрачене в контенті. Учасник подає запит із сумою та скриншотами; офіцер його переглядає. Предмети можуть бути смертю (втрачено повний білд) або OC (втрата поза кулдауном / часткова), і кожне потребує мінімальної кількості скринів (скриншотів).
Банк регіру	Гільдійний фонд, побудований із податку на регір; він також вбирає залишки округлення. Примітка: схвалення регіру зараховує на баланс учасника — воно не зменшує банк регіру.
Ремонт	Вартість лагодження спорядження для рейду, введена на момент розрахунку і вилучена з пулу учасників до поділу часток.
Перекличка	Реєстрація відвідуваності, прив'язана до голосового каналу збору рейду, використовується для підтвердження, хто справді з'явився.
Синтаксис специфікації ролі	Скорочення для визначення ролі складу: [Category > ]Name[:slots[:emoji]] — опційна категорія, назва, опційна кількість слотів та опційне емодзі. Рядок, що починається з #, відкриває нову суб-групу.
Сезон / пул	Період, протягом якого рейди в режимі пулу збирають своє чисте срібло в спільний пул і нараховують бали відвідуваності. Наприкінці сезону пул ділиться за балами — це незворотно.
Режим розрахунку	Коли рейд виплачується: негайний (поділити зараз) або пул (чисте живить сезонний пул, ділиться пізніше). Незалежний від режиму податку — див. Режим податку.
Срібло	Ігрова валюта Albion Online. Guild Butler відстежує баланси срібла лише в Discord; він ніколи не рухає срібло в грі.
Суб-група	Позначена група слотів ролей усередині складу — Група 1, Група 2 і так далі — використовується, щоб організувати великі склади в читабельні групи. Ви відкриваєте одну рядком-заголовком # у полі ролей. Розбиття складу на суб-групи не впливає на розрахунок луту.
Режим податку	Кого рейд оподатковує й відстежує: за роллю (лише гільдійці, за замовчуванням), усі (кожен учасник) або ніхто (рівний поділ без податку). Задається для сервера й для кожного типу контенту, фіксується знімком на кожен рейд. Конструктор показує його як Taxed / Untaxed.
Податки	Відсотки, взяті з відремонтованих часток учасників у гільдійні банки: податок торговцю живить банк Торговця, податок на регір живить банк Регіру. Кожен типово 10%.
Шаблон / склад	Збережений набір ролей (композиція) для рейду. Шаблони можуть бути Публічними (для всієї гільдії) або Особистими (вашими) і зазвичай позначені PvP чи PvE.
Білий лейбл	Представлення бота під власним ім'ям та аватаром вашої гільдії. Лайт-нікнейм працює на спільному боті; виділене налаштування запускає бота з власною глобальною ідентичністю (команда налаштовує це для вас).
ZvZ / CTA	Масштабний контент Albion Online. ZvZ (zerg-vs-zerg) — велика битва у відкритому світі; CTA (call to arms) — обов'язкова подія з явкою.