Difference between revisions of "Getting Started"

From Luanti Wiki
Jump to navigation Jump to search
m
(Replaced content with "[https://dev.luanti.org/getting-started/ This page has moved to the Luanti Developer Wiki]")
Tag: Replaced
 
(30 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{Languages}}
+
[https://dev.luanti.org/getting-started/ This page has moved to the Luanti Developer Wiki]
 
 
== 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.
 
 
 
=== 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.
 
 
 
=== 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 ''[[Subgames|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  “[[Subgames/Minetest Game|Minetest Game]]”.
 
* The name “Minetest” refers to the game engine, the name “Minetest Game” refers to the default subgame.
 
 
 
=== Play Singleplayer ===
 
 
 
To [[How to build your first house|play singleplayer]], simply '''create''' a world and click '''Play'''.
 
 
 
You can choose (or install) a [[Subgames|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 ===
 
 
 
[[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