> 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="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FULRRkcI42kmKbNjzvG6T%2Fimage.png?alt=media&amp;token=40b5b55f-7d3f-4552-9f16-057d7f205a3b" alt=""><figcaption></figcaption></figure>

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

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

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

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

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FHVMYEyUkJoCg9XUVQHNU%2Fimage.png?alt=media&amp;token=75201f9a-862d-4061-80b0-9a12c5808a11" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FUg2bgFf9sp4L9jJmtKVu%2Fimage.png?alt=media&amp;token=6c42213d-c5db-4c11-879e-6e97eaf07fe0" 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="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FJPy1VGkszXONhQdaFhX7%2Fimage.png?alt=media&amp;token=f4396625-c641-44e8-b3af-52f03d4f0577" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FuIZ0ktRrbeA3uhTD6ezD%2Fimage.png?alt=media&amp;token=5014985d-76fc-421e-9241-3c8167f96155" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FOsiNy9b0g8OXH2YJvRSP%2Fimage.png?alt=media&amp;token=47f7a71d-b613-43de-8dd8-932f9c6df88a" alt=""><figcaption></figcaption></figure>

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

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

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

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

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FlcvaTHuJOYQtCp8nTy1B%2Fimage.png?alt=media&amp;token=aad37a62-edf0-4d83-a03c-6bbb3ab279ad" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2Fqdw1vOaEX3OLArASmr7P%2Fimage.png?alt=media&amp;token=df2ea57e-f4cc-4bc9-9c0a-e8e54054d406" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FFhF8lLQGpcOxQltFLLZG%2Fimage.png?alt=media&amp;token=5cc31adc-0f6f-4466-b638-125f24e40f39" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FMhU8odkLAzaocsYGTR53%2Fimage.png?alt=media&amp;token=3eacd82f-fbf4-48fd-b9d0-45e54b304ebf" alt=""><figcaption></figcaption></figure>

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

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

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

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

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

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2F6O5npwZCVpiZncegUCkl%2Fimage.png?alt=media&amp;token=758d64b4-eaef-4c53-a792-61b17551b535" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FSnxHlvzBDVZ2XLuQYirR%2Fimage.png?alt=media&amp;token=81e81fab-241e-40b3-8691-319d5e7644be" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FoNKGe6G01c4EpGjd0Orv%2Fimage.png?alt=media&amp;token=4571d791-1173-49d3-8389-42bf77a6cf9d" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FOaaX2qId6oW4zfseEleV%2Fimage.png?alt=media&amp;token=97dcc5dc-c107-421d-ab20-c34851ba8175" alt=""><figcaption><p>Пример использования команды /поинты информация</p></figcaption></figure>

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

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

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

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FYhB7EYU1qXrRMuAqVS1A%2Fimage.png?alt=media&amp;token=998dc71d-590e-4948-a93a-f93123c87a21" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FUCBk0XeEAv0XY22RGywe%2Fimage.png?alt=media&amp;token=08e1bbcd-4e5a-45b4-8166-3cad5f789354" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2F9qYLT84IClD3dOVUmAQD%2Fimage.png?alt=media&amp;token=c34b2f23-d68e-46cd-944a-b88fdb06a14f" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2F0S6v0ry5a0rTJ5PbdtG5%2Fimage.png?alt=media&amp;token=73aedb24-26ef-4e0e-9488-96a31623dafc" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FAAmjD7OfDV8dB1qPNZKH%2Fimage.png?alt=media&amp;token=7a666f8b-0df5-4a3c-aa8d-a6b97efc25d6" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2Fo9ziI6Of22K38sennKOP%2Fimage.png?alt=media&amp;token=61925313-a245-4663-8fbc-28de6072ebdf" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FUliKY37xQoP4Oi69WMQP%2Fimage.png?alt=media&amp;token=f47f56c5-4e1a-4cf0-b655-eed082370f66" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FT5YkkvGK9m6j1azKNN16%2Fimage.png?alt=media&amp;token=36fa42d6-5708-46c5-acf9-9bad98f364fc" alt=""><figcaption></figcaption></figure>

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

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

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

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

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FK5RDlI9OtpeGfF5XBzoS%2Fimage.png?alt=media&amp;token=c0c1e9fd-f500-4fc7-bb80-781be2230aa1" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FXdgfG5ZJvRUVavvtB1O6%2Fimage.png?alt=media&amp;token=c6defb69-ec9f-427e-b755-53cf12f541d6" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FcGop0wm6Q9asosARDZPy%2Fimage.png?alt=media&amp;token=bb964d3f-44b0-4713-89b8-5b76acabcc1c" alt=""><figcaption></figcaption></figure>

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

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

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

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

<figure><img src="https://3576993301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6x2dCyYF04f6Q5TQ0tpE%2Fuploads%2FyDUXEda2hc9bf6xe5hvc%2Fimage.png?alt=media&amp;token=0dd6908f-9538-45e7-8c40-d8f9d14b4a57" alt=""><figcaption></figcaption></figure>