Essentials

Это форк Essentials под названием EssentialsX.

Если вы используете это, НЕ обращайтесь к Essentials за поддержкой.

Официальный исходный репозиторий исходного проекта Essentials находится по адресу https://github.com/Essentials/Essentials.

Зачем использовать EssentialsX?

EssentialsX — это продолжение набора плагинов Essentials, обновленное для поддержки современных версий Minecraft и Spigot.

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

Если вы используете оригинальный плагин Essentials, EssentialsX — это полная замена Essentials. Однако у него есть некоторые новые требования:

• Для работы EssentialsX требуется CraftBukkit, Spigot или Paper. Другое серверное программное обеспечение может работать, но оно не тестировалось командой, и мы не сможем помочь с возникшими проблемами.
• EssentialsX в настоящее время поддерживает версии Minecraft 1.8.8, 1.9.4, 1.10.2, 1.11.2, 1.12.2, 1.13.2, 1.14.4, 1.15.2, 1.16.5, 1.17.1, 1.18.2, 1.19. .4, 1.20.6 и 1.21.4.
• EssentialsX в настоящее время требует Java 8 или более поздней версии. Мы рекомендуем использовать последнюю версию Java, поддерживаемую вашим серверным программным обеспечением.
• EssentialsX требует, чтобы Vault включал использование префиксов/суффиксов чата и поддержку групп с помощью поддерживаемых плагинов разрешений.
  • Мы рекомендуем использовать LuckPerms для разрешений и групп.
  • Если у вас есть неподдерживаемый плагин разрешений, но вы все равно хотите использовать подстановочные знаки, включите use-bukkit-permissions в конфигурации. В противном случае плагин вернется к разрешениям на основе конфигурации.

Поддерживать

Нужна помощь с использованием EssentialsX? Присоединяйтесь к сообществу MOSS Discord, чтобы попросить о помощи и обсудить EssentialsX.

Если вам нужно сообщить об ошибке или предложить новую функцию, вы можете открыть проблему на GitHub.

Здание

Для сборки EssentialsX в вашей системе должен быть установлен JDK 8 или более поздней версии.

Клонируйте этот репозиторий, затем выполните следующую команду:

• В Linux или macOS: ./gradlew build
• В Windows: gradlew build

Затем вы сможете найти сборки модулей EssentialsX в каталоге jars/ .

Запуск тестового сервера

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

• В Linux или macOS: ./gradlew build :runServer
• В Windows: gradlew build :runServer

Обратите внимание : - без него вы будете запускать несколько серверов одновременно, что, скорее всего, приведет к сбою Gradle.

Использование EssentialsX в вашем плагине

Хотите интегрировать EssentialsX в свой плагин? Вы можете создать свой плагин на основе API EssentialsX , доступного в репозитории EssentialsX Maven.

Релизы размещаются в репозитории Maven по адресу https://repo.essentialsx.net/releases/ , а моментальные снимки (включая сборки для разработчиков) размещаются по адресу https://repo.essentialsx.net/snapshots/ .

Чтобы добавить EssentialsX в вашу систему сборки, вам следует использовать следующие артефакты:

Тип	Идентификатор группы	Идентификатор артефакта	Версия
Последний выпуск	net.essentialsx	EssentialsX	2.20.1
Снимки	net.essentialsx	EssentialsX	2.21.0-SNAPSHOT
Старые выпуски	net.ess3	EssentialsX	2.18.2

Примечание. До версии 2.18.2 EssentialsX использовал идентификатор группы net.ess3 .
Начиная с 2.19.0 , EssentialsX использует идентификатор группы net.essentialsx .
При обновлении плагина убедитесь, что вы используете правильный идентификатор группы.

Дополнительную информацию, включая примеры Maven и Gradle, можно найти на вики.

Поддержите проект EssentialsX

Хотите помочь улучшить EssentialsX? Есть несколько способов поддержать проект и внести свой вклад.

Пожертвовать в EssentialsX

Пожертвования позволяют нам покрывать расходы на нашу инфраструктуру, а также продолжать обновлять EssentialsX новыми функциями и новыми версиями Minecraft.

Вы можете поддержать нас разовым или ежемесячным пожертвованием через спонсоров GitHub и получите значок на GitHub за поддержку проекта.

Кроме того, вы также можете ежемесячно делать пожертвования в проект EssentialsX на Patreon или сделать разовое пожертвование на нашей странице Ko-fi.

Если вы не можете сделать пожертвование, не волнуйтесь! Есть много других способов внести свой вклад:

Непосредственный вклад в EssentialsX

• Вы разработчик? Мы всегда рады получать исправления ошибок и дополнения к функциям в виде запросов на включение.
• Вы говорите на нескольких языках? Если да, то мы всегда приветствуем вклад в переводы нашего сообщества. Краудин проект.

Посетите CONTRIBUTING.md, чтобы узнать больше.

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

• У вас есть сервер? Ознакомьтесь с разделами «Требуется помощь» и «Ошибка: неподтверждено», где вы можете найти проблемы, требующие дополнительного тестирования и исследования.
• Хотите помочь другим настроить EssentialsX? Вы можете внести свой вклад в документацию EssentialsX. Вы также можете присоединиться к сообществу MOSS Discord и оказывать прямую поддержку другим пользователям EssentialsX.