Comandos

Comandos são um método a partir do qual os operadores do servidor podem administrar os seus servidores, e ainda com que os jogadores podem interagir com o servidor.

No Sponge, os comandos seguem um sistema de permissões. Permissões permitem que os donos dos servidores controlem quem acede a que comandos. Por pré-definição, os jogadores com estatuto OP têm acesso a todos os comandos. Jogadores sem estatuto de operador não têm acesso a comandos administrativos ou a comandos que requeiram um nó de permissão. Um operador do servidor pode definir quem tem acesso a que comandos adicionando/negando nós de permissões, com o auxílio de um plugin de permissões.

Nota

O Sponge não é um plugin de gestão de permissoões. Para adicionar ou retirar permissões a jogadores individuais ou a grupos, você precisa de um plugin de gestão de permissões.

Comandos de Operadores

Estes comandos, para além dos comandos normais do jogador, estão disponíveis para os operadores do servidor.

Sponge

Os seguintes comandos estão disponíveis para os jogadores com o estatuto de operador (ou o nó de permissão correto) em servidores com o Sponge.

Comando

Descrição

Permissão

/sponge audit

Força o carregamento das classes que não foram carregadas para ativar o debugging dos mixins.

sponge.command.audit

/sponge chunks

Imprime dados da chunck para um mundo, uma dimensão, ou globalmente.

sponge.command.chunks

/sponge config

Altera uma configuração global, de mundo ou de dimensão.

sponge.command.config

/sponge heap

Faz um dump do heap da JVM.

sponge.command.heap

/sponge plugins

Lista os plugins instalados no momento.

sponge.command.plugins

/sponge plugins reload

Pede aos plugins que executem as suas rotinas de reload.

sponge.command.plugins.reload

/sponge reload

Recarrega a configuração do mundo, da dimensão ou global.

sponge.command.reload

/sponge save

Grava a configuração do mundo, da dimensão ou global.

sponge.command.save

/sponge timings

O comando principal para o módulo de timings.

sponge.command.timings

/sponge tps

Mostra as ticks por segundo de cada mundo.

sponge.command.tps

/sponge version

Imprime as versões do Sponge/SpongeAPI na consola.

sponge.command.version


Parâmetros dos Comandos do Sponge

  • /sponge chunks [-g] [-d dim] [-w world]

  • /sponge config [-g] [-d dim] [-w world] key value

  • /sponge save [-g] [-d dim|*] [-w world|*]

  • /sponge save [-g] [-d dim|*] [-w world|*]

Nota

O comando /sponge audit força o carregamento de quaisquer classes que ainda não tenham sido carregadas, permitindo que se visualize todo o output das variáveis de ambiente de debugging dos mixins. Isto também requer a variável ´´mixins.checks´´, vê a *Mixin wiki* para mais informação.

Dica

Aqui estão alguns exemplos do comando ´´sponge config´´ em ação. Por favor, vê Configurando o Sponge para uma explicação mais detalhada.

  1. /sponge config logging.chunk-load true

Como não foi especificada qualquer dimensão, a dimensão afetada é aquela em que o ´´sender´´ (o jogador) se encontra. Por isso, se estivesses numa dimensão ´´mystcraft´´, isto alteraria a configuração da dimensão ´´mystcraft´´.

  1. /sponge config -d nether logging.chunk-load true

Como foi especificado um tipo de dimensão, isto alteraria a configuração da dimensão nether (e por isso de todos os mundos nether).

  1. /sponge config -w DIM1 logging.chunk-load true

Isto alteraria a configuração do mundo chamado DIM1.

Timings

Os Timings são uma ferramenta constituinte do Sponge que permitem aos administradores dos servidores monitorizarem o desempenho dos seus servidores. Os Timings vão recolhendo informação sobre um servidor de tal modo que um relatório pode ser gerado com base nesses dados. A informação que é registada pelos timings inclui a motd, a versão do servidor, o uptime, estatísticas de memória, os plugins instalados, o número de ticks por segundo, a percentagem de perdas de tps, o número de jogadores, tile entities, entidades, e chunks. Segue-se uma lista de sub-comandos de /sponge timings:

Comando

Descrição

/sponge timings on

Ativa os timings: tem em conta que este comando vai reiniciar as estatísticas.

/sponge timings off

Desativa os timings. Tem em conta que a maior parte dos comandos dos timings não funcionarão e os timings não vão ser registados se estiverem desativados.

/sponge timings reset

Apaga todos os dados e começa a registá-los após a execução deste comando.

