The most comprehensive Crafting Guide on Minetest
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.



Custom recipes

Custom recipes are nonconventional crafts outside the main crafting grid. They can be registered in-game dynamically and have a size beyond 3x3 items.

Note: the registration format differs from the default registration format in everything. The width is automatically calculated depending where you place the commas. Look at the examples attentively.

Registering a custom crafting type (example)

craftguide.register_craft_type("digging", {
	description = "Digging",
	icon = "default_tool_steelpick.png",

Registering a custom crafting recipe (examples)

	type   = "digging",
	result = "default:cobble 2",
	items  = {"default:stone"},
	result = "default:cobble 16",
	items = {
		"default:stone, default:stone, default:stone",
		"default:stone,              , default:stone",
		"default:stone, default:stone, default:stone",

Recipes can be registered in a Minecraft-like way:

	grid = {
		"X  #",
		" ## ",
		"X  X",
	key = {
		['#'] = "default:wood",
		['X'] = "default:glass",
	result = "default:mese 3",

Multiples recipes can also be registered:

		result = "default:mese",
		items = {
			"default:mese_crystal, default:mese_crystal",
			"default:mese_crystal, default:mese_crystal",

	big = {
		result = "default:mese 4",
		items = {
			"default:mese_crystal, default:mese_crystal",
			"default:mese_crystal, default:mese_crystal",
			"default:mese_crystal, default:mese_crystal",
			"default:mese_crystal, default:mese_crystal",

Recipes can be registered from a given URL containing a JSON file (HTTP support is required¹):

	url = ""

Recipe filters

Recipe filters can be used to filter the recipes shown to players. Progressive mode is implemented as a recipe filter.

craftguide.add_recipe_filter(name, function(recipes, player))

Adds a recipe filter with the given name. The filter function should return the recipes to be displayed, given the available recipes and an ObjectRef to the user. Each recipe is a table of the form returned by minetest.get_craft_recipe.

Example function to hide recipes for items from a mod called “secretstuff”:

craftguide.add_recipe_filter("Hide secretstuff", function(recipes)
	local filtered = {}
	for _, recipe in ipairs(recipes) do
		if recipe.output:sub(1,12) ~= "secretstuff:" then
			filtered[#filtered + 1] = recipe

	return filtered

craftguide.set_recipe_filter(name, function(recipe, player))

Removes all recipe filters and adds a new one.


Removes the recipe filter with the given name.


Returns a map of recipe filters, indexed by name.

Search filters

Search filters are used to perform specific searches inside the search field. They can be used like so: <optional name>+<filter name>=<value1>,<value2>,<...>


  • +groups=cracky,crumbly: search for groups cracky and crumbly in all items.
  • sand+groups=falling_node: search for group falling_node for items which contain sand in their names.


  • If optional name is omitted, the search filter will apply to all items, without pre-filtering.
  • Filters can be combined.
  • The groups filter is currently implemented by default.

craftguide.add_search_filter(name, function(item, values))

Adds a search filter with the given name. The search function should return a boolean value (whether the given item should be listed or not).

Example function to show items which contain at least a recipe of given width(s):

craftguide.add_search_filter("widths", function(item, widths)
	local has_width
	local recipes = recipes_cache[item]

	if recipes then
		for i = 1, #recipes do
			local recipe_width = recipes[i].width
			for j = 1, #widths do
				local width = tonumber(widths[j])
				if width == recipe_width then
					has_width = true

	return has_width


Removes the search filter with the given name.


Returns a map of search filters, indexed by name.

Miscellaneous, item, show_usages)

Opens the Crafting Guide with the current filter applied.

  • player_name: string param.
  • item: optional, string param. If set, this item is pre-selected. If the item does not exist or has no recipe, use the player's previous selection. By default, player's previous selection is used
  • show_usages: optional, boolean param. If true, show item usages.


This is the table indexing the item groups by stereotypes. You can add a stereotype like so:

craftguide.group_stereotypes.radioactive = "mod:item"


If set, the mod will export all the cached recipes and usages in a JSON format to the given URL (HTTP support is required¹).

¹ Add craftguide to the secure.http_mods or secure.trusted_mods setting in minetest.conf.