DoxCore: фундамент для модов серии Dox
Если вы ставили какой-нибудь мод из серии Dox и видели требование «нужен DoxCore», вы попали по адресу. DoxCore — это общая библиотека, на которой держится вся линейка модов Dox. Сама по себе она не добавляет ни оружия, ни рюкзаков, ни новых механик: это каркас, который позволяет другим модам «договариваться» друг с другом в рантайме. Проще говоря, скачать DoxCore стоит ради того, чтобы остальные дополнения работали корректно и не конфликтовали.
Что такое DoxCore и зачем он нужен
Главная идея библиотеки — так называемые «мягкие связи» (soft-link). Вместо жёстких зависимостей, когда мод A не запустится без мода B, DoxCore предоставляет общие точки обмена данными. Если нужный мод установлен, связь работает; если нет — всё аккуратно откатывается к базовому поведению. Это делает сборку гибкой: вы можете ставить только те дополнения, которые вам нужны, и не тащить за собой весь комплект.
Ключевые возможности библиотеки
Связь по частям тела (Part-hit)
Движок хитбоксов может опубликовать информацию о том, в какую часть тела пришёлся удар, а моды урона и здоровья — прочитать её. Если такой движок не установлен, система просто возвращает null и не ломает игру.
Связь по позе (Pose)
Угол наклона и состояние задержки дыхания доступны коду интеграции оружия. Благодаря этому моды на наклон и дыхание остаются независимыми от оружейных модов — они не обязаны знать друг о друге.
Связь по размеру предметов (Item-size)
Предметы сообщают свой размер в сетке рюкзака (ширина на высоту и возможность стака), а мод рюкзака раскладывает их по ячейкам. При этом мод рюкзака не зависит от конкретных модов предметов.
Сетевые утилиты
DoxCore даёт хелперы для создания собственных каналов каждого мода и безопасной работы с буферами и строками. Каждый мод владеет своим каналом, поэтому нет хрупкой зависимости от порядка сообщений в общем канале.
Совместимость и поддерживаемые версии
DoxCore для Minecraft распространяется как библиотека под загрузчик Forge и не требует ничего сверх него. Что касается версий игры, ориентируйтесь на ту, под которую собран нужный вам мод Dox: библиотека ставится в пару к нему, и в описании конкретного дополнения всегда указана подходящая сборка Forge и Minecraft. Перед установкой проверьте, что версия Forge совпадает с той, что требует мод.
Если вы не хотите вручную сверять версии Forge и Minecraft, обратите внимание на лаунчер foxygame.net: в его каталоге дополнений DoxCore подбирается автоматически под вашу сборку, а обновления библиотеки приходят сами.
Как установить DoxCore
Установка предельно простая, потому что это обычная библиотека. Порядок действий такой:
- Убедитесь, что у вас установлен Forge нужной версии для вашей сборки Minecraft.
- Поместите файл DoxCore в папку mods вашего профиля.
- Добавьте туда же моды серии Dox, которым требуется библиотека.
- Запустите игру и проверьте, что в списке модов появился DoxCore без ошибок.
Важно: DoxCore сам по себе ничего не показывает в игре. Если вы не видите новых предметов или механик — это нормально, библиотека работает в фоне. Ставить её имеет смысл только тогда, когда её требует другой мод.
Для моддеров: точки входа
Если вы пишете собственный мод, DoxCore даёт удобные API для регистрации связей на этапе setup. Части тела регистрируются через DoxParts.register и читаются через DoxParts.resolve. Поза — через DoxPose.registerLean и DoxPose.registerBreath с последующим чтением угла наклона, смещения подглядывания и затухания дыхания. Размер предметов задаётся методом DoxItemSize.register с матчером, шириной, высотой и флагом стака, а читается через DoxItemSize.resolve. Для сетевого обмена есть DoxNetworks.create для SimpleChannel и DoxBufs для безопасного ввода-вывода строк.
Итог
DoxCore — это тихая, но важная часть экосистемы Dox. Она не развлекает игрока напрямую, зато обеспечивает гибкую совместимость между модами и избавляет от жёстких зависимостей. Если какое-то дополнение просит библиотеку, просто установите её подходящей версии для Forge и вашей сборки Minecraft — и вся связка заработает как надо.