Server commands/pt-br

Language:	English

Os Comandos do servidor são comandos especiais para o servidor que podem ser inseridos por qualquer jogador através do bate-papo para fazer com que o servidor realize algo. Existem alguns comandos que podem ser emitidos por qualquer jogador, mas alguns outros só funcionam se o jogador possuir determinados privilégios concedidos no servidor. Use "/privs" para ver seus próprios privilégios. Para os comandos explicados nesse artigo, se não for especificado algum privilégio necessário, fica subentendido que não requer privilégio nenhum. Este artigo cobrirá apenas os comandos incorporados no Minetest 0.4.10 e no Minetest Game. Outros mods e jogos podem trazer comandos adicionais; Consulte a documentação do mod ou use o comando "/help all".

Realizando comandos

Para emitir um comando, simplesmente digite-o como uma mensagem de bate-papo ou use o console. Alternativamente, você pode simplesmente pressionar a tecla “/” (apenas nos controles padrão), que simplesmente abre uma janela de bate-papo onde o “/” já foi digitado para você e digite o comando imediatamente. O comando propriamente dito não aparecerá no chat. Como cada comando começa com “/”, isso significa que as mensagens de bate-papo comuns não podem começar com “/”; Eles serão interpretados como um comando em vez disso, mesmo se esse comando não existir. Você pode saber se um comando foi bem-sucedido ou não pela resposta do servidor. Se você vir algo como “-!- Invalid command: /blargh” no bate-papo, você provavelmente errou algo. A maioria dos comandos fará com que o servidor escreva algo mais no log de bate-papo para você, se bem-sucedido.

Sintaxe geral

Todos os comandos começam com “/”. Depois disso, segue-se uma palavra que é seguida por alguns ou nenhum argumento. Você encontrará a sintaxe exata na referência de comando que se deseja realizar. Nas referências de comandos a seguir, o texto incluído em <> e [] são títulos/rótulos de valores/dados que devem ser substituídos por um valor real. Argumentos em <> são obrigatórios, enquanto que argumentos em [] são opcionais.

Command reference of built-in commands

The commands listed here are always available, regardless of the mods and subgames you have installed

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 again.

• /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.

Player-related

Informational

• /privs [player] - List of privileges granted to [player], if not specified, your own privileges.
• /last-login [player] - Show the date and time when [player] has logged in the last time into this server (UTC time zone, ISO 8601 format). If not specified, shows your own last login time.

Chat

These commands require the “shout” privilege to work.

• /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”)

See Chat for details.

Items

For the /give and /giveme commands, a negative count will count down from 65536. This means for example that giving -1 of an itemstring will give 65535 items of that itemstring, which is also the hard size limit of a stack.

• /giveme <itemstring> [count] - Give certain item [count] times (default: 1 times) to yourself. For a list of items to use this with, see the Itemstrings page. Requires the “give” privilege.
• /give <player> <itemstring> [count] - Give certain item [count] times (default: 1 times) to the player. Requires the “give” privilege.
• /pulverize - Destroys the wielded item. Can be used by any player.

Teleportation

Teleportation is the immediate displacement of any player to a given position. All of the following commands require the “teleport” privilege.

• /teleport <x>,<y>,<z> - Teleport yourself to given coordinates.
• /teleport <target_player> - Teleport yourself to the player with the name <target_player>.
• /teleport <player> <x>,<y>,<z> - Teleports <player> to given coordinates. Also requires the “bring” privilege.
• /teleport <player1> <player2> - Teleports <player1> to <player2>. Also requires the “bring” privilege.

Minetest Game also provides the command “/home”. See #Command reference for Minetest Game commands

Moderation

Password manipulation

These commands allow to set and reset the passwords of any player and require the “password” privilege to work.

• /setpassword <player> <password> - set password of <player> to <password>
• /clearpassword <player> - make password of <player> empty

Privilege manipulation

All these commands require you to have the “privs” (to manipulate all privileges) or “basic_privs” (to manipulate “interact” and “shout” privileges) 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>.

Excluding players from server

These commands allow the user to kick, ban and unban players. Kicking a player means to remove a connected player from the server. This requires the “kick” privilege. Banning a player prevents him/her to connect to the server again. The player does not need to be connected at this time. Unbanning means to remove a ban from a player, allowing him/her to connect to the server again. The ban and unban commands require the “ban” privilege.

• /kick <player name> [reason] – Kicks the player with the name <player name>. Optionally a [reason] can be provided in text-form. This text is also shown to the kicked player.
• /ban - show list of banned players
• /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

Server-related

Informational

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

• /admin - Player name of the administrator / server operator of the server you're connected to.
• /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.

World manipulation

• /time <hours>:<minutes> - Set the time of day in the 24-hour format (0:00-23:59). Requires the “settime” privilege.
• /time <time_of_day> - Set the time of day (tod) (number between 0 and 24000). 0 tod and 24000 tod are midnight, 12000 tod is noon, 18600 tod is sunset, 4750 tod is sunrise. (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.
• /spawnentity <entity> [<X>,<Y>,<Z>] - spawns an entity of type <entity> near your position or at the X,Y,Z coordinates, if specified. Requires “give” and “interact” privileges.

Server maintenance

All of these commands require the “server” privilege.

• /shutdown - Shuts down the server.
• /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, mobs and possibly more). Note this may crash the server or slow it down to a crawl for 10 to more than 60 seconds.
• /auth_reload - Reloads auth.txt, which is the authentication data, containing privileges and Base64-scrambled passwords.
• /deleteblocks here [radius] - Removes the MapBlock the player is in, from the database. As this triggers mapgen, this might start mechanisms like mud reflow or cavegen which very likely affect mapblocks outside the specified range. 113 blocks are a safe-distance for a server with no interfering mods. Radius is an optional argument to specify the range in which MapBlocks are deleted
• /deleteblocks <pos1> <pos2> - Removes the MapBlock containing blocks inside the area from pos1 to pos2 from the database. May crash for larger areas. Warnings from above apply.

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 (not a player); default for [seconds] is 60

Command reference for Minetest Game commands

If you use Minetest Game, two additional commands are available. These commands may not be available if you use a different game. Both require the “home” privilege.

• /sethome – Set your current position as your “home point”.
• /home – Teleport yourself to your “home point”. This command does not work if you haven’t set your “home point” yet, set it with /sethome first.