A propriedade player-idle-timeout em server.properties define quantos minutos de inatividade podem passar antes que o jogador seja removido. O padrão documentado é 0, que desativa o timeout. O Paper lista algumas ações que interrompem o contador, como chat, movimento e interações; portanto, AFK não é simplesmente ausência de movimento em todos os casos.

Use a opção para liberar vagas e recursos somente quando a política for clara. Um kick automático pode afetar pessoas que acompanham evento, usam tecnologias assistivas ou precisam pausar por alguns minutos. Teste regras e comunique prazo antes de ativar.

Defina por que precisa do timeout

Se vagas ficam ocupadas durante períodos longos, observe população, horários e capacidade. Talvez o servidor precise de fila ou limite de jogadores em vez de timeout agressivo. Se o motivo é impedir farms AFK, regra de gameplay ou plugin específico pode ser mais adequado, com avaliação de farms legítimas.

Se deseja reduzir custos quando ninguém está conectado, a opção não é o mesmo que pausar servidor vazio. `pause-when-empty-seconds` possui compatibilidade própria com plugins. Não misture esses objetivos e confira a documentação antes de escolher.

Defina tempo adequado à experiência, horário de evento e modo de jogo. Uma sessão de torneio com espectador parado pode ser válida. Um hub de acesso público pode querer liberar vagas rapidamente, desde que haja aviso e reconexão simples.

Entenda quais ações contam como atividade

O Paper lista pacotes que reiniciam o temporizador, incluindo clicar em janela, encantar item, atualizar placa, quebrar ou colocar bloco, trocar item na mão, animação, chat e uso de entidade. O comportamento deve ser testado na versão atual; não assuma que um bot imóvel sempre será expulso ou que qualquer tecla conta.

Plugins de AFK podem detectar padrões próprios e conceder status, recompensas ou exceção ao timeout. Compare regras e evite dois sistemas competirem, um removendo jogador enquanto outro o marca como ativo. Teste contas sem permissão especial.

Se uma pessoa é removida durante ação ou interface, registre momento e mensagem. Um sistema de rede pode desconectar por timeout de keepalive, que é diferente de política de inatividade. A causa aparece em logs distintos.

Considere farms, economia e equidade

Permitir AFK pode alterar produção de farms, economia e acesso a recursos. Remover AFK pode gerar a mesma mudança, favorecendo quem está online em períodos específicos. Explique se farms passivas são permitidas, quais exceções existem e como políticas se aplicam a todos.

Não recompense atividade falsa ou automação que contorna uma regra sem autorização. Defina como tratar espectadores, eventos, streamers, suporte da equipe e sessões de construção longa. Exceções devem ter justificativa, escopo e duração.

Se há pagamento, ranks ou vantagens associadas a AFK, revise transparência da regra e funcionamento de plugin. O timeout deve agir com previsibilidade e não remover participantes de atividade já paga ou evento com inscrição sem plano de reconexão.

Teste antes da publicação

Em staging, configure um intervalo curto para reproduzir kick e verifique mensagem, log, reconexão, whitelist e proxy. Faça testes com movimento, chat, inventário aberto e modo espectador. Depois restaure um valor realista e valide com equipe e usuários de teste.

Teste com Velocity e backend: política pode ser aplicada em um ponto e não em outro. Observe se troca de servidor reinicia contador. Em rede compartilhada, comunique se jogadores são removidos da rede ou somente de um modo.

Revise plugins de fila e tablist para verificar se o jogador aparece corretamente como desconectado e se a vaga é liberada. Um plugin que mantém estado em cache pode exibir contagem errada depois do kick.

Comunique prazo e alternativas

Informe prazo de inatividade, ações que reiniciam o contador e mensagem de kick. Oriente quem participa de torneio ou construção longa a avisar a equipe e a evitar deixar o jogo pausado no servidor. Não peça que mantenham macro ou bot ativo para escapar de política.

Se jogador precisa de tempo por acessibilidade, ofereça canal de suporte e alternativa clara, sem exigir informação médica pública. A equipe pode avaliar exceção limitada e consistente com regras de comunidade.

Publique mudança com aviso, período de observação e forma de reportar falso positivo. Se o timeout interrompe atividade importante, reverta antes de discutir novo valor.

Implemente e monitore

Faça backup de server.properties e registre configuração anterior. Aplique numa janela planejada, reinicie se necessário e monitore kicks, ocupação, filas e tickets. Compare antes e depois por horário de pico.

Não associe aumento de slots liberados automaticamente a melhor capacidade. Usuários removidos podem voltar juntos, criando novo pico de login. Combine timeout com limites e comunicação adequados.

Se resultado não cumprir o objetivo ou causar kick indevido, volte a 0 ou ao valor anterior e corrija o diagnóstico. Documente quem aprovou, a razão e a data de revisão.

Revise após atualizações

Depois de atualizar Minecraft, Paper, proxy ou plugin AFK, repita testes, porque atividade reconhecida e compatibilidade podem mudar. Revise os logs e a semântica da propriedade na documentação da versão.

Uma política de inatividade bem configurada libera capacidade sem surpreender quem joga. O número sozinho não define justiça; mensagens, exceções, fila e experiência do modo fazem parte da implementação.

Considere espectadores e trabalho da equipe

Jogadores em spectator podem estar assistindo evento sem interagir continuamente. Um timeout curto pode removê-los no meio de uma transmissão ou partida. Combine duração com agenda, ou use lista de permissões temporária da equipe sem conceder acesso administrativo desnecessário.

Construtores podem permanecer parados enquanto planejam uma estrutura, e pessoas com deficiência podem usar pausas. Mensagem e suporte devem permitir relatar necessidade sem exposição pública. A regra deve ser proporcional ao objetivo de liberar vaga.

Não prometa que OP nunca será removido ou que um cargo terá exceção se plugin e server.properties discordarem. Teste cada grupo e documente prioridade. Exceções em evento precisam expirar e ser revistas.

Analise efeitos em fila e presença

Se timeout libera vagas rapidamente, a fila pode crescer. Exiba posição e tempo estimado com margem honesta. Evite plugin que reconecta sem pausa após kick, pois pode gerar tempestade de logins e impactar quem está entrando.

Monitore horário dos kicks e retentativas. Se muitas contas são removidas em lote por uma janela de inatividade, dimensione staff para atendimento e assegure que contas de testes não gerem eventos em sistemas externos.

Se a meta é impedir abuso de múltiplas contas, timeout não verifica identidade ou automação. Use política de conta e moderação apropriada; não aumente agressividade de kick para resolver problema de segurança de outra camada.

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.