Um link simbólico (ou “symlink”) é uma entrada especial do sistema de arquivos que aponta para outro arquivo ou pasta, permitindo que um caminho em um lugar acesse conteúdo em outro lugar. Links simbólicos podem ser úteis para manter dados do Minecraft (como mundos, pacotes de recursos ou datapacks) em um local diferente das pastas padrão que o Minecraft usa.
Links simbólicos são suportados nos sistemas operacionais em que Minecraft: Java Edition roda, mas o Minecraft pode restringir o uso deles, a menos que você permita explicitamente criando um arquivo de exceções que o Minecraft possa consultar.
Como criar links simbólicos
Criar links simbólicos é feito fora do Minecraft e pode exigir o uso de uma ferramenta de linha de comando ou recursos do gerenciador de arquivos, dependendo do seu sistema operacional. Consulte a documentação do seu sistema para mais detalhes.
- Crie ou edite um arquivo de texto chamado allowed_symlinks.txt na pasta do jogo Minecraft. Para o cliente, normalmente é a pasta .minecraft. Para um servidor dedicado, é a pasta de trabalho do servidor.
- Adicione entradas à lista de permissões que correspondam aos caminhos de destino dos seus links simbólicos, usando o tipo de padrão que preferir (prefixo é o padrão). Use o separador de caminho do seu sistema operacional.
Aqui estão algumas dicas:
- Coloque cada destino em uma linha separada.
- Escolha um tipo de padrão: glob, prefix ou regex.
- Glob corresponde a caminhos que terminam com padrões curinga (por exemplo, *.txt).
- Prefixo corresponde a caminhos que começam com o padrão (por exemplo, /test, /test/ ou /test/file.txt).
- Regex corresponde ao caminho completo usando uma expressão regular (por exemplo, um caminho que termina com \.txt).
- Ignore comentários começando a linha com #.
Segurança e links simbólicos
Se você abrir um mundo de Minecraft e receber um erro dizendo que ele contém links simbólicos que você não criou, não abra — especialmente se veio de um arquivo baixado (como um .zip). O Minecraft verifica links simbólicos dentro das pastas de mundos para segurança; um mundo malicioso pode apontar para fora da pasta do mundo e fazer o Minecraft escrever ou sobrescrever arquivos em outros lugares, causando perda de dados.
Resolução de problemas com links simbólicos
- Se você receber um erro após criar um link simbólico, confira o arquivo de log para ver os destinos rejeitados (por exemplo, .minecraft\logs\latest.log no cliente) e ajuste suas entradas na lista de permissões usando as dicas acima.
- Caminhos relativos podem não funcionar como esperado. Use caminhos absolutos sempre que possível.
- Você pode precisar excluir a pasta existente no local onde quer criar o link simbólico. Faça backup de qualquer dado que queira manter.