IconButtons API

IconButtons API

API для простого добавления кнопок в ряд Icon Buttons в меню заголовка и меню паузы

Подключение

1. Настройте build.gradle

repositories {
    maven {
        url "https://api.modrinth.com/maven"
    }
}
dependencies {
    implementation "maven.modrinth:iconbuttonsapi:${project.iconbuttonsapi_version}+mc-${project.minecraft_version}"
}

2. Настройте gradle.properties

Добавьте следующие строки в файл gradle.properties и замените значения на нужные вам версии:

iconbuttonsapi_version=1.0.0

3. Настройте fabric.mod.json

Не забудьте объявить зависимость в fabric.mod.json, чтобы Fabric Loader мог проверить её во время выполнения:

"depends": {
    ...
    "iconbuttonsapi": ">=1.0.0"
}

Использование

Главная точка входа в API — класс IconButtons. Он предоставляет методы для простого добавления любого AbstractWidget (кнопок, слайдеров и т.д.) в ряды экрана заголовка или меню паузы Minecraft.

Вы можете регистрировать кнопки как постоянно видимые или управлять их видимостью динамически с помощью BooleanSupplier.

Пример

public class ExampleModClient implements ClientModInitializer {  
    public static final String MOD_ID = "iconbuttonsapi";  
    public static final Logger LOGGER = LoggerFactory.getLogger(MOD_ID);
    public static boolean willShow = true;

    @Override
    public void onInitializeClient() {
        Button buttonHi = Button.builder(
                Component.literal("hi"),
                b -> {
                    LOGGER.info("Hi!");
                }
        ).size(IconButtons.getButtonWidthAndHeight(), IconButtons.getButtonWidthAndHeight()).build();
        Button buttonToggleShow = Button.builder(
                Component.literal("T"),
                b -> {
                    willShow = !willShow;
                }
        ).size(IconButtons.getButtonWidthAndHeight(), IconButtons.getButtonWidthAndHeight()).build();

        IconButtons.addTitleScreenButton(buttonHi, () -> willShow);
        IconButtons.addPauseScreenButton(buttonHi, () -> willShow);

        IconButtons.addTitleScreenButton(buttonToggleShow);
        IconButtons.addPauseScreenButton(buttonToggleShow);
    }
}

Возможности

• Автоматическое позиционирование: вам не нужно указывать координаты (X и Y) для своих виджетов. API сам рассчитывает и применяет позиционирование, выстраивая ваши кнопки в аккуратный ряд.
• Размер: рекомендуется использовать IconButtons.getButtonWidthAndHeight() (возвращает 20) для правильного размера, чтобы ваши иконки идеально помещались рядом с ванильными.