craftguide/README.md

79 lines
2.2 KiB
Markdown
Raw Normal View History

# ![Preview1](http://i.imgur.com/fIPNYkb.png) Crafting Guide
2016-02-21 00:42:52 +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**.
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`.
`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.
![Preview2](https://i.imgur.com/bToFH38.png)
2018-12-16 23:20:54 +01:00
---
## API
### Custom recipes
#### Registering a custom crafting type
2018-12-16 23:20:54 +01:00
```Lua
craftguide.register_craft_type("digging", {
description = "Digging",
icon = "default_tool_steelpick.png",
2018-12-16 23:20:54 +01:00
})
```
#### Registering a custom crafting recipe
2018-12-16 23:20:54 +01:00
```Lua
craftguide.register_craft({
type = "digging",
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"},
})
```
### Progressive mode
2019-01-22 01:51:17 +01:00
#### `craftguide.add_progressive_filter(name, function(recipes, player))`
This function adds a recipe filter when progressive mode is enabled.
The default `craftguide` filter will still be used.
The 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":
```lua
2019-01-22 01:51:17 +01:00
craftguide.add_progressive_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
end
end
return filtered
end)
```
2019-01-22 01:51:17 +01:00
#### `craftguide.set_progressive_filter(name, function(recipes, player))`
This function sets an unique recipe filter when progressive mode is enabled.
The default `craftguide` progressive filter will be overridden.
#### `craftguide.get_progressive_filters()`
This function returns all progressive filters that are applied to recipes in progressive mode.