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.199 .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

然後，您可以在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 用戶提供直接的社群支援。