Wuzzy/minetest_doc_items-cd2025
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Simplify the quick start guide

Browse Source
This commit is contained in:
Wuzzy 2016-10-30 13:34:04 +01:00
parent a32750360a
commit e653b365cb
1 changed files with 7 additions and 28 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
API.md
View File

@ -8,17 +8,15 @@ features!
## Quick start ## Quick start
The most common use case for using this API requires only to set some The most common use case for using this API requires only to set some
hand-written help texts for your items. There are two methods, you should hand-written help texts for your items.
generally use only the preferred method.
### Preferred The preferred way is to add the following optional fields to the
The preferred way is to add the following fields into the item definition item definition when using `minetest.register_node`, etc.:
when using `minetest.register_node`, `minetest.register_tool` or
`minetest.register_craftitem`:
* `x_doc_items_longdesc`: Long description of this item. * `x_doc_items_longdesc`: Long description of this item.
Describe here what this item is, what it is for, its purpose, etc. Describe here what this item is, what it is for, its purpose, etc.
* `x_doc_items_usagehelp`: Description of *how* this item can be used. * `x_doc_items_usagehelp`: Description of *how* this item can be used.
Only set this if needed, e.g. standard mining tools don't need this.
Example: Example:
@ -35,28 +33,9 @@ When using this method, your mod does not need additional dependencies.
See below for some recommendations on writing good help texts. See below for some recommendations on writing good help texts.
### Alternative If you need to set the help texts of nodes you don't register, or you
If the preferred method is not possible, for example, you want to add want to overwrite existing help texts, use `doc.sub.items.set_items_longdesc`
help texts for items which your mods do not register, you can use the and `doc.sub.items.set_items_longdesc` (see below).
alternative method which uses function calls.
To add your description and/or usage help to items, optionally depend on
`doc_items`, use the functions `doc.sub.items.set_items_longdesc` and
`doc.sub.items.set_items_usagehelp` in the following programming idiom:
if minetest.get_modpath("doc_items") ~= nil then
doc.sub.items.set_items.longdesc({
["example:item1"] = "Long description goes here.",
["example:item2"] = "Lour long description goes here.",
})
doc.sub.items.set_items.usagehelp({
["example:item1"] = "Describe here how this item can be used.",
["example:item2"] = "Describe here how this item can be used.",
})
end
Don't forget to read at least the documentation of these functions.
If you need more customization, read ahead. ;-) If you need more customization, read ahead. ;-)
## Concepts ## Concepts