2019-01-13 01:36:38 +01:00
# ![Preview1](http://i.imgur.com/fIPNYkb.png) Crafting Guide
2016-02-21 00:42:52 +01:00
2019-01-13 01:36:38 +01:00
#### `craftguide` is the most comprehensive crafting guide on Minetest.
#### Consult the [Minetest Wiki](http://wiki.minetest.net/Crafting_guide) for more details.
2016-02-21 09:52:59 +01:00
2018-12-16 23:20:54 +01:00
This crafting guide is a blue book named *"Crafting Guide"* or a wooden sign.
2016-02-21 09:52:59 +01:00
2018-12-16 23:20:54 +01:00
This crafting guide features a **progressive mode** .
2019-01-23 02:15:26 +01:00
The progressive mode is a Terraria-like system that only shows recipes you can craft
from items you ever had in your inventory. To enable it: `craftguide_progressive_mode = true` in `minetest.conf` .
2016-12-13 01:48:45 +01:00
2019-01-23 02:15:26 +01:00
`craftguide` is also integrated in `sfinv` (Minetest Game inventory). To enable it:
2018-11-11 22:24:48 +01:00
`craftguide_sfinv_only = true` in `minetest.conf` .
2018-12-16 23:20:54 +01:00
Use the command `/craft` to show the recipe(s) of the pointed node.
2019-01-13 01:36:38 +01:00
![Preview2 ](https://i.imgur.com/bToFH38.png )
2018-12-16 23:20:54 +01:00
---
2019-01-13 01:36:38 +01:00
## API
### Custom recipes
2019-02-11 01:03:48 +01:00
#### Registering a custom crafting type (example)
2019-01-13 01:36:38 +01:00
2018-12-16 23:20:54 +01:00
```Lua
craftguide.register_craft_type("digging", {
2018-12-17 19:15:28 +01:00
description = "Digging",
icon = "default_tool_steelpick.png",
2018-12-16 23:20:54 +01:00
})
```
2019-02-11 01:03:48 +01:00
#### Registering a custom crafting recipe (example)
2019-01-13 01:36:38 +01:00
2018-12-16 23:20:54 +01:00
```Lua
craftguide.register_craft({
type = "digging",
2018-12-17 19:15:28 +01:00
width = 1,
2018-12-17 01:09:32 +01:00
output = "default:cobble 2",
2018-12-16 23:20:54 +01:00
items = {"default:stone"},
})
```
2019-02-03 16:15:28 +01:00
### Recipe filters
2019-01-13 01:36:38 +01:00
2019-02-03 16:15:28 +01:00
Recipe filters can be used to filter the recipes shown to players. Progressive
mode is implemented as a recipe filter.
2019-01-13 01:36:38 +01:00
2019-02-03 16:15:28 +01:00
#### `craftguide.add_recipe_filter(name, function(recipes, player))`
2019-01-13 01:36:38 +01:00
2019-02-03 16:15:28 +01:00
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` .
2019-01-23 02:15:26 +01:00
2019-01-13 01:36:38 +01:00
Example function to hide recipes for items from a mod called "secretstuff":
```lua
2019-02-03 16:15:28 +01:00
craftguide.add_recipe_filter("Hide secretstuff", function(recipes)
2019-01-13 01:36:38 +01:00
local filtered = {}
for _, recipe in ipairs(recipes) do
2019-01-18 17:15:25 +01:00
if recipe.output:sub(1,12) ~= "secretstuff:" then
2019-01-13 01:36:38 +01:00
filtered[#filtered + 1] = recipe
end
end
2019-01-18 17:15:25 +01:00
2019-01-13 01:36:38 +01:00
return filtered
2019-01-18 17:15:25 +01:00
end)
2019-01-13 01:36:38 +01:00
```
2019-01-18 17:15:25 +01:00
2019-02-03 16:15:28 +01:00
#### `craftguide.remove_recipe_filter(name)`
2019-01-18 17:15:25 +01:00
2019-02-03 16:15:28 +01:00
Removes the recipe filter with the given name.
2019-01-18 17:15:25 +01:00
2019-02-03 16:15:28 +01:00
#### `craftguide.set_recipe_filter(name, function(recipe, player))`
2019-01-18 17:15:25 +01:00
2019-02-03 16:15:28 +01:00
Removes all recipe filters and adds a new one.
#### `craftguide.get_recipe_filters()`
Returns a map of recipe filters, indexed by name.
2019-02-11 00:01:32 +01:00
### Miscellaneous
#### `craftguide.show(player_name, item, show_usages)`
Opens the craft 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.