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

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
Публикувай или опресни менютата си с роли, или ги преобразувай всички между бутони / падащо меню / емоджи реакции.
/embed post|list|copy|color|edit|source
Всички инструменти за ембеди в една команда — публикувай или изброй запазени ембеди, копирай публикувани ембеди между канали или категории, преоцвети всеки ембед, публикуван от бота, редактирай някой от суров JSON или вземи ембедите + съдържанието на съобщение като JSON.
/log list
Виж маршрутите за логване на събития — самото логване се настройва от таблото.
/stealemoji <emoji> [name]
Добави персонализирано емоджи от друг сървър в този. Страницата Емоджита в таблото управлява целия ти набор — качване, преименуване, премахване, вземане и преглед на заетите слотове.

Автоматизациите (табло → Utilities → Automations) са правила от типа „когато се случи това, направи онова“: избери тригер (публикувано съобщение, добавена реакция, присъединил се член, добавена или премахната роля), добави незадължителни условия (канал, роля, ключови думи, възраст на акаунта) и след това изпълни до 10 действия по ред — изпрати съобщение, ембед или лично съобщение, добави или премахни роля, реагирай, изтрий съобщението или започни нишка. Тръгни от готови шаблони като Welcomer, Keyword auto-reply и Auto-thread — до 50 на сървър, безплатно.

