#Minetest mod mod

Use this file to look up functions, core features of the Lua API, etc. You can find this file in your Minetest installation, in the doc directory. To understand it, you should know what a position variable in Minetest is a table made up out of 3 values: x, y and z.The only official Lua API documentation is lua_api.txt. You should already know everything else but the line pos.y=pos.y+1. Minetest.register_node('tutorial:decowood', )

Next, create a file called a and paste in the following:

#Minetest mod mod

We are going to make a mod that adds a special kind of wood that can only be used for decoration.įirst, create a folder called tutorial in the Minetest mods folder (see Installing Mods on the Minetest Wiki). See lua_api.txt for up to date information about mod files. This file is used if there is no description in mod.conf.

description.txt - Deprecated: you should use mod.conf instead.Optional dependencies can be defined by appending a question mark to a single modname. This file is used if there are no dependencies in mod.conf. depends.txt - Deprecated: you should use mod.conf instead.Markdown page describing and explaining your mod (for example if you are using GitHub). readme.md - Not actually used by Minetest, but good practice.locale - Translation files for the clients.These will be transferred to the client and will be available for use by the mod. textures, sounds, media - Media files (textures, sounds, whatever).models - Models for entities or meshnodes.Subsequent execution depends on Minetest calling the registered callbacks. Running this script should register everything it wants to register. settingtypes.txt - Mods settings displayed in the settings menu.It should be 3:2 with a minimum size of 300x200px. screenshot.png - Screenshot of your mod (used by mod managers).Like a dependency, but no error if the mod doesn't exist. optional_depends: A comma separated list of optional dependencies. These are mods that must be loaded before this mod. depends: A comma separated list of dependencies. Further information can be put into other sentences. The first sentence should be less than 100 characters. description: A description of your mod to be shown in the Mods tab of the main menu (also used by mod managers). Allows Minetest to determine the mod name even if the folder is wrongly named. mod.conf - A key-value store of mod details:.The following describes the folder structure of a mod. In this tutorial, we will make the node tutorial:decowood.įor example, default:dirt is the unique name for dirt. In this case, the mod is called modname (name is preset by the folder name) and the block is called itemname. The name's format is like this: modname:itemname. Craftitem ( minetest.register_craftitem): A miscellaneous item.Įach Node, Tool and Craftitem needs a unique name to identify it in the API.Tool ( minetest.register_tool): A tool/weapon that can dig and damage things according to tool_capabilities.Node ( minetest.register_node): A block from the world.The type of the object is important as it plays a part in the properties of that object. There are the three types of object that can be defined in Minetest. Modding Overview Types of objects in Minetest