Difference between revisions of "Getting Started"

Latest revision as of 19:58, 22 December 2024

This page has moved to the Luanti Developer Wiki

@@ 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 game 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'''.
-* Minetest supports running various '''[[games]]''', which is '''the''' core feature of Minetest
-* Most games (but not all!) have a sandbox gameplay focused on construction, mining and creativity
-* The default game is [[Games/Minetest Game|Minetest Game]], but '''[https://content.minetest.net/packages/?type=game 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 game.
-== Getting Minetest ==
-=== Windows ===
-* [http://www.minetest.net/downloads/ 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>.
-** If you want a desktop shortcut or the like, just make create a shortcut to this executable.
-Here is the directory structure you should have:
-<pre>
-minetest/
-├── bin/
-├── builtin/
-├── client/
-├── doc/
-├── fonts/
-├── games/
-├── locale/
-├── mods/
-└── textures/
-</pre>
-Once you run Minetest, some more folders like the <code>worlds/</code> folder will be created.
-=== 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:
-<pre>brew install minetest
-brew linkapps</pre>
-=== GNU/Linux Installation ===
-* If you are on a distribution with up to date enough repositories, you can install Minetest from your package manager.
-* If you are on Debian, Ubuntu or derivative, you can use:
-<pre>sudo apt-get install minetest</pre>
-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
-* On some Linux-systems, you can also install Minetest as a [https://snapcraft.io/docs/getting-started SNAP]-package, see [https://snapcraft.io/minetest snap-store]. Such a SNAP-installation would be separate from a minetest-version installed via apt or compiled, with its files, mods, worlds, screenshots etc. stored under <code>~/snap/minetest/</code>. That means, you could have eg. an old 0.4.x and a new 0.5.x version both ready to play on your pc.
-* Minetest can also be install from the [https://flathub.org/apps/details/net.minetest.Minetest Flatpak package], see also [https://flatpak.org/setup/ Quick Setup] for more information on setting up Flatpak. The configuration file(minetest.conf, mods, world, etc.) will be saved under <code>~/.var/app/net.minetest.Minetest/.minetest</code>.
-<pre>
-$ sudo apt update
-$ sudo apt install flatpak
-(GNOME) $ sudo apt install gnome-software-plugin-flatpak
-(KDE)   $ sudo apt install plasma-discover-backend-flatpak
-$ flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
-(Reboot the system)
-$ flatpak install flathub net.minetest.Minetest
-or Search "Minetest" and install from Gnome Software / Discover.
-</pre>
-=== 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 [[Games/Minetest Game|Minetest Game]]. Read [[How to build your first house]] for your first steps in Minetest Game.
-There is also an unofficial [[Games/Tutorial|Tutorial]] for an interactive introduction into Minetest in general.
-You can also choose to install other [[Games|games]]. We recommend this, because games 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.
-'''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 game which is aimed towards complete newbies, see [[Games/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 [[Games/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]]

Difference between revisions of "Getting Started"

Latest revision as of 19:58, 22 December 2024

Navigation menu

Search