MekoLab - Mekorama Level Editor

Hello everyone!

I'd like to share a new web-based application I've been working on called MekoLab.
It's a simple tool that allows you to quickly replace blocks in Mekorama levels by editing the QR code data.

This project would not have been possible without the amazing research and reverse engineering work done by this community.
A huge thank you to everyone who contributed to the reverse engineering thread, especially the original poster, @QuantumForce .
Your research was the foundation that allowed this web app to be built.

I would also like to express my gratitude to @Gepeto who generously shared parts of the source code from Mekostudio. His code served as a reference and guide during the development of MekoLab.
If you are looking for a powerful, 3D level editor, I highly recommend visiting Mekostudio.

A special thank you to @EL797 and @Denis Nazin for their valuable help in testing earlier versions of this application.
Their feedback was essential for making improvements and fixing bugs.

A quick note of caution:
Please be careful when using this tool with unreleased block types.
The logic for some blocks, particularly the wheel block, has not been fully implemented.
Using it might cause the Mekorama game to behave unstably or even crash.

For more information about the web app, its features, and the libraries it uses, you can visit the official GitHub repository:
https://github.com/nurularifin04/mekolab

I hope you find this tool useful.

Thank you all.

Spoiler

This text was generated with assistance from Gemini AI

 

I added code so we can input the same image when a block has been changed.

Code:

event.target.value = '';

Please clear the cache for this to work, or open this and refresh.

 

Orientation 0: Imagine robot B in its normal position. Its head (eyes) is up, and its body faces forward (z+ axis). [head = up, body = front]

Orientation 1: Robot B is rotated 90 degrees ccw on the y-axis, which means its body now faces left (x+ axis) while its head remains up (y+ axis). [head = up, body = left]

What if [head = down, body = right]?
The head is down and the body faces right. From its normal position, this means the block has been rotated 180 degrees on the x-axis and then rotated another 90 degrees ccw on the y-axis.

look at the rotation on the metal wedge below. the metal cube is used as a marker.

 

There's an issue with the jsQR library, which can't read QR Code version 23. I've found the error:

Code:

alignmentPatternCenters: [6, 30, 54, 74, 102]

The correct one should be:

Code:

alignmentPatternCenters: [6, 30, 54, 78, 102]

But I can't just modify the library; I have to fork or self-host it and include the license. So it takes time.

 

jsQR has been modified, please clear your cache.

 

I received an issue on GitHub. It says the button isn't working. I'm wondering if anyone can check it in MS Edge. Thank you.

https://github.com/nurularifin04/mekolab/issues/1

 

case closed.

 

Sorry, there was a wrong font on the Fake Motor block. I've fixed it, if there's anything else wrong please let me know.

 

I'm currently working on a new code. Hopefully, it'll be completed successfully.

 

Back to Python to make it easier to create tensor/ndarray logic. The goal is to rotate all blocks.

Code:

def index_to_coord(index, size):
    sss = size * size * size
    if index >= sss:
      print(f"!!! Index ({index}) may not equal or more than Dimension ({sss}).\n")
      return
    
    ss = size * size
    x = index % size
    y = int((index % ss) / size)
    z = int(index / ss)
    return (x, y, z)
 
def coord_to_index(coord, size):
    if coord:
        x, y, z = coord
        ss = size * size
        index = x + (y * size) + (z * ss)
        return index

def transpose(coord, index_axis):
    # Default index [x, y, z] => [0, 1, 2]
    # index_axis in Array
    if coord:
        x, y, z = index_axis
        newx = coord[x]
        newy = coord[y]
        newz = coord[z]
        return newx, newy, newz

def reverse(coord, size, index_axis):
    # Default index [x, y, z] => [0, 1, 2]
    # index_axis one of them
    if coord:
        x, y, z = coord
        if index_axis == 0:
            x = size - 1 - x
        elif index_axis == 1:
            y = size - 1 - y
        elif index_axis == 2:
            z = size - 1 - z
        else:
            return
        return x, y, z

# Dimension
dim = 4

# Index in 1D Array
idx = 0

# Transpose x <--> z
tpose = [2, 1, 0]

# Reverse at x, y, z axis
xrev, yrev, zrev = [0, 1, 2]

coord = index_to_coord(idx, dim)
index = coord_to_index(coord, dim)
new_coord = transpose(coord, tpose)
new_index = coord_to_index(new_coord, dim)
yrev_coord = reverse(new_coord, dim, yrev)

print(f"Dimension = {dim}x{dim}x{dim}")
print(f"Input Index = {idx}")

print(f"\n# Coord = {coord}")
print(f"# Output Index = {index}")

print(f"\nIn/Out isEqual = {idx == index}")

print(f"\nTranspose = {tpose}")
print(f"# New Coord = {new_coord}")
print(f"# New Index = {new_index}")

print(f"\nReverse ({yrev}) y axis")
print(f"# New Rev Coord = {yrev_coord}")

# Rotation y axis
rot_90 = reverse(transpose(coord, tpose), dim, xrev)
rot_180 = reverse(reverse(coord, dim, xrev), dim, zrev)
rot_270 = reverse(transpose(coord, tpose), dim, zrev)

print("\nRotation 90")
print(f"# New Coord 90 = {rot_90}")

print("\nRotation 180")
print(f"# New Coord 180 = {rot_180}")

print("\nRotation 270")
print(f"# New Coord 270 = {rot_270}")

By the way, I'm having trouble designing a good editor interface.

The first version didn't have complete visual blocks. But I also couldn't create a 3D model yet.

I was thinking of creating a 2D visual in layers. The layers would contain 16 x 16 blocks, but the layout would be very long considering there are 16 layers.

If you have any ideas, please let me know.

List of features we'll try to include:
1. Rotate all blocks.
2. Direct link to play at play.mekorama.com
3. Merge two or more levels (as long as the author name is the same).

 

Thanks for the idea.
Unfortunately, I can't implement it right now.
Even the code above is a mess after I implement it

For 3D model, I think Mekostudio is excellent, and of course, the Mekorama application itself. MekoLab is currently intended to replace blocks that aren't available in either application.

But I don't know what the future holds.

Rotation Results, excluding orientation.