Revelationary

Мод Revelationary для Minecraft — система геймификации и скрытия контента

Revelationary — это модульная система, позволяющая авторам модов и сборок скрывать блоки и предметы от игрока до тех пор, пока он не выполнит определённое условие. Основная механика заключается в замещении реального блока или предмета другим (маскирующим) с сохранением всех физических свойств маски. Когда игрок достигает требуемого прогресса (например, побеждает босса), скрытый объект мгновенно становится видимым и доступным, а его маскирующий аналог исчезает. Это позволяет создавать сложные цепочки прогрессии без необходимости генерировать новый контент в мире, делая его доступным только в нужный момент.

Суть механики: система Revelations

Revelationary реализует систему «Data Driven Block and Item Revelation», позволяющую авторам модов и сборок управлять прогрессией игрока через скрытие контента. Игрок не видит новые блоки или предметы, пока не выполнит конкретное условие (например, достижение). До момента раскрытия объекты существуют в мире, но отображаются как другие, более простые блоки или предметы. Например, редкая руда может выглядеть как обычный камень, а ценный цветок — как полевой мак. При добыче маскирующего объекта игрок получает лут, соответствующий маске, что обеспечивает плавный вход в игру без флуда неизвестными ресурсами. Как только условие выполнено, происходит «Uncloak»: маскирующий блок исчезает, и открывается оригинальный объект.

Физические ограничения маскировки

Важно помнить: скрытие касается только визуализации и выпадающего лута. Маскированные блоки сохраняют все физические свойства оригинала: габариты (hitbox), прозрачность для света, возможность установки и т.д. Например, если замаскировать редкую руду под камень, она будет иметь те же габариты камня. Это может создать неудобства при попытке построить что-то вокруг скрытого объекта. Однако автор предлагает хитрость: для руды лучше использовать маски из камня или глубокого слэша (deepslate), так как они визуально и физически похожи. Аналогично, цветок можно замаскировать под полевой мак, чтобы игроки могли ходить сквозь него, не зная о его существовании.

Динамическое изменение свойств для разработчиков

Для программистов предусмотрена возможность динамически менять свойства блоков через API в зависимости от их видимости. Это позволяет реализовать продвинутые сценарии, например, сделать так, чтобы замаскированный объект имел пустой hitbox (как воздух). В таком случае игроки смогут проходить сквозь него, не подозревая о наличии блока, пока не выполнили условие раскрытия. Для реализации таких сценарий достаточно внедрить класс, реализующий интерфейс RevelationAware.

Пример конфигурации Data Pack

Самый простой способ внедрить механику — использовать Data Pack. Файл конфигурации размещается в папке `resources/data/revelations`. В нём можно задать соответствие между достижением и списком блоков или предметов. Пример конфигурации показывает, как скрыть блоки бекона и обсидиана за травой, а также замаскировать звезду нether-мира под порох. Это позволяет легко создавать прогрессии без написания кода.

Реализация RevelationAware в Java

Для создания собственных модов с поддержкой Revelationary используется Java API. Необходимо создать класс, наследуясь от `Item` и реализовав интерфейс `RevelationAware`. В коде задаются идентификатор достижения, который должен быть выполнен для раскрытия, а также маскирующий предмет. Класс также должен содержать методы для получения списков замаскированных блоков и предметов, а также обработчики событий `onCloak` и `onUncloak`, которые вызываются при скрытии и раскрытии объекта.

Регистрация обратных вызовов (Callbacks)

API позволяет регистрировать обратные вызовы на момент раскрытия. Это удобно для реализации кастомной логики: например, при раскрытии блока можно автоматически создать вокруг него какой-то эффект, изменить ландшафт или добавить новые предметы в инвентарь игрока. Метод `registerRevelationCallback` принимает объект, в котором описывается, что должно произойти с блоками, предметами и достижениями в момент Uncloak.

Сообщество и поддержка

Если вам нужна помощь с настройкой или разработкой, вы можете найти много полезной информации и поддержки в Discord-сервере Spectrum. Там всегда есть дружелюбные и готовые помочь люди. Рекомендуется заглянуть в каналы, если у вас возникли вопросы по реализации Revelationary.

Связанные материалы

• Geckolib — похожий мод
• Fzzy Config — похожий мод
• AzureLib — похожий мод
• Pehkui — похожий мод

Автор: DaFuqs · Лицензия: LGPL-3.0-only