Octera — Documentation

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

Octera працює зі слеш-командами (/command) і текстовими командами з префіксом твого сервера (типово .). Майже все також налаштовується у вебпанелі керування.

Порада: введи .help <command> (напр. .help ban, .help eco), щоб побачити, що робить команда, і реальні приклади — або .help <category> для цілого розділу. <command> help теж досі працює.

Сервери з Premium: сторінка Premium у панелі керування (бічна панель → Налаштування) показує підписку сервера з першого погляду — тариф, дату продовження й того, хто платить — і поруч кнопки для оновлення та керування.

Префікс & довідка

/help [query]

Меню команд за категоріями — або вкажи команду, щоб побачити її використання + приклади, чи категорію, щоб отримати список.

Приклад: .help timeout

/prefix [set]

Показати або змінити префікс текстових команд (Manage Server).

Приклад: /prefix set: ?

/enable & /disable <targets>

Вмикай або вимикай модулі та/або команди — по кілька одразу.

Приклад: /disable economy music warn

Модерація

/warn @user [reason]

Попередь учасника; додає бали ескалації та записує кейс.

/timeout @user <duration> [reason]

Тимчасово заглуши учасника.

Приклад: /timeout @user 10m spamming

/kick · /ban · /unban

Звичайна модерація, і все з кейсами в журналі.

/case [id|@user]

Переглянь конкретний кейс або повну історію учасника.

/modlog

Задати канал журналу модерації.

/unbanall run

Масово розбанити всіх, крім захищеного чорного списку.

/unbanall blacklist add|remove|list

Керування захищеним списком — користувачами, яких масовий розбан ніколи не зачепить.

/purge <all | number | time span> [@user]

Масове видалення повідомлень. all очищає канал (і блокує його на час очищення, якщо він великий), число видаляє стільки останніх повідомлень, а проміжок часу (напр. 7d, 2mo) видаляє це вікно. Вкажи користувача, щоб видалити лише його повідомлення. Зверни увагу: Discord не дозволяє ботам масово видаляти повідомлення, старші за 14 днів.

Приклад: .purge 50 · .purge 2mo · .purge all

Безпека

/security

Анти-нюк, роль карантину та інформація про захист.

/quarantine @user · /release @user

Зніми з учасника ролі та ізолюй його — або поверни все назад.

/security panic on|off

Аварійне блокування — закрий канали та/або відправ новачків у карантин.

/security let-in @user · let-in-remove @user · let-in-list

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

Приклад: /security let-in @friend

/lockdown all|channel|end

Закрити всі канали (або один), щоб учасники не могли писати — /lockdown end знімає блокування й усе відновлює.

Приклад: /lockdown all

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

Рівні

/rank [@user]

Показуй рівень & XP на картці рангу.

/leaderboard

Найкращі учасники за XP.

/xp · /level

Адмін: додати/зняти/встановити XP або рівень учасника.

/leveling

Задай канал сповіщень про підвищення рівня та імпортуй рівні з інших ботів.

Економіка

/balance · /bank

Гаманець, банк і відсотки.

/deposit · /withdraw · /pay

Перевести або надіслати монети.

/work · /crime · /rob · /daily

Заробляй монети. Удача (від предметів & дрібничок) покращує шанси в /crime, /rob, збиранні та лутбоксах.

/farm

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

/fish · /hunt · /dig · /search

Мінігри на здобич, у кожної свій кулдаун — знаходь монети та товари на продаж.

/pet

Заведи улюбленця, годуй його та щогодини збирай із нього монети.

/trade @user

Запропонуй обмін — монети та/або предмети — який інший учасник прийме або відхилить.

/coinflip · /slots · /blackjack · /roulette · /highlow · /rps · /guess · /dice

Став свої монети — вісім ігор казино.

/economy-info guide|games

Короткий гайд про те, як працює вся економіка, і про кожну гру казино з її виплатами. (.games досі працює як скорочення.)

/shop · /buy · /sell · /use · /open

