cm-over/03-bot-commands.md

Bot Commands

Ниже команды по модулям. Описания — на уровне назначения, без внутренней логики.

Общая регистрация команд

Команды подключаются в internal/bootstrap/bot_commands.go.

Основные командные модули:

1. chatmanager
2. addons
3. utils
4. games
5. query (minecraft)
6. whois
7. screen

1) Addons module

Команды:

1. /addon (управление аддоном, подкоманды)
2. /addons (список аддонов чата)

Подкоманды /addon:

1. role — смена роли/приоритета доступа к аддону.
2. prefix — префикс вызова аддонов.
3. sandbox — статус/вкл/выкл/движок sandbox.
4. install — установка аддона из каталога.
5. enable|disable — вкл/выкл аддон.
6. delete — удалить аддон.
7. <name> <code> — создание аддона.

Отдельно:

1. unknown command handler перехватывает префиксные вызовы аддонов.

2) Chatmanager module

2.1 Moderation

1. kick, multikick, kickbots, kickdogs
2. kickafter, kickfrom, kickmessages
3. inactive, kickinactive, kickleft
4. ban, multiban, everban, multieverban, unban
5. mute, unmute
6. warn, unwarn, warnlist, banlist
7. selfban

2.2 Roles

1. role, promote, demote
2. joinrole
3. hierarchy, tree, staff, roles
4. createrole, deleterole, rolerename, roleemoji
5. fixed helpers: membercmd, helpercmd, modcmd, hmodcmd, admincmd, clearcmd, unrole

2.3 Access / Permissions

1. immunity, unimmunity, immunities
2. perm, perms

2.4 Settings

1. prefix, timezone
2. quieterrors, quieterrorsru
3. language, chatlang
4. autounban
5. warnlimit, limitwarns
6. warntime, warnlifetime
7. kickrole, inviterole, titlerole, pinrole, adminrole
8. kickmenu, inactivejoin, autodelete
9. statstype, catalog, news, whitelist, chattype

2.5 Service / Runtime / Help

1. logs, chathelp
2. resync
3. rules, setrules
4. motd, setmotd
5. online, offline, status, chatinfo
6. announce
7. notification toggles: notifybans, notifyunbans, notifywarns, notifyprevents, notifyevents, togglegroup, subscription
8. backlog, actions, captcha, write, cleanup

2.6 Automation

1. Limits: limits, limit, removelimit
2. Timers: timers, timer, remtask
3. Events/Prevents: events, addevent, redevent, remrule, preevents, prevent, remprevent

2.7 Stats & Templates

1. chatstats, stata, topstats, statlist
2. setwarn, setmute

2.8 Anywhere commands (доступ вне чата)

1. helpanywhere / helpme
2. mychats, rating
3. hidekeyboard
4. report
5. bind, tochat
6. donotnotify, nomention

2.9 Callback commands

1. callback
2. callbacktest
3. callbacksecret

3) Utils module

1. color / colour
2. gradient / grad
3. currency / rates / convert
4. datereg / regdate
5. ip / hostip / dns
6. ping / latency
7. password / pass / pwd
8. phar / zip / convertation / pluginconvert

Примечание:

1. команда jar есть в коде как отключенный блок.

4) Games module

1. balance / coins / wallet
2. bonus / reward
3. coin / coinflip
4. transfer / pay

5) Query module (Minecraft)

1. mcpe / mcbe / bedrock
2. java / mcjava / mcpc
3. query / q (обертка-подсказка)

Поддерживаются callback-кнопки refresh для обновления статуса.

6) Whois module

1. whois
2. aliases: ip, ipinfo

Возвращает сводку по IP/домену через whois/rdap-клиент.

7) Screen module

1. screen / screenshot / shot
2. admin: screen_admin / screenctl

screen — скриншот URL; screen_admin — управление доступностью/блоклистом.