Дискорд Боты

## Введение

Это Дискорд-боты, которые используются на сервере. Некоторые из них сделаны конкретно для администраторов, иные же могут использоваться игроками.

## Activities

    Позволяет использовать активности в голосом канале. Доступные команды:

* +help ‣ Показать все доступные команды.
* +youtube ‣ Запустить YouTube Together в голосовом канале.
* +game ‣ Запустить Мини-Игры в голосовом канале. Доступные игры: *Покер; Шахматы; Betrayal; Fishington*

## Captcha.bot

Служит для защиты дискорд сервера от дудосов твинками. Проверка капчей осуществляется на сайте. *Рекомендуется использование на пк. Жителям РФ и РБ рекомендуется включить VPN. В случае ошибки с верификации писать @𝔇𝔬𝔬𝔪𝔢𝔯#0001.*

## Carl-Bot

Выполняет административную функцию, когда необходимо запустить голосование на сервере. Доступная команда для участников сервера:*/fun [стиль] текст.*

## FGMusic

Музыкальный бот для администрации сервера. *Недоступен для всех участников.*

## Lofi Radio

Музыкальный радио-бот, транслирующий музыку с ютуб-канала LofiGirl.

/play - запускает бота в голосовом канале

## GameStatus

Показывает сколько игроков играет в данный момент, в канале **статистика.**

Отображает статистику онлайна сервера за последние 24 часа, а также текущий онлайн и статус соединения.

## Member Counter

    Показывает сколько игроков в данный момент в описании канала **о-сервере.**

## ServerStats

Отображает количество участников дискорда в категории **SERVER STATS**.

## Репорт Бот

Позволяет участникам сервера создавать тикеты с репортами о нарушениях/неполадках на сервере в канале **репорты**. Также используется для создания заявок на участие в конкурсах строителей. Принцип работы: участник должен выбрать категорию репорта, заполнить необходимые поля соответствующей информацией, после чего создаётся отдельный канал для этого участника и его репорта.

## FGApi

Аутентификатор, связывающий аккаунты дискорда и майнкрафта. Служит для синхронизации привилегий и активации двухфакторной аутентификации при заходе на сервер майнкрафта. Для корректной работы в настройках аккаунта дискорда необходимо включить функцию **Настройки пользователя - Конфиденциальность - Разрешить личные сообщения от участников сервера**

### Привязка дискорда к майнкрафту

Для привязки аккаунта нужно на майнкрафт сервере Meltarion прописать /discord link и отправить цифры боту в дискорде FGApi#0587

Команда /discord sync синхронизирует роль в дискорде с привилегией в майнкрафте.

После привязки вы можете включить двухфакторную аутентификацию /discord 2fa. Двухфакторная аутентификация будет требоваться всегда когда логинитесь (вводите пароль).

## Juniper Bot

Основной бот на сервере, который выполняет функции автомодерации, музыкального плеера, помощника администратора, внедряет систему уровней и репутации. Все доступные команды можно просмотреть в меню **-хелп**.  Общедоступная страница рейтинга участников на сервере. Большинство немузыкальных команд этого бота доступны для использования только в канале **команды боту**

### Автомодерация

Осуществляет автомодерацию по таким категориям: ссылки, скам-ссылки, мат, спам, Caps Lock, спам эмодзи, спам упоминаниями, использование символов Zalgo.

При нарушении участнику выдаётся предупреждение. После 3-х предупреждений выдаётся мут на 15 минут. После 5-ти предупреждений - на 30 минут. Предупреждения автомодерации длятся от одного часа до одного дня. При муте участницу выдаётся роль **Нарушитель**, которая не позволяет ему писать, ставить реакции, присоединятся к голосовым каналам.

### Музыка

Команды музыкального плеера воспринимаются ботом только в канале **музыка.**

#### Доступные команды:

* -плей — Воспроизвести композицию в голосовом канале
* -ютуб — Найти что-либо на YouTube
* -скип — Пропустить текущую воспроизводимую композицию
* -очередь — Показать очередь воспроизведения
* -перемешать — Перемешать очередь воспроизведения
* -продвинуть — Продвинуть композицию как следующую в очереди
* -удалить — Удалить композицию из очереди воспроизведения
* -текущая — Показать текущую композицию
* -повтор — Установить режим повтора
* -пауза — Поставить воспроизведение на паузу
* -старт — Продолжить воспроизведение композиции после паузы
* -стоп — Остановить воспроизведение
* -громкость — Установить громкость воспроизведения
* -сюда — Переместиться в голосовой канал участника
* -сначала — Начать воспроизведение композиции с начала
* -назад — Перемотать воспроизведение назад
* -вперед — Перемотать воспроизведение вперёд
* -позиция — Перемотать воспроизведение на указанную позицию

#### Заикается/отключается музыка или радио. Что делать?