Auto Send (табло → Utilities → 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
Приключи предсрочно, изтегли нови печеливши, отмени или изтрий, или виж списък със скорошните раздавания.

Редакторът Раздавания в таблото отива по-далеч — планирай или повтаряй раздавания, задай изисквания за участие и бонус участия, раздавай роли на победителите, персонализирай ембеда и запазвай шаблони.

Тикети

Създавай панели за тикети от таблото (модул „Тикети“). Членовете отварят тикет от бутона на панела; екипът го поема и затваря. При затваряне се запазва и публикува транскрипт, с линк Виж транскрипта онлайн за четене в браузъра.

/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

Временните гласови канали (табло → Utilities → Voice) работят на принципа влез-за-да-създадеш: избери един или повече основни гласови канала и всеки член, който влезе в такъв, получава собствен канал до него — изтрива се автоматично, щом се изпразни.

Само за оператора: /nuke channels, /nuke category и /restart са команди за поддръжка, заключени в кода за оператора на бота — екипът на сървъра не може да ги изпълнява.

Известия

Получавай известия, когато създател публикува. От таблото (Socials) добави емисии за YouTube, Twitch, Kick, TikTok, Reddit (новите публикации в даден сабредит), Podcast (нови епизоди от RSS емисията на предаване) или всякакъв Custom RSS адрес — Octera публикува новите качвания, публикации, епизоди и стартирали излъчвания в избрания от теб канал, със собствено съобщение.

Музика

Пускай музика в гласов канал с чиста опашка — без допълнителен бот за каним. (Premium.)

Търси песен по име или постави връзка — SoundCloud, Bandcamp, подкаст, интернет радиостанция или директен аудио URL. Octera чете повечето аудио сайтове и ти казва откъде идва песента.

YouTube не е наличен. YouTube блокира заявките за възпроизвеждане, идващи от хостинг доставчици, а именно там работи всеки Discord бот — затова връзките към YouTube се отхвърлят, вместо да се пускат. Търсенето по име продължава да работи и пуска от източниците по-горе. Връзките към Spotify и Apple Music не могат да бъдат пускани от нито един бот, защото аудиото им е криптирано; вместо това изпрати името на песента.

/play <song or link>
Пусни песен или я добави в опашката. Приема търсене или връзка от всеки сайт, който Octera наистина може да пусне.
/skip · /stop
Пропусни текущата песен или спри и напусни гласовия канал.
/music join|controls|queue|nowplaying|loop|pause|resume
Всичко останало в една команда — вкарай бота в гласов канал, отвори панела с бутони, виж опашката и текущата песен, зацикли песента или опашката, паузирай или продължи. (Старите навици с префикс като .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}Профилната му снимка — сложи това в поле за картинка или thumbnail
{user.color}Цветът на името му, напр. #a93bf0
{user.top_role}Името на най-високата му роля
{user.joinstamp}Кога се е присъединил, като число за времева отметка
{user.timestamp}Кога е създаден акаунтът му, като число за времева отметка

{target} работи по същия начин за първия човек, @споменат в команда (а ако няма такъв — за този, който я е изпълнил) — удобно в таговете: {target.mention}, {target.avatar}.

Сървърът & каналът

ПроменливаПопълва се с
{server}Име на сървъра
{server.members}Брой членове
{server.ordinal}Броят членове като място — „42-ри“
{server.icon}Иконата на сървъра — може да се ползва в поле за картинка или thumbnail
{server.id}ID на сървъра
{server.description}Описанието на сървъра
{channel}Име на канала
{channel.mention}Кликаем линк към #канал

Картинки от променливи

Полетата за изображение, миниатюра, икона на автора и икона на долния колонтитул приемат променлива вместо линк — така приветственият embed може да покаже собствения аватар на новия член:

Сложи {avatar} в полето thumbnail на приветствен ембед и всеки новодошъл вижда собствената си снимка в ъгъла. {server.icon} работи по същия начин.

Всяко от тези полета приема и обикновен https:// линк, или Качване… направо от компютъра ти — Octera съхранява изображението и използва постоянен линк, така че то продължава да работи завинаги.

Полезно да знаеш

Управление на сървъра: особености на Discord, които си струва да знаеш

Няколко неща в Discord се държат по начин, който изглежда счупен, а не е — рано или късно объркват почти всеки собственик на сървър. Нито едно от тях не се причинява от Octera; поправките са в собствените настройки на Discord.

Потребителско име се показва в грешен цвят

Discord оцветява името с най-високата роля, която има цвят. Роля, зададена на Default (без цвят), се пропуска по замисъл, така че безцветна роля, която държиш най-отгоре — обикновено за да се показваш отделно в списъка с членове — трябва да остави цвета на по-долна роля.

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

Накарай Discord да прочете ролята наново:

  1. Отвори Настройки на сървъра → Роли, избери засегнатата роля и иди на Показване.
  2. Задай я на Плътен, избери какъвто и да е видим цвят и запази.
  3. Отвори отново същата роля, върни я на По подразбиране (без цвят) и запази пак.
  4. Натисни Ctrl + R, за да презаредиш Discord.

Ролята вече се отчита като наистина безцветна: остава най-отгоре и продължава да показва членовете отделно, а цветът на името се поема от следващата роля надолу, която има цвят.

Короната на собственика изчезна до името ти

Короната изчезва, когато една от ролите ти има и двете включени едновременно:

За да запазиш собствената си роля изведена и да върнеш короната:

  1. Отвори Настройки на сървъра → Роли и избери своята изведена лична роля.
  2. Изключи Администратор за тази роля — остави Показвай членовете на ролята отделно включено.
  3. Натисни Ctrl + R, за да презаредиш Discord.
Не губиш нищо: собственикът на сървър вече има всяко право, така че лична роля никога не се нуждае от Администратор. За екипа си направи отделна роля Admin, която има включен Администратор и изключено Показвай членовете на ролята отделно.

Ръководство: създаване на команди с тагове

Таговете са персонализирани префикс команди, които сам си пишеш, задвижвани от TagScript — мъничък шаблонен език с променливи, логика, математика, случайност и контролни блокове (изтрий задействащото съобщение, изпрати отговора в ЛС, реагирай, ограничи по роля, прикачи ембед и още). Тук работи и всяка променлива в съобщенията.

Създай таг

Използвай /tag (или таблото → Инструменти → Тагове). Дай му име и съдържание. Членовете го изпълняват с твоя префикс, напр. .rules.

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

Изпълняване на .hello → Хей @Ти, добре дошъл в 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}Изпрати отговора в ЛС на този, който я е изпълнил
{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}}
Всичко, което можеш да направиш в таг, можеш да изградиш и визуално с Шаблони за съобщения и Автоотговори в таблото.