Privileges

From Minetest Wiki
Revision as of 01:30, 19 October 2013 by Wuzzy (talk | contribs) (→‎Historic notes: fixed see also section. Really!)
Jump to navigation Jump to search

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 Minetest 0.4.7, Minetest comes with the following privileges:

  • gameplay-related
    • interact - build, mine or use blocks
    • give - can use the /give and /giveme commands
    • teleport - can use the /teleport command to teleport to certain coordinates
    • bring - can use the /teleport command to teleport to a certain 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
  • 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 “interact” and “shout” privileges using /grant and /revoke
    • ban - can ban/unban IPs and names using /ban and /unban
    • rollback - can use the rollback functionality
  • administration-related
    • server - can do server-maintenance stuff such as /shutdown, /clearobjects, /set, …

Privileges from 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. Or, if you know the mod name, refer to the mod’s documentation.

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 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 name:hashed_password:privs A real example: celeron55:CcCUjNUDVJxmXmTHj+7WKHvA9Ds:build,shout

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.

See also