Safe bindings for grug

Basic Usage

use grug_rs::{Grug, Arguments};

use anyhow::Result;
use grug_rs_proc_macro::game_function;

fn main() -> Result<()> {
    // Initializes grug
    let grug = Grug::new(
        None,
        "./mod_api.json",
        "./mods",
        "./mods_dll",
        1000,
    )?;

    loop {
        grug.activate_on_function("World", "on_update", Arguments::empty())?;
    }
}

#[game_function]
fn println(message: String) {
    println!("{message}");
}

Use this as your main.rs.

You will need to create a mods directory and a mod_api.json.

Inside mod_api.json put this:

{
  "entities": {
    "World": {
      "description": "Let's print in here",
      "on_functions": {
        "on_update": {
          "description": "Called every tick"
        }
      }
    }
  },
  "game_functions": {
    "println": {
      "description": "Prints a string with a new line",
      "arguments": [
        {
          "name": "msg",
          "type": "string"
        }
      ]
    }
  }
}

Inside of mods create an about.json and put this:

{
    "name": "hello_world",
    "version": "1.0.0",
    "game_version": "1.0.0",
    "author": "YOUR NAME HERE"
}

And create a file called hello-World.grug and put:

on_update() {
    println("Hello world!", 10)
}

Then run your program!

If there are errors with unable to find symbols you might have to create a basic build.rs that looks like this:

fn main() {
    println!("cargo:rustc-link-arg=-rdynamic");
}