Hauptportal der Wiki - Dasik Library
Willkommen zur offiziellen technischen Dokumentation von Dasik Library, der gemeinsamen Schwarmintelligenz-Sozial-KI (Hive Mind), Genetik-Engine, Boids-Schwarmberechnung und dynamischen GameRule-Infrastruktur für Fabric Minecraft-Mods.
📌 Hinweis zum Quellcode-Repository: Die Dokumentation in diesem Wiki spiegelt den aktuellen Stand des Quellcodes im Repository wider, der möglicherweise kürzlich durchgeführte, noch nicht veröffentlichte Commits oder Entwicklungsfunktionen vor den öffentlichen Release-Builds auf CurseForge und Modrinth enthält.
💡 Architekturphilosophie
Dasik Library folgt zwei zentralen Architekturprinzipien:
- "Thin Mod, Fat Library" (Schlanke Mods, Mächtige Bibliothek): Modulare Consumer-Mods konzentrieren sich ausschließlich auf Entitätsinhalte und Registrierungen. Komplexe Mathematik, Tick-Scheduling, genetische Vererbung, Boids-Lenkvektorberechnungen und NBT-Zustandsserialisierung sind in Dasik Library gebündelt.
- "One Brain, Many Minds" (Ein Gehirn, Viele Geister): Eine zentralisierte Impulsausführung über
GlobalSocialSystemerzwingt die Highlander-Regel (strikt 1 globaler Tick-Zyklus pro Spiel-Tick), um Tausende aktiver Entitäten mit minimalem Leistungsaufwand zu verwalten.
📦 Minecraft-Versionsverzeichnis
- MC 26.2 Leitfaden — Installation und Konfiguration für Minecraft 26.2+.
- Versionskompatibilität — Matrix des Multi-Versions-Lebenszyklus (
>=26.1.2-bis26.2+), Knot ClassLoader-Sicherheit und Versionsschutzregeln.
🎮 Kernsysteme & Mechanik-Matrix
Erkunden Sie die vollständigen technischen Mechaniken und Konfigurationsleitfäden:
- Schwarmintelligenz-Sozialsystem — Einzelimpuls-Engine, Highlander-Regel, $O(1)$ geshardete
SocialRegistryund Tick-Budgets. - Sozialer Planer & Ereignisse —
EntitySocialScheduler, zweispurige Mood/Ambient-Ausführung,PriorityTierundSocialEventRegistry. - Tiergenetik-Engine —
EntityGenetics-Attachment, DNA-Long-Codierung, Größenskalierung (0.1x-3.0x), Kümmerling-Indikatoren und Vererbungsmathematik. - Genetik-API & Stammbaum —
DasikAnimalGeneticsAPI-Fassade, Stammbaum- und Verwandtschaftsberechnung, Inzuchtrisikovorhersage und dynamische Merkmalsmodifikatoren. - Genetik-Beutemodifikatoren —
GeneticsLootModifier,GeneticsLootRegistryund Drop-Abfanglogik viaLivingEntityLootMixin. - Anführer-Gefolge & Schwarmbildung —
GroupMember,FollowLeaderGoal, Flug- und Boden-Boids-Schwarmstrategien undGroupParameters-Gewichtungen. - Dynamischer GameRules-Manager —
DynamicGameRuleManager, dynamische Registrierung, automatische englische Übersetzungsinjektion, fette Kategorie-Header (§l) und Mathe-Helfer. - GameRule-Codec & Serialisierung — Validierung von Integer-GameRule-Grenzen (
Integer.MIN_VALUEFallback), verhindert Abstürze beiSavedDataStorage.encodeUnchecked. - Client-GameRules & GUI-Helfer —
ClientGameRuleHelper-Serverabfragen,GuiHelper, atomarer JSON-Austausch inConfigHelperund Sicherheit für dedizierte Server. - Dynamische Verzauberungen & Sichtverfolgung — Laufzeiteinspeisung via
DynamicEnchantmentManagerund Frustum-Raycast-Prüfungen mitPlayerVisionTracker. - Stochastik- & Mathe-Werkzeuge — XORSHIFT-Algorithmen in
FastRandom, Promille-/Dezilstichproben inStochasticUtilund Tick-zu-Sekunden-Umrechnung ($20\text{ ticks} = 1\text{s}$). - Veraltete Attributsbereinigung & Skalierung — Bereinigungsregeln für Attributsmodifikatoren,
ADD_VALUE-1.0fBasis-Offset-Mathematik undgenetics_-Modifikatorsicherheit. - ModVersionGuard & Start-Sicherheit — Knot ClassLoader-Sicherheit (
Thread.currentThread().getContextClassLoader()) und Schutz vor Vorabversionsabstürzen.
💻 Entwickler- & Technische Referenz
- Entwickler-Setup & Build — JDK 25 Voraussetzungen, Gradle 9.3+,
./gradlew build --no-daemonund./gradlew test. - Architektur & Paketstruktur — Vollständiger ASCII-Paketbaum (
ai,api,config,core,mixin,util) und Thread-Sicherheitsmodelle. - Mixin-Referenz & Hooks — Detaillierte Mixin-Aufschlüsselungstabelle (
LanguageMixin,LivingEntityLootMixin,MobGoalAccessor,PathfinderMobMixin,ProfileTriggerMixin). - Verhaltensprofile & Bedingungen —
BehaviorProfileManager,BehaviorProfile,BehaviorCondition,ProfileAwareundDefaultProfileBuilder. - Integrationsleitfaden für nachgelagerte Mods — Leitfaden und Codebeispiele für Mods (Better Dogs, Natural Reproduction, Collapsible Game Rule Screen, Bat Ecology, Ore Amplifier).
