Skip to content

遷移設定與資料儲存 ​

Bukkit 插件高度依賴 config.yml、YamlConfiguration 和 Bukkit 設定序列化系統。

在 Pumpkin 中,WebAssembly 插件執行在安全的沙箱環境中,可以使用 TOML、JSON 或 YAML 等標準格式以原生方式處理設定檔案。


主要區別 ​

功能Bukkit / SpigotPumpkin
設定檔案格式config.yml(YAML 格式)靈活選擇:TOML、JSON 或自訂檔案
預設設定生成saveDefaultConfig()從插件目錄或內嵌的 WASM 資源讀取設定
資料解析getConfig().getString(...)原生 serde / JSON / TOML 反序列化
檔案 I/O 沙箱可直接存取檔案系統中的任何位置向 WASM 插件授予沙箱化目錄存取權限

程式碼對比:載入設定 ​

1. Bukkit 實現(Java) ​

java
public class ConfigExample extends JavaPlugin {
    @Override
    public void onEnable() {
        saveDefaultConfig(); // 從 jar 資源儲存 config.yml
        FileConfiguration config = getConfig();

        String welcomeMsg = config.getString("welcome-message", "Default welcome!");
        int maxItems = config.getInt("max-items", 10);
        getLogger().info("Loaded message: " + welcomeMsg);
    }
}

2. Pumpkin 實現(Rust) ​

在 Pumpkin 中,你可以派生 serde::Deserialize 來解析簡潔的 TOML 設定檔案:

rust
use serde::Deserialize;
use std::fs;

#[derive(Deserialize, Debug)]
pub struct PluginConfig {
    pub welcome_message: String,
    pub max_items: i32,
}

impl Default for PluginConfig {
    fn default() -> Self {
        Self {
            welcome_message: "Default welcome!".to_string(),
            max_items: 10,
        }
    }
}

pub fn load_config() -> PluginConfig {
    let config_path = "plugins/my_plugin/config.toml";
    if let Ok(content) = fs::read_to_string(config_path) {
        toml::from_str(&content).unwrap_or_default()
    } else {
        PluginConfig::default()
    }
}

基於 MIT 授權條款釋出。