Combind

Combind предоставляет три API-класса в пакете net.pemiridosa.combind.api, которые позволяют вашему моду регистрировать привязки клавиш с полной поддержкой комбо.

Настройка зависимости

Добавьте Combind как зависимость времени компиляции через репозиторий Modrinth Maven:

// build.gradle
repositories {
    maven { url "https://api.modrinth.com/maven" }
}

dependencies {
    compileOnly "maven.modrinth:combind:VERSION"
    localRuntime "maven.modrinth:combind:VERSION" // optional: for dev runs
}

Объявите зависимость в fabric.mod.json. Используйте depends, если ваш мод требует Combind, или suggests, если она необязательна:

"depends": {
    "combind": "*"
}

API-классы

Примеры

Аккорд — удерживаемый модификатор(ы) + клавиша-триггер

Привяжите действие к Left Shift + E:

KeyMapping.Category category = KeyMapping.Category.register(
    Identifier.fromNamespaceAndPath("mymod", "mymod")
);

KeyMapping someActionMapping = KeyMappingHelper.registerKeyMapping(
    new KeyMapping("key.mymod.someaction", InputConstants.KEY_E, category)
);

// Left Shift + E
CombindKeyBinding someActionBinding = CombindKeyBinding.of(someActionMapping,
    new KeyCombo(
        InputKey.keyboard(InputConstants.KEY_E),
        new InputKey[]{ InputKey.keyboard(InputConstants.KEY_LSHIFT) }
    )
);

someActionBinding
    .onPress(ctx -> LOGGER.info("Some action PRESSED — combo: {}", ctx.combo().getDisplayName()))
    .onRelease(ctx -> LOGGER.info("Some action RELEASED — combo: {}", ctx.combo().getDisplayName()));

Аккорд с несколькими модификаторами

Привяжите действие к Left Control + Left Shift + E:

KeyMapping someActionMapping = KeyMappingHelper.registerKeyMapping(
    new KeyMapping("key.mymod.someaction", InputConstants.KEY_E, category)
);

// Left Control + Left Shift + E
CombindKeyBinding someActionBinding = CombindKeyBinding.of(someActionMapping,
    new KeyCombo(
        InputKey.keyboard(InputConstants.KEY_E),
        new InputKey[]{
            InputKey.keyboard(InputConstants.KEY_LCONTROL),
            InputKey.keyboard(InputConstants.KEY_LSHIFT)
        }
    )
);

someActionBinding
    .onPress(ctx -> LOGGER.info("Some action PRESSED — combo: {}", ctx.combo().getDisplayName()))
    .onRelease(ctx -> LOGGER.info("Some action RELEASED — combo: {}", ctx.combo().getDisplayName()));

Последовательность — нажатие одной и той же клавиши несколько раз

Привяжите действие к M M (двойное нажатие) или M M M (тройное нажатие):

KeyMapping someActionMapping = KeyMappingHelper.registerKeyMapping(
    new KeyMapping("key.mymod.someaction", InputConstants.KEY_M, category)
);

// Double-tap M (M M)
CombindKeyBinding someActionBinding = CombindKeyBinding.of(someActionMapping,
    KeyCombo.sequence(InputKey.keyboard(InputConstants.KEY_M), 2)
);

// Triple-tap M (M M M) — even safer
CombindKeyBinding someActionBinding = CombindKeyBinding.of(someActionMapping,
    KeyCombo.sequence(InputKey.keyboard(InputConstants.KEY_M), 3)
);

someActionBinding
    .onPress(ctx -> LOGGER.info("Some action PRESSED — combo: {}", ctx.combo().getDisplayName()))
    .onRelease(ctx -> LOGGER.info("Some action RELEASED — combo: {}", ctx.combo().getDisplayName()));

Аккорд + последовательность — удерживайте модификатор(ы) при многократном нажатии

Привяжи действие к Left Shift + Q Q (двойное нажатие Q с зажатым Shift):

// Left Shift + Q Q
CombindKeyBinding binding = CombindKeyBinding.of(mapping,
    new KeyCombo(
        InputKey.keyboard(InputConstants.KEY_Q),
        new InputKey[]{ InputKey.keyboard(InputConstants.KEY_LSHIFT) },
        2
    )
);

Кнопка мыши как триггер

Привяжи действие к Left Control + Left Button:

// Left Control + Left Mouse Button
CombindKeyBinding binding = CombindKeyBinding.of(mapping,
    new KeyCombo(
        InputKey.mouse(InputConstants.MOUSE_BUTTON_LEFT),
        new InputKey[]{ InputKey.keyboard(InputConstants.KEY_LCONTROL) }
    )
);

Одна клавиша (явная комбинация не нужна)

CombindKeyBinding.of(mapping) выводит начальную комбинацию из клавиши по умолчанию у KeyMapping:

CombindKeyBinding binding = CombindKeyBinding.of(mapping); // defaults to the KeyMapping's key

Без привязки — по умолчанию клавиша не назначена

// Player must configure this in the Controls > Key Binds screen
CombindKeyBinding binding = CombindKeyBinding.of(mapping, KeyCombo.unbound());

Опрос по тикам (в ванильном стиле)

Если ты предпочитаешь стандартный паттерн опроса по тикам вместо колбэков, он работает без изменений через ванильный KeyMapping:

ClientTickEvents.END_CLIENT_TICK.register(client -> {
    while (someActionMapping.consumeClick()) {
        // handle each queued click
    }

    if (someActionMapping.isDown()) {
        // binding is currently held
    }
});

Подробнее — в полной реализации по адресу src/client/java/net/pemiridosa/combind/api.