Getting Started

.net 6.0 +

We only support dotnet core versions 6 and up. It would be pretty easy to add support for .net 4 I suspect, but it is definitely not on our roadmap.

To start using SmolScript in your project, add the smolscript nuget either though the VS package manager or on the command line with dotnet add smolscript.

Initialize and run a simple smol script like this:

using SmolScript;

var exampleSmolScriptCode = @"

// This is the smol script program, not .net
var a = 10;

function multiplyA(valueToMultiplyBy) {
a = a * valueToMultiplyBy;
}

multiplyA(10);
";

var vm = SmolVM.Compile(exampleSmolScriptCode);

vm.Run();

var valueOfA = vm.GetGlobalVar<int>("a");

We're creating a string that contains our smol program code, and then creating a VM by compiling the code. Once we've compiled, if there are no errors, we can .Run() the VM to execute the entire program once.

On the last line of this sample, once the program has finished running and control is back in our .net code, we're getting the value of global variable 'a' from the VM and casting it to int. Currently only a handful of primptive casts are supported (string, int, double, bool).

This is just a very quick getting started sample. You can call Smol functions from .net, and you can register .net functions to call from SmolScript. More documentation and samples coming soon.