Modding Book/Folder Structure

From Minetest Developer Wiki
Jump to: navigation, search
Minetest Modding Book
Minetest uses Lua scripts to provide modding support. This online book aims to teach you how to create your own mods, starting from the basics.
Welcome to Minetest Modding
Introduction Folder Structure Lua Scripts Nodes, Items and Crafting Node Drawtypes
Let's get interactive!

Active Block Modifiers

Player Physics Formspecs HUD
Releasing a Mod lua_api.txt lua_api.html Methods Objects



In this chapter we will learn the basic structure of a mod's folder. This is an essential skill when creating mods.

  • Mod Folders
  • Dependencies
  • Mod Packs

Mod Folders

File:modding book folder modfolder.jpg
caption Find the mod's folder

Each mod has its own folder, where all its Lua code, textures, models and sounds are placed. These folders need to be placed in a mod location, such as minetest/mods. Mods can be grouped into mod packs, which are explained below.

A "mod name" is used to refer to a mod. Each mod should have a unique mod name, which you can choose - a good mod name can describes what the mod does. Mod names can be make up of letters, numbers or underscores. The folder a mod is in needs to be called the same as the mod name.

Mod Folder Structure

Mod name (eg: "mymod")
-   init.lua - the main scripting code file, which is run when the game loads.
-   (optional) depends.txt - a list of mod names that needs to be loaded before this mod.
-   (optional) textures/ - place images here, commonly in the format modname_itemname.png
-   (optional) sounds/ - place sounds in here
-   (optional) models/ - place 3d models in here
...and any other lua files to be included by init.lua

Only the init.lua file is required in a mod for it to run on game load, however the other items are needed by some mods to perform their functionality.


The depends text file allows you to specify what mods this mod requires to run, and what needs to be loaded before this mod.



As you can see, each modname is on its own line.

Mod names with a question mark following them are optional dependencies. If an optional dependency is installed, it is loaded before the mod. However, if the dependency is not installed, the mod still loads. This is in contrast to normal dependencies, which will cause the current mod not to work if the dependency is not installed.

Mod Packs

Modpacks allow multiple mods to be packaged together, and move together. They are useful if you want to supply multiple mods to a player but don't want to make them download each one individually.

Mod Pack Folder Structure

-   modone/
-   modtwo/
-   modthree/
-   modfour/
-   modpack.txt – signals that this is a mod pack, content does not matter

Example Time

Are you confused? Don't worry, here is an example putting all of this together.

Mod Folder

-   textures/
-   -   mymod_node.png
-   init.lua
-   depends.txt




print("This file will be run at load time!")

minetest.register_node("mymod:node", {
    description = "This is a node",
    tiles = {
    groups = {cracky = 1}

Our mod has a name of "mymod". It has two text files: init.lua and depends.txt. The script prints a message and then registers a node – which will be explained in the next chapter. The depends text file adds a dependency to the default mod, which is in Minetest Game. There is also a texture in textures/ for the node.

Personal tools