Portal Principal da Wiki - Dasik Library
Bem-vindo à documentação técnica oficial da Dasik Library, o motor compartilhado de IA social com Mente Coletiva (Hive Mind), framework de genética, calculadora de revoadas Boids e infraestrutura dinâmica de GameRules para mods do Fabric Minecraft.
📌 Aviso sobre o Código Fonte do Repositório: A documentação nesta Wiki reflete o estado atual do código fonte no repositório, que pode incluir commits recentes não lançados ou recursos em desenvolvimento antes das versões públicas no CurseForge e Modrinth.
💡 Filosofia de Arquitetura
A Dasik Library opera sob dois princípios arquiteturais essenciais:
- "Thin Mod, Fat Library" (Mod Enxuto, Biblioteca Robusta): Mods consumidores modulares focam estritamente no conteúdo e no registro de entidades. Cálculos matemáticos complexos, agendamento de ticks, herança genética, vetores de direcionamento Boids e serialização de estado NBT são centralizados na Dasik Library.
- "One Brain, Many Minds" (Um Cérebro, Várias Mentes): A execução centralizada de pulsos via
GlobalSocialSystemimpõe a Regra do Imortal (Highlander Rule) (estritamente 1 ciclo de pulso global por tick do jogo) para gerenciar milhares de entidades ativas com baixíssimo impacto de desempenho.
📦 Diretório de Versões do Minecraft
- Guia MC 26.2 — Instalação e configuração para Minecraft 26.2+.
- Compatibilidade de Versões — Matriz do ciclo de vida de compatibilidade multiversão (
>=26.1.2-a26.2+), segurança do Knot ClassLoader e regras de guarda de versão.
🎮 Matriz de Sistemas Principais e Mecânicas
Explore os guias técnicos e mecânicas completas:
- Sistema Social de Mente Coletiva — Motor de pulso único, Regra do Imortal, registro shard $O(1)$
SocialRegistrye orçamento de ticks. - Agendador Social e Eventos —
EntitySocialScheduler, execução de via dupla Mood/Ambient, escalonamentoPriorityTiereSocialEventRegistry. - Motor de Genética Animal — Anexo
EntityGenetics, codificação DNA long, limites de escala (0.1x-3.0x), indicadores de nanismo e matemática de herança. - API de Genética e Pedigree — Fachada
DasikAnimalGeneticsAPI, cálculo de árvore genealógica e parentesco, fórmulas de predição de consanguinidade e modificadores dinâmicos. - Modificadores de Saque Genético —
GeneticsLootModifier,GeneticsLootRegistrye lógica de interceptação de drops comLivingEntityLootMixin. - Seguidor de Líder e Revoada Boids —
GroupMember,FollowLeaderGoal, estratégias de revoada Boids aéreas e terrestres e pesos deGroupParameters. - Gerenciador Dinâmico de GameRules —
DynamicGameRuleManager, registro dinâmico, injeção automática de traduções em inglês, cabeçalhos em negrito (§l) e helpers matemáticos. - Codec e Serialização de GameRules — Validação de limites inteiros de GameRule (
Integer.MIN_VALUEfallback), prevenindo falhas emSavedDataStorage.encodeUnchecked. - GameRules do Cliente e Auxiliares de GUI — Consultas ao servidor integrado via
ClientGameRuleHelper,GuiHelper, substituição atômica de JSON emConfigHelpere segurança para servidores dedicados. - Encantamentos Dinâmicos e Rastreador de Visão — Injeção em tempo de execução com
DynamicEnchantmentManagere checagem de cone visual comPlayerVisionTracker. - Utilitários Estocásticos e Matemáticos — Algoritmos XORSHIFT no
FastRandom, sorteios por milhar/decis noStochasticUtile conversão de ticks em segundos ($20\text{ ticks} = 1\text{s}$). - Purga de Atributos Obsoletos e Escala — Regras de purga de modificadores de atributos, matemática de deslocamento base
ADD_VALUE-1.0fe segurança de identificadoresgenetics_. - ModVersionGuard e Segurança de Inicialização — Segurança do Knot ClassLoader (
Thread.currentThread().getContextClassLoader()) e prevenção de travamentos na inicialização.
💻 Referência Técnica e de Desenvolvedor
- Configuração de Desenvolvedor e Compilação — Pré-requisitos de JDK 25, Gradle 9.3+,
./gradlew build --no-daemone./gradlew test. - Arquitetura e Estrutura de Pacotes — Árvore completa de pacotes em ASCII (
ai,api,config,core,mixin,util) e modelos de concorrência segura. - Referência de Mixin e Pontos de Injeção — Tabela detalhada de Mixins (
LanguageMixin,LivingEntityLootMixin,MobGoalAccessor,PathfinderMobMixin,ProfileTriggerMixin). - Perfis de Comportamento e Condições —
BehaviorProfileManager,BehaviorProfile,BehaviorCondition,ProfileAwareeDefaultProfileBuilder. - Guia de Integração para Mods Consumidores — Guia de integração e trechos de código para mods (Better Dogs, Natural Reproduction, Collapsible Game Rule Screen, Bat Ecology, Ore Amplifier).