Server commands

From Minetest Wiki
Jump to: navigation, search

Server commands are special commands to the server that can be entered by any player via the chat to cause the server to do something. There are a few commands which can be issued by everyone, but some commands only work if you have certain privileges granted on the server. Use “/privs” to see your own privileges. If not noted otherwise, the commands in this article are assumed to require no privileges. This article will only cover the commands that come with Minetest 0.4.7. Mods may add additional commands; refer to the mod’s documentation or use “/help all” in this case.

Contents

Issuing a command

To issue a command, simply type it like a chat message. Alternatively, you can just press the “/” key (only in default controls) which simply opens a chatbox where the “/” has already been typed for you and then type the command right away. Although you use the chat box to issue the command, the command itself will not appear in the chat. Since every command starts with “/”, this means that ordinary chat messages can’t start with “/”; they will be interpreted as a command instead, even if such a command does not exist. You can tell wheather or not a command was successful by the server’s respone. If you see something “-!- Invalid command: /blargh” in the chat, you probably mis-spelled something. The most commands will cause the server to write you something else on the chat log for you, if successful.

General syntax

All commands start with “/”. After that, one word follows which is itself followed by some or none arguments. You’ll find the exact syntax in the command reference. In the following command reference, text enclosed in <> and [] are place-holders which have to replaced with an actual value. Arguments in <> are required whereas arguments in [] are optional.

Command reference

Quick documentation

Show short documentation of server commands and privileges; it will appear in the chat log, too. In case the help is too long, you can open the console with F10 to view everything agiain.

  • /help - Shows a list of the available commands—depending on your privileges—on the server.
  • /help <command> - Shows short description about the given command. You can view the help of a command even if you do not have the privilege to issue it.
  • /help all - Lists the available commands—depending on your privileges—on the server and a short description and syntax reference to each one.
  • /help privs - Lists all privileges on the server that could possibly be granted to players and shows a short description about each of them.

Chat

Probably these commands require the “shout” privilege to work (wiki editors: please check this!).

  • /msg <player> <message> - Send a private message <message> to <player>
  • /me <action> - Makes a text in the format “* <your name> <action>” appear in the chat log. E.g. “/me eats pizza.” leads to “* Alfred eats pizza.” (if your name is “Alfred”)

Request information

Request some information from the server; the answer from the server will also be written into the chatlog.

  • /status - Server’s Minetest version, time the server is running in seconds (called “uptime”), list of connected players and the message of the day (if it exists).
  • /mods - List of mods installed on the server.
  • /privs [player] - List of privileges granted to [player], if not specified, your own privileges.

Player actions

These commands affect the issuer of the command personally.

  • /giveme [mod:]<item> [count] - Give certain item [count] times (default: 1 times) to yourself. For a list of items to use this with, see the Item Codes page. Requires the “give” privilege.
  • /give <player> [mod:]<item> [count] - Give certain item [count] times (default: 1 times) to the player. Requires the “give” privilege.
  • /pulverize - Destroys the item currently in hand. Can be used by any player.
  • /teleport <x>,<y>,<z> - Teleport yourself to given coordinates. Requires the "teleport" privilege.
  • /teleport <x> <y> <z> - Teleport yourself to given coordinates. Requires the "teleport" privilege.
  • /teleport <target_player> - Teleport yourself to the player with the name <target_player>. Requires the "bring" privilege.

Privilege manipulation

All these commands require you to have the “privs” privilege.

  • /grant <player> <privilege> - Give the <privilege> to <player>.
  • /grant <player> all - Give all available privileges to <player>.
  • /revoke <player> <privilege> - Take away a <privilege> from <player>.
  • /revoke <player> all - Take away as much privileges as possible from <player>.

Privileges

Privilege Description
shout Can speak in chat
give Can use /give and /giveme
fly Can fly using the free_move mode
noclip Can fly through walls
interact Can interact with things and modify the world
server Can do server maintenance stuff

Examples:

Privilege Description
/grant player fly Player can fly
/revoke player fly Player can not fly

World manipulation

  • /time <time>

Set the time of day.

Value Description
0 or 24000 Midnight
4750 Sunrise
12000 Noon
18600 Sunset

(time of day = hour * 1000). Requires the “settime” privilege.

  • /set -n time_speed <speed> - Set the speed of day/night cycle where <speed> is the time speed (read as “<speed> times faster than in real life”). 72 is the default, which means a day-night cycle lasts 20 minutes by default. Requires the “server” privilege.

Server maintenance

All of these commands require the “server” privilege.

  • /shutdown - Shuts down the server. (In versions prior to 0.4.0, this can only be done by the user called "name" in the server's minetest.conf.)
  • /set <variable> - Read the server <variable> (→minetest.conf) with the given name and let the server show it to you.
  • /set <variable> <new value> - Set the existing server <variable> to the given <new value>.
  • /set -n <variable> <initial value> - Create a new server variable named <variable> and set it to <initial value>.
  • /clearobjects - Clears all objects/entities (removes all dropped items and mobs). Note this may crash the server or slow it down insanely for about 30 to 60 seconds.

Poorly documented commands

The following commands also exist in Minetest, but these need better documentation.

World manipulation

  • /spawnentity <name> - spawns entity at your position

Server maintenence

  • /auth_reload - reload authentification data

Banning and unbanning players

These commands ban/unban a certain player and apparently require the “ban” privilege.

  • /ban <player name> - ban IP of player
  • /unban <player name> - remove ban of player with the specified name
  • /unban <IP address> - remove ban of player with the specified IP address

password

Apparently these commands require the “password” privilege to work. Other than that, not much is known about these commands.

  • /setpassword <name> <password> - set given password
  • /clearpassword <name> - set empty password

Rollback

Allows to use Rollback. Requires the “rollback” privilege.

  • /rollback_check [range] [seconds] - check who has last touched a node or near it, max. [seconds] ago. (default [range]=0, default [seconds]=86400, which equals 24 hours in real time)
  • /rollback <player name> [seconds] - revert actions of a player; default for [seconds] is 60
  • /rollback :<actor name> [seconds]: - revert actions of an actor; default for [seconds] is 60
Personal tools
Namespaces
Variants
Actions
Navigation
Resources
Toolbox