🦇 Wiki do Better Bats (Minecraft 26.1.2)
Boas-vindas à documentação oficial do Better Bats, um mod completo para Minecraft 26.1.2 Fabric que recria totalmente o comportamento dos morcegos (Chiroptera). O mod implementa revoada 3D realista com algoritmo BOIDs (murmuração), fototaxia orbital em torno de tochas e lanternas, fotofobia diurna com recolhimento para cavernas, fertilização de plantações com guano, combate predatório em mergulho contra traças e endermites, pânico por vibrações acústicas e genética de entidades.
📌 Aviso Legal sobre o Código Fonte do Repositório: A documentação nesta Wiki reflete o estado atual do código-fonte no repositório, podendo incluir commits recentes em desenvolvimento antes de serem lançados no CurseForge e Modrinth.
🧭 Navegação pela Wiki
📦 Guias de Plataforma e Instalação
- Guia Técnico do Minecraft 26.1 — Especificações técnicas (JDK 25, Fabric Loader >=0.19.1, Fabric API 0.145.4+26.1.2).
- Matriz de Compatibilidade de Versões — Versões suportadas, checagem
ModVersionGuarde dependências. - Ambiente de Desenvolvimento e Compilação — Compilação com Gradle 9.3+ sem daemon (
--no-daemon) e Loom.
🎮 Guias de Jogabilidade e Mecânicas
- Ecologia dos Morcegos, Fotofobia e Poleiros — Limiares de luminosidade diurna e superfícies de repouso válidas (estalactites, lanternas, correntes, folhas).
- Revoadas 3D BOIDs, Limites de Altitude e Física — Forças vetoriais de coesão, alinhamento e separação ao entardecer.
- Produção de Guano e Fertilização Agrícola — Temporizadores de repouso, efeito de farinha de osso e drop físico de itens.
- Fototaxia e Órbita Noturna de Luzes — Detecção de fontes de luz, efeito mariposa e curvas suaves de aproximação.
- Controle de Pragas e Combate Predatório — Ataque em mergulho contra traças e endermites com dano genético.
- Ecolocalização Acústica e Pânico por Vibração — Pulsos sónicos com partículas de alma do sculk e dispersão por passos ou explosões.
- Genética Animal e Herança de Características — Envergadura (0.75x–1.30x), velocidade de voo e multiplicador de ataque.
- Tabela de Regras de Jogo Dinâmicas — Todas as 9 GameRules sob o namespace
better-bats:better_bats. - Spawn Ambiente e Modificadores de Peso — Spawn na superfície noturna e peso dinâmico de geração subterrânea.
- Diagnósticos HUD e Menus de Configuração — Menus com YetAnotherConfigLib (YACL v3) e integração ao ModMenu.
- Guia de Comandos e Conquistas — Árvore de comandos
/betterbatse/bb, compatibilidade com/gamerule. - Efeitos Sonoros e Matriz de Partículas — Matriz de emissão de partículas e eventos de áudio.
- Solução de Problemas e Perguntas Frequentes — Resolução de travamentos no início e sincronização de mundo.
💻 Referência Técnica para Desenvolvedores
- Arquitetura e Estrutura de Pacotes — Princípio de responsabilidade única e arquitetura de classes.
- Referência de Mixins e Pontos de Injeção — Injeções em
Bat,GameEventDispatchereNaturalSpawner. - Perfis de Comportamento e Métodos de Acesso — Matriz de prioridades e protocolo
BatStateAccessor. - Guia de Integração para Outros Mods — Integração via DasikLibrary API e leitura de genética.
📜 Direitos Autorais e Licença
Better Bats é software de código aberto desenvolvido por Dasik (Rifaditya) e licenciado sob a GNU General Public License v3.0 (GPL-3.0-or-later).