Se um jogador volta ao Survival ao reconectar, force-gamemode pode estar restaurando o modo padrão configurado. Confira o valor efetivo e valide o fluxo por cargo. Para evitar uma correção baseada em suposição, identifique primeiro a versão, a instância e o sintoma observável. Faça alterações em cópia sempre que houver risco para mundo, dados ou acesso dos jogadores.

Este guia explica como validar a hipótese com evidências. Os nomes, padrões e efeitos podem variar entre versões e integrações; consulte a documentação oficial listada no final para o seu release e registre o estado anterior antes de editar.

O que a configuração controla

Comece pela definição oficial e registre o padrão documentado para a versão instalada. Evite inferir comportamento apenas pelo nome do parâmetro: opções semelhantes podem atuar em estágios diferentes. Confira o arquivo e a build exatos antes de comparar resultados.

Registre o que mudou, execute o fluxo em pelo menos duas condições relevantes e confira os logs desde a inicialização. Se o resultado esperado não ocorrer, volte ao valor original e investigue a camada responsável antes de ampliar a mudança.

Identifique arquivo e processo ativos

Confirme o diretório de trabalho, o JAR executado e o processo que atende o endereço público. Painéis podem iniciar mais de uma instância e gerar arquivos no diretório configurado pelo comando. Compare timestamps, console e caminho informado pelo painel.

Registre o que mudou, execute o fluxo em pelo menos duas condições relevantes e confira os logs desde a inicialização. Se o resultado esperado não ocorrer, volte ao valor original e investigue a camada responsável antes de ampliar a mudança.

Entenda precedência e integrações

Procure argumentos CLI, configurações do proxy e plugins que possam substituir ou apresentar o valor. A referência de CLI do Paper descreve opções que sobrepõem propriedades equivalentes; gateways e painéis também mantêm dados próprios. Anote cada fonte antes de editar.

Registre o que mudou, execute o fluxo em pelo menos duas condições relevantes e confira os logs desde a inicialização. Se o resultado esperado não ocorrer, volte ao valor original e investigue a camada responsável antes de ampliar a mudança.

Reproduza em ambiente controlado

Faça backup e copie a situação para homologação. Mude uma variável por vez, reinicie pelo procedimento normal e repita uma ação concreta. Registre resultado esperado, resultado observado, mensagem e linhas de log. Isso reduz tentativa e erro e facilita voltar ao estado conhecido.

Registre o que mudou, execute o fluxo em pelo menos duas condições relevantes e confira os logs desde a inicialização. Se o resultado esperado não ocorrer, volte ao valor original e investigue a camada responsável antes de ampliar a mudança.

Faça a alteração mínima e segura

Com o processo parado quando a mudança exige reinício, salve a configuração original e edite somente a instância confirmada. Respeite formato, tipos e versão. Não substitua arquivo inteiro por um exemplo de outro release nem copie uma linha de fórum sem conferir sua documentação.

Registre o que mudou, execute o fluxo em pelo menos duas condições relevantes e confira os logs desde a inicialização. Se o resultado esperado não ocorrer, volte ao valor original e investigue a camada responsável antes de ampliar a mudança.

Valide no cliente e no servidor

Teste caminho completo: console, backend, proxy e cliente real quando aplicável. Confirme status, login, reconexão e persistência depois do reinício. Uma mensagem visual antiga pode vir de cache, mas um erro no log do backend aponta para outro ponto do diagnóstico.

Registre o que mudou, execute o fluxo em pelo menos duas condições relevantes e confira os logs desde a inicialização. Se o resultado esperado não ocorrer, volte ao valor original e investigue a camada responsável antes de ampliar a mudança.

Se o comportamento continuar incorreto

Reverta apenas a última alteração e confira se o problema desaparece. Analise o primeiro erro, identifique plugin citado e compare com uma cópia sem o componente quando seguro. Mantenha bibliotecas exigidas por outros plugins e use busca binária para isolar conflitos.

Registre o que mudou, execute o fluxo em pelo menos duas condições relevantes e confira os logs desde a inicialização. Se o resultado esperado não ocorrer, volte ao valor original e investigue a camada responsável antes de ampliar a mudança.

Documente e monitore

Anote valor anterior e novo, origem do parâmetro, versão, horário e plano de retorno. Acompanhe métricas e chamados após a mudança. Se a mesma divergência voltar após atualização ou restauração de painel, revise templates e automações que escrevem o arquivo.

Registre o que mudou, execute o fluxo em pelo menos duas condições relevantes e confira os logs desde a inicialização. Se o resultado esperado não ocorrer, volte ao valor original e investigue a camada responsável antes de ampliar a mudança.

Plano de validação em produção

Aprove a mudança em uma cópia representativa, prepare uma janela de manutenção e defina sinais de sucesso e reversão. Avise a equipe sobre o que observar, mantenha backup recente e não combine ajustes não relacionados durante a mesma janela.

  1. Confirme versão, instância e fonte efetiva do valor.
  2. Preserve configuração e dados antes da alteração.
  3. Reproduza o caso e anote logs e resultado.
  4. Altere um item por vez e reinicie quando necessário.
  5. Repita o teste com conta e cenário representativos.
  6. Documente conclusão e condição de rollback.

Esse processo não substitui testes específicos do seu plugin, proxy ou provedor. Quando um sintoma apontar para uma integração, use a documentação dessa integração e forneça aos mantenedores logs sanitizados e passos mínimos para reproduzir o problema.

Entenda modo salvo e modo padrão

O modo padrão definido pela propriedade gamemode é uma decisão de entrada do servidor. Jogadores também podem ter modo gravado em dados persistentes, e plugins podem atribuir valores na entrada, no mundo ou após uma permissão ser carregada. Por isso, uma troca ao reconectar pode resultar de mais de uma regra. Faça primeiro um teste sem plugins em uma cópia antes de atribuir o comportamento exclusivamente a Paper.

Ao concluir, compare o resultado com a linha de base, registre versão e horário e mantenha o procedimento de retorno documentado. Um teste reproduzível evita reaplicar a mesma hipótese em produção sem saber se resolveu a causa.

Desenhe uma matriz de contas

Teste pelo menos uma conta comum, uma conta staff e uma conta usada por minigame. Para cada uma, anote modo antes de sair, modo após retorno, servidor ou mundo de entrada e permissões. Repita após reinício. Essa matriz revela se a mudança é global, restrita a uma integração ou associada a um evento como troca de mundo.

Ao concluir, compare o resultado com a linha de base, registre versão e horário e mantenha o procedimento de retorno documentado. Um teste reproduzível evita reaplicar a mesma hipótese em produção sem saber se resolveu a causa.

Coordene a propriedade com plugins de cargos

Plugins de permissões determinam autorização, mas o plugin de modo pode ser outro. Verifique ordem de eventos de login e documentação do plugin que concede modo. Se a política varia por mundo, prefira uma configuração explícita dessa integração em vez de alternar a propriedade geral em cada ocasião. Evite conceder OP para mascarar problema de autorização.

Ao concluir, compare o resultado com a linha de base, registre versão e horário e mantenha o procedimento de retorno documentado. Um teste reproduzível evita reaplicar a mesma hipótese em produção sem saber se resolveu a causa.

Fontes e referências

Documentação consultada em 2026-10-08. Os exemplos precisam ser conferidos na versão instalada; este guia não afirma que a configuração foi testada no seu ambiente.