Dasik Library Wiki
Welcome to the official technical documentation for Dasik Library, the shared Hive Mind social AI engine, genetics framework, Boids flocking calculator, and dynamic GameRule infrastructure for Fabric Minecraft mods.
📌 Repository Source Disclaimer: The documentation in this Wiki reflects the current source code state in the repository, which may include recent unreleased commits or developmental features ahead of public release builds on CurseForge and Modrinth.
💡 Architectural Philosophy
Dasik Library operates under two core architectural principles:
- "Thin Mod, Fat Library": Modular consumer mods focus strictly on entity content and registration. Complex math, tick scheduling, genetic inheritance, Boids steering vector calculations, and NBT state serialization are centralized within Dasik Library.
- "One Brain, Many Minds": Centralized pulse execution via
GlobalSocialSystemenforces the Highlander Rule (strictly 1 global tick cycle per game tick) to manage thousands of active entities with low performance impact.
📦 Minecraft Versions Directory
- MC 26.2 Guide — Installation and configuration for Minecraft 26.2+.
- Version Compatibility — Multi-version compatibility lifecycle matrix (
>=26.1.2-to26.2+), Knot ClassLoader safety, and version guard rules.
🎮 Core Systems & Mechanics Matrix
Explore the complete technical mechanics and configuration guides:
- Hive Mind Social System — Single-pulse engine, Highlander Rule, $O(1)$ shard-based
SocialRegistry, and tick budgets. - Social Scheduler & Events —
EntitySocialScheduler, dual-track Mood/Ambient execution,PriorityTier, andSocialEventRegistry. - Animal Genetics Engine —
EntityGeneticsattachment, DNA long encoding, size-stats & scale bounds (0.1x-3.0x), runt indicators, and inheritance math. - Genetics API & Pedigree —
DasikAnimalGeneticsAPIfacade, Kinship & Pedigree family tree calculation, inbreeding risk prediction formulas, and dynamic trait reset/modifiers. - Genetics Loot Modifiers —
GeneticsLootModifier,GeneticsLootRegistry, andLivingEntityLootMixindrop wrapping logic. - Leader Follower & Flocking —
GroupMember,FollowLeaderGoal, Aerial & Terrestrial Boids flocking strategies, andGroupParametersweights. - Dynamic GameRules Manager —
DynamicGameRuleManager, dynamic registration, English translation injection, bold category headers (§l), and math helpers (getPct/getChance). - GameRule Codec & Serialization — Integer GameRule bounds validation (
Integer.MIN_VALUEfallback) preventingSavedDataStorage.encodeUncheckedcrashes. - Client GameRule & GUI Helpers —
ClientGameRuleHelperintegrated server lookups,GuiHelper,ConfigHelperatomic JSON swaps, and server crash safety gating. - Dynamic Enchantments & Vision —
DynamicEnchantmentManagerruntime injection, andPlayerVisionTrackerraycasting frustum checks. - Stochastic & Math Utilities —
FastRandomXORSHIFT algorithms,StochasticUtildecile/permille rolls, andTimeUtiltick-to-second ($20\text{ ticks} = 1\text{s}$) conversions. - Stale Attribute Purging & Scale — Attribute modifier purging rules,
ADD_VALUE-1.0fscale base offset math, andgenetics_modifier safety. - ModVersionGuard & Startup Safety —
ModVersionGuardKnot ClassLoader safety (Thread.currentThread().getContextClassLoader()), and pre-release startup crash prevention.
💻 Developer & Technical Reference
- Developer Setup & Building — JDK 25 prerequisites, Gradle 9.3+,
./gradlew build --no-daemon, and./gradlew test. - Architecture & Package Layout — Complete ASCII package tree (
ai,api,config,core,mixin,util) and thread-safety models. - Mixin Reference & Hooks — Detailed Mixin breakdown table (
LanguageMixin,LivingEntityLootMixin,MobGoalAccessor,PathfinderMobMixin,ProfileTriggerMixin). - Behavior Profiles & Conditions —
BehaviorProfileManager,BehaviorProfile,BehaviorCondition,ProfileAware, andDefaultProfileBuilder. - Consumer Mods Integration Guide — Integration guide and code snippets for consumer mods (Better Dogs, Natural Reproduction, Collapsible Game Rule Screen, Bat Ecology, Ore Amplifier).