Portail Principal du Wiki - Dasik Library
Bienvenue dans la documentation technique officielle de Dasik Library, le framework partagé d'intelligence collective sociale (Hive Mind), de moteur génétique, de calcul de nuées Boids et d'infrastructure de GameRules dynamiques pour les mods Fabric Minecraft.
📌 Avis sur le Dépôt Source : La documentation de ce wiki reflète l'état actuel du code source du dépôt, qui peut inclure des commits récents et non publiés ou des fonctionnalités en cours de développement précédant les versions publiques sur CurseForge et Modrinth.
💡 Philosophie Architecturale
Dasik Library repose sur deux principes directeurs :
- « Thin Mod, Fat Library » (Mod Léger, Bibliothèque Robuste) : Les mods consommateurs se concentrent uniquement sur le contenu spécifique et les enregistrements d'entités. Les calculs mathématiques lourds, la planification de ticks, la transmission génétique, les vecteurs de nuée et la sérialisation NBT sont centralisés dans Dasik Library.
- « One Brain, Many Minds » (Un Cerveau, Plusieurs Esprits) : Une exécution par pulsation centralisée via
GlobalSocialSystemapplique la Règle Highlander (strictement 1 cycle de tick global par tick de jeu) pour orchestrer des milliers d'entités sans dégradation des performances.
📦 Annuaire des Versions Minecraft
- Guide MC 26.2 — Installation et configuration pour Minecraft 26.2+.
- Compatibilité des Versions — Matrice du cycle de vie multi-versions (
>=26.1.2-à26.2+), sécurité Knot ClassLoader et règles de protection.
🎮 Systèmes Centraux & Matrice des Mécaniques
Explorez les mécaniques techniques complètes et les guides de configuration :
- Système Social d'Intelligence Collective — Moteur à impulsion unique, Règle Highlander,
SocialRegistrypartitionné en $O(1)$ et budgets de tick. - Planificateur Social et Événements —
EntitySocialScheduler, exécution double piste Humeur/Ambiance,PriorityTieretSocialEventRegistry. - Moteur de Génétique Animale — Attachement
EntityGenetics, encodage ADN en Long, mise à l'échelle (0.1x-3.0x), indicateurs de chétif et mathématiques d'hérédité. - API Génétique et Arbre Généalogique — Façade
DasikAnimalGeneticsAPI, calcul de parenté, prédiction des risques de consanguinité et modificateurs dynamiques. - Modificateurs de Butin Génétique —
GeneticsLootModifier,GeneticsLootRegistryet interception des drops viaLivingEntityLootMixin. - Suivi de Leader et Comportement de Nuée —
GroupMember,FollowLeaderGoal, stratégies Boids aériennes et terrestres, pondérations deGroupParameters. - Gestionnaire Dynamique de GameRules —
DynamicGameRuleManager, enregistrement dynamique, injection automatique des traductions, en-têtes gras (§l) et convertisseurs. - Codec et Sérialisation des GameRules — Validation des bornes entières (
Integer.MIN_VALUE), prévention des crashsSavedDataStorage.encodeUnchecked. - GameRules Client et Assistants GUI — Requêtes client
ClientGameRuleHelper,GuiHelper, remplacement atomique JSON dansConfigHelper. - Enchantements Dynamiques et Suivi de Vision — Injection à chaud via
DynamicEnchantmentManageret tests de champ de vision avecPlayerVisionTracker. - Utilitaires Stochastiques et Mathématiques — Algorithmes XORSHIFT dans
FastRandom, échantillonnage par mille/décile dansStochasticUtilet conversion tick-seconde ($20\text{ ticks} = 1\text{s}$). - Nettoyage d'Attributs Obsolètes et Échelle — Règles de purge pour modificateurs d'attributs, calcul d'offset de base
-1.0fpourADD_VALUE. - ModVersionGuard et Sécurité au Démarrage — Vérification Knot ClassLoader (
Thread.currentThread().getContextClassLoader()) et protection contre les incompatibilités.
💻 Référence Technique & Développeur
- Configuration Développeur et Compilation — Prérequis JDK 25, Gradle 9.3+,
./gradlew build --no-daemonet./gradlew test. - Architecture et Structure des Paquets — Arborescence complète des paquets ASCII (
ai,api,config,core,mixin,util) et concurrence. - Référence Mixin et Points d'Injection — Tableau d'injection détaillé (
LanguageMixin,LivingEntityLootMixin,MobGoalAccessor,PathfinderMobMixin,ProfileTriggerMixin). - Profils de Comportement et Conditions —
BehaviorProfileManager,BehaviorProfile,BehaviorCondition,ProfileAwareetDefaultProfileBuilder. - Guide d'Intégration pour Mods Consommateurs — Guide d'intégration et exemples de code pour mods tiers (Better Dogs, Natural Reproduction, Collapsible Game Rule Screen, Bat Ecology, Ore Amplifier).