MC Toolkit

Guias / Solução de problemas

Um mrpack é um zip que mente sobre ser um zip

Renomear um .mrpack para .zip entrega 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 extrair 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 do 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
gameVersão alvo do Minecraft e loader
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 marca um arquivo como client, server ou ambos. Um mod marcado como somente cliente não deve ser copiado para a pasta mods de um servidor de forma alguma — 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 de 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 — pula entradas env: client, mantém as env: server e as não marcadas, e descarta configs somente de cliente dos overrides.

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

Overrides sobrescrevem, não mesclam

Arquivos dentro de overrides/ são copiados sobre a instância depois que os mods são colocados. Um arquivo de config nos overrides substitui o padrão do mod por completo. Se um pacote traz um config nos overrides e você também edita esse 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 para servidor no Conversor de MRPACK para ZIP.

Conversor de MRPACK para ZIP →

Mais guias

Ver todos →

Procurando mais ferramentas de Minecraft?

Um conjunto de geradores, visualizadores e conversores que rodam no navegador — tudo grátis.