Cloth Config API: Por que esse mod está em alta em 2026

Cloth Config API é uma biblioteca que fornece a outros mods de Minecraft uma tela de configurações limpa e unificada. Você não a instala por recursos próprios. Todo mundo a instala porque dezenas de mods populares a listam como dependência, e em 2026 essa lista só cresce. Criada por shedaniel, está silenciosamente em todo lugar.

O que o Cloth Config API faz

Versão curta: é a tubulação. Cloth Config entrega aos desenvolvedores de mods uma GUI de configuração pronta, para que não precisem criar uma do zero toda vez. Alternâncias, sliders, menus suspensos, seletor de cores, categorias aninhadas. O autor define as opções, o Cloth Config desenha a tela.

Sem ele, muitos mods teriam que abrir um arquivo JSON manualmente (divirta-se) ou criar uma interface engessada que não combina com a de outros mods. Com ele, você tem um layout consistente em todo o pack. Abre a configuração de um mod e já sabe como usar as demais.

É isso. Não é glamouroso, mas é algo que você só percebe quando falta.

Um ponto a esclarecer: o Cloth Config, por si só, não adiciona nada que você veja jogando. Nada de blocos, mobs ou shaders. Instale sozinho, carregue um mundo e não notará diferença. Ele só entra em ação quando outro mod o chama.

Quem fez e por que isso importa

Cloth Config vem de shedaniel, um desenvolvedor em quem jogadores de modded já confiam sem perceber. É a mesma pessoa por trás de Roughly Enough Items e Architectury, duas ferramentas que sustentam grande parte do universo de mods.

Por que isso importa? Histórico. Uma biblioteca só é útil se for confiável, e uma dependência sem manutenção arrasta todos os mods que dependem dela para baixo. shedaniel mantém esses projetos atualizados de versão em versão do Minecraft, e é exatamente por isso que desenvolvedores confiam no Cloth Config para construir em cima dele.

Por que está em alta em 2026

Então, por que uma biblioteca de configuração de repente ganha atenção? Algumas razões se somam.

Primeiro, a cena de modding migrou fortemente para Modrinth e NeoForge nos últimos anos, e uma onda de mods foi atualizada para a 26.1. Cada vez que um mod grande se atualiza, suas dependências são arrastadas junto. O Cloth Config fica na base de grande parte do ecossistema Fabric, então seus downloads sobem a cada novo build de um mod popular. O Modrinth ainda o lista entre as bibliotecas mais baixadas, e isso não é por acaso.

Segundo, lançadores de modpacks agora sinalizam dependências ausentes automaticamente. Novos jogadores que nunca ouviram o nome continuam vendo a mensagem em vermelho: "requires Cloth Config API". A curiosidade faz o resto.

Terceiro, ele simplesmente funciona na versão atual. Na release 26.1.2 já está atualizado, o que não acontece com muitos mods que ficam em silêncio por meses após um grande update do Minecraft.

É "trending" no sentido do TikTok? Não. Ninguém faz montagens sobre telas de configuração. Mas no sentido prático de "o mod que todo mundo acaba instalando, planejado ou não", sim, está tendo seu momento.

Como instalar o Cloth Config API

Instalar é tão fácil quanto modding permite, principalmente porque você não configura nada por conta própria. Basta colocar a biblioteca onde o jogo a encontre.

No Fabric

Primeiro instale o Fabric Loader e o Fabric API. Depois baixe o Cloth Config no Modrinth ou CurseForge, combine a versão com a sua versão do Minecraft (essa parte importa mais do que parece) e coloque o .jar na pasta mods. Pronto.

A maioria dos jogadores usa o Mod Menu junto. O Mod Menu adiciona o botão que abre as telas de configuração no menu de pausa. O Cloth Config desenha a tela, o Mod Menu abre a porta. Parceria clássica.

No NeoForge

Ele funciona no Fabric e no Forge, bem, agora realmente no NeoForge, já que o suporte clássico ao Forge diminuiu nas versões atuais. O NeoForge o gerencia via Architectury, a caixa de ferramentas cross-loader do shedaniel. Baixe o arquivo correto e coloque em mods, mas verifique se o mod que você quer precisa da versão Fabric ou NeoForge. Escolher o arquivo errado é o erro mais comum que vejo nos fóruns de suporte.

Cheque rápido nas versões. Um build do Cloth Config para 1.20 não carrega na 26.1. Parece óbvio, mas metade dos posts de "crashou ao iniciar" vem de incompatibilidade entre a biblioteca e o loader. Leia o nome do arquivo. Duas vezes.

Os mods que dependem dele

A forma mais fácil de entender a importância é olhar quem depende dele. Roughly Enough Items (REI), o mod de visualização de receitas que muitos preferem ao JEI, é do próprio shedaniel e usa o Cloth Config. Também contam inúmeros mods de qualidade de vida e tecnologia que precisam de um painel de configurações real ao invés de um arquivo de texto.

Telas de configuração costumam controlar mais do que se imagina. Elas podem ajustar quais blocos um mod gera, taxas de spawn, reatribuir recursos, ligar ou desligar sistemas inteiros. Se estiver vasculhando opções e precisar confirmar o nome exato de um bloco para preencher um campo, nossa Busca de Blocos Minecraft economiza a ida à wiki.

Donos de servidores enfrentam outro tipo de dor de configuração. Listeners de voto, nós de permissão, etc. (Se as recompensas de voto do seu servidor pararem de funcionar, nosso testador Votifier dirá se o sinal chegou ao servidor). O Cloth Config não mexe na parte de server-side, mas o princípio é o mesmo: boas ferramentas tornam a configuração menos penosa.

O ponto está feito. Você raramente escolhe o Cloth Config; o mod que você quer já o escolheu por você.

Problemas comuns e como evitá-los

A maioria dos problemas não é culpa da biblioteca, mas aqui está o que costuma confundir:

• Incompatibilidade de versão: a versão da biblioteca deve combinar com sua versão do Minecraft e do loader. Esse é o grande.
• Build do loader errado: jar do Fabric em uma instância NeoForge (ou vice-versa) simplesmente não carrega.
• Falta do Fabric API: no Fabric, o Cloth Config espera que ele esteja presente. Sem Fabric API, nada funciona.
• Ausência do Mod Menu: a configuração existe, mas você não consegue acessá-la no jogo sem o botão.

Checklist chato? Sim. Mas resolve talvez nove em cada dez pânicos de "não inicia" antes mesmo que comecem.

Vale a pena instalar?

Se um mod que você quer lista como dependência: sim, claro, não há desvantagem. É pequeno, estável e quase não impacta a performance.

Se está pensando em instalar só por curiosidade: não, não há nenhum recurso para você. É uma fundação, não uma casa.

Minha opinião sincera após anos rodando modpacks: o Cloth Config é um daqueles mods que você esquece que tem até montar um pack novo e o jogo simplesmente se recusa a iniciar sem ele. Essa é a marca de uma boa infraestrutura. Invisível quando funciona, estrondoso quando falta. Mantenha-lo atualizado, combine as versões e você praticamente nunca mais precisará pensar nele. Essa é a ideia inteira.