Quando o Java responde Unable to access jarfile, o processo não encontrou o arquivo indicado na linha de comando. Isso costuma ser um caminho relativo diferente do esperado, nome incorreto ou extensão oculta. Baixar Paper de novo não resolve se script aponta para outro nome ou diretório.

Compare o arquivo real, o diretório de trabalho e o comando de início. Paper recomenda usar script de inicialização em vez de abrir o JAR por clique, porque script mantém argumentos e saída acessíveis para diagnóstico.

Confirme diretório de trabalho

O caminho relativo paper.jar é procurado a partir da pasta ativa do processo, que pode não ser a pasta onde você abriu o terminal ou visualiza no painel. Verifique qual diretório o painel usa. Em script local, mude para pasta do servidor ou forneça caminho absoluto de forma consistente.

Arquivos de mundo, configuração e plugin também dependem de diretório de execução. Corrigir somente nome do JAR não basta se processo passa a iniciar na pasta errada e cria uma segunda instalação vazia. Antes de rodar comando, confirme arquivos e diretório.

Confira nome e extensão do arquivo

Compare letra por letra o nome no comando com arquivo salvo. Windows pode ocultar extensões conhecidas, então arquivo mostrado como `paper.jar` pode ser `paper.jar.jar` ou `paper.jar.txt`. Ative exibição de extensões e verifique propriedades.

Em Linux, maiúsculas e minúsculas fazem diferença: `Paper.jar` e `paper.jar` não são o mesmo caminho. Evite espaços ocultos, acentos inesperados e caracteres especiais em nomes. Use um nome simples e ajuste o script ao valor exato.

Verifique se download criou o JAR correto

Confirme tamanho e formato do arquivo. Um download interrompido ou uma página HTML salva com extensão `.jar` não executa como servidor. Obtenha build do site oficial de Paper e verifique integridade quando publicador oferecer checksum. Não substitua arquivo por artefato de mirror duvidoso.

Se o comando diz que consegue acessar JAR mas erro seguinte é formato inválido ou arquivo corrompido, investigue download em vez de path. Guarde mensagem completa e faça nova transferência em pasta temporária antes de substituir instalação conhecida.

Leia script em vez de clicar no JAR

Um script permite definir Java, heap, arquivo JAR e opções. Use o gerador oficial de Paper para construir um comando compatível com seu sistema. No Windows, mantenha janela do terminal aberta após erro durante diagnóstico, seguindo a orientação do script. Em Linux, capture stdout e stderr em ambiente de serviço conforme gerenciador.

Confira que comando chama executável Java esperado e que argumentos do JAR estão depois do nome correto. Argumentos de Java, como memória, vêm antes de -jar; opções próprias do Paper aparecem depois do arquivo. Uma linha em ordem errada pode produzir mensagem diferente e confundir análise.

Em painel, confirme startup command

Hospedagem pode executar comando configurado no painel em diretório de container. O nome do arquivo enviado precisa coincidir com startup command e extensão visível. Verifique logs de inicialização, variável de nome de JAR e campos de parâmetro. Se painel monta comando automático, altere o campo documentado em vez de editar arquivo inacessível.

Confirme se upload chegou ao servidor certo e diretório raiz esperado. Algumas interfaces exibem arquivos de uma instância enquanto botão start controla outra. Compare ID e nome do servidor antes de renomear ou mover artefato.

Valide Java separadamente

Depois de corrigir o caminho, Java pode apresentar erro de versão. Verifique Java que processo usa, não somente terminal local. Paper indica requisitos por versão de Minecraft; uma JVM antiga pode falhar após o arquivo ser encontrado.

Trate `Unable to access jarfile` como questão de caminho até evidência mostrar outra coisa. Não atualize Java nem flags como primeira tentativa se arquivo não está acessível. Resolva uma camada por vez.

Proteja dados da instalação

Antes de substituir JAR, faça backup de mundo e configurações. Não delete pasta inteira para corrigir caminho. Salve o comando antigo para rollback e teste num clone se a instalação é crítica. Iniciar em pasta errada pode criar diretório adicional; confirme destino antes de copiar ou limpar arquivos.

Documente a configuração que inicia

Registre caminho do executável, diretório de trabalho, nome de JAR, versão e comando do painel. Remova caminhos locais com nomes de usuário se compartilhar log publicamente. Depois de teste, faça parada normal e confirme mundo correto.

Use o guia de startup script e troubleshooting, a página de primeiro início e o mapa de arquivos do servidor. Gere script para a versão correta e confira caminho antes de executá-lo.

Valide comando completo e diretório no início

Imprima ou copie o comando exatamente como painel o executa e compare o caminho em disco. Um caminho relativo pode funcionar ao iniciar por terminal e falhar como serviço, que começa em diretório diferente. Inclua também nome de pasta com espaços e aspas corretamente se usa caminho absoluto.

Depois de iniciar, confirme no log a versão, mundo e diretório carregado. Se Paper criou `logs` ou `world` numa pasta inesperada, pare imediatamente e ajuste working directory antes que jogadores criem progresso nessa instalação duplicada.

Valide arquivo de propriedades da interface

Confirme que você está lendo `server.properties` da mesma pasta usada no comando. Uma segunda cópia em diretório de teste pode levar a editar valores que o processo nunca carrega. Compare timestamp e log de início e não mova worlds ou plugins para tentar fazer JAR encontrar a si mesmo.

Use resultado de comando como verificação separada

Após corrigir working directory, rode um início completo e confirme que argumento de Java não foi alterado pelo painel. Se agora surgir erro de Java incompatível ou EULA, a etapa de acesso ao JAR foi resolvida; trate a próxima mensagem específica em vez de voltar a renomear arquivo.

Faça captura de uma única tentativa de partida

Registre hora, processo, diretório e erro exato da sessão atual. Evite clicar start repetidamente, pois pode criar logs e processos concorrentes que escondem a primeira causa. Corrija nome do JAR ou pasta em cópia, rode uma vez e compare primeira linha do console com o resultado esperado.

Evite script que troca JAR silenciosamente

Alguns painéis resolvem variável de versão ou caminho automaticamente. Confira se diretório tem mais de um JAR e qual o launcher realmente seleciona. Documente o nome escolhido e apague artefatos antigos somente depois de backup e validação; mover JAR de produção pode quebrar rollback planejado.

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.