ScriptKit - In-game interpreter plugin

Overview

ScriptKit is a C++ Unreal Engine plugin that enables developers to create coding-based gameplay experiences through a custom Lox-inspired language.

Games like The Farmer was Replaced & RoboMind show that there is an increased interest in games where programming is the main mechanic, whether for educational purposes or player enjoyment. For this personal project I set out to create a plugin that would make it easy for developers to create programming gameplay in Unreal Engine.

My contributions

Custum programming language: Flex

No programming game is the same. You might want for loops and custom function calls, or none at all - you might want it to be in English, or you might want it to be in your native language.

To allow the developer full customization of the language, and to gain a better understanding of programming languages & compilers I decided to make my own custom programming language from scratch. Following the Crafting Interpreters book by Robert Nystrom, I implemented a custom bytecode compiler & interpreter with variables (using std::variant & std::visit), operators, for & while loops and if-else statements as well as various standard library functions.

Video showcasing Flexlang running on the terminal with variables & statements

Unreal Engine integration

For ease of development I implemented my interpreter as a separate library, which I included as a submodule in my Unreal plugin repo.

To make the interpreter accessible & customizable to the end-user, I created a subsytem which holds the interpreter state. This exposes simple Blueprint nodes usable in Widget Blueprint UI.

For more custom behavior, I also added user-defined events that can e.g. trigger a restart of the level when the interpreter finishes executing. I also added logging interfaces that the user can attach any custom UI to.

Finally, I added UDeveloperSettings that expose things like execution speed and standard library function configurations for further control over the interpreter.

Logging interface connected to WBP UI

C++ delegates exposed to Blueprint - used to reset level

Blueprint function binding

The programmed behavior will also differ per-game. You might script a robot navigating through a maze, or a turret shooting at hordes of enemies.

To easily allow developers to add custom behavior in the language, I added support for extending the standard library with Blueprint function bindings.

All the developer has to do, is add the FunctionBindingComponent and write the name of the (pure!) Blueprint function. Using UE reflection magic, the component then automatically retrieves the UFunction, analyzes the parameter types and registers it to the interpreter, including proper error logging for incorrect parameter types.

Video showcasing Blueprint function binding to interpreter

What I Learned

This project taught me a lot about programming languages, compilers, Unreal Engine & working in large codebases.

• By building a programming language, compiler & interpreter from scratch I’ve demystified how these tools work in the tools I use day-to-day. I’ve learnt more about call stacks, call frames, assembly & data types.
• Making a custom C++ plugin for Unreal Engine has taught me more about UE and its underlying systems like Subsystems, DeveloperSettings, Delegates & Reflection.
• Working in Unreal Engine has taught me how to work in a large, existing codebase. You learn to work with both the tools that it gives you and the constraints you face.

Future Improvements

• Publishing plugin to FAB - This is a process I started, but haven’t completed yet. Will teach me more about documenting & packaging.
• Allowing further language customization - Fully switch out keywords, implement it in your native language with full Unicode support.