Learn · frameworks
O que é a API Fabric? Modding Explicado
A Fabric API é a biblioteca compartilhada da qual quase todos os mods do Fabric dependem. Veja o que ela faz, por que ela está separada do carregador e se você precisa dela.
O que é a API Fabric?
A API Fabric é a caixa de ferramentas comum sobre a qual o ecossistema Fabric se baseia. O carregador em si só sabe como iniciar o jogo e aplicar patches; ele não inclui quase nenhum recurso de conveniência. A API preenche essa lacuna com um conjunto estável de eventos, auxiliares e interfaces, para que mods individuais não precisem reinventar a mesma fiação ou se atrapalhem quando o fazem.
Pense nisso como a biblioteca padrão que o carregador omite. Quando um autor de mod deseja reagir a um jogador entrando, enviar um pacote personalizado ou registrar um novo bloco, ele chama a API em vez de hackear o motor diretamente.
Por que a API Fabric não faz parte do carregador?
O Fabric divide deliberadamente o sistema em duas partes. O carregador é o núcleo pequeno e de mudanças lentas que inicializa o Minecraft e executa a camada de patching. A API é o conjunto maior e de mudanças mais rápidas de interfaces compartilhadas empilhadas por cima. Mantê-los separados permite que cada um se mova em seu próprio ritmo.
| Peça | Tarefa | Ritmo de atualização |
|---|---|---|
| Carregador Fabric | Inicializa o jogo, aplica patches Mixin, resolve mods | Portado para uma nova versão do MC rapidamente |
| API Fabric | Eventos compartilhados, rede, registro, auxiliares de renderização | Evolui em seu próprio cronograma |
O grande benefício é a velocidade. Quando uma nova versão do Minecraft é lançada, um pequeno carregador pode ser compatível em poucas horas, enquanto a ampla API acompanha sem bloquear a primeira porta. Junte-os e a pilha inteira só se moveria tão rápido quanto sua parte mais lenta.
O que a API Fabric realmente oferece?
A API oferece aos mods uma forma estável de versão para fazer as coisas que quase todos os mods precisam. Em vez de cada autor escrever ganchos frágeis contra os internos brutos do jogo, eles visam uma superfície compartilhada que a comunidade mantém em conjunto.
Ciclo de vida e eventos de jogabilidade
Callbacks limpos para ticks, carregamento do mundo, entrada de jogadores e interação com blocos, para que mods possam reagir ao jogo sem a necessidade de patch manual.
Ajudantes de networking
Uma forma sensata de definir e enviar pacotes personalizados entre cliente e servidor, a espinha dorsal da maioria das mods com consciência de multiplayer.
Auxiliares de conteúdo e registro
Instalações hidráulicas compartilhadas para registrar novos itens, blocos e entidades, permitindo que dois mods adicionem conteúdo sem conflitar.
Renderização e auxiliares de recursos
Mods de ganchos de renderização comuns e utilitários de recursos dependem de HUD, modelos e texturas.
Remova a API e cada mod teria que distribuir sua própria cópia dessa estrutura. Eles duplicariam o esforço e se desviariam, quebrando uns aos outros no momento em que os combinasse em uma única pasta. A biblioteca compartilhada é o que mantém um monte de mods não relacionados funcionando bem juntos.
Você precisa da API Fabric?
Quase sempre, sim. A grande maioria dos mods Fabric a declara como dependência obrigatória, o que significa que eles não carregarão sem ela. Você a instala uma vez como um mod jar comum na sua pasta mods, e cada mod que a precisa utiliza a mesma cópia.
- Está usando Fabric com mais de um ou dois mods? Instale a API.
- A página do mod lista "Fabric API" em requisitos? Instale-a.
- Está a usar um único mod pequeno e autónomo que indica explicitamente que não precisa de nada? Pode ignorar a API, embora raramente custe nada em manter.
A versão curta: trate a API Fabric como uma base. O custo de tê-la quando você não a precisa estritamente é um jar extra. O custo de não tê-la é um crash.
Onde obter a API Fabric e como fazer o versionamento
Baixe a API dos canais oficiais do Fabric ou dos principais hosts de mods, e escolha a versão marcada para a sua versão exata do Minecraft. O versionamento é a coisa mais comum que as pessoas fazem de errado, e causa os crashes mais altos e confusos.
Confirme a versão do seu Minecraft
Observe a versão exata do seu perfil ao ser iniciado, incluindo o número da atualização.
Baixe a versão da API correspondente
Pegue a versão do Fabric API lançada com a mesma versão, não a mais recente disponível.
Coloque-o na pasta mods
Coloque o jar ao lado dos seus outros mods. Uma cópia serve para todos os mods que dependem dele.
Lance e leia o log se falhar
Se algo falha, o log geralmente indica a classe ausente ou a versão que esperava. Essa linha aponta diretamente para a correção.
Se gerenciar manualmente versões de carregadores, APIs e mods parece tedioso, é porque é. Lançadores gerenciados e clientes utilitários existem, em parte, para resolver essa cadeia de dependências por você, para que o jogo simplesmente abra.
Perguntas Frequentes
Nem todos, mas a maioria. Qualquer mod que o declare como dependência se recusa a carregar sem ele. Poucos mods pequenos e independentes o ignoram, mas instalá-lo é a opção segura por padrão, pois no momento em que você adiciona um segundo mod, provavelmente precisará dele.
Dos canais oficiais de distribuição do Fabric e dos principais hosts de mods. A única regra que importa: obtenha a versão que lista exatamente a sua versão do Minecraft. Um arquivo .jar 1.21 não salvará um jogo 1.20.
Por design. O carregador é mantido deliberadamente pequeno para que possa ser portado para uma nova versão do Minecraft rapidamente, enquanto a API maior evolui no seu próprio ritmo. A divisão deles impede que a parte que muda rapidamente retenha a parte que precisa ser atualizada primeiro.
Normalmente, você enfrenta uma falha ao iniciar, frequentemente um erro de classe ou método ausente no log. A correção é quase sempre deletar o jar incompatível e substituir pelo build da API que corresponde à sua versão do Minecraft.
Carregador, API e mods resolvidos para você, sem dores de cabeça com a correspondência de versões.