AmbleKit

AmbleKit - это вспомогательная модификация для разработчиков, созданная на платформе Fabric. Она значительно упрощает процесс программирования Minecraft модов, предлагая готовые решения для стандартных задач.

Основной функционал

Автоматическая регистрация

Библиотека избавляет от необходимости вручную регистрировать каждый объект в игре. Вместо этого достаточно, чтобы ваш класс наследовал или реализовывал один из специальных классов RegistryContainer. Система автоматически распознает такие интерфейсы при добавлении строки RegistryContainer.register(ClassName.class, MOD_ID) в метод #onInitialize вашего мода.

Работа с датапаками

Предоставляется класс SimpleDatapackRegistry, который позволяет легко загружать и регистрировать пользовательские классы напрямую из датапаков. Для активации регистрации необходимо вызвать метод register на экземпляре или использовать AmbleRegistries.register(MyRegistry.getInstance()) в методе #onInitialize.

Генерация данных

Библиотека использует аннотации и систему контейнеров регистрации для автоматического создания различных элементов. К примеру, можно автоматически генерировать английские переводы для блоков - достаточно создать экземпляр AmbleLanguageProvider, передать BlockContainer через метод #withBlocks, и при следующем запуске генерации данных все блоки получат локализацию на основе их идентификаторов.

Дополнительные возможности

Библиотека содержит множество других полезных инструментов для разработчиков, упрощающих стандартные процессы создания модов.

Начало работы

Для старта работы воспользуйтесь готовым шаблоном:

Если вы начинаете новый проект, используйте готовый шаблон для Fabric 1.20.1.

Шаблон мода для Fabric

Подключение к существующему проекту

Если у вас уже есть разрабатываемый мод, добавьте следующие строки в ваш build.gradle файл:

  repositories {
      maven {
          url "https://jitpack.io"

          metadataSources {
              artifact() // Поиск непосредственно артефакта
          }
      }
  }

  dependencies {
      modImplementation("com.github.amblelabs:modkit:${project.modkit_version}") {
          exclude(group: "net.fabricmc.fabric-api")
      }
  }

Или для пользователей Kotlin:

    repositories {
      maven {
          url = uri("https://jitpack.io")
          metadataSources {
              artifact() // Поиск непосредственно артефакта
          }
      }
      mavenCentral()
  }


  dependencies {
      modImplementation("com.github.amblelabs:modkit:${project.property(\"modkit_version\")}")
  }

Сообщество и ресурсы

• GitHub
• Discord