diff options
author | Lars Mueller <appgurulars@gmx.de> | 2022-06-03 13:09:03 +0200 |
---|---|---|
committer | sfan5 <sfan5@live.de> | 2022-06-05 15:20:13 +0200 |
commit | e82985c0a1b5d828cb0cbb4d76cdf7085dfec682 (patch) | |
tree | 7b314672578024b190e76197d5bd16a72053d9db /doc | |
parent | 8e5bd82c4d19c405fbb4f2592bf91ad8b110294b (diff) | |
download | minetest-e82985c0a1b5d828cb0cbb4d76cdf7085dfec682.tar.gz minetest-e82985c0a1b5d828cb0cbb4d76cdf7085dfec682.tar.bz2 minetest-e82985c0a1b5d828cb0cbb4d76cdf7085dfec682.zip |
Document itemstrings with metadata
Diffstat (limited to 'doc')
-rw-r--r-- | doc/lua_api.txt | 32 |
1 files changed, 29 insertions, 3 deletions
diff --git a/doc/lua_api.txt b/doc/lua_api.txt index 8a8030394..1efa5678e 100644 --- a/doc/lua_api.txt +++ b/doc/lua_api.txt @@ -1673,10 +1673,16 @@ these formats. ### Serialized This is called "stackstring" or "itemstring". It is a simple string with -1-3 components: the full item identifier, an optional amount and an optional -wear value. Syntax: +1-4 components: - <identifier> [<amount>[ <wear>]] +1. Full item identifier ("item name") +2. Optional amount +3. Optional wear value +4. Optional item metadata + +Syntax: + + <identifier> [<amount>[ <wear>[ <metadata>]]] Examples: @@ -1684,6 +1690,26 @@ Examples: * `"default:dirt 5"`: 5 dirt * `"default:pick_stone"`: a new stone pickaxe * `"default:pick_wood 1 21323"`: a wooden pickaxe, ca. 1/3 worn out +* `[[default:pick_wood 1 21323 "\u0001description\u0002My worn out pick\u0003"]]`: + * a wooden pickaxe from the `default` mod, + * amount must be 1 (pickaxe is a tool), ca. 1/3 worn out (it's a tool), + * with the `description` field set to `"My worn out pick"` in its metadata +* `[[default:dirt 5 0 "\u0001description\u0002Special dirt\u0003"]]`: + * analogeous to the above example + * note how the wear is set to `0` as dirt is not a tool + +You should ideally use the `ItemStack` format to build complex item strings +(especially if they use item metadata) +without relying on the serialization format. Example: + + local stack = ItemStack("default:pick_wood") + stack:set_wear(21323) + stack:get_meta():set_string("description", "My worn out pick") + local itemstring = stack:to_string() + +Additionally the methods `minetest.itemstring_with_palette(item, palette_index)` +and `minetest.itemstring_with_color(item, colorstring)` may be used to create +item strings encoding color information in their metadata. ### Table format |