1. Высокая нагруженность музыкального сервера: Степень нагрузки отображается в панели воспроизведения в самом дискорде и на странице Статистики. Если нагрузка менее 80%, проблема не в этом.
2. Проблемы с соединением до голосового шлюза Discord или его высокая нагруженность: Между Вами и ботом есть узел, называемый голосовым шлюзом. У Discord их несколько и каждый привязан к выбранному в настройках голосового канала Региону. Проблемы могут быть как между шлюзом и ботом, так и между Вами и этим шлюзом. Пробуйте менять регион голосового канала и смотреть будут ли улучшения на каком-нибудь из них (полностью перезапуская при этом воспроизведение музыки).
3. Проблемы с соединением бота до источника музыки: По независимым от нас причинам имеют место быть проблемы с соединением до источника музыки (YouTube, Яндекс.Музыка, радиостанции) когда сам источник музыки тормозит или нестабильное соединение до него. Проблема может нести как временный, так и постоянный характер и преимущественно для радиостанций.

### Рейтинг участников

Ниже подробно рассказано о рейтинге участников и о том, как эта механика работает. Каналы **срач, AFK** и **Toxic** не дают никакого опыта.

#### *Текстовое общение*

Каждый раз, когда участник пишет что-нибудь в чат, он получает от 7 до 12 единиц опыта не более раза в минуту. Для ознакомления со своим прогрессом или прогрессом другого участника используется команда "-ранг".

#### *Голосовая связь*

Опыт за голосовую связь и время голосовой активности начисляются только активным участникам, которые: С включенным микрофоном (не замьючены); С включенным звуком (слышат других); Не боты. Опыт за голосовую связь за одну минуту общения в идеальных условиях рассчитывается по следующей формуле:

```
exp = 6 * count * multiplier
count — количество активных участников в голосовом канале;
multiplier — множитель опыта в настройках панели управления (100% = 1, 200% = 2 и т.д.).

```

В получении опыта за голосовую связь и времени голосовой активности следует учитывать два важных момента: Опыт и время начисляются активным участникам только если в голосовом канале как минимум два активных участника; Опыт является накопительным. Это значит, что за промежуток времени пока общаются три участника, они все получают тройной опыт. Когда один из них выходит, отключает микрофон или звук, то с этого момента оставшиеся два не теряют уже накопленный тройной опыт, а продолжают получать двойной (за двоих).

#### *Уровни*

Опыт для каждого уровня рассчитывается по следующей формуле:

```
exp = 5 * level² + 50 * level + 100

```

#### *Коробка печенек*

Система рейтинга также включает в себя функционал кармы или простой системы накопительной репутации, называемой "Коробка печенек". Это простой счетчик, повысить который можно несколькими способами:

```
🔹Написать сообщение с обращением к участнику и эмоцией печеньки, например: @Участник 🍪
🔹Добавить реакцию печеньки к сообщению этого пользователя.

```

Для предотвращения фарма выдача печеньки от участника к участнику работает только раз в 10 минут.

#### Лесная Возня

Лесная Возня — разновидность командной психологической ролевой игры «Мафия», участники которой — лесные жители. Рекомендуемое число участников 15-20. Участники делятся на две команды: Хищников и Травоядных.

##### Интерфейс

Хищники Волки — стая, по ночам съедающая по зверю. Съеденный выходит из игры. Лиса — живёт отдельно от Волков и не знакома с ними. Каждую ночь ворует запасы еды у какого-либо из лесных зверей (независимо от роли). Если зверь оказывается обворован дважды, еды на зиму у него не остаётся и он уходит жить в соседний лес, оставляя свою команду и игру. ‎ Травоядные Зайцы — самые миролюбивые зверушки. Круглую ночь спят сладким сном и участвуют только в дневных обсуждениях и в голосовании на изгнание. Крот — по ночам роет норки, время от времени попадая в домики к другим зверям, узнавая, к какой команде те относятся. Бобёр — по ночам при желании возвращает обворованному Лисой зверю часть запасов. Бобёр компенсирует весь причинённый зверю Лисой ущерб (не важно, один раз она его обворовывала или два). Если Лиса обворует домик Бобра, с Бобром ничего не случится, сколько бы раз это не произошло.

##### Порядок действий

Игра начинается с короткой ночи, где все узнают свои роли, волки знакомятся друг с другом. В первую ночь волки никого не едят, Лиса никого не обворовывает, Бобёр не делится запасами, а вот Крот уже может прорыть норку и проверить кого-то из зверей. Вскоре объявляется день, и просыпается весь Лес. Звери могут вести обсуждение и голосовать. Затем начинается ночь, когда ночные ходы могут совершать уже все ночные роли. Ночи и дни далее чередуются. Порядок ночных ходов: Волки – Лиса – Бобёр – Крот.

##### Дневное голосование

Днём, обсудив ночные происшествия и попытавшись кто запутать остальных, кто – всё понять, участники голосуют за изгнание из Леса того или иного участника. За чьё изгнание проголосует больше людей, тот и считается изгнанным из Леса. Если в голосовании ничья, то изгнания не состоится. Изгнанный участник выходит из игры, его роль раскрывается.

Когда в игре останутся участники лишь одной команды, команда объявляется победившей. ‎