Balm — biblioteca de mods para fazer mods funcionarem em diferentes loaders no Minecraft
Balm é uma biblioteca que permite aos mods do Minecraft funcionar da mesma forma no Fabric, Forge e NeoForge, sem versões separadas para…
Balm é uma biblioteca que permite aos mods do Minecraft funcionar da mesma forma no Fabric, Forge e NeoForge, sem versões separadas para cada loader.
Balm — biblioteca de mods para fazer mods funcionarem em diferentes loaders no Minecraft
Versão do Minecraft com a qual o artigo foi testado e escrito: 26.1.2
Intervalo de versões suportadas: 1.18.x – 26.2
Balm é uma biblioteca da qual outros mods para o Minecraft dependem; por si só, não adiciona blocos, itens, mobs ou mecânicas. Não faz sentido instalá-la separadamente: ela só é necessária quando outro mod indica o Balm como dependência obrigatória. A função da biblioteca é fornecer aos autores de mods um código comum que funciona da mesma forma no Fabric, Forge e NeoForge, sem uma versão separada para cada loader.
Para que serve o Balm
Cada loader de mods funciona à sua maneira: o registo de itens, o tratamento de eventos, a rede e as configurações são feitos de formas diferentes no Fabric, Forge e NeoForge. Sem uma camada intermédia, o autor teria de escrever uma versão separada do código para cada um deles. O Balm assume essa diferença — o mod recorre a um conjunto comum de ferramentas da biblioteca, e é ela que traduz as chamadas para a linguagem do loader específico.
Para o jogador, a consequência é simples: o mesmo mod pode ser lançado ao mesmo tempo para os três loaders, e o comportamento é igual em todos. Se na página do mod pretendido a lista de dependências indicar o Balm, basta descarregar ambos os ficheiros para o teu loader e versão do Minecraft e colocá-los na pasta mods.
A versão da biblioteca deve corresponder à versão do Minecraft e ao loader com que o mod principal foi compilado. Um ficheiro do Balm para Fabric não vai funcionar no Forge, e vice-versa.
O que a biblioteca assume
Fora do jogo o Balm não é visível, mas é ela a responsável por parte do comportamento dos mods baseados nela. A biblioteca abrange várias áreas:
registo de conteúdo — itens, blocos e outros objetos do mod são adicionados através de um mecanismo comum;
eventos do jogo — o mod reage às ações do jogador e do mundo através de um conjunto único de handlers;
rede — transferência de dados entre cliente e servidor, abertura de menus com informação adicional;
configurações — sistema de ficheiros de configuração com a possibilidade de os apresentar num ecrã próprio dentro do jogo.
Além disso, a biblioteca disponibiliza pontos de acesso comuns a utilitários de terceiros: visualizadores de receitas, painéis de informação HUD e mods de acessórios. Graças a isto, os autores não precisam de manter manualmente cada uma dessas integrações para cada loader.
Configuração dos mods através do Balm
As configurações são uma das poucas partes que a biblioteca implementa por si só, em vez de se limitar a traduzi-las para o loader. Os mods baseados no Balm podem apresentar os seus parâmetros num ecrã de configurações próprio, acessível a partir da lista de mods, pelo que não é necessário editar ficheiros manualmente.
A segunda coisa visível para o jogador é a sincronização. Parte das configurações é transmitida pelo servidor ao cliente durante a ligação, pelo que as regras se aplicam da mesma forma a todos os participantes. A biblioteca também verifica a compatibilidade das versões de rede: se a versão do mod no cliente e no servidor for diferente, a ligação é recusada com uma mensagem, em vez de provocar falhas ocultas já dentro do jogo.
Conclusão
O Balm permite aos autores lançarem um mod simultaneamente para Fabric, Forge e NeoForge a partir de um código comum, e garante ao jogador o mesmo comportamento em qualquer um dos loaders. Ao contrário de outras camadas de abstração, a biblioteca limita-se às ferramentas oficiais dos loaders e não traz dependências de terceiros consigo. Só faz sentido instalar o Balm quando outro mod o exige; em modpacks, normalmente já vem adicionado automaticamente.
Instalação
Uma instalação típica leva cerca de 5 minutos. O fluxo é o mesmo; só mudam o loader e o build correspondente.
- 1Install a mod loader (Forge, Fabric or NeoForge) that matches your Minecraft version.
- 2Download the mod file (.jar) built for that same version.
- 3Place the .jar into your .minecraft/mods folder.
- 4Launch Minecraft with the modded profile and check the mod loads in-game.











