快速入門
本指南將幫助你開始使用 D 程式語言編寫 Pumpkin 伺服器插件。
Pumpkin 的 D 插件使用官方 pumpkin-api-d 綁定編譯為 WebAssembly(Wasm)元件。
前提條件
在為 Pumpkin 建構 D 插件之前,請確保已安裝以下內容:
1. 設定專案
為插件專案建立一個新目錄,並新增 dub.json 設定檔案:
bash
mkdir my-d-plugin
cd my-d-plugin在專案根目錄建立 dub.json:
json
{
"name": "my-d-plugin",
"description": "A minimal Pumpkin plugin built with D.",
"license": "proprietary",
"authors": ["You"],
"copyright": "Copyright © 2026, You",
"dependencies": {
"pumpkin-api-d": "~>0.1.0"
},
"targetType": "executable",
"dflags": ["-Xcc=-mexec-model=reactor"],
"buildTypes": {
"debug": {
"buildOptions": ["debugMode", "debugInfo"]
},
"release": {
"buildOptions": ["optimize", "inline"],
"dflags": ["-L-S"]
}
}
}NOTE
WebAssembly 連結器需要 -Xcc=-mexec-model=reactor 標誌,以便將插件視為 reactor(公開入口點的元件),而不是具有退出點的指令列程式。
2. 編寫插件
建立一個 source 目錄,並將程式碼放入 source/app.d:
d
module plugin;
import wit.pumpkin.plugin.plugin;
import wit.common;
import pumpkin.register;
struct MyPlugin {
@GetMetadata PluginMetadata getMetadata()
{
immutable(WitString)[$] authors = [
"You".witList
];
return (immutable PluginMetadata(
name: "my-d-plugin".witList,
version_: "0.1.0".witList,
authors: authors.witList,
description: "An example plugin in D.".witList,
dependencies: WitList!WitString(),
permissions: WitList!WitString()
)).witClone;
}
@OnLoad
Result!(void, WitString) onLoad(Context ctx)
{
scope (exit)
ctx.witDrop; // 傳入的資源在使用後必須清理
log(Level.info, "Hello from D plugin!".witList);
return ok!WitString;
}
}
mixin RegisterPlugin!MyPlugin;關鍵要素:
@GetMetadata:定義 Pumpkin 載入元件時請求的插件資訊(名稱、版本、作者、描述、權限)。@OnLoad:Pumpkin 初始化插件時呼叫的入口點。確保使用ctx.witDrop釋放傳入的上下文資源(ctx)。mixin RegisterPlugin!MyPlugin;:生成 Pumpkin 的 WASM 載入器所需的 WebAssembly 元件匯出和樣板程式碼。
3. 建構插件
將插件編譯為面向 wasm32-wasip3 的 WebAssembly 元件:
bash
dub build -b release -a wasm32-wasip3這會在專案根目錄生成 my-d-plugin.wasm。
4. 執行插件
- 將編譯後的
.wasm檔案複製到伺服器的plugins/目錄:bashcp my-d-plugin.wasm /path/to/pumpkin/plugins/ - 啟動或重啟 Pumpkin:bash
./pumpkin - 檢查伺服器日誌,確認插件已載入:text
[INFO] Hello from D plugin!