Wiki メインポータル - Dasik Library
Dasik Library の公式技術ドキュメントへようこそ。本ライブラリは、Fabric Minecraft Mod 向けの群知能ソーシャル AI（Hive Mind）、動物遺伝学エンジン、Boids 群れ制御ベクトル計算、および動的 GameRule インフラストラクチャを提供する共通コアフレームワークです。
📌 ソースリポジトリに関する注意事項: 本 Wiki のドキュメントは現在のリポジトリ内ソースコードの状態を反映しており、CurseForge や Modrinth での一般リリース版に先駆けて実装された最新のコミットや開発中の機能が含まれている場合があります。
💡 設計思想とアーキテクチャ
Dasik Library は以下の 2 つのコア設計原則に基づいて構築されています：
- 「Thin Mod, Fat Library」（軽量 Mod、重厚な共通ライブラリ）: 各コンシューマー Mod はエンティティ固有の挙動や登録処理に専念し、複雑な数学的計算、Tick スケジューリング、遺伝的継承、Boids 群れベクトル計算、NBT 状態シリアライズなどはすべて Dasik Library に集約します。
- 「One Brain, Many Minds」（一つの頭脳、無数の意識）:
GlobalSocialSystemによる集中パルス実行により、ハイランダーの原則（1 ゲーム Tick あたり厳格に 1 グローバル Tick サイクル）を強制し、何千ものアクティブなエンティティをサーバー負荷を最小限に抑えて統合制御します。
📦 Minecraft バージョンディレクトリ
- MC 26.2 ガイド — Minecraft 26.2+ 向けの導入方法と設定。
- バージョン互換性 — マルチバージョン対応マトリクス（
>=26.1.2-〜26.2+）、Knot ClassLoader の安全性、および互換性保護ルール。
🎮 コアシステム＆メカニクスマトリクス
全技術メカニクスおよび設定の詳細ガイド：
- 群知能ソーシャルシステム — 単一パルス駆動エンジン、ハイランダーの原則、$O(1)$ シャーディング
SocialRegistry、および Tick バジェット。 - ソーシャルスケジューラ＆イベント —
EntitySocialScheduler、Mood/Ambient デュアルトラック実行、PriorityTier、およびSocialEventRegistry。 - 動物遺伝学エンジン —
EntityGeneticsアタッチメント、DNA Long 値エンコーディング、サイズスケーリング（0.1x〜3.0x）、未熟個体（Runt）判定、遺伝の数学的計算。 - 遺伝学 API と血統ツリー —
DasikAnimalGeneticsAPIファサード、親族判定・血統分析、近親交配リスク予測、動的特性モディファイア。 - 遺伝学ドロップ修飾子 —
GeneticsLootModifier、GeneticsLootRegistry、およびLivingEntityLootMixinによるドロップ割り込みフック。 - リーダー追従＆群れ形成アルゴリズム —
GroupMember、FollowLeaderGoal、飛行および地上向け Boids アルゴリズム、GroupParameters重み付け。 - 動的 GameRules マネージャー —
DynamicGameRuleManager、動的登録、自動英語翻訳注入、太字カテゴリヘッダー（§l）、計算ヘルパー。 - GameRule Codec とシリアライズ — 整数 GameRule の境界値バリデーション（
Integer.MIN_VALUE）、SavedDataStorage.encodeUncheckedクラッシュ防止。 - クライアント GameRule と GUI ヘルパー —
ClientGameRuleHelperサーバー照会、GuiHelper、ConfigHelperによる JSON アトミック置換。 - 動的エンチャント＆視界トラッカー —
DynamicEnchantmentManagerによる実行時注入、およびPlayerVisionTrackerによるフラスタム・レイキャスト判定。 - 確率・数学ユーティリティ —
FastRandom（XORSHIFT）、StochasticUtilによるパーミル／デシル判定、Tick-秒変換（$20\text{ ticks} = 1\text{秒}$）。 - 古い属性のパージとスケール補正 — 属性モディファイアのクリーンアップルール、
ADD_VALUE-1.0fベースオフセット計算、genetics_接頭辞の安全性。 - ModVersionGuard と起動時クラッシュ防止 — Knot ClassLoader 検証（
Thread.currentThread().getContextClassLoader()）によるバージョン不整合の早期検知。
💻 開発者向け技術リファレンス
- 開発環境セットアップとビルド — JDK 25 要件、Gradle 9.3+、
./gradlew build --no-daemon、および./gradlew test。 - アーキテクチャとパッケージ構成 — 完全な ASCII パッケージツリー（
ai,api,config,core,mixin,util）およびスレッド安全性。 - Mixin リファレンスとフック — 詳細な Mixin インジェクション一覧表（
LanguageMixin,LivingEntityLootMixin,MobGoalAccessor,PathfinderMobMixin,ProfileTriggerMixin）。 - 行動プロファイルと発動条件 —
BehaviorProfileManager,BehaviorProfile,BehaviorCondition,ProfileAware,DefaultProfileBuilder。 - 下流 Mod 連携・統合ガイド — 下流 Mod（Better Dogs, Natural Reproduction, Collapsible Game Rule Screen, Bat Ecology, Ore Amplifier）向けの導入手順とコード例。