Getting Started

From Minetest Wiki
Jump to: navigation, search
Languages Language: English • Deutsch • español • français • magyar • Bahasa Indonesia • 日本語 • Bahasa Melayu • português do Brasil • русский


Getting Minetest


  • Download Minetest. If you have a 64-bit version of Windows, you should use a 64-bit download, but the 32-bit build will also run on 64-bit systems. The inverse of this is not true – 64-bit builds will not run on a 32-bit Windows.
  • Extract the downloaded archive. We suggest C:\Minetest\, C:\Games\Minetest\ or %USERPROFILE%\Documents\Minetest\. It doesn't matter where, as long as you have read/write access. Do NOT save to C:\Program Files\ or similar, as it will cause problems (no write access).
  • To run Minetest, open the extracted directory and look for the bin (binary) directory. Inside the bin directory is the Minetest executable, minetest.exe.

Here is the directory structure you should have:

├── bin/
├── builtin/
│   ├── async/
│   ├── common/
│   ├── fstk/
│   ├── game/
│   └── mainmenu/
├── client/
│   ├── serverlist/
│   └── shaders/
│       ├── nodes_shader/
│       └── water_surface_shader/
├── doc/
├── fonts/
├── games/
│   ├── minetest_game/
│   └── minimal/
├── locale/ 
│   └── (lots of language folders)
├── mods/ 
└── textures/
    └── base/
        └── pack/


  • Download Minetest.
  • Extract the file. It doesn't matter where, as long as you have read write access.
  • Open the .app file in the extracted folder.

GNU/Linux Installation

  • If you can, download the version already compiled for your distribution of GNU/Linux. If you can't find one, you can compile it yourself from here. In this case, you should also install a so-called subgame.
  • If you are on Debian, Ubuntu or derivative, you can also use:
sudo apt-get install minetest

This may however give you an outdated version, see the pages below for information on versions available:

minetest on
minetest on

  • You can also try to compile Minetest from the latest source on GitHub using this one-line script for installing/compiling Minetest Git, for Debian / Ubuntu / Mint

Folder structure according to CMakeLists.txt

based on the building scripts in CMakeLists.txt on github

DirVariable WIN32 APPLE UNIX/Linux/BSD RUN_IN_PLACE UNIX/Linux/BSD Description
SHAREDIR . ${BUNDLE_NAME}/Contents/Resources . ${CMAKE_INSTALL_PREFIX}/share/${PROJECT_NAME} Directory to install data files into
BINDIR bin ${BUNDLE_NAME}/Contents/MacOS bin ${CMAKE_INSTALL_PREFIX}/bin Directory to install binaries into
DOCDIR doc ${SHAREDIR}/${PROJECT_NAME} doc ${CMAKE_INSTALL_PREFIX}/share/doc/${PROJECT_NAME} Directory to install documentation into
EXAMPLE_CONF_DIR . ${DOCDIR} . ${DOCDIR} Directory to install example config file into
MANDIR unix/man ${CMAKE_INSTALL_PREFIX}/share/man Directory to install manpages into
XDG_APPS_DIR unix/applications ${CMAKE_INSTALL_PREFIX}/share/applications Directory to install .desktop files into
APPDATADIR unix/appdata ${CMAKE_INSTALL_PREFIX}/share/appdata
ICONDIR unix/icons ${CMAKE_INSTALL_PREFIX}/share/icons Directory to install icons into
LOCALEDIR locale ${SHAREDIR}/locale locale ${CMAKE_INSTALL_PREFIX}/share/${PROJECT_NAME}/locale Directory to install l10n files into

for Apple "BUNDLE_NAME" is set to "${PROJECT_NAME}.app" where the project_name is set to minetest and
the "BUNDLE_PATH" is set to "${BUNDLE_NAME}"


Now that you have it installed you can either; play singleplayer, play on a local server or play online by connecting to a server.

Some things you may need to know

  • What Minetest is
  • Mods in Minetest are on the server side. You do not need to install any mods when connecting to a server.
  • All the content in Minetest, such as blocks and tools, come from mods.
  • Minetest usually comes with a default subgame. Roughly, a subgame in Minetest is a collection of mods which provide base content which together become a fully playable game, a sandbox or similar. Minetest usually comes bundles with a subgame called “Minetest Game”.
  • The name “Minetest” refers to the game engine, the name “Minetest Game” refers to the default subgame.

Play Singleplayer

To play singleplayer, simply create a world and click Play.

You can choose (or install) a subgame. Perhaps the unoffical Tutorial is a good starting point, it teaches the basics. See Subgames/Tutorial for a short description and a full guide on how to install and start it.

Play Online

Change password screen

Joining a multiplayer server is done in the 'Client' tab. To select a server, click its name on the server list. The address and port will be automatically filled. Some servers are not listed on the server list. Find the server's topic, and enter the address and port given into the text boxes in the client tab. An address will look like or The port is a whole number between 1 and 65535.

After choosing a server and selecting it, you must enter a username and password.
When a username first connects to a server an account for that player is created.

Accounts in Minetest are not centralized. This means that accounts are stored on each server, rather than on a central server. You do not have to use the same username as on the forums, and you do not even need to have a forum account. Using a password is strongly recommended to stop others stealing your player and causing damage. You can change your password by clicking 'change password' on pause menu (ESC).

Minetest uses SRP authentication.

Some servers require you to request for build privileges on their forum topic, as an anti-griefing measure.

Basic Controls

Most of these can be changed in the “Change Keys” menu. For a more complete list of keyboard controls, see Controls.

The default and most important controls are:

  • W/A/S/D: move
  • Space: jump
  • Left mouse button: Punch, mine blocks, move an item stack in an inventory
  • Right mouse button: use (e.g. open chest or furnace), place blocks, move one item or split items in an inventory
  • Shift+Right mouse button: place blocks
  • Middle mouse button: move 10 items in an inventory
  • Mouse wheel: select item in the hotbar
  • 0-9: select item in the hotbar
  • Q: drop block, item or tool in hand
  • I: open or close the inventory menu
  • T: open the chat window
  • Shift: descend on ladders or sneak (walk slower, prevents falling off ledges)


The basic Minetest gameplay is taught in the unofficial Tutorial which is aimed towards complete newbies, see Subgames/Tutorial for a guide on how to install and start it.

A very brief but outdated introduction into Minetest can be seen in this video.

A quick-start guide for Minetest Game can be found at How to build your first house.

The following wiki pages explain some basic Minetest concepts more or less in-depth:

As soon as you grasped the basics, you may want to look up which blocks and items are available and get an overview about farming.

Just want to build? Try creative mode!

If you want more, consider trying new mods and games.

If you want to play online, you should read the gameplay notes for multiplayer servers.

Advanced topics:

See also

Languages Language: English • Deutsch • español • français • magyar • Bahasa Indonesia • 日本語 • Bahasa Melayu • português do Brasil • русский