VipSystem

简介

VipSystemEx может помочь вам самостоятельно управлять vip-сервером, поддерживает временные, постоянные и переключаемые vip. Этот плагин использует индексированный SQLite или MySQL для хранения данных, поддерживает настраиваемое включение/выключение пула соединений и обеспечивает совместимость и эффективность.

Команды

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

Базовое использование

Подготовка

Установите плагин на сервер и перезапустите его. Если вам нужна китайская версия плагина, найдите файл /plugins/VipSystem/config.yml и измените lang: en на lang: zh_CN. Затем введите команду /vipsys reload, чтобы перезагрузить. Вам не нужно дополнительно настраивать группу по умолчанию, плагин автоматически вернёт группу по умолчанию в соответствии с правами доступа. Создайте соответствующую группу vip, например, создайте группу с именем vip. Если вы ранее использовали старую версию VipSystem, вы можете напрямую установить новую версию на сервер и удалить старую. Плагин автоматически обновит файлы конфигурации и структуру данных между версиями.

Предоставление vip

Предположим, что имя игрока Test, и ему необходимо предоставить 30-дневный vip. Введите команду /vipsys give Test vip 30d. Игрок может использовать /vipsys me для просмотра своего статуса vip. Чтобы удалить vip, просто введите /vipsys remove Test как администратор.

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

Если вам нужно использовать заполнители, предоставляемые VipSystem, вам необходимо установить плагин PlaceholderAPI. Заполнители отображаются следующим образом:

Расширенное использование

Настройка языка

Плагин имеет встроенные английский и китайский языки. Вы можете изменить значение lang в файле конфигурации на zh_CN или en, чтобы использовать встроенные языки плагина. Вы также можете настроить свой собственный язык, изменив значение lang на название языка после установки, а затем перезагрузить плагин. Плагин создаст языковой файл в каталоге messages, который можно настроить и перезагрузить для активации нового языкового файла.

Режим UUID

Если ваш сервер является официальным сервером, рекомендуется включить режим UUID в файле конфигурации uuid: true.

Группа по умолчанию

Плагин определяет группу по истечении срока действия vip на основе группы прав доступа. Если вам нужно изменить группу по умолчанию, установите defaultGroup: builder в файле конфигурации. Это изменит возвращаемую группу на builder или другую.

Возврат к предыдущей группе

Если вы хотите вернуть игрока в предыдущую группу после истечения срока действия его vip, установите previousGroup: true в файле конфигурации, чтобы реализовать эту функцию. Обратите внимание, что эта функция не может использоваться одновременно с настройкой группы по умолчанию.

База данных

По умолчанию плагин использует HikariCP для подключения к базе данных SQLite. Если у вас нет особых требований, не изменяйте эту часть файла конфигурации. Если ваш сервер не может запуститься с использованием файла конфигурации по умолчанию и выдаёт ошибку, содержащую слово hikarcp, измените значение usePool на false. Если вам требуется использовать MySQL, установите значение useMySQL равным true и настройте информацию о базе данных ниже.

Глобальный vip

Если вы используете GroupManager в качестве плагина прав доступа, вам не нужно изменять эту часть конфигурации без необходимости. Если вы используете PermissionsEx в качестве плагина группы прав доступа и по умолчанию vip не действует во всём мире, установите значение isGlobal равным false. Если он всё ещё не действует во всём мире, добавьте вручную все ваши миры в раздел worlds, например:

worlds:
  - world
  - world_nether
  - world_the_end

Пользовательский формат даты

Если требуется изменить формат даты, обратитесь к документации https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html для изменения заполнителя.

Пользовательские команды

Вы можете настроить команды для активации и истечения срока действия vip. Ниже приведена конфигурация по умолчанию:

customCommands:
  vip:
    activate:
      - 'say {0} has activated vip!'
      - 'give {0} minecraft:diamond'
    expire:
      - 'say {0} is no longer a vip'

Это означает, что при активации vip будет выполнена указанная команда, которая отправит сообщение и даст игроку алмаз. При истечении срока действия vip будет выполнена следующая команда, отправляющая сообщение:

say {0} is no longer a vip

Аналогично для svip. Если у вас есть больше типов vip, вы можете добавить их в соответствии с указанным форматом. Если эта функция вам не нужна, её можно удалить.

Пользовательские функции

Плагин позволяет редактировать пользовательские функции для выполнения автоматических операций по расписанию. Например, вы можете использовать плагин для реализации временных прав доступа. Конкретный метод редактирования описан на https://www.zhanshi123.me/?p=320.

Загрузка плагина

Этот плагин бесплатен, но не предоставляет прямой ссылки для скачивания jar-файла. Вы можете клонировать/форкнуть этот проект и собрать его самостоятельно, установив maven, а затем войти в каталог проекта и ввести mvn install для автоматической сборки. Целевой файл будет создан в каталоге /target. Если у вас нет возможности самостоятельной сборки, вы можете связаться с автором и заплатить ￥20 в качестве пожертвования, после чего автор предоставит вам собранный файл. Все платежи являются огромной поддержкой для автора!

API

Чтобы использовать этот плагин в качестве предварительного условия (например, Maven), выполните следующие действия:

<repository>
  <id>soldier-repo</id>
  <url>https://repo.zhanshi123.me/repository/maven-public/</url>
</repository>

<dependency>
  <groupId>me.zhanshi123</groupId>
  <artifactId>VipSystem</artifactId>
  <version>4.13</version>
  <scope>provided</scope>
</dependency>

Вы можете получить экземпляр VipSystemAPI с помощью VipSystemAPI.getInstance(). Дополнительная информация будет добавлена позже.

Благодарности

Спасибо следующим пользователям за поддержку плагина: (упорядочено по времени)