Difference between revisions of "Getting Started"

From Luanti Wiki
Jump to navigation Jump to search
(Replaced content with "[https://dev.luanti.org/getting-started/ This page has moved to the Luanti Developer Wiki]")
Tag: Replaced
 
(15 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Languages}}
+
[https://dev.luanti.org/getting-started/ This page has moved to the Luanti Developer Wiki]
Welcome to [[Minetest]]! This page explains what Minetest is all about, how to get it, and how to start playing your first games alone or online.
 
 
 
== “What is this strange ‘Minetest’ thing I keep hearing about?” ==
 
[[File:Desert_at_sunset_0.4.7.png|thumb|300px|Screenshot of Minetest Game, a subgame for Minetest]]
 
* '''[[Minetest]]''' is a program on which you can play many '''games''' which are set in a '''world entirely made out of blocks'''.
 
* You can play '''offline or online'''.
 
* '''[[Subgames]]''' is ''the'' core feature of Minetest. ''Subgames'' are games you can play in Minetest.
 
* Most subgames (but not all!) have a sandbox gameplay focused on construction, mining and creativity
 
* The default subgame is [[Subgames/Minetest Game|Minetest Game]], but '''[[List of Subgames|there are many more]]'''.
 
* You can install '''[[mods]] to modify''' certain '''aspects of gameplay'''. Mods are an '''inherent''' part of Minetest.
 
* '''Mods work out of the box when playing on [[server]]s''', no additional installations required. Mods are server-side, everything is handled automatically.
 
* The name “Minetest” ''only'' refers to the game engine. The name “Minetest Game” ''only'' refers to the default subgame.
 
 
 
== Getting Minetest ==
 
=== Windows ===
 
* [http://minetest.net/download#windows_xp_vista_7_8_81 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 <code>C:\Minetest\</code>, <code>C:\Games\Minetest\</code> or <code>%USERPROFILE%\Documents\Minetest\</code>. It doesn't matter where, as long as you have read/write access. '''Do NOT save to <code>C:\Program Files\</code> or similar, as it will cause problems (no write access).'''
 
* To run Minetest, open the extracted directory and look for the <code>bin</code> (binary) directory. Inside the <code>bin</code> directory is the Minetest executable, <code>minetest.exe</code>.
 
 
 
Here is the directory structure you should have:
 
<pre>
 
minetest/
 
├── 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/
 
</pre>
 
<!--As installed by the build for Windows minetest-0.4.12_MSVC compiled by Krock, 2015-04-07-->
 
 
 
=== OS X ===
 
* [http://minetest.net/download#osx 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.
 
Or use Homebrew to install the latest stable version:
 
<big><source lang="bash">brew install minetest
 
brew linkapps</source></big>
 
 
 
=== GNU/Linux Installation ===
 
 
 
* If you can, download the version [http://minetest.net/download#linux already compiled] for your distribution of GNU/Linux. If you can't find one, you can compile it yourself from [https://github.com/minetest/minetest here]. In this case, you should also install a so-called [[Subgames|subgame]].
 
 
 
* If you are on Debian, Ubuntu or derivative, you can also use:
 
<big><source lang="bash">sudo apt-get install minetest</source></big>
 
 
 
This may however give you an outdated version, see the pages below for information on versions available:
 
 
 
[https://packages.debian.org/search?keywords=minetest <code>minetest</code> on packages.debian.org]<br />
 
[http://packages.ubuntu.com/search?keywords=minetest <code>minetest</code> on packages.ubuntu.com]
 
 
 
* You can also try to compile Minetest from the latest source on GitHub using this [http://forum.minetest.net/viewtopic.php?f=3&t=3837 one-line script] for installing/compiling Minetest Git, for Debian / Ubuntu / Mint
 
 
 
 
 
=== Folder structure according to CMakeLists.txt ===
 
based on the building scripts in [https://github.com/minetest/minetest/blob/master/CMakeLists.txt CMakeLists.txt on github]
 
 
 
{|class="wikitable sortable"
 
!'''DirVariable'''
 
!'''WIN32'''
 
!'''APPLE'''
 
!'''UNIX/Linux/BSD  RUN_IN_PLACE'''
 
!'''UNIX/Linux/BSD'''
 
!'''Description'''
 
|-
 
| SHAREDIR|| <big>'''.'''</big> ||${BUNDLE_NAME}/Contents/Resources|| <big>'''.'''</big> ||${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|| <big>'''.'''</big> ||${DOCDIR}|| <big>'''.'''</big> ||${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 <br />
 
the "BUNDLE_PATH" is set to "${BUNDLE_NAME}"
 
 
 
 
 
== Playing ==
 
 
 
Now that you have it installed you can either; play singleplayer, play on a local server or play online by connecting to a server.
 
 
 
=== Play Singleplayer ===
 
 
 
To play singleplayer, simply '''create''' a [[world]], select a [[map generator]] (optional) and click '''Play'''. By default, you start in [[Subgames/Minetest Game|Minetest Game]]. Read [[How to build your first house]] for your first steps in Minetest Game.
 
 
 
There is also an unofficial [[Subgames/Tutorial|Tutorial]] for an interactive introduction into Minetest in general.
 
 
 
You can also choose to install other [[Subgames|subgames]] (which are essentially different ''games''). We recommend, because subgames is one of ''the'' key features in Minetest; if you only look at Minetest Game, you will be missing out on a lot of other interesting creations from the community.
 
 
 
=== Play Online ===
 
 
 
[[File:Password.PNG|thumb|250px|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.
 
[https://forum.minetest.net/viewforum.php?f=10 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 <code>redcrab.suret.net</code> or <code>64.3.4.1</code>. The port is a whole number between 1 and 65535.
 
 
 
After choosing a server and selecting it, you must enter a username and password.<br/>
 
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 [https://github.com/minetest/minetest/issues/1943 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''': [[Punching|Punch]], [[Mining|mine]] [[blocks]], move an [[item stack]] in an [[inventory]]
 
* '''Right mouse button''': [[Using|use]] (e.g. open [[chest]] or [[furnace]]), [[Building|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 [[Sneaking|sneak]] (walk slower, prevents falling off ledges)
 
 
 
=== Gameplay ===
 
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 [http://www.youtube.com/watch?v=cJMj8MiqjwI this video].
 
 
 
A quick-start guide for [[Subgames/Minetest Game|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:
 
* [[Inventory]]
 
* [[Tool]]
 
* [[Using]]
 
* [[Mining]]
 
* [[Building]]
 
* [[Crafting]]
 
* [[Smelting]]
 
 
 
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 [[game]]s.
 
 
 
If you want to play online, you should read the [[Server#In the server|gameplay notes for multiplayer servers]].
 
 
 
''Advanced topics:''
 
 
 
* [[Groups]]
 
* [[Liquid]]
 
* [[Light]]
 
 
 
== See also ==
 
 
 
* [[Help:Advanced Beginners Guide]]
 
 
 
{{Languages}}
 
[[Category:Tutorials]]
 

Latest revision as of 19:58, 22 December 2024