Architectury API служит критически важным промежуточным слоем, разработанным для значительного упрощения процесса создания модов, которые могут работать на различных платформах моддинга Minecraft. Он решает присущие сложности и различия между различными загрузчиками модов, такими как Fabric и Forge, предоставляя унифицированный набор абстракций. Это позволяет разработчикам писать логику своего мода один раз, и она будет беспрепятственно интегрироваться с различными средами, тем самым сокращая время и усилия, необходимые для портирования модов, и обеспечивая более широкую совместимость для игроков. Основная цель — оптимизировать разработку мультиплатформенных модов, делая ее более доступной и эффективной для создателей, что в конечном итоге обогащает экосистему моддинга Minecraft более разнообразным контентом. Этот API работает путем абстрагирования конкретных реализаций общих функций, найденных в различных загрузчиках модов. Он предлагает комплексный набор инструментов, включая более 90 хуков событий, сетевые абстракции, абстракции вызовов загрузчика и абстракции реестра игры. Ключевой особенностью является аннотация `@ExpectPlatform`, которая упрощает условную логику для платформенно-специфичных функций, хотя она в основном предназначена для статических методов. Предоставляя эти стандартизированные интерфейсы, Architectury API гарантирует, что разработчики могут сосредоточиться на уникальных функциях своего мода, а не увязать в тонкостях каждого отдельного API моддинга, что приводит к меньшему количеству шаблонного кода и более надежному и поддерживаемому опыту разработки на всех поддерживаемых платформах. Architectury API разработан для широкой совместимости с несколькими версиями Minecraft и загрузчиками модов. Он поддерживает версии Minecraft 1.21.8, 1.21.9, 1.21.10, 1.21.11, а также версии Forge/NeoForge 26.1, 26.1.1, 26.1.2 и 26.2. Этот мод требуется как на клиенте, так и на сервере, что означает, что игрокам необходимо установить его на свой игровой клиент для присоединения к серверам, которые его используют, а администраторы серверов также должны иметь его установленным для корректной работы среды с модами. Это двойное требование гарантирует, что все аспекты игрового процесса с модами будут последовательными и функциональными для всех участников, предотвращая проблемы совместимости и обеспечивая плавный многопользовательский опыт. Для установки Architectury API поместите файл мода в папку `mods` вашей установки Minecraft. Если вы используете Forge или NeoForge, она обычно находится в основной директории Minecraft. Для Fabric или Quilt папка `mods` обычно находится внутри папки `.minecraft`. Перед запуском игры крайне важно убедиться, что у вас установлена правильная версия загрузчика модов, соответствующая версии Minecraft, в которую вы играете. Кроме того, убедитесь, что все остальные необходимые моды, особенно те, которые зависят от Architectury API, также правильно размещены в папке `mods` и совместимы друг с другом и с версией игры, чтобы избежать сбоев или неожиданного поведения.
