Portal Principal de la Wiki - Dasik Library
Bienvenido a la documentación técnica oficial de Dasik Library, el motor de IA social compartida con Mente Colmena (Hive Mind), marco de genética, calculadora de bandadas Boids e infraestructura dinámica de GameRules para mods de Fabric Minecraft.
📌 Aviso sobre el Código Fuente del Repositorio: La documentación de esta Wiki refleja el estado actual del código fuente en el repositorio, que puede incluir confirmaciones recientes no publicadas o características en desarrollo antes de las compilaciones públicas en CurseForge y Modrinth.
💡 Filosofía Arquitectónica
Dasik Library opera bajo dos principios arquitectónicos fundamentales:
- "Thin Mod, Fat Library" (Mod Ligero, Biblioteca Robusta): Los mods consumidores modulares se enfocan estrictamente en el contenido de entidades y registros. Las matemáticas complejas, la planificación de ticks, la herencia genética, el cálculo de vectores de dirección Boids y la serialización de estado NBT se centralizan dentro de Dasik Library.
- "One Brain, Many Minds" (Un Cerebro, Múltiples Mentes): La ejecución de pulsos centralizada a través de
GlobalSocialSystemaplica la Regla del Inmortal (Highlander Rule) (estrictamente 1 ciclo de pulso global por tick del juego) para administrar miles de entidades activas con bajo impacto de rendimiento.
📦 Directorio de Versiones de Minecraft
- Guía de MC 26.2 — Instalación y configuración para Minecraft 26.2+.
- Compatibilidad de Versiones — Matriz del ciclo de vida de compatibilidad multiversión (
>=26.1.2-a26.2+), seguridad de Knot ClassLoader y reglas de protección de versión.
🎮 Matriz de Sistemas y Mecánicas Principales
Explore las mecánicas técnicas completas y las guías de configuración:
- Sistema Social de Mente Colmena — Motor de pulso único, Regla del Inmortal, registro fragmentado $O(1)$
SocialRegistryy presupuestos de tick. - Programador Social y Eventos —
EntitySocialScheduler, ejecución dual Mood/Ambient, nivelesPriorityTierySocialEventRegistry. - Motor de Genética Animal — Adjunto
EntityGenetics, codificación DNA long, límites de escala (0.1x-3.0x), indicadores de cría raquítica y matemáticas de herencia. - API de Genética y Pedigrí — Fachada
DasikAnimalGeneticsAPI, cálculo de árbol genealógico y parentesco, fórmulas de predicción de endogamia y modificadores dinámicos. - Modificadores de Botín Genético —
GeneticsLootModifier,GeneticsLootRegistryy lógica de envoltura de caídas conLivingEntityLootMixin. - Seguidor de Líder y Bandadas —
GroupMember,FollowLeaderGoal, estrategias de bandadas Boids aéreas y terrestres y pesos deGroupParameters. - Gestor de GameRules Dinámicas —
DynamicGameRuleManager, registro dinámico, inyección automática de traducciones en inglés, encabezados en negrita (§l) y ayudantes matemáticos. - Codec y Serialización de GameRules — Validación de límites enteros de GameRule (
Integer.MIN_VALUEfallback), evitando cierres inesperados enSavedDataStorage.encodeUnchecked. - GameRules del Cliente y Ayudantes de GUI — Consultas al servidor integrado con
ClientGameRuleHelper,GuiHelper, reemplazo atómico de JSON enConfigHelpery seguridad para servidores dedicados. - Encantamientos Dinámicos y Rastreador de Visión — Inyección en tiempo de ejecución con
DynamicEnchantmentManagery comprobaciones de cono visual conPlayerVisionTracker. - Utilidades Estocásticas y Matemáticas — Algoritmos XORSHIFT en
FastRandom, tiradas de probabilidad por mil/deciles enStochasticUtily conversión de ticks a segundos ($20\text{ ticks} = 1\text{s}$). - Purga de Atributos Obsoletos y Escala — Reglas de purga de modificadores de atributos, matemáticas de desplazamiento base
ADD_VALUE-1.0fy seguridad de identificadoresgenetics_. - ModVersionGuard y Seguridad de Inicio — Seguridad de Knot ClassLoader (
Thread.currentThread().getContextClassLoader()) y prevención de fallos al iniciar el juego.
💻 Referencia Técnica y para Desarrolladores
- Configuración de Desarrollador y Compilación — Requisitos de JDK 25, Gradle 9.3+,
./gradlew build --no-daemony./gradlew test. - Arquitectura y Distribución de Paquetes — Árbol de paquetes ASCII completo (
ai,api,config,core,mixin,util) y modelos de concurrencia segura. - Referencia de Mixins y Puntos de Inyección — Tabla detallada de Mixins (
LanguageMixin,LivingEntityLootMixin,MobGoalAccessor,PathfinderMobMixin,ProfileTriggerMixin). - Perfiles de Comportamiento y Condiciones —
BehaviorProfileManager,BehaviorProfile,BehaviorCondition,ProfileAwareyDefaultProfileBuilder. - Guía de Integración para Mods Consumidores — Guía de integración y fragmentos de código para mods (Better Dogs, Natural Reproduction, Collapsible Game Rule Screen, Bat Ecology, Ore Amplifier).