Skip to content
Build script for Minetest on OS X, now mostly depracated in favor of nightly builds; binaries at available at:
Branch: master
Clone or download
Latest commit 0354360 Apr 23, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
releases build latest stable or dev (closes #2) Jan 4, 2015
fpsfix.patch update share path; add patch for fps limiter bug Dec 25, 2014 fix URL for Carbone repo Apr 23, 2018
megaf_sneak.patch create Core 2-compatible binaries May 9, 2014

Script for automatically building Minetest for OS X from GitHub repo

Binaries made with this are available here

Quick start

Get Xcode (app store; older versions from download area at Apple Developer), XQuartz, Xcode Command Line Tools, and Homebrew (see below for details).

Start (or any other terminal emulator for OS X) and install the Minetest dependecies with Homebrew:

brew install cmake freetype gettext hiredis irrlicht jpeg leveldb libogg libvorbis luajit git

Then clone the mtmake-osx build scripts from GitHub and start the build process:

git clone
cd mtmake-osx
./ stable

This will compile the latest stable version of Minetest, updating the app in releases/ and creating a ZIP file with the app bundle. Finally, copy the app to /Applications/. To compile the latest development version leave "stable" away.

Get mtmake-osx from GitHub as a ZIP file

(This section only applies if you cannot clone mtmake-osx with git for some reason.)

You cannot just go to the GitHub page and right click the script and do "save as...". This just saves the html page with the script. The entire folder provided on the GitHub page is required. Download the zip file, extract it, navigate inside it with a terminal and type ./ The zip file with the application can be found in the "releases" folder.


Install these pacakges with Homebrew ("brew install"): cmake, freetype, gettext, hiredis, irrlicht, jpeg, leveldb, libogg, libvorbis, luajit

(snappy and libpng will get installed by brew automatically too.)

You need Xcode and the Xcode Command Line Tools. You should get prompted for installation of the latter if you run the build script for the first time. Alternatively, start Xcode, go to Xcode->Preferences->Downloads and install a component named "Command Line Tools".

You will also have to install XQuartz for X11 support.

If git is not installed, you can get it via Homebrew too: "brew install git"

Note that for compatibility with older CPUs (like Core 2) it is necessary to install dependencies from bottles, because those are automatically compiled by Homebrew to work on all CPUs supported by OS X Mavericks.

Hints for playing the game

  • Use two finger tap for right click

  • Use "e" for sneak/climb down (activate in 'Settings -> Change keys')

  • If you would like to start the Minetest server from a terminal, run "/Applications/ --server".

How to update dynamic libraries (rarely needed; done automatically by now)

The script (in releases/) will rebuild the libs folder. This means that dynamic libraries which the MT executable depends on will get copied into the bundle directory.

Normally this should only be necessary if the libraries your executable got linked to have a different version number than the ones already in the bundle. will copy the libraries from e.g. the Homebrew folder (/usr/local/Cellar/) into the bundle and change their install names, so that every library in the bundle will match the globally installed libraries on your system.

Note that needs an existing MT binary in minetest-git/bin/ to scan for its dynamic library dependencies! So first you need to build MT itself successfully before you can then rebuild the libs folder.

Also, don't forget to create an updated ZIP file with after running if you intend to distribute the ZIP file!

Below are some explanations for manually updating libraries without the use of Normally this should not be needed but it explains what does.

This command will create the libs directory and change library path names:

dylibbundler -x -b -d ./ \
-p @executable_path/../../libs/ -cd

(Note that this only works with an unmodified minetet binary that has not had its own link s changed by e.g. the dylibbundler invocation in itself.)

Check if all no libraries point to Homebrew Cellar direcory any more:

$ for x in *.dylib ; do otool -L $x|grep Cell; done

Update a library reference that was not updated by dylibbundler with:

$ install_name_tool -change /usr/local/Cellar/libvorbis/1.3.4/lib/libvorbis.0.dylib \
@executable_path/../../libs/libvorbis.0.dylib libvorbisfile.3.dylib
You can’t perform that action at this time.