Гортай магазин (кнопки купівлі), купуй/продавай предмети, використовуй витратні речі, відкривай лутбокси.

Приклад: .buy lucky coin 3

/inventory · /collect · /multipliers · /rich

Предмети, ролі з доходом, активні бусти & дебафи та топ багатіїв.

/eco

Адмін: видати/забрати монети чи предмети з магазину, надати тимчасові бусти, нарахувати відсотки.

/lootbox

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

Ролі & учасники

/role <add|remove> <roles> (user or everyone) [duration]

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

Приклад: /role add roles:@VIP @Booster user:@someone duration:7d

/serverinfo

Статистика сервера — власник, дата створення, учасники, ролі, канали, бусти.

/info [@user]

Вік акаунта учасника, дата приєднання, ролі та колір.

/av [@user]

Показати аватар користувача в повний розмір.

/roles

Список усіх ролей разом із їхніми ID.

/dump [role]

Вивантажити учасників ролі (або всього сервера) у файл.

/oldest · /youngest

Учасник із найстарішим / найновішим акаунтом Discord.

/clonecategory · /stylechannels · /cleanroles · /counters

Клонуй категорію з правами, додавай емодзі-префікси до каналів, прибирай оздоблення з назв ролей, налаштовуй канали з живою статистикою.

Автоматизація

/tag

Власні префіксні команди, написані на TagScript — див. гайд нижче.

/reactionrole sync|list|convert

Опублікуй або онови свої меню ролей чи переведи їх усі між кнопками / випадним списком / реакціями-емодзі.

Усі інструменти ембедів в одній команді — публікуй або переглядай збережені ембеди, копіюй опубліковані ембеди між каналами чи категоріями, перефарбовуй усі ембеди, які опублікував бот, редагуй один із сирого JSON або витягуй ембеди + вміст повідомлення у форматі JSON.

/log list

Показати маршрути логування подій — саме логування налаштовується в панелі керування.

/stealemoji <emoji> [name]

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

Automations (панель → Утиліти → Automations) — це правила у форматі «коли стається це — зроби те»: обери тригер (опубліковано повідомлення, додано реакцію, приєднався учасник, додано або знято роль), додай необов’язкові умови (канал, роль, ключові слова, вік акаунта), а потім виконай до 10 дій по черзі — надіслати повідомлення, ембед чи особисте повідомлення, додати або зняти роль, поставити реакцію, видалити повідомлення або створити гілку. Почни з готових шаблонів на кшталт Welcomer, Keyword auto-reply та Auto-thread — до 50 на сервер, безкоштовно.

Auto Send (панель → Утиліти → Auto Send) публікує повторюване повідомлення із заданим інтервалом або щодня о визначеній годині UTC — обери дні тижня, коли воно виходить, додай необов’язкове вікно надсилання, увімкни захист від флуду (пропускає надсилання, поки останнє повідомлення бота ще найновіше) або надішли його як ембед.

Дні народження

/birthday set <date> [year]

Збережи свій день народження — MM-DD або YYYY-MM-DD. Додай рік, якщо хочеш, щоб святкували й вік.

Приклад: /birthday set 10-12 · /birthday set 1993-12-16

/birthday view [@user] · /birthday next

Подивитися день народження учасника або 10 найближчих на сервері.

/birthday remove

Видалити збережений день народження.

/birthday set-user @user <date>

Адмін: встановити день народження учасника (Керувати сервером).

Увімкни привітання в панелі керування (Інструменти → Дні народження): вибери канал, зміни повідомлення й за бажання видай на цей день іменинну роль.

Досягнення

/achievements [@user]

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

Налаштуй їх у панелі керування (Досягнення): увімкни функцію, щоб отримати готовий стартовий набір, а тоді додай власні — одиничні або багаторівневі цілі від Бронзи до Діаманта за повідомленнями, реакціями, часом у голосових каналах, гілками, бустами, участю в розіграшах, покупками в крамниці та днями народження, кожна з необов’язковими нагородами-ролями й оголошеннями про відкриття.

