Cloth Config API — mod para telas de configuração no Minecraft

Cloth Config API — mod para telas de configuração no Minecraft

Cloth Config API é uma biblioteca exigida por dezenas de modificações no Minecraft para exibir suas configurações na forma de um menu dentro do jogo em vez de um arquivo de texto. Por si só, ela não adiciona nada ao jogo: nem itens, nem blocos, nem novas mecânicas. É uma dependência — sem ela, os mods que a vincularam não iniciam e exibem um erro na lista de modificações.

Quando o mod é necessário

A biblioteca não é instalada de forma independente, mas junto com outras modificações. Há duas maneiras de saber se ela é necessária para um determinado conjunto:

• Na descrição do mod no Modrinth ou no CurseForge, a Cloth Config API está indicada na lista Dependencies.

• O jogo fecha ao iniciar o conjunto, e no registro (logs/latest.log) aparece uma menção à ausência de cloth-config ou cloth-config-2.

O nome interno cloth-config-2 pertence ao mesmo mod — é o identificador que surgiu a partir da segunda versão principal da biblioteca. Se alguém escreve «é necessário cloth-config-2», trata-se da versão moderna da Cloth Config API.

Como abrir as configurações do mod

No Forge e no NeoForge, a lista de modificações instaladas é integrada ao menu principal do jogo — a opção Mods. Ao lado de cada mod que vinculou a Cloth Config aparece um ícone de configurações. O clique abre uma tela separada com todos os parâmetros justamente dessa modificação.

No Fabric não há uma lista padrão de mods no carregador, por isso o acesso às telas da Cloth Config é realizado por meio de uma ferramenta externa de visualização de modificações — ela mostra a lista do que está instalado e permite clicar no botão ao lado do item desejado.

Configurações do mod com a ajuda da Cloth Config 

Como é a própria tela

Todas as telas do mod são montadas segundo o mesmo esquema: à esquerda — as categorias de parâmetros; no centro — os próprios parâmetros; embaixo — os botões Salvar e Cancelar. Cada parâmetro é exibido por um elemento da interface que corresponde ao tipo do seu valor. 

Na parte superior da tela, para configurações com dezenas de parâmetros, há um campo de busca — ele filtra a lista por nome. Ao lado dos parâmetros para os quais o autor da modificação definiu uma descrição, ao passar o cursor aparece uma dica com a explicação.

Se você inserir um valor fora do intervalo permitido ou em um formato não aceito, o campo é destacado e o botão de salvar fica inativo até que o erro seja corrigido. Ao lado de cada parâmetro há um botão de redefinição — ele retorna o valor àquele que o autor da modificação marcou como padrão.

Conclusão

Cloth Config API é uma dependência de infraestrutura: sem ela, parte das modificações simplesmente não inicia, mas o próprio mod não oferece nada visível no jogo sem outros mods vinculados. Seu papel é reduzir as configurações das diferentes modificações no Minecraft a um padrão visual comum em vez de uma dezena de interfaces de tipos distintos. No Fabric e em conjuntos multiplataforma, a Cloth Config API continua sendo o padrão comum mais difundido.