MC Toolkit

Guias / Solução de problemas

Um mrpack é um zip que mente sobre ser um zip

Renomear um .mrpack para .zip te dá um manifesto e uma pasta overrides, não os mods — os jars ficam no CDN do Modrinth e são baixados por hash.

Um .mrpack é um arquivo ZIP, então renomeá-lo para .zip e extraí-lo funciona — e não produz quase nada de útil. Você recebe um modrinth.index.json, uma pasta overrides, e nenhum mod. Os jars nunca estiveram lá dentro.

Por que os mods estão faltando

Os pacotes do Modrinth armazenam um manifesto, não o conteúdo. Cada entrada em modrinth.index.json lista uma URL de download mais um hash SHA-1 e SHA-512 para o arquivo que essa URL deve retornar. O launcher lê o manifesto, baixa cada arquivo, verifica o hash e só então o coloca na instância.

Esse design mantém os pacotes pequenos e permite atualizar um pacote sem reenviar cada jar. Também significa que um pacote é inútil offline até que alguém o resolva uma vez.

O que o manifesto realmente contém

CampoSignificado
formatVersionVersão do esquema do manifesto
gameSempre "minecraft" — as versões ficam em dependencies
filesArray de path, hashes, downloads, env
dependenciesVersões do loader e do Minecraft a instalar primeiro

O campo env em cada arquivo é o que as pessoas ignoram. Ele diz, separadamente para client e server, se o arquivo é required, optional ou unsupported — e um arquivo sem env é obrigatório em ambos. Um mod marcado como client-only não deve ser copiado para a pasta mods de um servidor de jeito nenhum — fazer isso é uma causa comum de um servidor que se recusa a iniciar.

A verificação de hash não é opcional

Se o SHA-1 de um arquivo baixado não corresponder ao manifesto, o arquivo está errado: um download truncado, uma página de erro do CDN salva como jar, ou um espelho adulterado. Um conversor que pula a verificação vai empacotar alegremente uma instância quebrada. A verificação é o motivo inteiro de fazer isso localmente em vez de confiar em um repack aleatório.

Saída para cliente versus servidor

O mesmo manifesto produz dois arquivos diferentes dependendo do alvo:

  • Pacote de cliente — tudo, mais overrides mesclado na raiz da instância, pronto para um launcher que aceita um ZIP.
  • Pacote de servidor — pule entradas cujo env.server seja unsupported, mantenha o resto, e sobreponha server-overrides/ sobre overrides/ em vez de client-overrides/.

Apenas Edição Java. A Edição Bedrock não tem formato equivalente; os add-ons da Edição Bedrock são arquivos .mcaddon/.mcpack com um manifest.json de formato completamente diferente, e nenhum pacote do Modrinth se resolve para eles.

Overrides sobrescrevem, não mesclam

Arquivos sob overrides/ são copiados sobre a instância depois que os mods são colocados. Um arquivo de configuração em overrides substitui o padrão do mod por completo. Se um pacote inclui uma config em overrides e você também edita essa config na instância, a cópia dos overrides vence na próxima resolução.

Converta um manifesto, verifique cada hash e obtenha um ZIP pronto para launcher ou servidor no Conversor de MRPACK para ZIP.

Conversor de MRPACK para ZIP →

Mais guias

Ver todos →