summaryrefslogtreecommitdiff
path: root/doc/lua_api.txt
diff options
context:
space:
mode:
authorraymoo <raymoo@users.noreply.github.com>2017-10-28 01:30:50 -0700
committerSmallJoker <mk939@ymail.com>2018-06-03 17:32:00 +0200
commit7b8288d605260a92693a93a85134555a8c975bb9 (patch)
tree9c14b93d6f23213f912d7e3d8f58882ba2aeeac8 /doc/lua_api.txt
parent2f969196b86a9ffd4ef3bce9b17fcfb49ec89cd2 (diff)
downloadminetest-7b8288d605260a92693a93a85134555a8c975bb9.tar.gz
minetest-7b8288d605260a92693a93a85134555a8c975bb9.tar.bz2
minetest-7b8288d605260a92693a93a85134555a8c975bb9.zip
Fix default item callbacks to work with nil users (#5819)
* Fix default item callbacks to work with nil users * item.lua: Handle node drops for invalid players The if-condition for the dropping loop is the same as `inv`, which means that the 2nd possible definition of `give_item` is never used. Remove redundant `local _, dropped_item`
Diffstat (limited to 'doc/lua_api.txt')
-rw-r--r--doc/lua_api.txt3
1 files changed, 3 insertions, 0 deletions
diff --git a/doc/lua_api.txt b/doc/lua_api.txt
index 3d461735b..d6b8fc5bb 100644
--- a/doc/lua_api.txt
+++ b/doc/lua_api.txt
@@ -2287,6 +2287,7 @@ Call these functions only at load time!
* `minetest.register_on_placenode(func(pos, newnode, placer, oldnode, itemstack, pointed_thing))`
* Called when a node has been placed
* If return `true` no item is taken from `itemstack`
+ * `placer` may be any valid ObjectRef or nil.
* **Not recommended**; use `on_construct` or `after_place_node` in node definition
whenever possible
* `minetest.register_on_dignode(func(pos, oldnode, digger))`
@@ -2992,6 +2993,7 @@ These functions return the leftover itemstack.
* Returns true, if player `name` shouldn't be abled to dig at `pos` or do other
actions, defineable by mods, due to some mod-defined ownership-like concept.
Returns false or nil, if the player is allowed to do such actions.
+ * `name` will be "" for non-players or unknown players.
* This function should be overridden by protection mods and should be used to
check if a player can interact at a position.
* This function should call the old version of itself if the position is not
@@ -4276,6 +4278,7 @@ Definition tables
^ Called after constructing node when node was placed using
minetest.item_place_node / minetest.place_node
^ If return true no item is taken from itemstack
+ ^ `placer` may be any valid ObjectRef or nil
^ default: nil ]]
after_dig_node = func(pos, oldnode, oldmetadata, digger), --[[
^ oldmetadata is in table format