IconButtons API

IconButtons API

一个用于在标题菜单和暂停菜单的图标按钮行中轻松添加按钮的API

实现方法

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）来获取正确的尺寸，确保你的图标能够完美适配原版图标。