Запрошення

/invites me · /invites user @member

Скільки запрошень у тебе (або в учасника) — з розбивкою на входи, виходи та фейки.

Приклад: /invites user member: @friend

/invites leaderboard

Найактивніші запрошувачі сервера, за рейтингом.

/invites who-invited [@member]

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

Налаштуй це в панелі керування (Запрошення): ігноруй зовсім нові акаунти як фейкові та автоматично видавай ролі-нагороди на етапних кількостях запрошень.

Розіграші

/giveaway start <duration> <prize> [winners]

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

Приклад: /giveaway start duration: 1d prize: Nitro winners: 2

/giveaway end|reroll|cancel|delete|list

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

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

Тікети

Створюй панелі тікетів у панелі керування (модуль «Тікети»). Учасники відкривають тікет кнопкою на панелі; команда бере його в роботу та закриває. Після закриття транскрипт зберігається й публікується разом із посиланням View Online Transcript, щоб прочитати його в браузері.

/close [reason]

Закрити поточний тікет і зберегти його транскрипт.

/ticket add|remove|blacklist|unblacklist

Персонал: додай або прибери когось із поточного тікета чи заблокуй тому, хто зловживає, можливість відкривати тікети.

Інструменти

/ping

Затримка бота.

/poll create|end

Опублікуй рідне опитування Discord, за яке голосують просто в повідомленні, або заверши його достроково. Сторінка Опитування в панелі керування теж створює опитування — до 10 варіантів, власна тривалість і кілька відповідей.

/voice rename|limit|lock|unlock|claim

Керувати своїм тимчасовим голосовим каналом: перейменувати, задати ліміт учасників, закрити чи відкрити доступ або забрати його собі, якщо власник пішов.

Приклад: /voice rename name: Gaming · /voice lock

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

Лише для оператора: /nuke channels, /nuke category і /restart — службові команди, жорстко закріплені в коді за оператором бота; персонал сервера їх запустити не може.

Сповіщення

Отримуй сповіщення, коли автор щось публікує. У панелі керування (Socials) додай стрічки для YouTube, Twitch, Kick, TikTok, Reddit (нові пости сабреддита), Podcast (нові випуски з RSS-стрічки шоу) або будь-яку URL-адресу Custom RSS — Octera опублікує нові відео, пости, випуски та старти трансляцій у вибраному тобою каналі разом із твоїм текстом.

Музика

Слухай музику в голосовому каналі з охайною чергою — без окремого бота. (Premium.)

Шукай пісню за назвою або встав посилання — SoundCloud, Bandcamp, подкаст, інтернет-радіо чи пряме посилання на аудіо. Octera читає більшість аудіосайтів і показує, звідки взявся трек.

YouTube недоступний. YouTube блокує запити на відтворення від хостинг-провайдерів, а саме там працює кожен Discord-бот, — тож посилання на YouTube відхиляються, а не програються. Пошук за назвою працює й далі та відтворює з наведених вище джерел. Посилання на Spotify та Apple Music не може відтворити жоден бот, бо їхнє аудіо зашифроване; надсилай натомість назву пісні.

/play <song or link>

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

/skip · /stop

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

Усе інше — однією командою: поклич бота в голосовий канал, відкрий панель із кнопками, переглянь чергу та поточний трек, зациклюй трек чи чергу, став на паузу або продовжуй. (Звичні префіксні команди на кшталт .queue та .pause досі працюють.)

Переклад

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

/translate text <text> <to> [from]

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

Приклад: /translate text text: where is the meeting to: Spanish

/translate live <from> <to>

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

Приклад: /translate live from: Chinese to: English

/translate off

Припинити переклад того, що ти пишеш у цьому каналі.

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

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

Живий переклад. Для однієї людини, яка долучається до розмови мовою, якої не знає. Вона один раз запускає /translate live — і все, що вона пише, публікується ще й іншою мовою, доки вона не виконає /translate off або не замовкне. Власник сервера може вимкнути це в панелі.

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

