A rewrite of the node_ownership Minetest mod with many new features.
Go to file
1F616EMO c9f1cf2fac Prevent saving entities
This may add lag, but stops saving entities (which lua_api.md discourages). This also eliminates areas.markPos{1,2} (which seemed to be internal) and integrates areas:setPos{1,2} with such function.
2024-11-05 20:17:13 +01:00
.github/workflows Add luacheck CI and drop node_ownership remnants (#44) 2020-06-08 21:52:11 +02:00
locale fix trailing whitespace in translatable strings 2024-09-25 20:42:09 +02:00
textures Initial commit 2013-09-02 19:16:14 -04:00
.gitignore Initial commit 2013-09-02 19:16:14 -04:00
.luacheckrc Adapt to the new version of playerfactions (#48) 2020-09-05 18:49:17 +02:00
api.lua Make smallest area concept optional (#80) 2024-10-01 17:54:47 +02:00
api.md Allow custom checks before allowing a player to protect new areas (#74) 2024-03-22 22:26:12 +01:00
async.lua Move areas:save() into async 2024-11-05 20:17:13 +01:00
chatcommands.lua Short summary print in /list_areas for admins (#72) 2024-02-24 11:46:45 +01:00
hud.lua Fix deprecated hud_elem_type field warning (#78) 2024-07-17 18:18:21 +02:00
init.lua Localize areas.startTime 2024-11-05 20:17:13 +01:00
interact.lua Minor cleanup 2020-06-04 20:36:12 +02:00
internal.lua Move areas:save() into async 2024-11-05 20:17:13 +01:00
legacy.lua Add luacheck CI and drop node_ownership remnants (#44) 2020-06-08 21:52:11 +02:00
LICENSE.txt License tweaks 2013-11-14 19:11:20 -05:00
mod.conf Add support for playerfactions mod (#37) 2019-09-21 15:33:42 +02:00
pos.lua Prevent saving entities 2024-11-05 20:17:13 +01:00
README.md Fix orthography (it's -> its) (#65) 2023-08-26 11:40:59 +02:00
settings.lua Minor cleanup 2020-06-04 20:36:12 +02:00
settingtypes.txt Make smallest area concept optional (#80) 2024-10-01 17:54:47 +02:00

Areas mod for Minetest

Dependencies

Minetest 5.0.0+ is recommended, but 0.4.16+ should work as well. Minetest 5.0.0+

Optional support for following mods:

Configuration

Open the tab Settings -> All Settings -> Mods -> areas to get a list of all possible settings.

For server owners: Check settingtypes.txt and modify your minetest.conf according to the wanted setting changes.

Tutorial

  1. Specify the corner positions of the area you would like to protect. Use one of the following commands:
  • /area_pos set and punch the two corner nodes to set them.
  • /area_pos set1/set2 and punch only the first or second corner node to set them one at a time.
  • /area_pos1/2 to set one of the positions to your current position.
  • /area_pos1/2 X Y Z to set one of the positions to the specified coordinates.
  1. Protect the selected area by running one of the following commands:
  • /set_owner <OwnerName> <AreaName> -- If you have the areas privilege.
  • /protect <AreaName> -- If you have the areas privilege or the server administrator has enabled area self-protection.

The area name is used only for informational purposes and has no functional importance.

For example: /set_owner SomePlayer Mese city

  1. You now own an area. You may now add sub-owners to it if you want to (see command /add_owner). Before using the /add_owner command you have to select the corners of the sub-area as you did in step 1.

If your markers are still around your original area and you want to grant access to your entire area you will not have to re-set them. Use /select_area to place the markers at the corners of an existing area if you've reset your markers and want to grant access to a full area.

The /add_owner command expects three arguments:

  1. The ID number of the parent area (the area that you want to add a sub-area to).
  2. The name of the player that will own the sub-area.
  3. The name of the sub-area. (can contain spaces)

For example: /add_owner 123 BobTheBuilder Diamond lighthouse

Commands

  • /protect <AreaName> -- Protects an area for yourself. (if self-protection is enabled)

  • /set_owner <OwnerName> <AreaName> -- Protects an area for a specified player. (requires the areas privilege)

  • /add_owner <ParentID> <OwnerName> <ChildName> -- Grants another player control over part (or all) of an area.

  • /rename_area <ID> <NewName> -- Renames an existing area.

  • /list_areas -- Lists all of the areas that you own, or all areas if you have the areas privilege.

  • /find_areas <Regex> -- Finds areas using a Lua regular expresion. For example, to find castles:

    /find_areas [Cc]astle
    
  • /remove_area <ID> -- Removes an area that you own. Any sub-areas of that area are made sub-areas of the removed area's parent, if it exists. If the removed area has no parent its sub-areas will have no parent.

  • /recursive_remove_areas <ID> -- Removes an area and all sub-areas of it.

  • /change_owner <ID> <NewOwner> -- Change the owner of an area.

  • /area_info -- Returns information about area configuration and usage.

  • /select_area <ID> -- Sets the area positions to those of an existing area.

  • /area_pos {set,set1,set2,get} -- Sets the area positions by punching nodes or shows the current area positions.

  • /area_pos1 [X,Y,Z|X Y Z] -- Sets area position one to your position or the one supplied.

  • /area_pos2 [X,Y,Z|X Y Z] -- Sets area position two to your position or the one supplied.

  • /areas_cleanup -- Removes all ownerless areas. Useful for cleaning after user deletion, for example using /remove_player.

  • /area_open <ID> -- Toggle open/closed the specified area for everyone.

  • /area_faction_open <ID> <faction> -- Toggle open/closed the specified area for members of the faction. Factions are created and managed by playerfactions mod.

License

Copyright (C) 2013-2017 ShadowNinja

Copyright (C) 2015-2020 various contributors

Licensed under the GNU LGPL version 2.1 or later. See LICENSE.txt and http://www.gnu.org/licenses/lgpl-2.1.txt