Minetest, an open source infinite-world block sandbox game engine with support for survival and crafting. Also see https://github.com/minetest/minetest_game http://minetest.net/

DS 6106e4e72b Fix sound and particlespawner id generation (#14059) 20 hours ago
.github 0e4de28988 Try to fix VS build failures 1 week ago
android dc6452db1b Don't copy user texture packs into Android bundle (#14053) 2 days ago
builtin 7f9326805c Return texture filter settings to previous state 1 day ago
client 0ade097e99 Allow the server to control fog_distance and fog_start via the sky-api (#13448) 5 months ago
clientmods 6ec6acc539 Add `minetest.settings` to CSM API and allow CSMs to provide `settingtypes.txt` (#12131) 1 year ago
cmake 8cccd75e81 Android build via CMake (#13528) 6 months ago
doc 31ee7af3ab lua_api.md: Add tick marks to position HUD element 1 week ago
fonts 76dbd0d2d0 Fully remove bitmap font support (#11863) 1 year ago
games 7199ee4ff8 Devtest: Fix testnodes bouncy color calculation 1 week ago
lib 180ec92ef9 Remove trailing whitespace (#13505) 6 months ago
misc 8d2e1289a4 Use newer IrrlichtMt 1 month ago
mods 180ec92ef9 Remove trailing whitespace (#13505) 6 months ago
po 2bc0d76f63 Update translation files 2 weeks ago
src 6106e4e72b Fix sound and particlespawner id generation (#14059) 20 hours ago
textures 4ee32c5441 Add package update detection on Content tab (#13807) 1 month ago
util 36f4953502 Update credits for 5.8.0 release (#14017) 2 days ago
worlds fcd670e6f7 Add a worlds_here.txt file in the worlds folder and update .gitignore (#12720) 1 year ago
.clang-format aaae9d5a77 Fix `.clang-format` file config values 5 months ago
.clang-tidy 8546d6089a Update clang-tidy configuration and scripts 3 years ago
.dockerignore c4b048fbb3 fix: don't send the whole local context to the docker image 2 years ago
.editorconfig d16d1a1341 Settings GUI: Add setting dependencies (#13704) 3 months ago
.gitattributes f4856a33c9 .gitattributes 12 years ago
.gitignore 531122ee86 Add .fleet folder to gitignore (#13611) 5 months ago
.gitlab-ci.yml 570fc90bf6 Debundle Minetest Game (#13818) 3 weeks ago
.luacheckrc 83b85ba16a Rewrite the gamebar (#13768) 2 months ago
.mailmap 0a698d92c3 Update credits tab and mailmap 8 months ago
CMakeLists.txt 80c4c260ae Refactor and move `world_format.txt` to `world_format.md` (#13504) 3 weeks ago
CNAME 5949172735 Build MkDocs Lua API docs using GitHub CI, deploy to api.minetest.net (#13675) 2 months ago
COPYING.LESSER 6b6cd42ce4 Added copy of LGPL-2.1 (#12950) 1 year ago
Dockerfile 570fc90bf6 Debundle Minetest Game (#13818) 3 weeks ago
LICENSE.txt 4ee32c5441 Add package update detection on Content tab (#13807) 1 month ago
README.md 570fc90bf6 Debundle Minetest Game (#13818) 3 weeks ago
minetest.conf.example 8abb5796ed Update example conf and settings translations 2 weeks ago



Build Status Translation status License

Minetest is a free open-source voxel game engine with easy modding and game creation.

Copyright (C) 2010-2022 Perttu Ahola celeron55@gmail.com and contributors (see source file comments and the version control log)

Table of Contents

  1. Further Documentation
  2. Default Controls
  3. Paths
  4. Configuration File
  5. Command-line Options
  6. Compiling
  7. Docker
  8. Version Scheme

Further documentation

Default controls

All controls are re-bindable using settings. Some can be changed in the key config dialog in the settings tab.

Button Action
Move mouse Look around
W, A, S, D Move
Space Jump/move up
Shift Sneak/move down
Q Drop itemstack
Shift + Q Drop single item
Left mouse button Dig/punch/use
Right mouse button Place/use
Shift + right mouse button Build (without using)
I Inventory menu
Mouse wheel Select item
0-9 Select item
Z Zoom (needs zoom privilege)
T Chat
/ Command
Esc Pause menu/abort/exit (pauses only singleplayer game)
+ Increase view range
- Decrease view range
K Enable/disable fly mode (needs fly privilege)
J Enable/disable fast mode (needs fast privilege)
H Enable/disable noclip mode (needs noclip privilege)
E Aux1 (Move fast in fast mode. Games may add special features)
C Cycle through camera modes
V Cycle through minimap modes
Shift + V Change minimap orientation
F1 Hide/show HUD
F2 Hide/show chat
F3 Disable/enable fog
F4 Disable/enable camera update (Mapblocks are not updated anymore when disabled, disabled in release builds)
F5 Cycle through debug information screens
F6 Cycle through profiler info screens
F10 Show/hide console
F12 Take screenshot



  • bin - Compiled binaries
  • share - Distributed read-only data
  • user - User-created modifiable data

Where each location is on each platform:

  • Windows .zip / RUN_IN_PLACE source:
    • bin = bin
    • share = .
    • user = .
  • Windows installed:
    • bin = C:\Program Files\Minetest\bin (Depends on the install location)
    • share = C:\Program Files\Minetest (Depends on the install location)
    • user = %APPDATA%\Minetest or %MINETEST_USER_PATH%
  • Linux installed:
    • bin = /usr/bin
    • share = /usr/share/minetest
    • user = ~/.minetest or $MINETEST_USER_PATH
  • macOS:
    • bin = Contents/MacOS
    • share = Contents/Resources
    • user = Contents/User or ~/Library/Application Support/minetest or $MINETEST_USER_PATH

Worlds can be found as separate folders in: user/worlds/

Configuration file

  • Default location: user/minetest.conf
  • This file is created by closing Minetest for the first time.
  • A specific file can be specified on the command line: --config <path-to-file>
  • A run-in-place build will look for the configuration file in location_of_exe/../minetest.conf and also location_of_exe/../../minetest.conf

Command-line options

  • Use --help



We provide Minetest server Docker images using the GitLab mirror registry.

Images are built on each commit and available using the following tag scheme:

  • registry.gitlab.com/minetest/minetest/server:latest (latest build)
  • registry.gitlab.com/minetest/minetest/server:<branch/tag> (current branch or current tag)
  • registry.gitlab.com/minetest/minetest/server:<commit-id> (current commit id)

If you want to test it on a Docker server you can easily run:

sudo docker run registry.gitlab.com/minetest/minetest/server:<docker tag>

If you want to use it in a production environment you should use volumes bound to the Docker host to persist data and modify the configuration:

sudo docker create -v /home/minetest/data/:/var/lib/minetest/ -v /home/minetest/conf/:/etc/minetest/ registry.gitlab.com/minetest/minetest/server:master

Data will be written to /home/minetest/data on the host, and configuration will be read from /home/minetest/conf/minetest.conf.

Note: If you don't understand the previous commands please read the official Docker documentation before use.

You can also host your Minetest server inside a Kubernetes cluster. See our example implementation in misc/kubernetes.yml.

Version scheme

We use major.minor.patch since 5.0.0-dev. Prior to that we used 0.major.minor.

  • Major is incremented when the release contains breaking changes, all other numbers are set to 0.
  • Minor is incremented when the release contains new non-breaking features, patch is set to 0.
  • Patch is incremented when the release only contains bugfixes and very minor/trivial features considered necessary.

Since 5.0.0-dev and 0.4.17-dev, the dev notation refers to the next release, i.e.: 5.0.0-dev is the development version leading to 5.0.0. Prior to that we used previous_version-dev.