From 66372e75d9b584fbb3b3fbce0de572585dd86dca Mon Sep 17 00:00:00 2001 From: SmallJoker Date: Sun, 25 Feb 2018 12:25:39 +0100 Subject: is_area_protected: Rename from intersects_protection (#7073) * is_area_protected: Rename from intersects_protection Return first protected position Clarify docs: Mods may overwrite the function --- doc/lua_api.txt | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) (limited to 'doc') diff --git a/doc/lua_api.txt b/doc/lua_api.txt index 5f06a4ccc..962a56e10 100644 --- a/doc/lua_api.txt +++ b/doc/lua_api.txt @@ -3429,9 +3429,10 @@ These functions return the leftover itemstack. * `minetest.record_protection_violation(pos, name)` * This function calls functions registered with `minetest.register_on_protection_violation`. -* `minetest.intersects_protection(minp, maxp, player_name, interval) - * Returns a boolean, returns true if the volume defined by `minp` and `maxp` - intersects a protected area not owned by `player_name`. +* `minetest.is_area_protected(pos1, pos2, player_name, interval) + * Returns the position of the first node that `player_name` may not modify in + the specified cuboid between `pos1` and `pos2`. + * Returns `false` if no protections were found. * Applies `is_protected()` to a 3D lattice of points in the defined volume. The points are spaced evenly throughout the volume and have a spacing similar to, but no larger than, `interval`. @@ -3439,6 +3440,8 @@ These functions return the leftover itemstack. * `interval` defaults to 4. * `interval` should be carefully chosen and maximised to avoid an excessive number of points being checked. + * Like `minetest.is_protected`, this function may be extended or overwritten by + mods to provide a faster implementation to check the cuboid for intersections. * `minetest.rotate_and_place(itemstack, placer, pointed_thing, infinitestacks, orient_flags)` * Attempt to predict the desired orientation of the facedir-capable node defined by `itemstack`, and place it accordingly (on-wall, on the floor, or -- cgit v1.2.3