Difference between revisions of "Privileges"

From Minetest Wiki
Jump to navigation Jump to search
m (→‎Historic notes: fixed see also section. Really!)
(rename Minetest to Luanti)
 
(29 intermediate revisions by 8 users not shown)
Line 1: Line 1:
 +
{{Languages}}
 +
 
Every player has a set of privileges, which differ from server to server. Roughly spoken, one’s privileges determine what one is able to do and what not. Each privilege has a name (the meaning is described below). Privileges can be granted and revoked from other players by any player who has the privilege called “privs”. On a multiplayer server with a default configuration, new players start with the privileges called “interact” and “shout”. To view one’s own privileges, one can issue the [[Server commands|server command]] “/privs”.
 
Every player has a set of privileges, which differ from server to server. Roughly spoken, one’s privileges determine what one is able to do and what not. Each privilege has a name (the meaning is described below). Privileges can be granted and revoked from other players by any player who has the privilege called “privs”. On a multiplayer server with a default configuration, new players start with the privileges called “interact” and “shout”. To view one’s own privileges, one can issue the [[Server commands|server command]] “/privs”.
  
 
== Built-in privileges ==
 
== Built-in privileges ==
As of Minetest 0.4.7, Minetest comes with the following privileges:
 
* gameplay-related
 
** '''interact''' - [[Building|build]], [[Mining|mine]] or use blocks
 
** '''give''' - can use the <code>/give</code> and <code>/giveme</code> commands
 
** '''teleport''' - can use the <code>/teleport</code> command to teleport to certain [[coordinates]]
 
** '''bring''' - can use the <code>/teleport</code> command to teleport to a certain player
 
** '''fast''' - allows the player to activate fast [[Controls/Movement modes|mode]]
 
** '''fly''' - allows the player to activate fly mode
 
** '''noclip''' - allows the player to activate noclip mode
 
* chat-related
 
** '''shout''' - can [[Chat|chat]] with other people
 
* world-manipulation-related
 
** '''settime''' - can set [[Time of day|time of day]] using <code>/time</code>
 
* moderation-related
 
