Cmail

Cmail 是一款專為 Paper (Minecraft 1.21.x+) 伺服器設計的虛擬郵件與禮包系統。本插件採用 SQLite 本地資料庫儲存郵件數據，並支援 Vault 經濟系統。具備完整的 NBT 道具保存能力，可供管理員打包禮包並進行批次指令分發，適用於伺服器道具發放與自動化商城整合。

功能特性

• 安全防護機制：
  • 當玩家在「放入附件」或「編輯禮包」時，若因異常斷線、伺服器重載或非正常關閉選單，系統會自動將所有道具退回玩家背包。若背包空間不足，則會自然掉落於玩家所在的世界座標，防止道具遺失或複製漏洞。
  • 唯讀選單全面禁用 Shift-Click 與滑鼠拖曳限制，防止附件道具異常移出。
• NBT 禮包範本系統：
  • 管理員可在遊戲內打開 36 格介面，將含有自訂 NBT 數據（如自訂金幣、特殊標籤道具、Lore 武器）擺放完成並進行打包。
  • 支援通過主機或控制台指令（支援以逗號分隔多位玩家名稱）將打包好的禮包範本直接分發給多位玩家。
• 控制台指令整合：
  • 提供 consolesend 與 sendpack 指令，可直接由控制台、RCON 或外部腳本調用以發送郵件與物品。
• 管理員後台審查：
  • 管理員可調閱全伺服器所有歷史信件。內建安全鎖機制，解鎖後始可修改信件內文、調整信件附件，並支援在確認後永久刪除郵件。
• Vault 經濟整合：
  • 可啟用發信手續費與附件手續費，並在玩家寄信時顯示扣款確認界面。
• 發信人自訂：
  • 系統發送的信件（如禮包、後台信件）之發信人名稱可於 config.yml 中自由配置，支援色彩代碼。
• 自動清理機制：
  • 定時自動清理過期郵件，可設定保留天數及是否清理未讀/含附件郵件。

指令與權限

指令	說明	執行端	權限節點	預設
/cmail 或 /cmail mail	開啟個人收件箱 GUI	僅限玩家	cmail.use	所有人
/cmail send <玩家> <訊息>	撰寫郵件並開啟附件放置 GUI	僅限玩家	cmail.use	所有人
/cmail help	顯示指令說明清單	僅限玩家	cmail.use	所有人
/cmail admin	開啟管理員審查選單	僅限玩家	cmail.admin	OP
/cmail sendall <訊息>	撰寫並發送全服廣播郵件	僅限玩家	cmail.admin	OP
/cmail reload	重新載入設定檔	遊戲內 / 控制台	cmail.admin	OP
/cmail savepack <禮包名稱>	在遊戲內打包道具為禮包範本	僅限玩家	cmail.admin	OP
/cmail sendpack <玩家1,玩家2,...> <禮包名稱> <訊息>	發送禮包範本給多位玩家	遊戲內 / 控制台	控制台無限制 / cmail.admin	OP
/cmail consolesend <玩家1,玩家2,...> <訊息> [材質:格位:數量]...	透過純指令發送特定排列的道具給多位玩家	遊戲內 / 控制台	控制台無限制 / cmail.admin	OP

使用範例

1. 打包並發送自訂 NBT 道具

1. 管理員將自訂道具放入快捷欄，在遊戲內執行：

   /cmail savepack cash_v1
   

2. 將道具放入前 27 格，點擊右下角儲存並關閉。
3. 於控制台發送給指定玩家：

   cmail sendpack playerA,playerB cash_v1 感謝贊助，這是您的禮包。
   

2. 控制台直接發送基本道具

控制台發送 64 個鑽石在第 4 格，16 個金錠在第 22 格給特定玩家：

cmail consolesend playerC 這是您的活動獎勵 DIAMOND:4:64 GOLD_INGOT:22:16