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.
/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´´.
/sponge config -d minecraft: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).
/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.overrideAllow 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 |
A full list of vanilla commands can be found at: https://minecraft.gamepedia.com/Commands#List_of_commands. Permissions
for vanilla Minecraft commands on a Sponge server are of the structure minecraft.command.<command>.
