> For the complete documentation index, see [llms.txt](https://wiki.umo-gta5rp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.umo-gta5rp.com/premium/points.md).

# Поинты

Хотите следить и поощрять активность участников вашего дискорд сервера на проекте GTA5RP? Этот модуль, который не имеет аналогов, специально для вас!

## Подготовка

Для начала нам необходимо создать канал с любым названием для логов и действиях с поинтами. Для этого используем `/опции канал_выбрать` с типом "Изменение канала с логами поинтов":

<figure><img src="/files/7MTRPVslPoVumemdg9gP" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Теперь все готово для начала использования!
{% endhint %}

## Использование

### Настройка модуля

Для настройки модуля "Поинты" используется команда `/модули поинты`:

<figure><img src="/files/YB0ZYB6Nu0vxGu779odF" alt=""><figcaption></figcaption></figure>

Открывается меню настроек:

<figure><img src="/files/HqADTCjI1PdP22hSbosE" alt=""><figcaption></figcaption></figure>

Подробное описание каждой из кнопок:

<table><thead><tr><th width="214">Кнопка</th><th width="381">Действие</th><th>По умолчанию</th></tr></thead><tbody><tr><td>Включить/Выключить списание поинтов</td><td>Позволяет включить или выключить списание поинтов. Каждые 10 минут у каждого пользователя, добавленного в модуль "Поинты" списывается 1 поинт.</td><td>Включено</td></tr><tr><td>Включить/Выключить уведомления пользователям в ЛС</td><td>Позволяет включить или выключить уведомления пользователям в ЛС. При включении пользователю, над которым проводят действие, будет приходить уведомление от бота в личные сообщения. Например о начислении поинтов, списании поинтов, добавлении в систему поинтов и прочего.</td><td>Включено</td></tr><tr><td>Действие при достижении минимума поинтов</td><td>Позволяет установить действие, которое произойдет в случае, если пользователь достигнет минимума поинтов. Это может быть "Кик с дискорда" или "Предупреждение". Предупреждение направляется в канал логи с упоминанием лидера и его заместителей.</td><td>Кик с дискорда</td></tr><tr><td>Изменить дневной коэффициент</td><td>Позволяет изменить дневной коэффициент начисления поинтов. Каждые 10 минут при нахождении в игре с 6:01 до 23:59 пользователю начисляются поинты по формуле: <code>коэффициент*8</code>. Результат начисляется пользователю при нахождении в игре. Чем выше коэффициент, тем меньше нужно находиться в игре в день. Чем меньше коэффициент, тем больше нужно играть в день. В настройках модуля внизу текстом указано сколько при таком значении дневного коэффициента нужно находиться в игре. ВАЖНО! Можно играть часть времени днем, часть ночью. Все коэффициенты будут учтены!</td><td>1</td></tr><tr><td>Изменить ночной коэффициент</td><td>Позволяет изменить ночной коэффициент начисления поинтов. Каждые 10 минут при нахождении в игре с 00:00 до 6:00 пользователю начисляются поинты по формуле: <code>коэффициент*8</code>. Результат начисляется пользователю при нахождении в игре ночью. Чем выше коэффициент, тем меньше нужно находиться в игре в ночью. Чем меньше коэффициент, тем больше нужно играть в ночью. В настройках модуля внизу текстом указано сколько при таком значении ночного коэффициента нужно находиться в игре. ВАЖНО! Можно играть часть времени днем, часть ночью. Все коэффициенты будут учтены!</td><td>1</td></tr><tr><td>Изменить минимальное количество поинтов</td><td>Позволяет изменить минимальное количество поинтов при котором будет поступать уведомление </td><td></td></tr></tbody></table>

{% hint style="info" %}
Таким образом, изменяя коэффициенты вы устанавливаете количество начисляемых поинтов за каждые 10 минут игры в дневное и ночное время. Пользователь например может поиграть 12 часов и потом несколько дней не заходить в игру. Или стабильно отыгрывать определенное количество времени.
{% endhint %}

### Добавление пользователей в систему поинтов

{% hint style="warning" %}
Поинты списываются и начисляются только пользователям, которых вы сами внесете в систему командой `/поинты добавить`

Добавлять пользователей могут пользователи с правами Администратора, лидер, заместитель лидера, старший состав и рекрутеры.
{% endhint %}

Для добавления пользователей в систему поинтов используем команду: `/поинты добавить`:

<figure><img src="/files/cu5veGTZtMP9jFwBM7CJ" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/5zXBjNVjVPFkeZbigtKl" alt=""><figcaption></figcaption></figure>

Если у вас включена опция "Уведомления пользователям в ЛС", то в личные сообщения пользователю поступит такое сообщение:

<figure><img src="/files/Kxg4tBvAzxQKlkGNuTGx" alt=""><figcaption></figcaption></figure>

Для отслеживания игровой активности ему необходимо включить игровой оверлей по инструкции. Также важно, чтобы во время игры у него не стояла "Невидимка", иначе поинты начисляться не будут.

### Включение игрового оверлея <a href="#activity" id="activity"></a>

{% hint style="info" %}
Для начисления поинтов у пользователя должна быть включена игровая активность в настройках дискорда.
{% endhint %}

Сначала перейдите в настройки слева снизу:

<figure><img src="/files/W9kPYTWZ0lXVJyWUvgMr" alt=""><figcaption></figcaption></figure>

Листайте вниз и найдите раздел "Настройки активности". В нем нажимайте на "Конфиденциальность активности":

<figure><img src="/files/yWb7GkYa2RYMQIzl9Lag" alt=""><figcaption></figcaption></figure>

Установите галочку на пункте "Делитесь своими игровыми активностями с другими":

<figure><img src="/files/z82PMuUmUOicBXIsNykt" alt=""><figcaption></figcaption></figure>

Теперь перейдем в раздел ниже: "Зарегистрированные игры". Тут рядом с RAGE Multiplayer сделайте иконку монитора видимой:

<figure><img src="/files/4xhIQrNSPYvsai5uEOf7" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Теперь вам будут начисляться поинты за каждые 10 минут игры на серверах проекта GTA5RP!
{% endhint %}

### Действия с поинтами вручную

{% hint style="info" %}
Вы можете самостоятельно начислять и списывать поинты у участников, добавленных в систему.\
Например за круто сыгранную игру можно начислить 400 поинтов участнику.\
Или за нарушение правил семьи списать поинты.
{% endhint %}

{% hint style="warning" %}
Начислить и списать поинты может только пользователь с правами Администратора и лидер.
{% endhint %}

Для начисления поинтов используется команда `/поинты начислить`:

<figure><img src="/files/HGtHlnTiiYthd3fac5e4" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/3DpHNtAr3PralQ0SmqkH" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
Перед списанием поинтов рекомендуем проверить текущее количество поинтов у человека.\
В случае, если после списания количество поинтов у человека достигнет минимального значения, он может быть кикнут или предупрежден в зависимости от настроек.\
Возможно вы не хотите его терять и не будете списывать поинты.
{% endhint %}

Для получения информации о пользователе в системе поинтов используется команда `/поинты информация`:

<figure><img src="/files/58pKxIRUZzeJ2SNtKScC" alt=""><figcaption></figcaption></figure>

Здесь необходимо выбрать одно из трех значений, по которым будет выполнен поиск пользователя!

<figure><img src="/files/g28vlK4whSif0xn9hemo" alt=""><figcaption><p>Пример использования команды /поинты информация</p></figcaption></figure>

### Система отпуска

Представим ситуацию. У пользователя сломался компьютер или он отправился в другой город. Он не имеет возможности заходить в игру. Вы можете выдать такому пользователю отпуск и на определенный срок у него не будут списываться поинты за иннактив.

Для выдачи отпуска используется команда `/поинты выдать_отпуск`:

<figure><img src="/files/4ZcUaCzKCMeGuJjnXUD9" alt=""><figcaption></figcaption></figure>

В поле "дата" необходимо вписать дату окончания отпуска в формате день.месяц.год. Нельзя использовать дату, которая уже прошла или наступила. Время окончания отпуска будет в указанную дату в 00:00 по Московскому времени.

<figure><img src="/files/vNzPXCeUkxtsHKZllFrg" alt=""><figcaption></figcaption></figure>

В личные сообщения поступит такое сообщение:

<figure><img src="/files/AGmX1RhtXliywD9XaA8N" alt=""><figcaption></figcaption></figure>

Вы можете ознакомиться с полным списком пользователей, которые сейчас в отпуске. Для этого используйте команду `/поинты список_отпуск`:

<figure><img src="/files/SA43VRzaDUL0e0oEdwvm" alt=""><figcaption></figcaption></figure>

Здесь содержится подробная информация о каждом пользователе и дата окончания отпуска:

<figure><img src="/files/CFkiGOmFQ74bERaPd1Cv" alt=""><figcaption></figcaption></figure>

Отпуск можно завершить вручную. Для этого используйте команду `/поинты снять_отпуск`:

<figure><img src="/files/htRBejea3aenSNqsiSaI" alt=""><figcaption></figcaption></figure>

Пользователю поступит уведомление о выходе из отпуска:

<figure><img src="/files/1sZBPTAWiKIRH5iXQ9SK" alt=""><figcaption></figcaption></figure>

### Команда тэгнуть

Устали вручную искать людей, которые в игре, но не в голосовом канале? Для вас уникальная команда `/поинты тэгнуть`!

Сначала пропишем команду `/поинты тэгнуть`:

<figure><img src="/files/XUlo3layKmInfxkBzHxQ" alt=""><figcaption></figcaption></figure>

В поле "голосовой\_канал" необходимо указать голосовом канал, в котором должны были находиться пользователи.

В поле "текстовый\_канал" необходимо указать текстовый канал, в который поступит упоминание пользователей, которые в игре, но не в указанном голосовом канале.

В поле "текст" необходимо указать текст сообщения, который будет отправлен в текстовый канал вместе с упоминаниями.

{% hint style="info" %}
Анализ пользователей происходит не быстро из-за ограничения Discord. Придется немного подождать.
{% endhint %}

<figure><img src="/files/8ABLWJzDQDkwqcdlGpyX" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/BtvXS2fuW5YAWqq6tSwa" alt=""><figcaption></figcaption></figure>

Также в текстовый канал поступил пинг пользователей, которые в игре, но не в нужном голосовом канале:

<figure><img src="/files/4Seqp1lSjAuseeOqfhQa" alt=""><figcaption></figcaption></figure>

### Удаление пользователя из модуля

Вы можете удалить пользователя из модуля.

{% hint style="warning" %}
Если пользователь выйдет с сервера без удаления, то его аккаунт в модуле будет заморожен автоматически.
{% endhint %}

Для удаления пользователя из модуля используйте команду `/поинты удалить`:

<figure><img src="/files/PBjUk5ZU5qkqvlEGho2I" alt=""><figcaption></figcaption></figure>