## 🗂 Содержание

| Раздел | Что внутри |
|---|---|
| [⭐ Уровни доступа](#-уровни-доступа) | Роли бота и что они могут |
| [🔥 Основное](#-основное) | Профиль, ник, сервер, помощь |
| [💎 Экономика](#-экономика) | Баланс, переводы, вывод, чеки, рефералы |
| [🛒 Магазин и торговля](#-магазин-и-торговля) | Торговец, лоты, заказы |
| [🏰 Государства](#-государства) | Создание, налоги, казна, дипломатия |
| [🎮 Мини-игры](#-мини-игры) | Казино, Крокодил, Города, Шахта |
| [📊 Статистика](#-статистика) | Топы, активность, казна |
| [📝 Заметки](#-заметки) | Личные заметки |
| [🎲 Развлечения](#-развлечения) | QR, среднее, MiniMessage, картинки |
| [🛡 Модерация](#-модерация) | Ники, ЧС, whitelist, RCON |
| [📣 Подписки](#-подписки) | Рассылки |

---

## ⭐ Уровни доступа

| Уровень | Роль |
|:---:|:---|:---|
| `-1` | 🚫 Заблокированный |
| `0` | 👤 Игрок |
| `1` | ⭐ Вип |
| `2` | 🔰 Мл. модер |
| `3` | 🛡 Модер |
| `4` | 🏅 Админ |
| `5` | 👑 Создатель |

Если роли не хватает, бот ответит:
`⭐️ : Для использования этой команды необходим доступ <N> - <Название>`.

---

## 🔥 Основное

### 👤 Информация о себе

#### `/profile`
Полная карточка игрока: Minecraft-ник, баланс, роль, государство, время в игре и сообщения за день/неделю/месяц/всё время.  
Алиасы: `/профиль`, `/обо мне`, `/я`, `/i`, `/myprofile`

#### `/profile @юзер`
Профиль **другого** человека. Принимает `@юзернейм`, `@id` или Minecraft-ник.
Можно ответить командой на любое сообщение — покажется профиль автора.  
Алиас: `/профиль @юзер`

#### `/nick`
Показывает привязанный Minecraft-ник.  
Алиасы: `/ник`, `/ник @юзер`, `/ник` (ответом на сообщение)

### 🔗 Привязка ника

#### `/привязать <ник>`
Привязывает Minecraft-ник к Telegram-аккаунту. Зачисляет бонус аметистов, добавляет в whitelist и автоматически одобряет заявку в чат.  
Алиасы: `/linknick <ник>`, `/новый ник <ник>`, `/линкник <ник>`, `привязать <ник>`

### 🌐 Сервер

#### `/ip`
Адрес сервера (два домена + Bedrock-порт `19132`).  
Алиасы: `/хост`, `/host`, `/айпи`

#### `/online`
Список игроков онлайн (через RCON `list`).  
Алиасы: `/онлайн`, `онлайн`, `online`

#### `/map`
Ссылка на интерактивную онлайн-карту сервера.  
Алиасы: `/мап`, `/карта`

#### `/серв`
Системная информация о хосте бота (CPU, RAM, нагрузка).  
Алиасы: `/сервер`, `/server`

#### `/time`
Текущее московское время.  
Алиасы: `/время`, `/мск`, `/msk`

### 🤖 Прочее

#### `/help`
Ссылка на вики с командами.  
Алиасы: `/помощь`, `/команды`, `/commands`, `команды`, `бот помощь`

#### `/start`
Приветственное сообщение. С параметром `nick_<ник>` запускает привязку, с числом — активация реферала.  
Алиас: `/старт`

#### `/пинг`
Задержка ответа бота. С аргументом `all` — ещё минимальный, средний и максимальный пинг игроков на сервере.  
Алиасы: `/ping`, `пинг`

#### `/vote`
Ссылки на мониторинги для голосования и буста.  
Алиасы: `/голос`, `/голосование`, `/проголосовать`

#### `/rules`
Ссылка на правила сервера.  
Алиасы: `/правила`, `/правилачата`, `/правила сервера`, `правила`

#### `/игрок <ник>`
Ищет Telegram-профиль, роль и государство по Minecraft-нику.  
Алиасы: `/нпоиск <ник>`, `/пник <ник>`, `/поискпонику <ник>`, `игрок <ник>`

---

## 💎 Экономика

### 💰 Баланс

#### `/баланс`
Показывает ваш баланс.  
Алиасы: `/аметисты`, `/wallet`, `/мой баланс`, `баланс`

### ↔️ Переводы

#### `/скинуть <сумма> <@юзер>`
Переводит аметисты другому игроку. Вместо суммы можно написать `все`.
Получателя можно указать тегом или ответом на его сообщение.  
Алиасы: `/кинуть`, `/дать`, `/перевести`, `перевести`

### 🏧 Вывод в игру

#### `/вывести <сумма>`
Выводит аметисты на игровой сервер командой `invgive amethyst_shard`. Действует дневной лимит.  
Алиасы: `/вывод`, `/вмайн`, `/в майн`, `/вмаин`, `/в маин`, `вывести`

### 🎟 Чеки

#### `+чек <сумма>`
Создаёт чек на N аметистов (списывает их с баланса). **Только в личных сообщениях.**  
Алиас: `+ticket <сумма>`

#### `/чек <id>`
Активирует чек по его ID и зачисляет аметисты.  
Алиасы: `/ticket`, `/активировать`, `активировать`, `/activate`

### 🎁 Рефералы

#### `/рефка`
Ваш реферальный код и ссылка `t.me/luminto_chatbot?start=<id>`, а также список приглашённых.  
Алиасы: `/рефкод`, `/моярефка`, `/мойрефкод`, `/реферальныйкод`, `/реферальный код`, `/refcode`, `/reflink`, `/рефссылка`

#### `/топреф`
Топ пригласивших (до 10 мест).  
Алиасы: `/топрефералов`, `/топрефералы`, `/топ рефералы`, `/топ реф`, `/топ рефералов`, `/рефералы топ`

---

## 🛒 Магазин и торговля

#### `/shop`
Витрина Странствующего торговца: 5 товаров, обновляются по таймеру.  
Алиасы: `/шоп`, `/магазин`, `магазин`, `shop`, `шоп`

#### `+товар <предмет>`
Выставляет предмет на продажу (диалог в ЛС: количество и цена), затем публикует лот в торговый топик.

#### `+заказ <предмет>`
Публикует предложение «У меня есть этот предмет, могу продать» — для тех, кто ищет покупателя.

#### `/logshop <ник>` 🔰 *мин. роль: 2*
История покупок игрока с пагинацией.  
Алиасы: `/логшоп`, `/покупки`

#### `/logshopstats` 🔰 *мин. роль: 2*
Сводная статистика по логам магазина.  
Алиас: `/статистикапокупок`

---

## 🏰 Государства

!!!info
Команды с префиксом `/г` — сокращение от `/государство`.
!!!

### 📜 Обзор

#### `/states`
Список всех государств с числом жителей.  
Алиасы: `/госва`, `/государства`, `государства`, `список госв`

#### `/госво <название>`
Подробная карточка государства: тип, казна, глава, заместитель, координаты, налоги, описание и состав (до 50 человек). Если прикреплена картинка государства — придёт с ней.  
Алиасы: `/state`, `/государство`; без аргумента — ваше государство

### 🏗 Создание и вступление

#### `/создать госво <название>`
Создаёт государство (цена зависит от настроек). Требуется подтверждение.  
Алиасы: `+госво <название>`, `+государство <название>`

#### `/вступить <название>`
Вступает в государство. Если вход платный — нужно его оплатить.  
Алиасы: `вступить`, `/г вступить`, `/г войти`

#### `/ливнуть`
Покидает государство. Если вы глава — главенство перейдёт заместителю (нужен назначенный зам).  
Алиасы: `/покинуть госво`, `/покинуть государство`, `выйти из государства`, `выйти из госва`, `/г покинуть`, `/г выйти`

#### `/уничтожить госво`
Распускает государство. Доступно только главе, требует подтверждения. Казна возвращается главе.  
Алиасы: `/удалить госво`, `/удалить государство`, `уничтожить государство`, `удалить государство`, `/г уничтожить`, `/г удалить`

### ⚙️ Управление

#### `/г описание <текст>`
Меняет описание (до 300 символов).  
Алиасы: `/о госве`, `/г о госве`

#### `/г корды <x> <y> <z>`
Задаёт координаты государства.  
Алиас: `/г координаты`

#### `/г входы <режим>`
Настройка входа: `да` — свободный, `нет` — закрытый, число — платный вход.  
Алиас: `/г вступления`

#### `/г название <новое>`
Переименовывает государство (платно). Требуется подтверждение.  
Алиасы: `/г нейм`, `/г name`, `/г переназвать`, `/название госва`

#### `/г pic`
Устанавливает картинку государства: прикрепите фото к команде.  
Алиасы: `/г картинка`, `/г фото`

#### `/г кик <@юзер>`
Исключает игрока из государства. Цель можно указать тегом или ответом на сообщение.  
Алиасы: `/г кикнуть`, `/г изгнать`, `/г выгнать`, `/выгнать`

#### `/назначить зама <@юзер>`
Назначает заместителя главы из числа жителей.  
Алиасы: `/г назначить зама`, `/назначить заместителя`, `/г назначить заместителя`

#### `/убрать зама <@юзер>`
Снимает заместителя.  
Алиасы: `/г убрать зама`, `/убрать заместителя`, `/г убрать заместителя`

#### `/г передать <@юзер>`
Передаёт главенство другому игроку. Требуется подтверждение.

### 💸 Казна и налоги

#### `/пополнить казну <сумма>`
Пополняет казну. Можно указать `все`, чтобы внести весь баланс.  
Алиасы: `/г пополнить`, `+казна`, `г пополнить`

#### `/забрать из казны <сумма>`
Снимает деньги из казны (только глава/зам). Можно указать `все`.  
Алиасы: `/г снять`, `-казна`, `г снять`

#### `/г налог <сумма>`
Устанавливает налог на жителя. `0` — отключает налог.

#### `/г собратьналог`
Вручную собирает налог с жителей.  
Алиасы: `/г собратьналоги`, `/госво собратьналоги`, `/госво собратьналог`, `/collecttax`

#### `/г периодналогов <дни>`
Задаёт период сбора налогов (по умолчанию 7 дней).

#### `/г неуплата <режим>`
Что делать с неплательщиками: `ничего` или `кик`.

### 🌍 Дипломатия

#### `/г конгресс`
Подаёт заявку на международное признание.  
Алиас: `/г заявка`

#### `/г признать <название>`
Голосует за признание другого государства (голосует только глава).

#### `/г статус <название>`
Статус признания: голоса, казна, титул, список проголосовавших.

#### `/г запретить въезд <@юзер>`
Банит игрока на вход в государство (также исключает его из состава).

#### `/г разрешить въезд <@юзер>`
Снимает запрет на въезд.

#### `/г банлист`
Список игроков, которым запрещён въезд.

---

## 🎮 Мини-игры

!!!info
Мини-игры работают только в **игровом топике** чата сервера.
!!!

### 🎰 Казино

#### `/казино`
Запускает автомат «🎰» за фиксированную цену. Три одинаковых — крупный выигрыш, два — возврат ставки.  
Алиас: `/casino`

### 🐊 Крокодил

#### `/крокодил`
Запускает игру «Крокодил»: игроки угадывают слово по подсказкам.  
Алиасы: `/crocodile`, `старт крокодил`

#### `/ставка <сумма>`
Ставка на следующую победу в «Крокодиле». Без аргумента — минимальная ставка.  
Алиас: `/крокоставка`

#### `/подсказка`
Предлагает подсказку к текущему слову (отправляется на модерацию).

### 🏙 Города

#### `/города`
Запускает игру «Города». Нужно минимум 2 игрока; вход платный.  
Алиасы: `/города старт`, `/cities start`, `/миниигра города`, `/minigame cities`, `/cities`

#### `+город <название>`
Предлагает новый город для базы игры (одобряет администратор).

#### `+города <список>`
Массовая отправка городов на проверку (через пробел или с новой строки).

#### `-город <название>` 🏅 *мин. роль: 4*
Удаляет город из базы.

### ⛏ Шахта

#### `/шахта`
Спуск в шахту: серия кнопок «Продолжить / Уйти». Каждый шаг — шанс найти аметисты, получить бонус или погибнуть. Нужно состоять в государстве.  
Алиасы: `/майнить`, `/копать`, `/mine`, `/г шахта`

---

## 📊 Статистика

#### `/топ соо [дни]`
Топ самых активных в чате. Если указать период ≥7 дней или `весь` — придёт график.  
Алиасы: `/топ сообщений`, `/топ в чате`, `/актив сервера`, `/мчат`, `/мстат`

#### `/топ игроков [N]`
Топ по времени в игре на сервере (от 3 до 30 мест).  
Алиасы: `/топигроков`, `/topplayers`, `/playtimetop`, `/bestplayers`, `/toppt`

#### `/топ шахтёров`
Топ добычи аметистов в шахте.  
Алиасы: `/топ шахтеров`, `/топ шахта`, `/topmine`, `/minetop`, `/bestminers`

#### `/топ крокодил`
Топ побед в «Крокодиле».  
Алиасы: `/топ слова`, `/стат крокодил`, `/стат слова`, `топ крокодила`

#### `/банк`
Сколько аметистов всего в обороте (сумма всех балансов).

#### `/toptreasury`
Топ государств по казне.  
Алиасы: `/топказна`, `/топ казна`, `/казна топ`, `/казтоп`, `/ктоп`, `казна топ`, `казтоп`

---

## 📝 Заметки

!!!info
Заметки создаются в личку боту и доступны через точку: `.имя`
!!!

#### `+note <имя>` ⭐ *мин. роль: 1*
Создаёт заметку. Первая строка — имя, следующие строки — текст.  
Алиас: `+нот`

#### `.имя`
Выводит заметку. Работает и ответом на сообщение.

#### `/notes`
Список всех заметок (нумерованный).  
Алиас: `/ноты`

#### `/моиноты` ⭐ *мин. роль: 1*
Только ваши заметки.  
Алиас: `/mynotes`

#### `-нот <имя>` ⭐ *мин. роль: 1*
Удаляет заметку. Чужие может удалять только админ.  
Алиасы: `-note`, `-text`

---

## 🎲 Развлечения

#### `/qr <данные>`
Генерирует PNG с QR-кодом (до 1000 символов).

#### `/qr`
Справка по команде `/qr`.

#### `/среднее <числа>`
Считает среднее арифметическое. Через пробел, можно с запятой.

#### `/minimessage <текст>`
Рендерит MiniMessage-разметку в PNG-картинку.

#### `/картинка`
Случайная картинка из коллекции (с антифлудом).  
Алиасы: `/randompic`, `/рандомпик`

#### `/сайт <домен>`
Проверяет доступность домена с разных нод.

#### `/ai <вопрос>` ⭐ *мин. роль: 1*
Вопрос нейросети «Люме». Работает только в основном чате.  
Алиас: `/ии`

---

## 🛡 Модерация

### 👑 Управление ролями

#### `+staff <@юзер>` 👑 *роль: 5*
Повышает роль игрока на +1.  
Алиас: `+стафф`

#### `-staff <@юзер>` 👑 *роль: 5*
Понижает роль на −1.  
Алиас: `-стафф`

### 🔨 Чёрный список бота

#### `/чсб <@юзер> <причина>` 🏅 *роль: 4*
Блокирует пользователя в боте. Можно ответом на сообщение + причина.

#### `-чсб <@юзер>` 🏅 *роль: 4*
Снимает блокировку.

### 🎫 Ники

#### `/сменитьник <ник> <@юзер>` 🏅 *роль: 4*
Меняет привязанный Minecraft-ник игроку.

#### `/непривязанные` 🔰 *мин. роль: 2*
Нумерованный список участников чата без привязанного Minecraft-ника. Длинный список разбивается на несколько сообщений.

### 📜 Whitelist

#### `+wl <ник>` ⭐ *мин. роль: 1*
Добавляет ник в whitelist сервера.

#### `-wl <ник>` ⭐ *мин. роль: 1*
Удаляет ник из whitelist.  
Алиас: `-вт`

### 💎 Аметисты

#### `/выдать <сумма> <@юзер>` 🏅 *роль: 4*
Выдаёт аметисты игроку.

#### `/изменить баланс <сумма> <@юзер>` 🏅 *роль: 4*
Начисляет (или списывает) аметисты, показывая старый и новый баланс.  
Алиас: `/change balance`

### ⚙️ Служебные

#### `//<команда>` 🏅 *роль: 4*
Выполняет любую команду на сервере через RCON. Ответ приходит в блоке кода.  
Пример: `//list`

#### `+pic` 🏅 *роль: 4*
Сохраняет картинку из сообщения или ответа в коллекцию бота.

#### `/gethint` 🏅 *роль: 4, только в ЛС*
Показывает последнюю подсказку к слову «Крокодила», ожидающую модерации.

#### `/newhint` (в ЛС)
Предложить подсказку к слову (уходит админам на модерацию).  
Алиас: `/addhint`

---

## 📣 Подписки

#### `+обновление <текст>` 🏅 *роль: 4*
Рассылка текста всем подписчикам с индикатором прогресса.

#### `+обновления`
Подписаться на рассылку обновлений.

#### `/отписаться`
Отписаться от рассылки.

---

## ℹ️ Замечания

- **Топики.** Мини-игры (`/казино`, `/крокодил`, `/города`, `/шахта`) требуют, чтобы сообщение было в игровом топике — иначе бот попросит перейти туда.
- **Личные сообщения.** `+чек`, `+note`, `/newhint` и диалоги торговли работают только в ЛС.
- **Привязка обязательна** для большинства игровых функций. Без ника бот попросит сначала выполнить `/привязать <ник>`.
- **Ответ на сообщение** работает как указание получателя во многих командах: `/ник`, `/г кик`, `/г передать`, `/назначить зама`, `/чсб`, `/скинуть`.
