BBLang

• VSCode Extension
• Language Server

About

An interpreted language for mostly scripting purposes or simulations. I use this project in my game to implement in-game programming. It can also generate Brainfuck code, because why not, and can also optimize functions into MSIL, or compile the whole script into a DynamicMethod.

Note

Currently it doesn't support serializing, so you can only execute the script. However, you can save the generated Brainfuck code.

Command Line Arguments

BBLang [options...] source

• --help Prints some information about the program

• --verbose Prints some information about the compilation process

• --format format Specifies which generator to use. Supported formats are bytecode, brainfuck and assembly.

Warning

Brainfuck sometimes aint working.

Warning

Assembly 100% not working.

• --debug Launches the debugger screen (only avaliable on Windows) More info

• --output file Writes the generated code to the specified file (this option only works for brainfuck)

• --throw-errors Crashes the program whenever an exception thrown. This useful for me when debugging the compiler.

• --print-instructions Prints the generated instructions before execution

• --print-memory Prints the memory after execution

• --basepath directory Sets the path where source files will be searched for using statements

• --dont-optimize Disables all optimization

• --no-debug-info Disables debug information generation (if you compiling into brainfuck, generating debug informations will take a lots of time)

• --stack-size size Specifies the stack size

• --heap-size size Specifies the heap size

Note

For brainfuck, if you specify zero the heap will not be initialized and wherever you try to access it, it will not compile.

Note

Because of how heap represented, its size can't be larger than 126.

• --no-nullcheck Disables null check generation when dereferencing a pointer

Hello World

using "https://raw.githubusercontent.com/BBpezsgo/Interpreter/master/StandardLibrary/System.Console.bbc";

PrintLine("hello, world");

Without dependencies:

[External("stdout")]
void Print(char message);

void PrintLine(temp string message)
{
    for (int i = 0; message[i]; i++)
    {
        Print(message[i]);
    }
    Print('\r');
    Print('\n');
}

PrintLine("hello, world");

Project Structure

• /Examples Examples for using the project as a library.
• /StandardLibrary Preimplemented functions and structures and some "external function" declarations.
• /TestFiles Test files I use for testing.
• /Source The core functionality.
• /Utility The command line interface.
• /Debugger A terminal based debugger.

Project Dependencies

Core Library

• System.Collections.Immutable

Note

With .NET 9 this is already installed.

Command Line Utility

• Core
• Debugger
• CommandLineParser

Debugger

• Core

Unity

• Import the /Unity/package.json to the Unity project.
• Make sure to make a symlink to the Sources directory. Run this inside the /Unity directory:

ln -s ../Source Runtime

Note

If you are on Windows, move and rename the /Source directory to /Unity/Runtime.

• Inside Unity, naviage to Edit > Project Settings... > Player > Other Settings > Scripting Define Symbols and add the UNITY variable.
• If you are using the Burst compiler, add UNITY_BURST too.
• If you are not using the Burst compiler, remove the Unity.Burst reference from /Unity/BBLang.asmdef.
• If you want some profiler analytics, add UNITY_PROFILER too.
• You can install the necessary NuGet packages with this tool: NuGetForUnity or import the dll-s manually.

Tests

Troubleshooting

api-ms-win-crt-string-l1-1-0.dll Missing Error

install this