Como funciona o provider de fonte bitmap do Minecraft
Um resource pack da Java Edition pode mapear caracteres para células em uma folha de sprites PNG. Este gerador cria o JSON do provider de bitmap que conecta a localização do recurso de textura, as linhas de caracteres, a altura do glifo e a posição da linha de base. Ele não cria ou modifica o PNG, portanto a grade de caracteres inserida aqui deve corresponder à imagem que você colocar no pack.
Cada linha na Grade de caracteres representa uma fileira horizontal de células de tamanho igual na textura. Leia cada linha da esquerda para a direita e mantenha todas as linhas com o mesmo comprimento. Se o JSON listar um caractere na célula errada, o Minecraft exibirá o glifo vizinho.
Localização do recurso de textura
Use uma localização de recurso com namespace, como my_pack:font/custom.png. A imagem correspondente deve estar em assets/my_pack/textures/font/custom.png. O namespace e o caminho diferenciam maiúsculas de minúsculas e devem usar caracteres minúsculos.
Height e ascent
Height controla a altura do glifo renderizado em pixels. Ascent move o glifo em relação à linha de base do texto. Comece com ascent um pixel abaixo de height, visualize o pack no Minecraft e ajuste quando as letras ficarem muito altas ou muito baixas ao lado da fonte vanilla.
Onde salvar o JSON
Baixe custom.json e coloque-o em assets/<namespace>/font. O nome do arquivo se torna o ID do recurso de fonte. Um arquivo salvo como assets/my_pack/font/custom.json pode ser referenciado como my_pack:custom por componentes de texto que suportam um campo font.
O que este gerador valida
A ferramenta mantém a estrutura do provider válida e converte cada linha de texto em uma linha de caracteres. Ela não pode inspecionar o PNG externo, verificar as dimensões das células, detectar caracteres duplicados ou confirmar que um servidor envia o resource pack aos jogadores.
Crie e teste uma fonte personalizada do Minecraft
- Prepare um PNG transparente cujos glifos estejam organizados em uma grade regular.
- Insira a localização do recurso do PNG e copie a ordem exata dos caracteres, uma linha de imagem por linha de texto.
- Defina height e ascent e baixe custom.json.
- Coloque o JSON e o PNG nas pastas correspondentes do resource pack e recarregue os recursos no Minecraft.
- Teste cada caractere que pretende usar e ajuste o PNG ou ascent quando o espaçamento estiver incorreto.
Perguntas sobre JSON de fonte do Minecraft
Esta ferramenta cria o PNG da fonte?
Não. Ela gera apenas o JSON do provider de bitmap. Crie a folha de sprites transparente separadamente e faça a ordem das células corresponder exatamente à Grade de caracteres.
Por que o Minecraft mostra o caractere errado?
A causa usual é uma incompatibilidade entre a ordem das células do PNG e as linhas de chars. Verifique o comprimento das linhas, células em branco, quebras de linha, namespace, caminho do arquivo e as dimensões reais da imagem.
Isso pode substituir a fonte padrão do Minecraft?
Um resource pack pode definir providers no arquivo de fonte padrão, mas substituir caracteres vanilla afeta todas as interfaces que usam essa fonte. Uma fonte separada com namespace é mais segura quando apenas componentes de texto selecionados precisam de glifos personalizados.
Por que a fonte fica invisível após recarregar o pack?
Confirme que o pack carrega sem erros de recurso, que o JSON está em assets/<namespace>/font, que o PNG está em assets/<namespace>/textures e que o campo file aponta para o mesmo namespace e caminho de textura.