/sponge timings report

Gera o relatório dos timings do desempenho do teu servidor em https://timings.aikar.co

/sponge timings verbon

Ativa monitorização dos timings a nível detalhado (verbose).

/sponge timings verboff

Desativa monitorização dos timings a nível detalhado (verbose). Tem em conta que os timings de alta frequência não estarão disponíveis.

/sponge timings cost

Calcula o custo de utilizar timings.

Forge

Os comandos que se seguem só estão disponíveis quando se utiliza o SpongeForge coremod no Forge. Outras implementações da SpongeAPI, tal como o SpongeVanilla, não incluem estes comandos.

Comando

Descrição

Permissão

/forge tps

Mostra as ticks por segundo de cada mundo.

forge.command.forge

/forge track

Ativa o tile entity tracking.

forge.command.forge


Para quaisquer mods do Forge que usem a API de comandos vanilla, as permissões de comandos são da forma <modid>.command.<commandname>.

Vanilla

Há vários comandos incorporados no Minecraft vanilla que também estão disponíveis nos servidores com o Sponge. A lista abaixo não está completa, mas inclui os comandos mais comuns. Estes comandos estão disponíveis a jogadores com estatuto de operador (ou com o nó de permissão correto). Em geral, as permissões dos comandos vanilla num servidor Sponge são da forma minecraft.command.<command>, como mostrado abaixo.

Comando

Descrição

Permissão

/ban

Banir um jogador.

minecraft.command.ban

/ban-ip

Banir o endereço IP de um jogador.

minecraft.command.ban-ip

/banlist

Ver todos os jogadores banidos.

minecraft.command.banlist

/clear

Limpar um inventário.

minecraft.command.clear

/deop

Retirar o estatuto OP a um jogador.

minecraft.command.deop

/difficulty

Definir a dificuldade do jogo.

minecraft.command.difficulty

/gamemode

Definir o modo de jogo de um jogador.

minecraft.command.gamemode

/gamerule

Definir uma regra do jogo.

minecraft.command.gamerule

/give

Dar um item a um jogador.

minecraft.command.give

/kill

Matar um jogador ou uma entidade.

minecraft.command.kill

/op

Dar estatuto de operador a um jogador.

minecraft.command.op

/pardon

Remover um jogador da lista de banidos.

minecraft.command.pardon

/save-all

Guardar o servidor.

minecraft.command.save-all

/save-off

Desativar a gravação automática do servidor.

minecraft.command.save-off

/save-on

Ativar a gravação automática do servidor.

minecraft.command.save-on

/setidletimeout

Define quanto tempo os jogadores podem estar ausentes antes de serem kickados.

minecraft.command.setidletimeout

/setworldspawn

Definir o spawnpoint do mundo.

minecraft.command.setworldspawn

/stop

Parar o servidor.

minecraft.command.stop

/toggledownfall

Alternar entre tempo chuvoso ou sol.

minecraft.command.toggledownfall

/tp

Teleportar jogadores e entidades.

minecraft.command.tp

/weather

Mudar as condições meteorológicas.

minecraft.command.weather

/whitelist

Gerir a whitelist do servidor.

minecraft.command.whitelist

/worldborder

Modificar os limites do mundo.

minecraft.command.worldborder


Sponge also creates a spawn-protection bypass permission, and two permissions for controlling the ability to edit commandblocks. Note that these permissions use the actual name of the commandblock, which is normally @ by default.

  • Allow player to bypass spawn-protection on all worlds: minecraft.spawn-protection.override

  • Allow editing an ordinary commandblock of the given name: minecraft.commandblock.edit.block.<name>

  • Allow editing a minecart commandblock of the given name: minecraft.commandblock.edit.minecart.<name>

Comandos dos Jogadores

Os comandos seguintes estão disponíveis como parte do Minecraft vanilla para jogadores sem o estatuto de operador.

Comando

Descrição

Permissão

/help

Ver informações sobre os comandos utilizados no servidor

minecraft.command.help

/me

Dizer a toda a gente o que estás a fazer.

minecraft.command.me

/say

Mostrar uma mensagem a toda a gente (ou, se utilizares canais, a jogadores específicos).

minecraft.command.say

/tell

Enviar uma mensagem privada para outro jogador.

minecraft.command.tell


Uma lista completa dos comandos vanilla pode ser encontrada em: http://minecraft.gamepedia.com/Commands#List_of_commands. As permissões para os comandos de Minecraft Vanilla num servidor Sponge seguem a estrutura minecraft.command.<comando>.