Difference between revisions of "FAQ"

From Luanti Wiki
Jump to navigation Jump to search
(Replaced content with "[https://dev.luanti.org/faq/ This page has moved to the Luanti Developer Wiki]")
Tag: Replaced
 
(19 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Languages|nocat=1}}
+
[https://dev.luanti.org/faq/ This page has moved to the Luanti Developer Wiki]
 
 
This is a collection of some '''frequently asked questions''' about Minetest. For technical problems, refer to [[Troubleshooting]].
 
 
 
== What is Minetest? ==
 
Minetest is a free software game engine desgined to create [https://en.wikipedia.org/wiki/Voxel voxel]-based games. A detailed description can be found at [[Minetest]].
 
 
 
== About the Engine ==
 
=== How much does Minetest cost? ===
 
Nothing. It's free.
 
 
 
=== Is Minetest a clone of Minecraft? ===
 
The very first version of Minetest was intended to replicate what Minecraft Alpha had been shown to do at the time (2010)<ref>https://fr.wikinews.org/wiki/Interview_de_Perttu_Ahola,_cr%C3%A9ateur_du_jeu_Minetest</ref>. It's goals soon diverged from Minecraft and eventually became a game engine instead.
 
 
 
=== Who created Minetest? ===
 
[[Celeron55|Perttu Ahola]] (also known as '''celeron55'''). It is currently developed by [https://github.com/orgs/minetest/people this random bunch of lunatics] as well as [https://github.com/minetest/minetest/graphs/contributors the community].
 
 
 
=== What is Minetest written in? ===
 
Minetest is written in C++ using a [[#What is Irrlicht?|forked version of the Irrlicht rendering engine]]. The game and mod API uses the [https://www.lua.org/ Lua language].
 
 
 
=== Can I change the code myself? ===
 
[https://github.com/minetest/minetest/ Yes.] Minetest is freely licensed ([https://github.com/minetest/minetest/blob/master/LICENSE.txt LGPL 2.1 and others]).
 
 
 
=== When will the next version of Minetest be released? ===
 
Check the [https://github.com/minetest/minetest/milestones GitHub milestones] for a good idea of how far along the next version is.
 
 
 
==== Why did the version change from 0.4.17.1 to 5.0.0? ====
 
Minetest switched to [https://semver.org/ semver] after 0.4.17.1 because the leading zero was never going to change. In the old versioning system 5.0.0 would be 0.5.0.0. Semver is cleaner and is an industry standard.
 
 
 
=== How do I install and run Minetest? ===
 
''See [[Getting_Started#Getting_Minetest]].''
 
 
 
=== How do I update Minetest? ===
 
This depends on your operating system and installation method. You will usually either download the newest version or run an update command. Some systems may require you to move your worlds and mods. If you are using the Git version, simply pull and compile every time you want to update.
 
 
 
=== Where and how do I find games to install? ===
 
Check out the [https://content.minetest.net/packages/?type=game Minetest ContentDB] for a list of games. You can easily install games (and other content) through the client in the '''Content''' tab ('Browse online content'). You may also manually install games you find on the forum or GitHub to the "games" folder in your Minetest data directory. For more information about games, see [[Games]].
 
 
 
=== What is Irrlicht? ===
 
Minetest uses its own [https://github.com/minetest/irrlicht fork of Irrlicht], a German rendering engine created in 2003. The fork is focused on removing old and unused code to make the engine lighter, though the goal is to replace Irrlicht entirely in the future as it is very outdated.
 
 
 
=== Why does the UI look so old? ===
 
A lot of the interface uses default [[#What is Irrlicht?|Irrlicht]] styling from before [https://github.com/minetest/minetest/blob/f0703f3/doc/lua_api.txt#L2958 form styling] was introduced. It is possible to make the UI look modern, but UI design is already a pain on its own, coupled with the quirks of the [https://github.com/minetest/minetest/blob/f0703f3/doc/lua_api.txt#L2227 formspec] system Minetest uses. A proper GUI replacement may arrive in the future.
 
 
 
=== The main menu sucks! ===
 
[https://github.com/minetest/minetest/issues/6733 We're working on it.]
 
 
 
=== I have a technical problem, how to fix this? ===
 
''See [[Troubleshooting]].''
 
 
 
=== Is Minetest multi-threaded? ===
 
Yes. Minetest's client and server run in different threads. The server also runs map generation in worker threads, although this is limited to a single thread currently due to issues (but [https://github.com/minetest/minetest/blob/eea2a97/minetest.conf.example#L2973-L2984 can be changed in settings]). The client runs mesh generation in worker threads.
 
 
 
It's rare for games to be heavily concurrent as it's not needed for smaller games - it's usually only found in MMOs. It's a lot harder to write multi-threaded gameplay logic, which is in conflict with Minetest's aim to be an easy-to-use content creation platform. There is an API for mods to run tasks in a worker thread, however.
 
 
 
=== Why is it called "Minetest"? ===
 
Minetest started as an experiment (a '''test''', if you will) to replicate '''Mine'''craft Alpha. The name stuck, and [https://forum.minetest.net/viewtopic.php?f=5&t=17133 no one can agree] [https://github.com/minetest/minetest_game/issues/2077 on a new one].
 
 
 
=== Can you add support for iOS? ===
 
We are unable to add Minetest to the App Store as there is a license conflict. The App Store's EULA contains terms that limit software freedom, which (as far as the consensus goes) conflicts with (L)GPL licenses.
 
 
 
Whilst it theoretically would be possible to distribute apps outside of the App Store, iOS is generally anti software freedom. Users would need to either pay $80 a year for a developer license and have a Mac Book, or jailbreak their phone. Neither of these things are particularly desirable.
 
 
 
So unfortunately, this isn't something we can do.
 
 
 
=== Can you add support for X platform or console? ===
 
Minetest is a volunteer project with limited time and resources. Supporting a new platform takes a lot of effort, and we're only able to officially support platforms with a core developer using it.
 
 
 
Additionally, a lot of consoles have restrictive NDAs that prevent open source software from being ported to them without resorting to homebrew. NDAs stop you from open sourcing your code, and copy-left prevents you from close sourcing Minetest.
 
 
 
Minetest is open source. We welcome contributors to port Minetest to other platforms (providing they follow the licenses, ofc). Contributors are also welcome to contribute their changes back upstream as well, providing that they're not too intrusive.
 
 
 
== Terminology ==
 
; Mod : A "module" or "modification" to a game. ''See [[Mods]].''
 
; Game : A collection of modules configured to run on the Minetest engine. ''See [[Games]].''
 
; Subgame : A legacy term for [[Games|game]].
 
; Texture pack : A set of client-side textures that overwrite included game or mod textures. ''See [[Texture Packs]].''
 
; Node : Technical name for a single cube or block.
 
; Mob : A moving creature. ''See [[Mobs]].''
 
 
 
== About Minetest Game ==
 
=== What is Minetest Game? ===
 
Minetest Game is the game currently included with Minetest, mostly intended to show features and act as a base for mods. See [[Games/Minetest Game|Minetest Game]] for more details.
 
 
 
=== Where is [insert Minecraft feature here]? ===
 
Minetest Game is not intended to replicate Minecraft in any way. Features from Minecraft may be found in mods or other games (try out [https://content.minetest.net/packages/Wuzzy/mineclone2/ Mineclone2] for a close analog of Minecraft). If you would like to play a game with Minecraft features, we recommend playing Minecraft.
 
 
 
''See also [[Differences from Minecraft]].''
 
 
 
==== Which Mineclone should I play? ====
 
[https://content.minetest.net/packages/Wuzzy/mineclone2/ Mineclone2] is the more popular and usually more stable version of Mineclone. [https://content.minetest.net/packages/kay27/mineclone5/ Mineclone5] is a fork of Mineclone2 with a fast and loose development process resulting in more features sooner, but more instability. Nearly all features from Mineclone5 end up in Mineclone2. It is worth noting that Mineclone5 worlds may be converted to Mineclone2, but not the reverse.
 
 
 
[https://git.minetest.land/Mineclonia/Mineclonia Mineclonia] is a somewhat inactive fork focused on stability. [https://forum.minetest.net/viewtopic.php?t=11467 Mineclone] (the original) was a project from 2015 intended to replicate Minecraft in Minetest, now succeeded by Mineclone2.
 
 
 
==== What is MeseCraft? ====
 
Contrary to what the name may suggest, [https://content.minetest.net/packages/MeseCraft/mesecraft/ MeseCraft] is not a Minecraft clone. It is a collection of mods intended to provide a curated, ready-to-go survival experience.
 
 
 
=== Where is all the content? No mobs? No story? ===
 
Minetest Game is not designed with a story or goal in mind. It is simply a sandbox to play in. Mods or other games provide actual gameplay content. Try looking for some on the [https://content.minetest.net/ ContentDB].
 
 
 
=== You should add [insert feature here] to Minetest Game! ===
 
Minetest Game is [https://github.com/minetest/minetest_game/issues/2710 currently in a low-development state], mostly just maintenance and bug fixes. New game features are not being considered as Minetest Game is intended to be retired from "default" status.
 
 
 
=== How does [insert item or block here] work? How do I craft it? ===
 
Refer to [[Blocks]] and [[Items]] for information on usage and crafting. You can also install a [[crafting guide]] mod to view available crafting recipes.
 
 
 
=== I was told there were dungeons. Where are they? ===
 
Make sure you enable dungeons when you create your world. They tend to spawn generally anywhere under or on the surface, you'll run into one eventually.
 
 
 
== Community ==
 
=== Where can I ask questions? ===
 
You can ask in [http://minetest.net/irc IRC (#minetest)], the [https://forum.minetest.net/ Forum], [https://discord.gg/minetest Discord], or [https://www.reddit.com/r/Minetest/ Reddit]. It is recommended to search history and archives first, many questions have already been answered.<br/>
 
Be mindful of which category (thread, channel, etc.) your question may fall under when asking on certain platforms.
 
 
 
Find out where you can get involved [https://www.minetest.net/get-involved/ here].
 
 
 
=== How do I install third-party content? ===
 
You can find all kinds of community-made content on [https://content.minetest.net/ the Minetest ContentDB]. You can find and install content from this database using "Browse online content" found in the '''Content''' tab in the main menu.
 
 
 
For manually installing content, see [[Games#Installing games|Installing Games]], [[Installing Mods|Installing Mods]], [[Maps#Installation|Installing Maps]], and [[Texture Packs#Installation|Installing Texture Packs]].
 
 
 
=== Why can't I find the mod <code>default</code> or [insert mod here]? ===
 
Some mods are part of games. Mods like <code>default</code> and <code>wool</code> are usually part of Minetest Game and are not meant to be installed as seperate mods. For a mod depending on e.g. <code>default</code> to work, you will need to use Minetest Game. Good game design practice is to prefix game-specific mods with the game name. Minetest Game is a particularly confusing case, unfortunately.
 
 
 
=== Are mods compatible with each other? ===
 
Unless otherwise noted, most mods will just work with each other (they may or may not interact perfectly). Different API implementations (such as mobs or stairs), game-specific mods, or competing content implementations may not be compatible with each other.
 
 
 
=== How do I connect to servers? Do I need a multiplayer account? ===
 
There is no globally valid multiplayer account in Minetest. For each server, you can use a different name and password. The "account" is created at first login. This way, only you can access your player and inventory on that particular server. You can always play singleplayer with no need for any username and password.
 
 
 
=== How do I make my own server? ===
 
Read [[Setting up a server]] and [[Server]]. See [[Server commands]] for a list of usual included chat commands.
 
 
 
=== How do I get an account for the Minetest Wiki? ===
 
By requesting one at https://forum.minetest.net/viewtopic.php?f=3&t=10473.
 
 
 
== Gameplay ==
 
=== How do I see my coordinates or check my FPS? ===
 
Use the <kbd>F5</kbd> key to toggle debug info (available info may differ per game or server). The top of your screen may display your FPS and coordinates, among other information. Pressing <kbd>F5</kbd> again will toggle the profiler, and then wireframe mode if the '''debug''' [[Privileges|privilege]] is possessed. A final press will toggle debug info off.
 
 
 
=== Why is my FPS so low? ===
 
There are many reasons your FPS could be low. A common culprit is having infinite viewing range enabled. Toggle it with <kbd>R</kbd> by default. You can also try decreasing your regular view range using the <kbd>-</kbd> by default (<kbd>+</kbd> to increase). Render distance is measured in nodes.
 
 
 
=== How do I enable full-screen? ===
 
On many systems your OS fullscreen key (such as <kbd>alt+F11</kbd> on Ubuntu) should work just fine. Otherwise, navigate to '''Advanced Settings''' in the '''Settings''' tab in the main menu, and go to ''Graphics > In-Game > Advanced > Fullscreen'', where you can double-click to change the value or use the '''Edit''' button. You will need to restart Minetest for this to take effect.
 
 
 
=== What are the controls? How do I change them? ===
 
''See [[Controls]].'' 
 
 
 
=== Can I use a controller or gamepad? ===
 
You'll need to use an external program to bind them. See [[Gamepads]] for more info.
 
 
 
=== Why can't I change settings in the pause screen? ===
 
Many settings require the game to reload anyway, but otherwise there simply isn't a menu implemented to do it. [https://github.com/minetest/minetest/pulls Contributions welcome].
 
 
 
=== How big is the [[Maps|map]]? ===
 
The map is a cube with a side length of 61840 [[Nodes|node]] (blocks) lengths. The map has thus a volume equal to the volume of 61840<sup>3</sup> nodes = 236,487,637,504,000 nodes.
 
The coordinates range from −30912 to 30927 in all dimensions.
 
 
 
''See also [[Coordinates]] and [[World boundaries]].''
 
 
 
=== Can I change my skin? ===
 
Skins are implemented per-game and per-world. If you'd like to change your skin in singleplayer, try using one of the [https://content.minetest.net/packages/?type=mod&q=skin many skin mods]. To change your skin on a server, use their skin mod (if any) or contact a member of management.
 
 
 
==== What format do skins use? ====
 
Minetest Game uses pre-1.8 Minecraft skins (64x32). These support regular body texture, a head overlay, 4px-wide arms, and a cape. Other skin mods implement 64x64 skin support or other formats.
 
 
 
=== How do I set my spawn point? ===
 
If you play Minetest Game, you can build a [[bed]] and sleep at night. On your next life, you will spawn on the bed.
 
 
 
Otherwise, you can find a mod (such as [https://forum.minetest.net/viewtopic.php?t=16923 this one]) or set your spawn point for ''all'' worlds using <code>static_spawnpoint = (x,y,z)</code> in your [[minetest.conf]] file.
 
 
 
=== How do I make the world flat? ===
 
Use the <code>flat</code> mapgen when creating your world and disable all the mapgen flags. If you want the world to use a single material, try the [https://content.minetest.net/packages/rdococ/really_flat/ Really Flat mod].
 
 
 
=== Can I add fancy shaders? ===
 
Minetest comes with toggleable dynamic shadows (controlled by game if needed). Post-processing with other effects is an upcoming feature. Minetest already supports third-party shaders using the <code>client/shaders</code> path, though these are somewhat limited in available information and scope.
 
 
 
=== How do I increase the brightness? ===
 
''See [[Troubleshooting#The_screen_is_too_dark]].''
 
 
 
=== How do I fly? ===
 
To fly, you first need the "fly" [[Privileges|privilege]]. Use the <kbd>K</kbd> key to toggle flying. Ascend with the jump key (default: <kbd>space bar</kbd>) and descend with the sneak key (default: <kbd>shift</kbd>).
 
 
 
See also: [[Controls/Movement modes#Fly mode]]
 
 
 
=== How do I sprint? ===
 
With default Minetest behavior you can "go fast" using the "fast" [[Privileges|privilege]] (toggled with the <kbd>J</kbd> key) and your auxilary key (default: <kbd>E</kbd>). This is a lot faster than natural sprinting. There are [https://content.minetest.net/packages/?type=mod&q=sprint some mods] and games that implement conventional sprinting.
 
 
 
See [[Controls/Movement modes#Fast mode]].
 
 
 
=== How do I find my house again? ===
 
You can keep track of your coordinates (depending on the game) using debug info (<kbd>F5</kbd>). If you want, you can teleport to coordinates using
 
/teleport x y z
 
''See [[Server commands#Teleportation]]. Requires "teleport" [[Privileges|privilege]]''.
 
 
 
In Minetest Game, you can avoid getting lost again if use <code>/sethome</code> at home to save your home position and <code>/home</code> to teleport back to it.
 
 
 
=== How do I generate a map of my world? ===
 
There are [[Programs_and_Editors#Mapping|various mapping tools]] to generate previews of your world. There is also a [https://github.com/Treer/Amidst-for-Minetest fork of Amidst] to preview biomes for a world seed.
 
 
 
=== Can I use WorldPainter with Minetest? ===
 
The author of WorldPainter has created a [https://www.worldpainter.net/files/plugins/MinetestSupport.jar Minetest plugin] for WorldPainter. Your mileage may vary.
 
 
 
=== Is there a World Edit for Minetest? ===
 
[https://content.minetest.net/packages/sfan5/worldedit/ Yes.] Check out [[Programs_and_Editors#World_editing|other editing tools]] as well.
 
 
 
=== Can I convert Minecraft worlds and content to Minetest? ===
 
Yes, there are [[Programs_and_Editors#Convert_data_from_Minecraft|some tools]] to convert Minecraft content to Minetest. Your mileage may vary.
 
 
 
== Game and Mod Development ==
 
''See [http://dev.minetest.net/Modding_FAQ Modding FAQ] on the Minetest Development Wiki.''
 
 
 
=== What language are games and mods written in? ===
 
Minetest uses the [https://www.lua.org/ Lua language] for games and mods. It is simple, light, and fast. You can find plenty of tutorials online.
 
 
 
* [https://www.tutorialspoint.com/lua/lua_overview.htm Lua guide by tutorialspoint]
 
* [https://www.youtube.com/watch?v=jUuqBZwwkQw Lua in 100 Seconds]
 
* [https://www.youtube.com/watch?v=kgiEF1frHQ8 Lua in 15 Minutes for Programmers]
 
 
 
==== How fast is Lua? ====
 
[https://programming-language-benchmarks.vercel.app/lua-vs-java Really], [https://programming-language-benchmarks.vercel.app/lua-vs-cpp really fast].
 
 
 
==== Why can't I use modern Lua features? ====
 
Minetest uses [https://luajit.org/ LuaJIT] which is based on Lua 5.1. In the future if PUC Lua ever matches JIT performance, Minetest could change to a newer version of Lua.
 
 
 
==== Can I write games or mods in [insert language here]? ====
 
If it can transpile to Lua or you connect your own interpreter, yes. [https://content.minetest.net/packages/siegment/loria/ Loria] is written in [https://fennel-lang.org/ Fennel].
 
Otherwise, support for other languages will not be made first-class. Lua is designed for embedding and we will stick to it.
 
 
 
==== I want to use this Java mod! I need Java! ====
 
Lua can easily outperform a bridge to Java in most cases. If you really need to use another language for something like heavy data crunching, Lua can natively call C/++ libraries (only usable if a mod is [[#What is mod security?|trusted]]).
 
 
 
=== What is the Minetest API? ===
 
The Minetest API gives you access to everything the engine currently has to offer. You can find the latest API reference [https://github.com/minetest/minetest/blob/master/doc/lua_api.txt here]. A ReadTheDocs version can be read [https://minetest.gitlab.io/minetest/ here].
 
 
 
=== Can mods overwrite the engine? ===
 
Minetest mods must use the engine-provided API. Unlike Minecraft, Minetest mods cannot change the engine. If you think the engine is missing a feature, consider [https://github.com/minetest/minetest/issues opening an issue] or [https://github.com/minetest/minetest/pulls write the feature yourself].
 
 
 
=== What is devtest? ===
 
[https://wiki.minetest.net/index.php?title=FAQ&action=history Development Test (devtest)] is a game for testing engine features and doing mod development. It provides a minimal set of game content along with an extensive library of content for testing engine features. It is included with the engine.
 
 
 
=== What is mod security? ===
 
Mod security prevents mods from executing insecure methods without user approval. A mod needs to be explicitly specified as HTTP to utilize the HTTP API. A mod needs to be trusted to run many OS-level methods.
 
 
 
=== How can I learn to make games and mods? ===
 
We recommend the [https://rubenwardy.com/minetest_modding_book/en/index.html Minetest Modding Book] to start.
 
 
 
=== I get an error or warning message, what does it mean? ===
 
''See [[Troubleshooting#Error messages without crashes]].''
 
 
 
=== Why can't I make other keybinds? ===
 
This is a missing feature. [https://github.com/minetest/minetest/pulls Contributions welcome].
 
 
 
=== How do I make models for my mods? ===
 
We recommend [[Using_Blender|using Blender]] to create models.
 
 
 
==== Can I use Blockbench to make models? ====
 
Yes, but you will need to export and convert your models to a [[Using_Blender#File_format_support|format Minetest supports]] using Blender. Converting animations from Blockbench is not known to work well (if at all).
 
 
 
=== Can I sell games I make with Minetest? ===
 
As long as you comply with [https://github.com/minetest/minetest/blob/master/LICENSE.txt the license], sure.
 
 
 
[[Category:About Minetest]]
 
[[Category:Languages pages]]
 

Latest revision as of 19:58, 22 December 2024