** '''privs''' - can set any privileges of players using <code>/grant</code> and <code>/revoke</code> (→[[Server commands#Privilege manipulation]])
 
** '''basic_privs''' - can set “interact” and “shout” privileges using <code>/grant</code> and <code>/revoke</code>
 
** '''ban''' - can ban/unban IPs and names using <code>/ban</code> and <code>/unban</code>
 
** '''rollback''' - can use the [[Rollback|rollback]] functionality
 
* administration-related
 
** '''server''' - can do server-maintenance stuff such as <code>/shutdown</code>, <code>/clearobjects</code>, <code>/set</code>, …
 
  
== Privileges from mods ==
+
As of version 5.0.0, Luanti comes with the following privileges:
[[Mods]] may make additional privileges available on the server. Issue the server command /help privs” to receive a full list (and short descriptions) of all possible privileges on the server. Or, if you know the mod name, refer to the mod’s documentation.
+
 
 +
* gameplay-related:
 +
** '''interact'''—can [[Building|build]]/[[Mining|mine]]/[[Using|use]] blocks and drop/eat/craft/use items and [[Punching|punch]] things and interact with [[Objects|objects]] and [[Player|players]]
 +
** '''give'''—can use the <code>/give</code> and <code>/giveme</code> commands
 +
** '''teleport'''—can use the <code>/teleport</code> command to teleport oneself to certain [[coordinates]] or to another [[player]]
 +
** '''bring'''—in combination with '''''teleport''''', can use the <code>/teleport</code> command to teleport any player to certain coordinates or to yet another player
 +
** '''fast'''—allows the player to activate [[Controls#Movement modes|fast mode]]
 +
** '''fly'''—allows the player to activate [[Controls#Movement modes|fly mode]]
 +
** '''noclip'''—allows the player to activate [[Controls#Movement modes|"noclip" mode]], which allows them to fly through walls
 +
* chat-related:
 +
** '''shout'''—can [[Chat|chat]] with other people
 +
* world–manipulation-related:
 +
** '''settime'''—can set [[Time of day|time of day]] using <code>/time</code>
 +
* moderation-related:
 +
** '''privs'''—can set any privileges of players using <code>/grant</code> and <code>/revoke</code> (→[[Server commands#Privilege manipulation]])
 +
** '''basic_privs'''—can set the privileges set as basic_privs in the minetest.conf (default “interact” and “shout”) using <code>/grant</code> and <code>/revoke</code>
 +
** '''kick'''—can kick players with <code>/kick</code>
 +
** '''ban'''—can ban/unban IPs and names using <code>/ban</code> and <code>/unban</code>
 +
** '''rollback'''—can use the [[Rollback|rollback]] functionality
 +
** '''protection_bypass'''—can bypass protection of blocks (e.g. can open [[Locked Chest|locked chests]] or [[Steel Door|steel doors]] of everyone)
 +
* administration-related:
 +
** '''server'''—can do server maintenance stuff such as <code>/shutdown</code>, <code>/clearobjects</code>, <code>/set</code>, …
 +
** '''debug'''—can access advanced [[debug]] features and information, such as the wirewrame in the debug screens (<kbd>F5</kbd>). It also prevents the game from restricting information in the debug screen and from restricting the “toggle block bounds” key.
 +
 
 +
== Irrevokable privileges ==
 +
 
 +
A player’s privileges may be irrevokable in certain situations. It is not possible to revoke these privileges with <code>/revoke</code> then.
 +
 
 +
In multiplayer [[server]]s, the player whose name equals the [[minetest.conf]] setting “name” automatically has all privileges and all of these are irrevokable. This is also the case for players who started a server (not a dedicated server).
 +
In [[singleplayer]], you start with '''interact''', '''shout''', '''privs''' and '''basic_privs'''. These privileges are irrevokable.
 +
 
 +
== Privileges from mods and [[Games|games]] ==
 +
=== [[Games/Minetest Game|Minetest Game]] ===
 +
* '''home'''—can use <code>/home</code> and <code>/sethome</code>.
 +
 
 +
=== Mods ===
 +
[[Mods]] may make additional privileges available on the server. Issue the server command <code>/help privs</code> to receive a full list (and short descriptions) of all possible privileges on the server.
  
 
== Server configuration ==
 
== Server configuration ==
 +
 
Using the server’s configuration files, a lot of privilege-related stuff can be manipulated.
 
Using the server’s configuration files, a lot of privilege-related stuff can be manipulated.
  
Line 34: Line 53:
 
</code>
 
</code>
  
*The player having the name in the "name" field of the [[minetest.conf|configuration]] has all privileges.
+
* The player having the name in the “name” field of the configuration has all the privileges.
** This makes the player in the local game able to do everything. The "name" field can also be used for setting the admin of the server. The extended privileges caused by this setting do not show up in /privs.
 
  
Privileges are stored in the new auth.txt file. The format of every line in that file is
+
== See also ==
<code>
 
name:hashed_password:privs
 
</code>
 
A real example:
 
<code>
 
celeron55:CcCUjNUDVJxmXmTHj+7WKHvA9Ds:build,shout
 
</code>
 
 
 
The auth.txt file is written periodically and at shutdown, so you should edit it only when the server is not running.
 
 
 
== Historic notes ==
 
As of 0.4, the “build” privilege was renamed to “interact”.
 
  
The “noclip” privilege was added in version 0.4.5. Before that, only the “fly” privilege was sufficient to fly through walls.
+
* [[Server]]
 +
* [[Server commands]]
  
== See also ==
 
*[[Server]]
 
*[[Server commands]]
 
  
 
[[Category:Server]]
 
[[Category:Server]]
[[Category:Commands]]
 

Latest revision as of 23:10, 22 October 2024

Languages Language: English • Deutsch • français • italiano • 日本語 • 中文(简体)‎

Every player has a set of privileges, which differ from server to server. Roughly spoken, one’s privileges determine what one is able to do and what not. Each privilege has a name (the meaning is described below). Privileges can be granted and revoked from other players by any player who has the privilege called “privs”. On a multiplayer server with a default configuration, new players start with the privileges called “interact” and “shout”. To view one’s own privileges, one can issue the server command “/privs”.

Built-in privileges

As of version 5.0.0, Luanti comes with the following privileges:

  • gameplay-related:
    • interact—can build/mine/use blocks and drop/eat/craft/use items and punch things and interact with objects and players
    • give—can use the /give and /giveme commands
    • teleport—can use the /teleport command to teleport oneself to certain coordinates or to another player
    • bring—in combination with teleport, can use the /teleport command to teleport any player to certain coordinates or to yet another player
    • fast—allows the player to activate fast mode
    • fly—allows the player to activate fly mode
    • noclip—allows the player to activate "noclip" mode, which allows them to fly through walls
  • chat-related:
    • shout—can chat with other people
  • world–manipulation-related:
  • moderation-related:
    • privs—can set any privileges of players using /grant and /revoke (→Server commands#Privilege manipulation)
    • basic_privs—can set the privileges set as basic_privs in the minetest.conf (default “interact” and “shout”) using /grant and /revoke
    • kick—can kick players with /kick
    • ban—can ban/unban IPs and names using /ban and /unban
    • rollback—can use the rollback functionality
    • protection_bypass—can bypass protection of blocks (e.g. can open locked chests or steel doors of everyone)
  • administration-related:
    • server—can do server maintenance stuff such as /shutdown, /clearobjects, /set, …
    • debug—can access advanced debug features and information, such as the wirewrame in the debug screens (F5). It also prevents the game from restricting information in the debug screen and from restricting the “toggle block bounds” key.

Irrevokable privileges

A player’s privileges may be irrevokable in certain situations. It is not possible to revoke these privileges with /revoke then.

In multiplayer servers, the player whose name equals the minetest.conf setting “name” automatically has all privileges and all of these are irrevokable. This is also the case for players who started a server (not a dedicated server). In singleplayer, you start with interact, shout, privs and basic_privs. These privileges are irrevokable.

Privileges from mods and games

Minetest Game

  • home—can use /home and /sethome.

Mods

Mods may make additional privileges available on the server. Issue the server command /help privs to receive a full list (and short descriptions) of all possible privileges on the server.

Server configuration

Using the server’s configuration files, a lot of privilege-related stuff can be manipulated.

There is an option in the configuration file for setting the default privileges for new players. default_privs = interact, shout

  • The player having the name in the “name” field of the configuration has all the privileges.

See also