first commit

03-bot-commands.md

@@ -0,0 +1,156 @@
+# 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` — управление доступностью/блоклистом.