LibJF — Biblioteca técnica e núcleo para suporte a mods de terceiros no Minecraft

LibJF — Biblioteca técnica e núcleo para suporte a mods de terceiros no Minecraft

LibJF é uma biblioteca modular do autor JFronny, contendo um conjunto de componentes partilhados para os seus próprios mods. No PC de um jogador, este mod geralmente não é instalado isoladamente, mas como uma dependência obrigatória — sem ele, os respetivos mods não iniciarão. LibJF não adiciona receitas, criaturas ou novos blocos ao Minecraft. A sua tarefa é diferente: extrair a funcionalidade repetitiva — formato de configuração, sistema de tradução, servidor HTTP local, duas etiquetas utilitárias — para um projeto separado e reutilizá-la em diferentes mods do mesmo programador.

Propósito num Modpack

A biblioteca está dividida em módulos separados, cada um responsável pela sua tarefa: o formato dos ficheiros de configuração e o seu menu no jogo, etiquetas de itens, tradução, componentes de rede. Os mods que dependem do LibJF apenas carregam os módulos que realmente usam. Portanto, após o primeiro lançamento do jogo, não aparece apenas um ficheiro na pasta config/, mas vários (um por módulo ativo).

Um dos efeitos básicos que o jogador notará imediatamente é o recarregamento automático das configurações. O parâmetro watchForChanges está ativado por predefinição: se alterar qualquer ficheiro de configuração através do LibJF, as alterações serão aplicadas sem reiniciar o jogo.

Etiquetas universais para itens e armaduras

LibJF adiciona duas etiquetas disponíveis tanto para outros mods como para datapacks vanilla:

As próprias etiquetas estão vazias — são preenchidas por um datapack ou um mod de terceiros. Para tornar, por exemplo, um conjunto de couro completo "impenetrável" na sobrevivência, basta criar um pequeno datapack que adicione minecraft:leather_helmet, minecraft:leather_chestplate, minecraft:leather_leggings e minecraft:leather_boots ao ficheiro de etiqueta libjf:overpowered.

Subsistema de Tradução

O módulo libjf-translate-v1 dá a outros mods do programador acesso a um serviço de tradução de strings. A biblioteca em si não traduz nada no chat ou interface — determina apenas por qual serviço externo os pedidos passarão se um mod consumidor os chamar. São suportadas quatro opções de provedor:

• Google — interface pública do Google Translate (valor predefinido).

• DeepLX — implementação aberta da API DeepL.

• LibreTranslate — solução open-source alojada pelo utilizador; requer a especificação da morada da instância.

• Noop — devolve o texto inserido sem alterações; útil para testes e para desativar completamente a tradução.

Um parâmetro separado throttleMillis define a pausa mínima entre as chamadas ao serviço. Esta restrição é necessária para evitar banimentos temporários da API gratuita em caso de pedidos frequentes de um mod.

Servidor Web Local

O módulo libjf-web-v1 lança um pequeno servidor HTTP dentro do jogo. É usado por outros mods do autor quando é necessário fornecer ao cliente algo mais do que um pacote de rede normal (p. ex., uma página estática ou um ficheiro de pré-visualização). No ambiente padrão de um jogador, este módulo geralmente é silencioso: a porta está aberta apenas localmente (127.0.0.1) e a partilha de ficheiros está desativada.

Os administradores de servidores privados podem ativar a partilha de ficheiros arbitrários da pasta config/wwwroot como recursos estáticos através de um parâmetro de configuração separado — esta é uma funcionalidade opcional, não ativada por predefinição.

Conclusão

LibJF é uma biblioteca de dependência necessária quando um modpack contém um mod do mesmo programador ou um datapack que usa as etiquetas libjf:overpowered ou libjf:shulker_boxes_illegal. Em comparação com outras bibliotecas desta classe, distingue-se por uma arquitetura modular e pela presença de um servidor HTTP local juntamente com uma camada de tradução, o que a maioria das bibliotecas auxiliares não oferece. Para um modpack normal do Minecraft Java Edition vanilla, não faz sentido instalar LibJF; para modpacks com mods do JFronny, é obrigatório.