Antes de backup, atualização ou movimentação do mundo, o Paper precisa terminar o desligamento e salvar estado. Fechar aba do painel não necessariamente para processo; clicar em stop pode enviar uma solicitação, mas não garante que todos os dados já foram gravados. Aguarde mensagem final e confirme que o serviço não está mais ativo.
Paper recomenda parada completa antes de editar arquivos para evitar corrupção. Um encerramento gracioso permite ao servidor concluir trabalho de mundo e jogador conforme o fluxo da implementação, enquanto encerramento forçado interrompe o processo sem essa sequência.
Use comando stop ou botão de parada do painel
Prefira comando de parada e mecanismo do painel documentado pelo provedor. Avise jogadores e equipe, encerre evento ou atividade econômica em andamento e aguarde tempo para salvar. Uma instância grande pode levar mais tempo para finalizar; não conclua pelo desaparecimento de jogadores somente.
Leia as últimas linhas do console. Mensagem de salvamento e fechamento completo indica que processo avançou; tela parada com processo ativo pode significar plugin em shutdown travado. Registre horário e evidência antes de agir manualmente.
Diferencie parada lenta de parada travada
Se shutdown demora, acompanhe logs, uso de CPU e atividade de disco por período razoável. Uma operação de plugin, backup ou banco pode atrasar. Se há stack dump ou watchdog, use contexto para investigar. Não inicie segunda cópia sobre o mesmo diretório.
Se nenhum progresso ocorrer e provedor confirmar travamento, faça um snapshot conforme recursos disponíveis antes de encerramento forçado, se isso puder ser feito com segurança. Force kill somente como medida operacional excepcional e aceite que estado mais recente talvez não esteja salvo.
Evite tarefas concorrentes durante cópia
Depois de solicitar parada, espere que arquivo do mundo e banco parem de crescer antes de compactar ou mover. Um script de backup que inicia enquanto Paper ainda está gravando pode copiar dimensões em momentos diferentes. Use procedimento do provedor que garante consistência, ou espere encerramento completo.
Não faça atualização de JAR, edição de config ou restauração simultaneamente a processo ativo. Paper pode reescrever arquivo no shutdown e sobrescrever sua edição. Separe manutenção em etapas, com registro e backup antes de cada mudança.
Monitore desligamento inesperado
Se servidor para limpo sem solicitação visível, pode ter recebido comando de painel, plugin ou agendador. Preserve logs e verifique atividade do painel, cron, rotina de auto-restart e integração. Habilite a opção de debug que a documentação indica para a próxima ocorrência se stack trace for necessário.
Se processo desaparece sem log de shutdown, diferencie encerramento gracioso de crash, OOM killer ou interrupção do host. Consulte o provedor e logs de sistema. Reiniciar automaticamente pode ocultar a primeira evidência e gerar gravações adicionais.
Proteja o acesso ao comando de parada
Controle quem pode enviar /stop, usar console e acionar o painel. Um plugin mal configurado ou canal externo de console pode permitir parada não autorizada. Use contas individuais e revise permissões da equipe.
Em proxy, parar backend pode afetar jogadores enquanto entrada permanece acessível. Comunique estado pelo proxy e defina destino seguro de manutenção. Teste fluxo de saída antes de desligar mundo com participantes.
Valide integridade depois de iniciar
Após uma parada normal, confira logs do último shutdown e do novo startup. Confirme mundos, jogadores, inventários, bancos e plugins. Se havia interrupção forçada, verifique registros e faça backup imediatamente depois de avaliar integridade, sem sobrepor uma cópia anterior que possa ser necessária.
Faça pequenos testes de leitura e escrita numa área segura. Compare erros de região e dados com a cópia conhecida. Em caso de dúvida, feche o acesso e restaure numa instância de homologação antes de permitir novas alterações de jogadores.
Crie uma janela de manutenção simples
Avise horário, ação e rota de retorno. Desconecte jogadores com mensagem clara, conclua parada, verifique processo encerrado, faça backup, altere somente o planejado e teste antes de abrir. Se etapa falhar, interrompa e use plano de rollback.
As recomendações de diagnóstico do Paper exigem parada completa e backup antes de editar. Consulte o guia de atualização e a descrição do ciclo de shutdown Folia como referência técnica de salvamento ordenado. Use os controles do servidor e aguarde confirmação de saída.
Faça uma parada com salvamento observável
Antes de copiar dados, observe o console até confirmar sequência final de salvamento. Compare horário de modificação de arquivos em uma cópia local ou pelo painel, sem tentar abrir ou editar mundo ativo. O tempo de finalização varia com volume e plugins, então use confirmação de processo encerrado como sinal final, não um cronômetro fixo.
Se hospeda várias instâncias, confirme que nenhuma outra acessa o mesmo diretório via mount compartilhado. Parar um backend não garante que proxy ou worker auxiliar não escreve em banco comum.
Espere e confirme antes de desligamento forçado
Se processo não responde, capture console e solicite ao provedor a confirmação de que ainda está ativo. Não repita botão stop ou start muitas vezes: cada tentativa pode criar tarefa sobreposta. Se encerramento forçado for inevitável, documente que arquivos podem ter ficado sem flush e confira integridade antes de aceitar conexões.
Confira se reinício automático espera o desligamento
Uma política de auto-restart pode iniciar outra cópia antes da primeira liberar o lock de mundo. Revise intervalo e condição do painel e teste parada completa em janela de manutenção. Se log da instância antiga ainda atualiza, não inicie a nova nem mova dados compartilhados.
Crie checklist de encerramento
Confirme: jogadores avisados, backups agendados pausados, parada solicitada, saída final confirmada, processo encerrado e diretório correto. Marque quem executou e o horário. Uma checklist curta reduz chance de equipe mover JAR ou comprimir mundo enquanto servidor ainda está gravando.
Reabra com teste funcional
Após reiniciar, confirme que jogadores entram, mundos carregam e logs não mostram erros de salvamento. Faça uma ação simples de bloco numa área segura, pare corretamente e repita leitura depois do startup. Isso valida persistência do ciclo, e não somente que a porta voltou a responder.
Documente exceção durante operação
Se houve force kill, marque backup feito depois como potencialmente inconsistente e faça restauração de teste antes de apagar snapshot anterior. Registre o que a equipe observou no console, PID e arquivos modificados. Essa informação ajuda a decidir se é necessário recuperar dados em vez de somente iniciar novamente.
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.