modlib/Readme.md

Modding Library (modlib)

Multipurpose Minetest Modding Library

About

No dependencies. Licensed under the MIT License. Written by Lars Mueller aka LMD or appguru(eu).

API

Mostly self-documenting code. Mod namespace is modlib or _ml, containing all variables & functions.

Configuration

Legacy

1. Configuration is loaded from <worldpath>/config/<modname>.<extension>, the following extensions are supported and loaded (in the given order), with loaded configurations overriding properties of previous ones:
   1. json
   2. lua
   3. luon, Lua but without the return
   4. conf
2. Settings are loaded from minetest.conf and override configuration values

Locations

0. Default configuration: <modfolder>/conf.lua
1. World configuration: config/<modname>.<format>
2. Mod configuration: <modfolder>/conf.<format>
3. Minetest configuration: minetest.conf

Formats

1. lua

• Lua, with the environment being the configuration object
• field = value works
• Return new configuration object to replace

2. luon

• Single Lua literal
• Booleans, numbers, strings and tables

3. conf

• Minetest-like configuration files

4. json

• Not recommended