minetest.register on protection violation

This page contains unofficial, low-quality Lua API documentation and is likely to be outdated or wrong. Do not rely on it! For the official and up-to-date documentation, see Lua API Documentation.

This page has been proposed for deletion for the following reason: "Contains unofficial and potentially outdated, redundant and inconsistent Lua API information" If you don't think that this page should be deleted, please explain why on the talk page.

Syntax

minetest.register_on_protection_violation(function(pos, playername))

Description

Registers a function to be called when a player violates protection.

Example

-- Show a message to protection violators
minetest.register_on_protection_violation(function(pos, name)
  if not mymod:can_interact(pos, name) then
    local pos_string = minetest.pos_to_string(pos)
    local owner_string = mymod:get_owner_string(pos)
    minetest.chat_send_player(name, pos_string.." is protected by "..owner_string)
  end
end)

-- Damage protection violators
minetest.register_on_protection_violation(function(pos, name)
  local player = minetest.get_player_by_name(name)
  if not player then return end
  player:set_hp(math.max(player:get_hp() - 1, 0))
end)