更新日誌
Zig 綁定和輔助函式的更改,按 pumpkin-api-zig 版本分組。這些版本獨立於 Pumpkin 伺服器的釋出版本。釋出版本所指明的插件 API 修訂仍必須與伺服器匹配。
0.2.0
WIT:pumpkin-plugin-wit@79cc4f0。
新增輔助函式和範例
- 聊天提示:提出問題、解析數字答案、重試驗證,並提供可點選或可鍵入的選項。會話支援取消、替換、超時、自訂文字和匹配、捕獲過濾器以及可設定的選項指令。
- 選單:將類似箱子的欄位標記為
free,放入現有的stacks,並透過menu.items讀取內容,包括在on_close期間讀取。 - 倉庫:支援頁面選擇的個人儲存,顯示已佔用欄位,提供
/vault <page>,並可將容量設定為 1 至 45 頁。降低容量後,較高頁面上已佔用的欄位仍可存取。 - 選單範例新增
/trash,治療範例現在允許傳送者單獨使用/heal。
更靈活地控制輔助函式
- 指令:透過
cmd.bad_argument替換型別化引數的錯誤提示,透過cmd.failWith返回帶樣式的失敗訊息,並透過register_permission跳過自動權限註冊。 - 物品:設定預設斜體、選擇修飾符 ID、讀寫顯式資料名稱空間,以及使用
item.room檢查物品欄容量。將其用於交易前,請先閱讀文件中關於副手的限制。 - 設定:獨立於檔名選擇 TOML 或 JSON,控制檔案建立和缺失設定的重寫,抑制未知鍵警告,並限制檔案讀取大小。TOML 寫入器支援陣列中的結構和元組。
- 玩家資料:選擇 JSON 佈局、TOML 或自訂編解碼器;設定鍵驗證、閒置驅逐和讀取大小限制。更改格式不會遷移現有檔案。
- 網路:為傳出連線和已接受的連線設定 TCP 接收緩衝區,並透過
http.ca_file選擇 HTTPS 證書包。/nettest新增了對自訂緩衝區和超長行的檢查。
修復
- TOML 序列化不再因陣列中的結構或元組而失敗。
- 執行階段生成的彩色按鈕現在會為其名稱使用各自獨立的後備儲存。
0.1.1
WIT:pumpkin-plugin-wit@75f96e9。
修復了插件宣告三個或更多事件時發生的編譯階段分支配額失敗。比較 0.1.0 和 0.1.1。
0.1.0
WIT:pumpkin-plugin-wit@75f96e9。
面向 Zig 0.16.0 的初始版本,可將插件建構為 WebAssembly 元件:
- 生成的插件 API 和
wasi:sockets綁定,包含規範 ABI 執行階段和回呼資源管理。 - 用於插件建構的
addPlugin和target,支援額外的 Zig 匯入及相容 WASI 的 C 依賴。 - 事件註冊、宣告式指令樹和帶樣式的文字輔助函式。
- 鎖定的物品欄選單,以及用於建構、編輯、給予和收取物品堆疊的物品輔助函式。
- 支援複製資料和取消跟蹤的延遲任務與重複任務。
- TOML 和 JSON 設定、按玩家劃分的檔案儲存、HTTP/HTTPS 以及 TCP/UDP 網路。
- 範例插件、用於伺服器端網路檢查的
/nettest,以及自動化建構和釋出工作流。