locale_test

Path: examples/locale_test.

Registers /greet <1-3>, picks a greeting locale key from a constant array, and prints a Factorio LocalisedString that interpolates the player’s name (__1__). Translations ship for English, German, and Spanish via locale!.

const GREETINGS: &[&str] = &[
    "greetings.hello",
    "greetings.welcome",
    "greetings.howdy",
];

factorio_rs::locale! {
    en {
        greetings {
            "hello" = "Hello, __1__!",
            // ...
        }
    }
}

commands.add_command("greet", ["greetings.command-help"], lua_fn(greet));

pub fn greet(command: CustomCommandData) {
    // ...
    player.print([key, player.name()], None);
}
// -> commands.add_command("greet", { "greetings.command-help" }, control.greet)
// -> player.print({ key, player.name })

lua_fn coerces a Rust fn item to LuaFunction for cargo check and is stripped when lowering. pub fn callbacks are emitted as control.greet (not a bare global). Private fn greet also works and becomes a Lua local function.

Try it

cd examples/locale_test
factorio-rs build
factorio-rs install --open   # optional

In-game (change language under Settings -> Interface to see other locales):

/greet 1
/greet 2
/greet 3

See Locale for locale! and runtime LocalisedString usage.