相容性Compatibility

伺服器版本

建置	適用版本	Java
標準	1.21 以上	21
legacy	1.13 – 1.20.6	17

兩種建置不能互換。 InventoryView 在 1.21 從抽象類別改成了介面，兩種建置產生的呼叫指令不同（invokevirtual 對 invokeinterface）。裝錯版本時指令都能用，但一開選單就會丟 IncompatibleClassChangeError。

Folia

不支援。 程式碼使用 Bukkit 的傳統排程器，Folia 的區域化執行緒模型需要不同的 API 與 plugin.yml 宣告。

代理端

這是伺服器端插件，不能裝在 BungeeCord、Velocity 或 Waterfall 上。

其他插件

插件	關係
PlaceholderAPI	選用，安裝後自動註冊變數
LuckPerms	選用，用於權限判定
SkinsRestorer	選用，用於選單中的玩家頭顱
Essentials	選用，可一次性匯入 `userdata` 的餘額
Vault.jar	衝突，不可同時安裝

從 Essentials 匯入

import:
  essentials:
    enabled: true
    replace: false   # true = 覆蓋現有餘額；false = 僅在缺少時建立

匯入由標記檔守衛，一輩子只會執行一次。完成後可將 enabled 改回 false。

Server versions

Build	Supports	Java
Standard	1.21 and newer	21
legacy	1.13 – 1.20.6	17

The two builds are not interchangeable. InventoryView became an interface in 1.21, so the two builds emit different call instructions (invokevirtual vs invokeinterface). With the wrong build, commands work fine but opening any menu throws IncompatibleClassChangeError.

Folia

Not supported. The plugin uses the classic Bukkit scheduler; Folia's regionised threading model requires a different API and an explicit plugin.yml declaration.

Proxies

This is a server-side plugin. It does not run on BungeeCord, Velocity or Waterfall.

Other plugins

Plugin	Relationship
PlaceholderAPI	Optional; placeholders register automatically
LuckPerms	Optional, for permission checks
SkinsRestorer	Optional, for player heads in menus
Essentials	Optional; one-shot balance import from `userdata`
Vault.jar	Conflicts; never install both

Importing from Essentials

import:
  essentials:
    enabled: true
    replace: false   # true = overwrite existing balances; false = only create missing ones

The import is guarded by a marker file and runs exactly once, ever. Afterwards you can set enabled back to false.