Mindcode: a Mindustry Logic high-level language

Mindcode is a high-level language that compiles down to Mindustry Logic - mlog. Mindcode includes higher-level constructs, such as expressions, user-defined functions and control statements. Here are some examples to give you an idea how to use Mindcode:

Mindcode Source Code: Mindustry Logic:

// Binds two different units, stores them in variables and controls
// both them simultaneously by moving them around in a pattern

// Units is a system library providing functions
// for easy acquisition of units
require units;

// We'll write messages onto this block
// It is used by the units system library to output messages as well
param MESSAGES = message1;

// Finds a free unit of given type, not returning until such a unit is found
// Sets the flags of these units to a nonzero value
// Stores the acquired units in variables
poly = waitForFreeUnit(MESSAGES, "Control two units example\n", @poly, 1);
mega = waitForFreeUnit(MESSAGES, "Control two units example\n", @mega, 1);

// This is a global variable
ANGLE = 0;

while true do
    controlUnit(poly);
    controlUnit(mega);
end;

def controlUnit(unit)
    // Binds the unit stored in a variable
    ubind(unit);
    move(@thisx + 10 * sin(ANGLE), @thisy + 10 * cos(ANGLE));
    print($"Currently bound unit is ${@unit}.");
    printflush(MESSAGES);
    wait(0.8);
    ANGLE += 45;
end;

34 lines of code

set MESSAGES message1
ubind @poly
jump 9 notEqual @unit null
print "Control two units example\n"
print "No unit of type "
print @poly
print " found."
printflush MESSAGES
jump 1 always 0 0
sensor __tmp6 @unit @controlled
jump 17 equal __tmp6 0
print "Control two units example\n"
print "Looking for a free "
print @poly
print "..."
printflush MESSAGES
jump 1 always 0 0
ucontrol flag 1 0 0 0 0
set __fn3retval @unit
set poly __fn3retval
ubind @mega
jump 28 notEqual @unit null
print "Control two units example\n"
print "No unit of type "
print @mega
print " found."
printflush MESSAGES
jump 20 always 0 0
sensor __tmp6 @unit @controlled
jump 36 equal __tmp6 0
print "Control two units example\n"
print "Looking for a free "
print @mega
print "..."
printflush MESSAGES
jump 20 always 0 0
ucontrol flag 1 0 0 0 0
set __fn3retval @unit
set mega __fn3retval
set ANGLE 0
ubind poly
op sin __tmp9 ANGLE 0
op mul __tmp10 10 __tmp9
op add __tmp11 @thisx __tmp10
op cos __tmp12 ANGLE 0
op mul __tmp13 10 __tmp12
op add __tmp14 @thisy __tmp13
ucontrol move __tmp11 __tmp14 0 0 0
print "Currently bound unit is "
print @unit
print "."
printflush MESSAGES
wait 0.8
op add ANGLE ANGLE 45
ubind __fn3retval
op sin __tmp9 ANGLE 0
op mul __tmp10 10 __tmp9
op add __tmp11 @thisx __tmp10
op cos __tmp12 ANGLE 0
op mul __tmp13 10 __tmp12
op add __tmp14 @thisy __tmp13
ucontrol move __tmp11 __tmp14 0 0 0
print "Currently bound unit is "
print @unit
print "."
printflush MESSAGES
wait 0.8
op add ANGLE ANGLE 45
jump 40 always 0 0
end
print "Compiled by Mindcode - github.com/cardillan/mindcode"

71 lines of code

Bug reports, suggestions and questions are welcome at the project page.

Compiler messages:

Main file: number of reported ambiguities: 8
77 instructions before optimizations.
3 instructions eliminated by Temp Variables Elimination.
7 instructions eliminated by Dead Code Elimination (4 iterations).
2 instructions eliminated by Jump Normalization (3 iterations).
2 instructions eliminated by Jump Optimization (3 iterations).
2 instructions eliminated by Single Step Elimination (4 iterations).
10 instructions eliminated by Data Flow Optimization (3 passes, 9 iterations).
23 instructions added by Function Inlining (4 iterations).
4 function calls inlined by Function Inlining.
4 instructions updated by JumpThreading.
4 instructions eliminated by Unreachable Code Elimination.
70 instructions after optimizations.
Performance: parsed in 7 ms, compiled in 5 ms, optimized in 41 ms.

Mindcode Compiler Mlog Decompiler Schematics Builder Schematics Decompiler

Mindcode Compiler
Mlog Decompiler
Schematics Builder
Schematics Decompiler