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 启用使用聊天前缀/后缀以及受支持的权限插件的组支持。
  • 我们建议对权限和组使用 LucPerms。
  • 如果您有不受支持的权限插件，但仍想使用通配符，请在配置中启用use-bukkit-permissions 。否则，插件将回退到基于配置的权限。

支持

需要使用 EssentialsX 方面的帮助吗？加入 MOSS Discord 社区寻求帮助并讨论 EssentialsX。

如果您需要报告错误或想要建议新功能，可以在 GitHub 上提出问题。

建筑

要构建 EssentialsX，您需要在系统上安装 JDK 8 或更高版本。

克隆此存储库，然后运行以下命令：

• 在 Linux 或 macOS 上： ./gradlew build
• 在 Windows 上： gradlew build

然后，您可以在jars/目录中找到 EssentialsX 模块的构建。

运行测试服务器

您还可以使用以下命令从开发环境运行测试服务器：

• 在 Linux 或 macOS 上： ./gradlew build :runServer
• 在 Windows 上： gradlew build :runServer

请注意: - 如果没有它，您将同时运行多个服务器，这可能会导致 Gradle 崩溃。

在您的插件中使用 EssentialsX

您想在您的插件中集成 EssentialsX 吗？您可以根据EssentialsX API构建您的插件，该 API 可从 EssentialsX Maven 存储库获取。

版本托管在 Maven 存储库上，网址为https://repo.essentialsx.net/releases/ ，而快照（包括开发版本）托管在https://repo.essentialsx.net/snapshots/ 。

要将 EssentialsX 添加到您的构建系统，您应该使用以下工件：

类型	组号	工件ID	版本
最新发布	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组 ID。
从2.19.0开始，EssentialsX 使用net.essentialsx组 ID。
更新插件时，请确保使用正确的组 ID。

您可以在 wiki 中找到更多信息，包括 Maven 和 Gradle 示例。

支持 EssentialsX 项目

想要帮助改进 EssentialsX？您可以通过多种方式支持该项目并为该项目做出贡献。

捐赠给 EssentialsX

捐款使我们能够支付基础设施的成本，并使我们能够不断更新 EssentialsX 的新功能和新的 Minecraft 版本。

您可以通过 GitHub 赞助商一次性或每月捐款来支持我们，并且您将在 GitHub 上获得一枚徽章，以表彰您通过此方式支持该项目。

或者，您也可以每月向 Patreon 上的 EssentialsX 项目捐款，或者您可以在我们的 Ko-fi 页面上进行一次性捐款。

如果您无法捐款，请不要担心！还有很多其他方式可以做出贡献：

直接为 EssentialsX 做出贡献

• 您是开发人员吗？我们总是很高兴收到错误修复和功能添加作为拉取请求。
• 你会说多种语言吗？如果是这样，我们始终欢迎为我们的社区翻译做出贡献。克劳丁项目。

请参阅 CONTRIBUTING.md 了解更多信息。

为其他用户提供支持

• 你运行服务器吗？查看我们的“需要帮助”和“错误：未确认”问题，您可以在其中找到需要额外测试和调查的问题。
• 您想帮助其他人设置 EssentialsX 吗？您可以为 EssentialsX 文档做出贡献。您还可以加入 MOSS Discord 社区，并为其他 EssentialsX 用户提供直接的社区支持。