Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

ForgottenRPG Build Status

ForgottenRPG is a game I am building in C# on top of a total re-write of my [unfinished] Java RPG engine.

It is not compatible with the data, as many of the XML formats have changed.

It runs a simple 'bytecode' (integer array) VM as a scripting language, with a rudimentary ASM-style language and a small compiler to morph that into acceptable code.


With NuGet, this should now work out of the box with a sensible .NET Core compiler


Completed & information

The following show the completed parts of / technical information about each main component:

  • Core information
    • Uses XML for maps, entities, etc.
    • Uses the SFML framework for rendering, audio, etc.
  • Map loading
    • Uses the Tiled map editor, but the game contains its own logic for parsing the XML.
    • Player start location loaded from map
  • Entities
    • Entities based on a component system with inter-component messaging
    • Entities can follow a predetermined path embedded in the XML of the map
    • Entities spawn location is loaded dynamically from the map
    • Entities follow A* algorithm for pathing
  • Dialog
    • Dialog is embedded inside each entity's XML, and allows an uncapped number of prompts and replies.
    • Replies may lead to different prompts (with different replies), end the discussion, or execute arbitrary VM code (See scripting)
    • Dialog does not yet have conditions but these will be implemented based on code running atop the VM
    • Dialog is presented in a GUI form and engageable through clicking on NPCs that have dialog associated
    • Dialog can be navigated through clicking replies in the GUI
  • Scripting / VM
    • Hand-written lexer / parser / code generator
    • Functions, includes, strings, all natively supported
    • Compiles into a crude assembly-style language that is then compiled into an integer-based bytecode format
      • String data can be embedded and referenced
      • Conditionals, registers, stack, and more currently functional
  • AI dialog
  • GUI
    • Contains a powerful custom GUI system
    • Components include:
      • GUI window (renders a border and background)
      • Text container (with custom text wrapping)
      • Vertical flow container (renders children one below the other; height is sum of children's height)
      • Column container (dual column, one fixed, other stretches to fill space. Height is max of both column heights)
      • Padding container (simply adds padding around child component)
  • Inventory
    • You can view your inventory with a GUI
    • You can move items around in your inventory

In development

Currently, I am working on a higher-level scripting language for the engine, primarily for fun rather than because it will be more helpful than actually implementing important game features.

You can see the progress in ScriptCompiler/, ForgottenRPG/VM/ and ScriptCompilerTests/ for CI (the first CI in the project!)

A snippet of code that currently works, compiling into the assembly and then being assembled into the byte code, is:


function void a(string str) {
    print str;


import "file1"

print "Hello, world";

func void test(int z) {
    print "Called a function";
    print z;

int x = 10;
print 5;
print "And returned!";
test(x + 5);
print "And returned again!";
a("Hello world!");
print 5 + 2 * 6 / 3 - 4 + 8 * (2 + 1) / (3 + 1 - 1);

As you can see, it's currently a fairly bare-bones primitive language.

I am hoping to move away from the stack machine to a register machine architecture for the VM, and that has already happened at a higher level (the assembly code assumes a register machine), but the assembler currently manipulates this into code for the underlying stack machine VM, which works for now.

I hope to flesh out the type system, and aim to make functions first class types and enable user type definitions.

Also on the agenda is a built-in library which is compiled with your scripts depending on which bits of it you use; this will be automatically included through a library path-style system via import statements.

The hope is that this scripting language can enable very flexible dialog, map behaviour, and AI behaviour, while also allowing specialised built-ins and syntax which would be trickier with a typical dynamic scripting language I could plug and play.

Also, it's more fun to do this from scratch than set up bindings for Lua/Python/Ruby/your favourite scripting language here.

Upcoming / planned

The following are (very broad) features I intend to implement in the future:

  • Inventory system
    • Items should be able to be on the floor, picked up, and dropped
  • NPC inventory system
    • Should use a component based system to share logic with player
    • But player should have an inventory GUI and NPCs should have a shop component accessible through dialog
  • World map
    • Going to the border of the map should move you to the world map, where you can travel to the next location or go to previous locations
    • Should load from a dynamic format
  • Combat
    • Combat with NPCs. NPCs should be able to be friendly and hostile. Hostile should engage on sight, whereas friendly will just talk to you. You may attack friendly NPCs which will turn them (and possibly their friends) hostile.
  • Companions
    • You should be able to recruit companions, who follow you around and may also have their own inventory
  • Quests
    • You should be able to see and accept quests, potentially from NPCs or events, and complete them
  • Menu
    • There should be a menu screen
    • Settings
  • Sound
    • There should be sounds for walking, ambience, etc...
  • Proper art
    • Take a look at the resources/images folder... Need I say more...
  • Saving/loading
  • Level system with abilities to level up e.g. agility, swordsmanship
  • Proper scripting language for the VM
  • Nicer NPC editor (There is an existing dialog editor in my old RPG project which I can definitely repurpose)
  • Loading screens
    • Currently everything loads instantly, but this will likely change throughout development. I will likely do a loading screen when this actually presents a problem, though keeping it in mind to avoid embedding too much loading logic too strongly into the main synchronous game loop may be a good idea.
  • ... An actual game!
    • If everything above is implemented, the only thing left to do is actually create games on top of this engine. Finally! :)
      • Though at the current rate I am developing, I'll probably die of old age before I get around to this


Currently the scripting must be done in an unpleasant assembly-style language. An example file which loops five times is shown below, along with it's compiled version (with strings embedded). This can be executed as part of dialog, and eventually as part of map triggers, and all sorts of other events.

STRING loopmsg Looping...
STRING endmsg Finished looping!
MOV r1 0
CMP r1 5

PRINT loopmsg

ADD r6 1

INC r1

PRINT endmsg

When compiled, the following form is produced:


The first few numbers contain metadata about the data stored -- lengths, locations, etc. Then follows the data (character encoded), and then finally the code follows. The preceding 34 indicates execution should begin at the 34th index.

This can be embedded where mentioned. The execution is shown below:

 Finished looping!


The default branch of the repository is on develop, since there is no stable release.


Rewrite of my other RPG in C#, but structured better. Mostly a way to procrastinate.




No releases published


No packages published