Sobrescrita de Dependências
Um guia para sobrescrever dependências definidas no fabric.mod.json de um mod.
WARNING
As sobrescritas de Dependências são usadas para dar aos desenvolvedores de modpacks controle sobre seus mods. Isso não deve ser usado por jogadores normais.
É importante entender como os campos de dependências são estruturados antes de continuar.
Às vezes, ao montar um modpack, você pode encontrar mods com requerimentos de dependências inconvenientes - por exemplo, um mod pode ser muito rigoroso, requirindo o Minecraft 26.1, apesar dele funcionar na versão 26.1.2.
Para contrariar isso, o Fabric Loader permite que você sobrescreva os requerimentos de dependências, desse modo você pode tentar carregar um mod em uma versão de Minecraft para a qual ele não foi desenvolvido.
TIP
Sobrescrever dependências deve ser apenas uma solução temporária se possível. Se o mod for ativamente mantido, considere reportar essa incompatibilidade no registro de erros e deixar os desenvolvedores originais resolverem o problema.
Configuração
INFO
Para este exemplo, nós vamos usar o seguinte fabric.mod.json para um mod com o id example-mod. A qualquer momento, você pode trocar a guia em um bloco de código para ver como a sobrescrita de dependência afeta este fabric.mod.json.
fabric.mod.json
{
"depends": {
"fabricloader": ">=0.11.1",
"fabric-api": ">=0.28.0",
"minecraft": "26.1"
},
"breaks": {
"optifabric": "*"
},
"suggests": {
"anothermod": "*",
"flamingo": "*",
"modupdater": "*"
}
}2
3
4
5
6
7
8
9
10
11
12
13
14
15
Primeiro, crie um arquivo nomeado fabric_loader_dependencies.json dentro da pasta .minecraft/config.
Em seguida, preenchemos o arquivo com o seguinte conteúdo padrão:
{
"version": 1,
"overrides": {
"example-mod": {}
}
}2
3
4
5
6
{
"depends": {
"fabricloader": ">=0.11.1",
"fabric-api": ">=0.28.0",
"minecraft": "26.1"
},
"breaks": {
"optifabric": "*"
},
"suggests": {
"anothermod": "*",
"flamingo": "*",
"modupdater": "*"
}
}2
3
4
5
6
7
8
9
10
11
12
13
14
15
Vamos analisar ele linha por linha.
Primeiro, nós temos version, que especifica a versão da especificação da sobrescrita de dependência que nós gostaríamos de usar. No momento da escrita dessa página, a versão mais recente é a versão 1.
Segundo, nós temos um objeto overrides que conterá todas as nossas sobrescritas de dependências para vários mods. Para começar, ele inclui uma entrada vazia para example-mod para qual podemos adicionar sobrescritas de dependências.
As chaves dentro do objeto do mod pode ser um dos 5 tipos de dependências (depends, recommends, suggests, conflicts, breaks). O valor de qualquer uma daquelas chaves deve ser um objeto JSON. Este objeto JSON segue a mesma estrutura que um fabric.mod.json objeto de dependência do.
A chave pode ser opcionalmente prefixado com + ou - (por exemplo, "+depends", "-breaks").
Se a chave é prefixada com +, as entradas dentro daquele objeto JSON serão adicionadas (ou sobrescritas caso já existirem) ao mod.
{
"version": 1,
"overrides": {
"example-mod": {
"+depends": {
"minecraft": ""
}
}
}
}2
3
4
5
6
7
8
9
10
Sobrescrevendo Dependências
Vamos presumir que um mod com o ID example-mod depende exatamente da versão do Minecraft 26.1, mas nós queremos que ele funcione nas outras versões 26.1. Vamos ver como podemos fazer isso:
{
"version": 1,
"overrides": {
"example-mod": {
"depends": {
"minecraft": "26.1.x"
}
}
}
}2
3
4
5
6
7
8
9
10
{
"depends": {
"fabricloader": ">=0.11.1",
"fabric-api": ">=0.28.0",
"minecraft": "26.1.x"
},
"breaks": {
"optifabric": "*"
},
"suggests": {
"anothermod": "*",
"flamingo": "*",
"modupdater": "*"
}
}2
3
4
5
6
7
8
9
10
11
12
13
14
15
Agora uma dependência "minecraft" será sobrescrita se especificada (e nós sabemos ser). Há outra forma de fazer isso:
{
"version": 1,
"overrides": {
"example-mod": {
"-depends": {
"minecraft": "IGNORED"
}
}
}
}2
3
4
5
6
7
8
9
10
{
"depends": {
"fabricloader": ">=0.11.1",
"fabric-api": ">=0.28.0",
"minecraft": "26.1.x"
},
"breaks": {
"optifabric": "*"
},
"suggests": {
"anothermod": "*",
"flamingo": "*",
"modupdater": "*"
}
}2
3
4
5
6
7
8
9
10
11
12
13
14
15
Como especificado acima, o valor da chave "minecraft" será ignorado ao remover as dependências. Se uma dependência com um requisito de ID de mod minecraft é encontrada, ela será removida do nosso mod alvo example-mod.
Nós também podemos sobrescrever inteiramente o bloco depends, mas com grandes poderes vem grandes responsabilidades. Tenha cautela.
Além de mudar a dependência minecraft, nós também queremos remover todas as dependências suggests. Nós podemos fazer isso removendo o prefixo da chave suggests, o que a substitui com um objeto vazio, essencialmente limpando seu conteúdo. Isso ficaria assim:
{
"version": 1,
"overrides": {
"example-mod": {
"-depends": {
"minecraft": ""
},
"suggests": {}
}
}
}2
3
4
5
6
7
8
9
10
11
{
"depends": {
"fabricloader": ">=0.11.1",
"fabric-api": ">=0.28.0",
"minecraft": "26.1"
},
"breaks": {
"optifabric": "*"
},
"suggests": {}
}2
3
4
5
6
7
8
9
10
11




