Minetest is an open source voxel game engine with easy modding and game creation
Go to file
SmallJoker 95a9f4ab7c
Inventory: Allow InvRef:set_list with new_size >= old_size (#13497)
Fixes a regression introduced by enforced checks to work with
valid pointers within inventory actions.
2023-05-18 20:32:55 +02:00
.github Use .md extension for markdown files 2023-04-16 20:23:53 +01:00
android Android: Minor Code Improvements (#13342) 2023-04-10 23:05:01 +01:00
builtin Settings menu improvements regarding default values (#13489) 2023-05-18 20:32:26 +02:00
client Fix missing shadows when sun tilt is zero 2023-03-11 13:49:40 +01:00
clientmods/preview Add minetest.settings to CSM API and allow CSMs to provide settingtypes.txt (#12131) 2022-08-02 11:58:08 +02:00
cmake/Modules Always build locale files in CMAKE_SOURCE_DIR if building RUN_IN_PLACE (#13272) 2023-03-27 20:02:48 +02:00
doc Settings menu improvements regarding default values (#13489) 2023-05-18 20:32:26 +02:00
fonts Fully remove bitmap font support (#11863) 2022-01-08 14:53:25 +01:00
games/devtest Add min/max protocol version to minetest.get_version() (#13482) 2023-05-06 16:16:21 +01:00
lib Other minor CMake improvements 2022-10-13 23:02:11 +02:00
misc AppImageBuilder.yml: add script section and update to Jammy (#13078) 2023-04-14 13:00:20 +01:00
mods Update mods_here.txt to mention installing mods via CDB (#11876) 2022-04-29 17:15:19 +01:00
po Translated using Weblate (Russian) 2023-04-08 17:37:31 +02:00
src Inventory: Allow InvRef:set_list with new_size >= old_size (#13497) 2023-05-18 20:32:55 +02:00
textures Add setting icons 2023-05-01 17:11:41 +01:00
util Use .md extension for markdown files 2023-04-16 20:23:53 +01:00
worlds Add a worlds_here.txt file in the worlds folder and update .gitignore (#12720) 2022-10-30 16:53:31 +01:00
.clang-format Use scoped app storage on Android (#11466) 2021-10-15 18:14:48 +02:00
.clang-tidy Update clang-tidy configuration and scripts 2020-03-12 00:10:09 +01:00
.dockerignore fix: don't send the whole local context to the docker image 2021-04-02 14:40:22 +02:00
.editorconfig Add .editorconfig (#11412) 2021-07-03 23:05:15 +02:00
.gitattributes .gitattributes 2011-08-11 17:57:40 +02:00
.gitignore AppImageBuilder.yml: add script section and update to Jammy (#13078) 2023-04-14 13:00:20 +01:00
.gitlab-ci.yml Cut back on Gitlab-ci & misc pipeline updates 2022-08-15 10:47:47 +02:00
.luacheckrc Add math.round and fix vector.round (#10803) 2021-04-02 00:18:58 +02:00
.mailmap Update credits tab and mailmap 2023-03-29 23:19:11 +02:00
CMakeLists.txt Use .md extension for markdown files 2023-04-16 20:23:53 +01:00
COPYING.LESSER Added copy of LGPL-2.1 (#12950) 2022-11-16 13:09:53 -05:00
Dockerfile Add missing optional dependencies to Container Image (#12914) 2022-12-04 12:35:03 +01:00
LICENSE.txt Add setting icons 2023-05-01 17:11:41 +01:00
minetest.conf.example Update settingtypes (#13428) 2023-04-14 22:32:25 +01:00
README.md Split compilation instructions from README.md (#13457) 2023-04-25 21:02:02 +01:00

Minetest

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)

In case you downloaded the source code

If you downloaded the Minetest Engine source code in which this file is contained, you probably want to download the Minetest Game project too. See its README.txt for more information.

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

Paths

Locations:

  • 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

Compiling

Docker

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.