[HeadShop] A plugin for buying player heads

✨ 功能特色

• Vault 經濟系統整合 - 使用伺服器的經濟系統進行交易
• 玩家頭顱購買 - 購買任何玩家的頭顱作為裝飾
• 靈活配置 - 可自定義價格和默認數量
• ️ 權限系統 - 完整的權限控制
• 批量購買 - 一次購買多個頭顱
• 友好提示 - 清晰的中文提示訊息

系統需求

• ✅ Minecraft 版本: 1.13+
• ✅ 依賴插件: Vault
• ✅ 經濟插件: EssentialsX, CMI 等支援 Vault 的經濟插件

安裝方法

1. 確保您的伺服器已安裝 Vault 和任一經濟插件
2. 下載 HeadShop.jar 檔案
3. 將檔案放入伺服器的 plugins 資料夾
4. 重啟伺服器
5. 完成！

⚙️ 配置檔案
config.yml
permissions: "headshop.buy" # 使用插件所需的權限
default:
total: '1' # 默認購買數量
price: '200' # 每個頭顱的價格
指令說明
主要指令
/headshop <玩家名稱> [數量]

指令範例：

• /headshop Steve - 購買 1 個 Steve 的頭顱
• /headshop Alex 5 - 購買 5 個 Alex 的頭顱
• /headshop Notch 10 - 購買 10 個 Notch 的頭顱

指令參數說明：
參數 類型 必填 說明
<玩家名稱> 字串 ✅ 要購買頭顱的玩家名稱
[數量] 整數 ❌ 購買數量（1-64，默認為配置中的數量）
權限設定
權限節點
權限 默認 說明
headshop.buy true 允許玩家購買頭顱
設定範例（LuckPerms）
/lp group default permission set headshop.buy true
/lp user <玩家名稱> permission set headshop.buy true

限制說明

• 餘額檢查: 購買前會檢查玩家餘額是否足夠
• 玩家驗證: 只能購買存在的玩家頭顱
• 背包空間: 需要有空的背包格子
• 數量限制: 單次購買數量限制為 1-64 個
• ️ 權限檢查: 需要相應權限才能使用

使用技巧

1. 經濟管理: 建議根據伺服器經濟平衡調整頭顱價格
2. 裝飾用途: 玩家頭顱可用於建築裝飾和收藏
3. 社群互動: 促進玩家間的互動和交易

故障排除
常見問題
Q: 插件無法載入？

• A: 請確保已正確安裝 Vault 插件和經濟插件

Q: 無法購買頭顱？

• A: 檢查玩家權限、餘額和背包空間

Q: 找不到指定玩家？

• A: 確保玩家名稱正確且該玩家曾經加入過伺服器

開發計劃

• 多語言支援
• 購買歷史記錄
• 統計功能

⚠️ 重要提醒
語言設定: 目前無法設定語言，敬請期待...

授權條款
本專案採用 MIT 授權條款 - 詳見 LICENSE 檔案

‍ 開發者
作者: AllenPixel, Allen