Главная страница Wiki - Dasik Library
Добро пожаловать в официальную техническую документацию Dasik Library — общего движка социального ИИ коллективного разума (Hive Mind), фреймворка генетики, калькулятора стайного поведения Boids и инфраструктуры динамических GameRules для модов Fabric Minecraft.
📌 Предупреждение об исходном коде репозитория: Документация в этой Wiki отражает текущее состояние исходного кода в репозитории, которое может содержать недавние невыпущенные коммиты или разрабатываемые функции, опережающие общедоступные релизные сборки на CurseForge и Modrinth.
💡 Архитектурная философия
Dasik Library работает в соответствии с двумя фундаментальными архитектурными принципами:
- "Thin Mod, Fat Library" (Тонкий мод, толстая библиотека): Модульные моды-потребители фокусируются исключительно на контенте сущностей и их регистрации. Сложная математика, планирование тиков, генетическое наследование, расчет векторов руления Boids и сериализация NBT-состояния централизованы в Dasik Library.
- "One Brain, Many Minds" (Один мозг, множество разумов): Централизованное импульсное выполнение через
GlobalSocialSystemстрого соблюдает Правило Горца (Highlander Rule) (ровно 1 глобальный цикл тика за игровой тик), управляя тысячами активных сущностей с минимальной нагрузкой на производительность.
📦 Каталог версий Minecraft
- Руководство по MC 26.2 — Установка и настройка для Minecraft 26.2+.
- Совместимость версий — Матрица жизненного цикла многоверсионной совместимости (
>=26.1.2-до26.2+), безопасность Knot ClassLoader и правила защиты версий.
🎮 Матрица основных систем и механик
Ознакомьтесь с полным списком технических руководств по механикам:
- Социальная система коллективного разума — Одноимпульсный движок, Правило Горца, шардированный $O(1)$ реестр
SocialRegistryи бюджет тиков. - Социальный планировщик и события —
EntitySocialScheduler, двухколейное выполнение Mood/Ambient, уровниPriorityTierиSocialEventRegistry. - Движок генетики животных — Вложение
EntityGenetics, кодирование DNA long, границы масштабирования (0.1x-3.0x), индикаторы недомерков и математика наследования. - API генетики и родословная — Фасад
DasikAnimalGeneticsAPI, вычисление родословной и родства, формулы предсказания риска инбридинга и динамические модификаторы. - Модификаторы добычи генетики —
GeneticsLootModifier,GeneticsLootRegistryи логика перехвата дропа черезLivingEntityLootMixin. - Следование за лидером и стайное поведение —
GroupMember,FollowLeaderGoal, воздушные и наземные стратегии Boids и параметры весовGroupParameters. - Менеджер динамических GameRules —
DynamicGameRuleManager, динамическая регистрация, автоинъекция английских переводов, жирные заголовки категорий (§l) и математические помощники. - Codec и сериализация GameRules — Валидация границ целочисленных GameRules (
Integer.MIN_VALUEfallback), предотвращающая крашиSavedDataStorage.encodeUnchecked. - Клиентские GameRules и помощники GUI — Запросы к встроенному серверу через
ClientGameRuleHelper,GuiHelper, атомарная замена JSON вConfigHelperи безопасность выделенного сервера. - Динамические зачарования и трекер поля зрения — Инъекция во время выполнения через
DynamicEnchantmentManagerи лучевые проверки фрустумаPlayerVisionTracker. - Стохастические и математические утилиты — Алгоритмы XORSHIFT в
FastRandom, броски промилле/децилей вStochasticUtilи конверсия тиков в секунды ($20\text{ ticks} = 1\text{s}$). - Очистка устаревших атрибутов и масштабирование — Правила очистки модификаторов атрибутов, смещение базы
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. - Руководство по интеграции модов-потребителей — Руководство по интеграции и примеры кода для модов (Better Dogs, Natural Reproduction, Collapsible Game Rule Screen, Bat Ecology, Ore Amplifier).