Python logo

Technical Background

This page provides an inside view of how Miney works.

Miney’s basic idea is, to use Minetest with Python.

Minetest’s main programming language (besides C++) is Lua and it provides an mighty Lua-API for mod programming. But Lua isn’t the ideal programming language to start programming and mod programming isn’t fun, if you just want to play around with a sandbox. So we need something like an interface that is accessible by Python.

The interface

For this we’ve written the Mineysocket mod as a regular Lua mod. This mod opens a network port and receives JSON encoded commands. The most important command is the “lua” command, where it just executes the received Lua code and sends any return value back.

Miney is using this lua command to execute Lua code inside Minetest.


And you can use Miney without knowing any Lua or even seeing a single line of Lua code.

Mineysocket, Windows and the Miney distribution

Python is the language with batteries included and it ships with a very complete library for nearly everything. In contrast Lua has the batteries explicitly excluded, so there are nearly no libraries and it misses also a network library.

So we need a Lua extension for networking, thats luasocket. And an extension for JSON, thats lua-cjson

Under Linux this should be no big deal, just install these packages (most distributions provide them) and you are ready to go.


It isn’t that easy for Minetest on Windows. The Minetest binary’s where compiled with Visual Studio and the extension has to be linked against minetest also with the same version of Visual Studio. So the best way under windows is, to compile Minetest and the Lua extensions by yourself with the same Visual Studio.

And when we already do this, why not replace Lua with lua-jit for more speed?

And when we’ve done all this, why not also bundle a actual python interpreter? And why not preinstall Miney in this interpreter? Now it would be nice to have a comfortable launcher.

We’ve done all this for windows and we call it Miney Distibution.