Dasik Library

<img src="https://img.shields.io/badge/Requires-Fabric_API-blue?style=for-the-badge&logo=fabric" alt="Requires Fabric API"> <img src="https://img.shields.io/badge/Discord-Join_Community-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Join Discord"> <img src="https://img.shields.io/badge/Environment-Client_&_Server-success?style=for-the-badge" alt="Client & Server"> <img src="https://img.shields.io/badge/Language-Java_25-orange?style=for-the-badge&logo=java" alt="Java 25">

🧠 Dasik Library

> "The universal Hive Mind foundation powering autonomous animal genetics, dynamic GameRules, and high-performance flocking across Minecraft."

📖 Introduction

Developing modern Minecraft Fabric mods often means facing recurring architectural roadblocks: registering dynamic GameRules on the fly without causing immutable registry lockouts, synchronizing animal genetics and scale attributes across world save cycles, orchestrating swarming and flocking AI without decimating server tick rates, and integrating optional client configuration GUIs without causing fatal ClassNotFoundException crashes on headless dedicated servers.

Dasik Library is the universal standalone foundation engineered to solve these challenges. It provides the high-performance architectural backbone powering every mod across the Vanilla Outsider, Delayed Gratification, and Instant Gratification collections. Designed with strict zero-allocation hot paths, Knot ClassLoader isolation, and modular APIs, it equips developers and players with an enterprise-grade framework for modern Minecraft.

> [!IMPORTANT] > This is a Standalone Universal Core Library / API. > Universal Single-JAR Standard: Dasik Library builds a single universal cross-version JAR (>=26.1.2-, currently v1.8.35) using pure SemVer. It seamlessly loads across Minecraft 26.1.2, 26.2, 26.3, and future snapshots. > Both Client & Dedicated Server Ready: Fully compatible with singleplayer clients and multiplayer dedicated servers. > * Zero Standalone Gameplay Bloat: Does not add arbitrary gameplay items or world generation on its own. It runs quietly in the background, providing shared AI, genetics, and registry infrastructure for dependent mods.

✨ Features

🧬 Autonomous Animal Genetics & Breeding API

• Persistent Entity Genetics: Attaches an entity-agnostic genetic data model to living entities via persistent Fabric attachments (dasik-library:genetics), preserving lineage, UUIDs, and generational traits across world saves.
• Triangular Mutation & Outcross Recovery: Implements natural biological breeding math, including triangular mutation distribution, parent trait averaging, multi-tier inbreeding penalties, and genetic outcross recovery.
• Size-Stats Builder & Linked Attributes: Easily bind entity physical scale (minecraft:scale, customizable from 0.1f to 3.0f) to secondary attributes (Max Health, Movement Speed, Attack Damage) via LinkedAttributeRegistry with linear, inverse, or quadratic scaling.
• Genetics-Driven Loot Modification: Uses GeneticsLootRegistry and loot hooks to dynamically scale drops, meat yields, and resources based on entity size and genetic vitality.

⚙️ Dynamic GameRule Registration & Auto-Translation Engine

• On-Demand Registry Unfreezing: Safely unfreezes BuiltInRegistries.GAME_RULE at runtime via MappedRegistryAccessor, allowing consumer mods and addons to register custom GameRules without startup race conditions or registry lockouts.
• Automatic Translation Injection: Dynamically generates human-readable translation keys and injects them directly into vanilla's Language map (dasik$injectDynamicGameRuleTranslations), eliminating missing string placeholders (§l bold category formatting included).
• World Save Persistence: Seamlessly intercepts SavedData serialization (GameRuleMapMixin), ensuring dynamic GameRule changes made via /gamerule persist reliably in level.dat and game_rules.dat.
• Automated Orphaned Rule Pruning: Hooks ServerLifecycleEvents.SERVER_STARTING to detect and cleanly purge orphaned dynamic GameRules left behind when mods are uninstalled, keeping world save files pristine.
• Math Conversion Helpers: Built-in calculation utilities for percentages, permilles, and deciles (getPct, getChance, getProb, getDecileFloat).

🦅 High-Performance Swarm & Flocking AI (Cached Boids)

• $O(N)$ Leader-Follower Pattern: Eliminates expensive $O(N^2)$ pairwise distance checks by computing and caching group metrics (FlockState) exclusively on the pack Leader, enabling smooth swarms of 100+ entities at a solid 20 TPS.
• Biomechanical Steering: Full Alignment, Cohesion, and Separation vector steering calculations for realistic aerial murmurations (AerialFlockingStrategy) and terrestrial pack movement (TerrestrialFlockingStrategy).
• Resilient Following: Integrated water navigation penalty bypass and catch-up teleportation thresholds to ensure pack members never get lost across chunk boundaries.