Резервні копії

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

Гайд: змінні в повідомленнях

Скрізь, де Octera пише повідомлення, можна вставити змінну — короткий заповнювач {name}, який підставляє значення в момент надсилання. Вони працюють у привітаннях і прощаннях, ембедах, автовідповідачах, тегах, авторозсилці, панелях ролей за реакції, панелях тікетів і не тільки — і всюди мають однакові назви.

Welcome {user.mention} to **{server}** — you're member #{server.members}!

Пиши їх через крапку або в дужках; це те саме: {user.name} = {user(name)}.

Учасник

Змінна	Що підставляється
{user}	Їхнє ім’я
{user.mention}	Справжній @-пінг
{user.name}	Їхнє ім’я користувача
{user.nick}	Їхній нікнейм на цьому сервері (ім’я користувача, якщо нікнейму немає)
{user.id}	Їхній Discord ID
{avatar}	Їхнє фото профілю — встав це у слот зображення або мініатюри
{user.color}	Колір їхнього імені, напр. `#a93bf0`
{user.top_role}	Назва їхньої найвищої ролі
{user.joinstamp}	Коли вони приєдналися, як число-мітка часу
{user.timestamp}	Коли було створено їхній акаунт, як число-мітка часу

{target} працює так само для першої людини, згаданої через @ у команді (а якщо згадки немає — для того, хто виконав команду), — зручно в тегах: {target.mention}, {target.avatar}.

Сервер & канал

Змінна	Що підставляється
{server}	Назва сервера
{server.members}	Кількість учасників
{server.ordinal}	Кількість учасників як порядкове місце — «42-ге»
{server.icon}	Іконка сервера — придатна для слота зображення або мініатюри
{server.id}	ID сервера
{server.description}	Опис сервера
{channel}	Назва каналу
{channel.mention}	Клікабельне посилання на #channel

Зображення зі змінних

Слоти зображення, мініатюри, іконки автора та іконки футера приймають змінну замість посилання — тож привітальний ембед може показати власний аватар новачка:

Постав {avatar} у слот thumbnail вітального ембеда — і кожен новачок побачить у кутку своє фото. {server.icon} працює так само.

Кожен із цих слотів також приймає звичайне посилання https:// або Upload… прямо з твого комп’ютера — Octera зберігає зображення й використовує постійне посилання, тож воно працюватиме завжди.

Корисно знати

Змінна, якої не існує, підставляється за найближчим збігом, а не викликає помилку — якщо щось виводиться дивно, звір написання з таблицями вище.
Змінні підставляються в момент надсилання повідомлення, тож попередній перегляд у панелі керування показує сирий текст {name}.
Теги та власні команди додають до цього логіку — див. створення команд-тегів.

Керування сервером: особливості Discord, про які варто знати

Дещо в Discord поводиться так, ніби воно зламане, хоча це не так — і майже кожен власник сервера рано чи пізно на цьому спотикається. Жодна з цих речей не спричинена Octera; усі виправлення — у власних налаштуваннях Discord.

Ім’я користувача показується не тим кольором

Discord фарбує ім’я за найвищою роллю, у якої є колір. Роль зі значенням Default (без кольору) має пропускатися, тож безбарвна роль, яку ти тримаєш угорі — зазвичай щоб окремо виділятися в списку учасників, — залишає колір ролі нижче.

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

Змусь Discord перечитати роль:

Відкрий Server Settings → Roles, вибери потрібну роль і перейди до Display.
Постав Solid, вибери будь-який видимий колір і збережи.
Знову відкрий ту саму роль, поверни їй значення Default (без кольору) і збережи ще раз.
Натисни Ctrl + R, щоб перезавантажити Discord.

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

Поруч із твоїм ім’ям зникла корона власника

Корона зникає, коли в однієї з твоїх ролей увімкнено обидва ці пункти одночасно:

дозвіл Адміністратор, і
Показувати учасників ролі окремо від учасників онлайн.

