Config files

Plugins get a simple settings file at plugins/<name>/config.txt, with one key = value per line. Lines starting with # are comments.

#![allow(unused)]
fn main() {
use crate::plugin::Config;

fn on_server_start(&self, server: &Server) {
    let mut config = Config::load("greeter");
    let message = config.get_or("join-message", "Welcome to the server!");
    let _ = config.save(); // writes the defaults so server owners can see every setting
    // ...
}
}
CallDoes
Config::load("name")Read plugins/name/config.txt. A missing file is fine, you get an empty config.
config.get("key") -> Option<&str>The value, if set
config.get_or("key", "default") -> StringThe value, or default. The default is also added to the file on the next save().
config.set("key", "value")Change a value
config.save()Write the file, creating the folder if needed

Saving data per player

Config::player gives each player their own file for your plugin, at plugins/<name>/players/<player>.txt. It's keyed by Xbox id, so the data survives name changes.

#![allow(unused)]
fn main() {
fn on_join(&self, server: &Server, player: &PlayerInfo) {
    let mut data = Config::player("greeter", player);
    let visits: u32 = data.get_or("visits", "0").parse().unwrap_or(0) + 1;
    data.set("visits", &visits.to_string());
    let _ = data.save();
    server.tell(player.id, &format!("Visit number {visits}!"));
}
}

Numbers

Values are text. Parse numbers yourself:

#![allow(unused)]
fn main() {
let radius: i32 = config.get_or("spawn-radius", "50").parse().unwrap_or(50);
}