1
0
mirror of https://github.com/sys4-fr/server-nalc.git synced 2024-11-14 14:30:34 +01:00
server-nalc/mods/areas/README.md
2014-12-11 18:53:00 +01:00

100 lines
3.6 KiB
Markdown
Executable File

Areas mod for Minetest 0.4.8+
=============================
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Configuration
-------------
If you wish to specify configuration options, such as whether players are
allowed to protect their own areas with /protect (Disabled by default), you
should check config.lua and set the appropriate settings in your minetest.conf.
Tutorial
--------
To protect an area you must first set the corner positions of the area.
In order to set the corner positions you run:
1. "/area\_pos set" punch the two border nodes.
2. "/area\_pos set1/2" punch only the first or second border node.
3. "/area\_pos1/2" set position one or two to your current position.
4. "/area\_pos1/2 X Y Z" set position one or two to the specified coordinates.
Once you have set the border positions you can protect the area by running:
1. "/set\_owner <OwnerName> <AreaName>"
-- If you are a administrator or moderator with the "areas" privilege.
2. "/protect <AreaName>"
-- If the server administraor has enabled area self-protection.
The area name is used so that you can easily find the area that you want when
using a command like /list\_areas. It is not used for any other purpose.
For example: /set\_owner SomePlayer Diamond city
Now that you own an area you may want to add sub-owners to it. You can do this
with the /add\_owner command. Anyone with an area can use the add\_owner
command on their areas. Before using the add\_owner command you have to select
the corners of the sub-area as you did for set\_owner. 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. You can also use select\_area to place
the markers at the corners of an existing area.
The add\_owner command expects three arguments:
1. The id of the parent area. (The area that you want it to be a sub-area of)
2. The name of the player that will own the sub-area.
3. The name of the sub-area.
For example: /add\_owner 123 BobTheBuilder Diamond lighthouse
Chat commands
-------------
* /protect <AreaName>
Protects an area for yourself. (If self-protection is enabled)
* /set\_owner <OwnerName> <AreaName>
Protects an area. (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, useful after converting from node_ownership
when all areas are unnamed.
* /list\_areas
Lists all of the areas that you own.
(Or all of them if you have the "areas" privilege)
* /find\_areas <Regex>
Finds areas using a Lua regular expresion.
For example:
/find_areas [Cc]astle To find castles.
* /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. Otherwise they 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.
* /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.
License
-------
Copyright (C) 2013 ShadowNinja
Licensed under the GNU LGPL version 2.1 or higher.
See LICENSE.txt and http://www.gnu.org/licenses/lgpl-2.1.txt