Fluidlogged API

Мод библиотеки, добавляющий в версию 1.12.2 гибкие возможности настройки жидкости!

Fluidlogging — это механика, вдохновленная механикой Waterlogging] из Vanilla, и функционирующая очень похоже. Основное отличие состоит в том, что Fluidlogged API поддерживает жидкости не из исходного кода и все модифицированные жидкости!

Если вы разработчик модпаков и хотите добавить Fluidlogged API в модпак, распространяемый за пределами CurseForge или Modrinth, используйте File Director, чтобы избежать повторной загрузки файлов Fluidlogged API.

Любые блоки можно сделать допускающими или не допускающими плавную регистрацию с помощью конфигураций Fluidlogged API, однако он делает определенные типы блоков допускающими плавную регистрацию по умолчанию. Любые правильно закодированные модифицированные варианты этих блоков поддерживаются по умолчанию. Моды также могут добавлять блоки с возможностью регистрации жидкости со своего конца. Чтобы просмотреть полный список блоков, допускающих журналирование жидкости, запустите в игре команду /fluidlogged_api print, чтобы создать текстовые файлы, содержащие всю активную информацию о регистрации жидкости.

Наряду с этим Fluidlogged API загрузит и применит конфигурации сообщества! Это сделано для того, чтобы свести к минимуму объем работы, которую игроки должны проделать для полной регистрации жидкости во всех модах, но при желании это поведение можно полностью отключить в fluidlogged_api/general.cfg.

API Fluidlogged также значительно повышает точность столкновений жидкостей и исправляет различные проблемы, связанные с жидкостью в Vanilla и модифицированной версии. Некоторые исправления ошибок Vanilla включают в себя:

• MC-2591 Прохождение через угол лавы наносит урон
• MC-4533 Графический сбой воды при диагональном подключении
• MC-68129 Плавное освещение не работает должным образом под водой
• MC-100886 Падающий песок с идентификатором воды или лавы не отображается
• MC-125771 Выбор блока не отображается под водой
• MC-127030 Проточная вода пытается соединиться с затопленными блоками, хотя это не должно
• MC-127108 Затопленные блоки превращают лаву в обсидиан или булыжник на физически несоединённых сторонах
• MC-127270 Визуальный уровень воды внутри заболоченных блоков не регулируется правильно
• MC-227302 Плавное освещение не работает должным образом на поверхности воды

| Известные несовместимости | Известные решения | | --- | --- | | Улучшенная водная сетка | Никто. | | Надгробие Кораля | Используйте Corail Tombstone v4.6.0 или новее! | | Океанические просторы | Используйте Oceanic Expanse v1.2.0 или новее! | | Фосфор | Вместо этого используйте Alfheim или 燐/Hesperus]! | | Эфир II | Phosphor поставляется в комплекте с The Aether II. К счастью, существует Эфир II: Фосфор не входит в комплект, который соответствует названию! | | Винтажиум | Вместо этого используйте Селеритас! |

Вопрос/Ответ:

<details> <summary>Как работает этот мод?</summary>

Чтение исходного кода было бы лучшим способом по-настоящему понять внутреннюю работу этого мода, но я опишу здесь упрощенную версию:

Для каждого блока в мире Vanilla имеет две функции, которые сохраняются в каждом чанке: обязательный IBlockState и необязательный TileEntity. API Fluidlogged добавляет третью функцию, которая сохраняется в каждом фрагменте: необязательный FluidState, который хранит зарегистрированную жидкость, если она присутствует.

Этот мод применяет ASM (библиотеку манипулирования байт-кодом, которая входит в состав Forge), чтобы позволить Vanilla и Forge правильно читать и использовать FluidStates.

</details>

<details> <summary>Безопасно ли добавлять этот мод в существующие миры?</summary>

Обычно рекомендуется всегда создавать резервные копии своих миров перед добавлением новых модов. При этом этот мод не меняет поведение IBlockStates, поэтому добавить его в существующие миры будет нормально! Удаление этого мода из существующих миров также подойдет, просто учтите, что существующий FluidStates будет удален и после этого его невозможно будет восстановить.

</details>

<details> <summary>Как мне использовать конфиги этого мода? Как мне использовать этот мод в качестве зависимости?</summary>

wiki] этого мода в конечном итоге охватит обе эти темы, на данный момент там рассматривается только то, как использовать конфигурацию этого мода. Если вы хотите использовать Fluidlogged API в качестве библиотеки (необязательная или обязательная зависимость), лучшее, что я могу сделать, пока не закончу вики, — это сослаться на исходный код других моих проектов: Campfire, Seared Ladder Backport, Subaquatic.

</details>

<details> <summary>Что мне делать, если я столкнусь с какими-либо ошибками, сбоями или несовместимостью модов?</summary>

Если вы сообщите обо всем, что обнаружите, в отслеживание проблем этого мода, это очень поможет мне улучшить этот мод! Без людей, щедро тратящих на это время, этот мод не был бы тем, чем он является сегодня!

</details>

Если вы хотите проводить журналирование жидкости для версий выше 1.12.2, ознакомьтесь с Fluidlogged (не связано с Fluidlogged API) и Towelette!

Прямой контакт: jbred.dev@gmail.com

Этот мод не будет портирован.