Skip to content
Hospedagem · Configuração de servidor

ops.json, banned-players.json e outras listas

Arquivos JSON de serviço do servidor: operadores, bans, whitelist e cache de nicknames — o que contêm e quando são editados à mão.

Atualizado em 13 de agosto de 2026

O servidor armazena as listas de jogadores em arquivos JSON na raiz. Normalmente elas são gerenciadas por comandos, mas às vezes é mais rápido abrir o arquivo.

ArquivoConteúdo
ops.jsonOperadores, nível de acesso, bypassesPlayerLimit
whitelist.jsonWhitelist
banned-players.jsonBanimentos por nickname e UUID
banned-ips.jsonBanimentos por IP
usercache.jsonCache do mapeamento nickname → UUID

Exemplo de ops.json

[
  {
    "uuid": "8a1b...",
    "name": "Steve",
    "level": 4,
    "bypassesPlayerLimit": true
  }
]

Regras de edição

  • Somente com o servidor parado. Um servidor em execução mantém as listas na memória e sobrescreve o arquivo ao desligar — suas edições serão perdidas.
  • O formato é rígido: uma vírgula a mais quebra o arquivo inteiro, e o servidor inicia com a lista de operadores vazia.
  • O UUID precisa corresponder ao nickname. Em um servidor premium, o UUID é permanente; em um servidor com login por nickname, ele é calculado a partir do nickname — quando você muda o online-mode, todas as listas efetivamente deixam de corresponder.

Alterando o online-mode

Esta é a causa mais comum de “todos os operadores e claims desapareceram”: os UUIDs dos jogadores mudam, e as entradas antigas não se referem mais a ninguém. Para detalhes, veja Login por nickname.

Plugins

Plugins de permissão e de banimento armazenam seus dados separadamente (arquivos ou MySQL) e ignoram as listas vanilla — LuckPerms, Banimentos e mutes.

Hospedagem MinecraftSeu servidor roda enquanto você está offlineCriar servidor