Difference between revisions of "Modding Intro"

From Minetest Developer Wiki
Jump to navigation Jump to search
Line 6: Line 6:
  
 
== Documentation ==
 
== Documentation ==
The '''only''' official Lua API documentation is [https://github.com/minetest/minetest/blob/master/doc/lua_api.txt lua_api.txt]. You can find this file in your Minetest installation, in the <code>doc</code> directory. Use this file to look up functions, core features of the Lua API, etc. This file is maintained by the core developers of Minetest and every change to it goes through a quality control process. This document explains everything you need to know about the Lua API in concise form, but may be daunting for newbies to read. There is also (as of april 2020) a automatically [https://minetest.gitlab.io/minetest/ generated version] that might be easier to read.
 
  
For beginners, there's also an unofficial guide/tutorial into Minetest modding: The [http://rubenwardy.com/minetest_modding_book/ Minetest Modding Book]. It also includes a HTML version of lua_api.txt which is more readable.
+
=== Lua API Reference ===
  
A very basic overview is written in [[Modding Overview]].
+
The '''only''' official Lua API documentation is [https://github.com/minetest/minetest/blob/master/doc/lua_api.txt lua_api.txt]. You can find this file in your Minetest installation, in the <code>doc</code> directory. Use this file to look up functions, core features of the Lua API, etc. This file is maintained by the core developers of Minetest and every change to it goes through a quality control process. This document explains everything you need to know about the Lua API in concise form, but may be daunting for newbies to read.
 +
 
 +
There is also (as of april 2020) a automatically [https://minetest.gitlab.io/minetest/ generated version] that might be easier to read.
  
 
'''WARNING''': A huge amount of pages on this wiki regarding Lua methods and objects are extremely outdated. Ignore them for now, use lua_api.txt instead. It has been [https://forum.minetest.net/viewtopic.php?f=47&t=22469 proposed] to remove those pages as redundant.
 
'''WARNING''': A huge amount of pages on this wiki regarding Lua methods and objects are extremely outdated. Ignore them for now, use lua_api.txt instead. It has been [https://forum.minetest.net/viewtopic.php?f=47&t=22469 proposed] to remove those pages as redundant.
 +
 +
=== Tutorials ===
 +
 +
There's also an unofficial guide/tutorial into Minetest modding: The [http://rubenwardy.com/minetest_modding_book/ Minetest Modding Book].
 +
 +
A very basic overview is written in [[Modding Overview]].
  
 
== Other useful links ==
 
== Other useful links ==

Revision as of 19:43, 3 December 2020

Language: [[::Modding Intro|English]]

Minetest has a scripting API (Application Programming Interface), which is used to program mods (short for "modifications") for the game, extending its features and adding new items. This API is accessed using an easy-to-use programming language called Lua. More specifically, the version of Lua is 5.1.

The only thing you will need is basic programming knowledge. See Lua for details.

Documentation

Lua API Reference

The only official Lua API documentation is lua_api.txt. You can find this file in your Minetest installation, in the doc directory. Use this file to look up functions, core features of the Lua API, etc. This file is maintained by the core developers of Minetest and every change to it goes through a quality control process. This document explains everything you need to know about the Lua API in concise form, but may be daunting for newbies to read.

There is also (as of april 2020) a automatically generated version that might be easier to read.

WARNING: A huge amount of pages on this wiki regarding Lua methods and objects are extremely outdated. Ignore them for now, use lua_api.txt instead. It has been proposed to remove those pages as redundant.

Tutorials

There's also an unofficial guide/tutorial into Minetest modding: The Minetest Modding Book.

A very basic overview is written in Modding Overview.

Other useful links