Щоб твоя власна роль лишалася вгорі, а корона повернулася:

Відкрий Server Settings → Roles і вибери свою виділену особисту роль.
Вимкни Administrator для цієї ролі — Display role members separately залиш увімкненим.
Натисни Ctrl + R, щоб перезавантажити Discord.

Ти нічого не втрачаєш: власник сервера й так має всі права, тож особистій ролі Administrator ніколи не потрібен. Для персоналу створи окрему роль Admin з увімкненим Administrator і вимкненим Display role members separately.

Гайд: як збирати тег-команди

Теги — це власні префіксні команди, які ти пишеш сам, на основі TagScript — крихітної шаблонної мови зі змінними, логікою, математикою, випадковістю й керівними блоками (видалити тригер, надіслати відповідь у DM, поставити реакцію, обмежити за роллю, прикріпити ембед тощо). Кожна змінна повідомлення працює й тут.

Створити тег

Скористайся /tag (або панель керування → Інструменти → Теги). Дай йому назву й вміст. Учасники викликають його твоїм префіксом, напр. .rules.

/tag name: hello content: Hey {user(mention)}, welcome to {server(name)}! 👋

Виконання .hello → Привіт, @You, ласкаво просимо до Octera! 👋

Змінні

У тегу працює кожна змінна повідомлення — {user.mention}, {server}, {avatar} та решта. Теги додають кілька своїх:

Змінна	Що дає
{args}	Усе, що набрано після команди. `{args(1)}` = перше слово, `{args(2)}` = друге…
{target(mention)}	Перша @згадка в повідомленні (інакше той, хто його запустив) — ті самі атрибути, що й у `{user}`
{uses}	Скільки разів запускався тег
{unix}	Поточна мітка часу Unix

Логіка, математика & випадковість

Блок	Що робить
{if(a==b):yes\|no}	Умова. Оператори: `==` `!=` `>` `<` `>=` `<=`
{any(a==b\|c==d):yes\|no}	`any`/`or` та `all`/`and` для кількох умов одночасно
{math:2*(3+4)}	Арифметика (`+ - * / % ^`)
{random:a~b~c}	Вибрати один випадковий варіант (розділяй через `~` або `,`)
{range:1-100}	Випадкове ціле число з діапазону
{=(name):value}	Задати змінну; прочитати її пізніше через `{name}`
{lower} {upper} {replace(a,b):text} {length:text}	Текстові помічники

Керуючі блоки (побічні ефекти)

Блок	Ефект
{delete}	Видалити повідомлення, яке викликало тег
{dm}	Надіслати відповідь у DM тому, хто викликав команду
{react:✅,🎉}	Реагує на відповідь · {reactu:✅} реагує на тригер
{redirect:#channel}	Надіслати відповідь в інший канал
{require(@Role)} / {blacklist(@Role)}	Дозволити або заборонити використання тегу лише цим ролям чи каналам
{embed(title):Hi}{embed(description):...}	Зібрати насичений ембед (заголовок, опис, колір, зображення, мініатюра, футер, поле)
{silent}	Виконати побічні дії тегу, не надсилаючи тексту

Розібрані приклади

Скринька пропозицій — видаляє команду й публікує охайний ембед у каналі:

{delete}{redirect:#suggestions}{embed(title):💡 Suggestion from {user(name)}}{embed(description):{args}}{embed(color):#a855f7}

Підкидання монети з реакціями:

{user(mention)} flips… **{random:Heads~Tails}**! {react:🪙}

Оголошення лише для персоналу — доступ за роллю, нікому не пише в особисті, публікує в канал:

{require(@Staff):You can't use this.}{redirect:#announcements}📢 {args}

Персоналізоване привітання зі згадкою учасника:

{=(msg):Welcome {target(mention)} — you're member #{server(member_count)}!}{if({args}==):Mention someone to welcome them.|{msg}}

Усе, що можна зробити в тегу, можна також зібрати візуально за допомогою Шаблонів повідомлень та Автовідповідачів у панелі керування.