JamLib — uma biblioteca técnica para outros mods de Minecraft

JamLib — uma biblioteca técnica para outros mods de Minecraft

O JamLib é um mod-biblioteca para Minecraft que, por si só, não adiciona ao jogo itens, blocos, mobs nem estruturas. É um wrapper utilitário que dá aos autores de outros mods o seguinte: uma abstração de plataforma entre loaders, um sistema de ficheiros de configuração já pronto e um detetor de ficheiros jar reempacotados. Sem esta biblioteca, os mods que a exigem simplesmente não arrancam.

O que faz o mod

A biblioteca resolve três tarefas para o programador ao mesmo tempo:

• Abstrações de plataforma baseadas no Architectury — o mesmo código funciona no Fabric, Forge, NeoForge e Quilt sem ramos separados.

• Uma API de configuração em formato JSON5 com um ecrã de definições automático dentro do jogo.

• Verificação do ficheiro jar de um mod à procura de sinais de reempacotamento a partir de «espelhos» piratas.

Do ponto de vista do jogador, a biblioteca não acrescenta nada à jogabilidade. A única coisa que se pode notar é o aparecimento de uma entrada no menu de mods para qualquer mod que use o JamLib para as suas definições. Se esses mods estiverem presentes na pack, a janela correspondente mostrará uma página com controlos deslizantes, interruptores e campos de introdução, gerada automaticamente.

Configurações JSON5

O JSON padrão não permite comentários no código. O JSON5, com o qual a biblioteca trabalha através da dependência Jankson, permite. Na prática, isto significa que os ficheiros de definições dos mods construídos sobre o JamLib parecem .json5 e já contêm comentários a descrever cada parâmetro juntamente com o respetivo valor predefinido mesmo por cima.

Os ficheiros preservam as alterações do utilizador ao serem reescritos: se adicionar a sua própria nota numa linha //, esta permanecerá no lugar depois de a configuração ser guardada novamente. As bibliotecas JSON padrão não conseguem fazer isto.

Os ecrãs de definições são gerados separadamente. No Fabric e no Quilt, a interface é apresentada através do menu de mods padrão; no Forge e no NeoForge, através da API integrada de ecrãs de configuração do loader. Os autores de mods não precisam de escrever uma GUI à mão: o JamLib pega nos campos da classe de configuração e constrói para eles widgets com validação — intervalo de números, expressão regular para strings, avisos sobre a necessidade de reiniciar o jogo.

Detetor de mods reempacotados

Uma função separada verifica se o ficheiro .jar do mod instalado foi transferido a partir de uma fonte oficial. Alguns sites reempacotam mods com os seus próprios nomes e, por vezes, juntam-lhes software de terceiros. O JamLib compara o nome real do ficheiro com o campo JamLib-File-Name presente no seu manifesto. Se não corresponderem, é apresentado um aviso no chat depois de o mundo carregar. A mensagem é mostrada uma vez por cada ficheiro suspeito, após o que o nome desse .jar é memorizado.

A verificação aplica-se apenas aos mods cujos autores adicionaram deliberadamente o JamLib-File-Name ao seu manifesto (ou seja, mods do mesmo programador ou de quem integrou esta funcionalidade manualmente). A biblioteca não analisa todos os .jar na pasta mods à procura de vírus ou código malicioso — não é um antivírus.

Conclusão

O JamLib liberta o programador de um mod de escrever manualmente um sistema de configuração e uma abstração de plataforma para quatro loaders ao mesmo tempo. Instalar o JamLib só faz sentido em conjunto com um mod dependente que o exija. Se uma pack não tiver nenhum mod da JamCoreModding nem de outro autor terceiro baseado nesta biblioteca, o .jar do JamLib ficará simplesmente na pasta mods sem um papel ativo.