Forge Config API Port — Minecraft Java Edition

O Minecraft vanilla não possui ferramentas integradas para configuração conveniente de parâmetros do jogo ou modificações, forçando os desenvolvedores a criar sistemas de salvamento de configuração por conta própria. O carregador de mods Forge oferece uma solução pronta na forma de seu próprio sistema de configuração, mas o Fabric historicamente não possui um padrão único para isso. Por conta disso, os criadores de mods multiplataforma precisam escrever códigos de configuração separados para cada carregador, gastando muito tempo em tarefas rotineiras. A biblioteca Forge Config API Port resolve esse problema ao portar a interface de configuração comprovada do Forge para o Fabric e Quilt.

Como a biblioteca funciona

A Forge Config API Port atua como intermediária entre o código da modificação e o sistema de arquivos do jogo. Ela recria totalmente os pacotes originais net.minecraftforge.common.ForgeConfigSpec e net.neoforged.fml.config no ambiente Fabric. O desenvolvedor escreve a descrição da configuração apenas uma vez usando a sintaxe padrão do Forge, e a biblioteca cria automaticamente os arquivos correspondentes no disco e gerencia seu carregamento.

Formato de arquivo de configuração TOML

A biblioteca armazena todas as configurações no formato TOML. Este formato oferece uma estrutura conveniente para leitura e edição usando um editor de texto comum. Cada parâmetro pode conter comentários, valores padrão, bem como limites claros de valores permitidos (número mínimo e máximo). Os arquivos de configuração aparecem automaticamente na pasta config dentro do diretório raiz do jogo após a primeira inicialização da modificação. Eles têm a extensão .toml e o nome especificado pelo desenvolvedor do mod.

Sincronização automática e recarregamento dinâmico

Uma das características mais importantes da Forge Config API Port é o suporte integrado para sincronização e recarregamento dinâmico de configurações:

• Sincronização entre servidor e cliente (Sync): quando um jogador se conecta ao servidor, o servidor envia automaticamente suas configurações para o cliente. Isso evita conflitos devido a diferentes versões de configuração entre os jogadores no servidor.

• Recarregamento dinâmico (Reload): a biblioteca monitora alterações nos arquivos TOML em tempo real. Se você editar e salvar o arquivo de configuração durante o jogo, a Forge Config API Port atualizará imediatamente os parâmetros na memória RAM sem a necessidade de reiniciar o cliente do Minecraft.

esses mecanismos funcionam automaticamente, liberando os desenvolvedores de ter que codificar a interação de rede por conta própria para sincronizar os valores de configuração.

Importância para jogadores e desenvolvedores

Para jogadores comuns, a Forge Config API Port não adiciona nenhum conteúdo visível, novos blocos ou itens. Seu papel é garantir o funcionamento de outras modificações. Sem instalar esta biblioteca, o jogo simplesmente não iniciará se outros mods fizerem referência às suas classes. A modificação é necessária principalmente para usuários do Fabric, pois o Forge e o NeoForge possuem essas funções por padrão em sua estrutura.

Para desenvolvedores, a biblioteca é uma ferramenta indispensável ao criar projetos multiplataforma. Ela permite:

1. Economizar centenas de linhas de código que antes eram gastas no desenvolvimento de uma lógica separada de salvamento de configurações para diferentes carregadores.

2. Garantir a mesma experiência de administração de mods para os usuários finais, pois os arquivos de configuração possuem uma estrutura idêntica no Fabric e no Forge.

3. Usar o poderoso kit de ferramentas de validação de valores do Forge, que corrige automaticamente as entradas incorretas do usuário, restaurando os parâmetros para os valores padrão em caso de falhas.

Modificações dependentes populares

O desenvolvedor da biblioteca, conhecido pelo pseudônimo Fuzs (ou Fuzs_), usa-a em todos os seus mods populares. Aqui estão alguns exemplos conhecidos:

• Easy Magic: um mod que altera a mecânica da mesa de encantamentos, permitindo guardar itens dentro do inventário da mesa e adicionando novas maneiras de melhorar os encantamentos.

• Trading Post: um bloco que unifica as ofertas comerciais de todos os aldeões ao redor em uma única interface.

• Visuality: um mod de efeitos visuais que adiciona partículas realistas de sujeira, faíscas e respingos de água de várias ações dos mobs.

• Easy Shulker Boxes: permite interagir com caixas de shulker diretamente do inventário sem ter que colocá-las no chão.

Além dos projetos do Fuzs, centenas de outros desenvolvedores usam a Forge Config API Port para portar seus trabalhos do Forge para o Fabric, dando aos jogadores acesso a uma enorme biblioteca de conteúdo de qualidade.