keybindUI 1.2.0-rc.1

Release Candidate / Beta

This build is a release candidate for keybindUI 1.2.0. It has been tested locally, but is being published as a Beta so it can be validated in real modpacks and different environments before the final 1.2.0 release.

🌐 Simplified Chinese Support

keybindUI now officially supports Simplified Chinese (zh_cn).

The translation was provided by fanren_, who also helped identify several usability limitations and provided feedback that directly influenced this update.

Simplified Chinese translation provided by fanren_.

The Chinese resource pipeline is now explicitly UTF-8, and the final JAR was validated to preserve the original Unicode characters correctly.

⚔️ Improved Conflict Detection

Conflict detection has been significantly improved.

keybindUI now takes Forge's key conflict contexts and key modifiers into account instead of simply assuming that two actions using the same physical key must always conflict.

This reduces false conflict warnings for keybinds that can legitimately coexist in different contexts.

Modifier combinations are also handled more accurately, including cases involving combinations such as:

• F
• CTRL + F
• SHIFT + F
• mouse buttons
• GUI/gameplay contexts

The goal is to distinguish actual conflicts from keybinds that only happen to share an input.

🛡️ Ignore Specific Conflicts

Some conflicts cannot be determined perfectly by Forge because mods may handle input dynamically depending on things such as:

• the currently open screen;
• the mouse position;
• hovered items;
• mod-specific overlays;
• custom input logic.

Because of this, keybindUI now allows you to manually ignore a specific conflict pair when you know the two actions do not interfere with each other during normal gameplay.

For example:

Minecraft Attack ↔ JEI Action

Ignoring this pair does not whitelist the entire Left Mouse Button.

Only that specific pair is ignored. Other actions using the same button will still be checked normally.

Ignored conflicts:

• no longer count as active conflicts;
• no longer receive the critical red conflict indication;
• are ignored by automatic conflict resolution;
• are respected by key suggestions;
• persist between game sessions;
• can be reviewed and restored later.

↕️ Expand / Collapse All

A new control has been added to quickly expand or collapse all mod categories in the sidebar.

This is especially useful in large modpacks where hundreds of keybinds may be distributed across many mods.

🔎 Conflict System Reliability

The internal conflict system received extensive corrections and regression testing during development.

The new implementation preserves Forge 1.20.1 keybinding semantics while allowing keybindUI to distinguish legitimately separate contexts.

The release candidate currently passes 100 automated tests, including:

• conflict semantics;
• modifiers;
• contextual conflicts;
• ignored conflicts;
• key suggestions;
• Unicode resource integrity;
• language file validation;
• Mixin/refmap validation;
• final JAR packaging.

🧪 Why is this a Release Candidate?

Although the current build has passed automated tests and local in-game testing, keybind behavior can vary significantly between mods.

This build is therefore being published as a Beta / Release Candidate before becoming the final 1.2.0 release.

Testing in large modpacks is especially valuable.

If you encounter:

• a false conflict;
• a conflict that should exist but is not detected;
• problems when ignoring/restoring conflicts;
• broken or missing Chinese text;
• UI problems;
• compatibility problems with another mod;
• or any other unusual behavior;

please report it.

❤️ Special Thanks

A special thanks to fanren_ for the detailed feedback, real-world examples, whitelist/ignore-conflict suggestion, Simplified Chinese translation, and additional ideas for improving keybindUI.

A significant part of the work leading to 1.2.0 started from that community feedback.

Thank you for helping make keybindUI better!

---

keybindUI 1.2.0-rc.1 — Português (Brasil)

Release Candidate / Beta

Esta build é uma candidata à versão final do keybindUI 1.2.0. Ela já foi testada localmente, mas está sendo publicada como Beta para ser validada em modpacks reais e diferentes ambientes antes da versão 1.2.0 final.

🌐 Suporte a Chinês Simplificado

O keybindUI agora possui suporte oficial a Chinês Simplificado (zh_cn).

A tradução foi fornecida por fanren_, que também ajudou a identificar diversas limitações de usabilidade e forneceu feedback que influenciou diretamente esta atualização.

Tradução para Chinês Simplificado fornecida por fanren_.

O pipeline de recursos agora utiliza UTF-8 explicitamente, e o JAR final foi validado para garantir que os caracteres Unicode originais sejam preservados corretamente.

⚔️ Detecção de Conflitos Aprimorada

A detecção de conflitos foi significativamente melhorada.

O keybindUI agora considera os contextos de conflito e modificadores de teclas do Forge, em vez de simplesmente assumir que duas ações utilizando a mesma tecla física sempre estão em conflito.

Isso reduz falsos alertas para atalhos que podem coexistir legitimamente em contextos diferentes.

Combinações com modificadores também são tratadas com maior precisão, incluindo casos envolvendo:

• F
• CTRL + F
• SHIFT + F
• botões do mouse
• contextos de interface/gameplay

O objetivo é diferenciar conflitos reais de atalhos que apenas compartilham a mesma entrada.

🛡️ Ignorar Conflitos Específicos

Alguns conflitos não podem ser determinados perfeitamente pelo Forge porque mods podem processar entradas dinamicamente dependendo de fatores como:

• a tela atualmente aberta;
• a posição do mouse;
• o item sob o cursor;
• overlays específicos de mods;
• lógica de entrada personalizada.

Por isso, o keybindUI agora permite ignorar manualmente um par específico de conflitos quando você sabe que aquelas duas ações não interferem entre si durante o uso normal.

Por exemplo:

Ataque do Minecraft ↔ Ação do JEI

Ignorar esse par não adiciona todo o Botão Esquerdo do Mouse a uma whitelist.

Somente aquele par específico será ignorado. Outras ações utilizando o mesmo botão continuarão sendo verificadas normalmente.

Conflitos ignorados:

• deixam de contar como conflitos ativos;
• deixam de receber a indicação crítica/vermelha de conflito;
• são ignorados pela resolução automática de conflitos;
• são respeitados pelas sugestões de teclas;
• permanecem salvos entre sessões;
• podem ser revisados e restaurados posteriormente.

↕️ Expandir / Recolher Tudo

Um novo controle foi adicionado para expandir ou recolher rapidamente todas as categorias de mods na barra lateral.

Isso é especialmente útil em modpacks grandes, onde centenas de atalhos podem estar distribuídos entre muitos mods.

🔎 Confiabilidade do Sistema de Conflitos

O sistema interno de conflitos recebeu diversas correções e testes de regressão durante o desenvolvimento.

A nova implementação preserva a semântica de keybindings do Forge 1.20.1 enquanto permite que o keybindUI diferencie contextos legitimamente separados.

Esta Release Candidate atualmente passa por 100 testes automatizados, incluindo:

• semântica de conflitos;
• modificadores;
• conflitos contextuais;
• conflitos ignorados;
• sugestões de teclas;
• integridade de recursos Unicode;
• validação dos arquivos de idioma;
• validação de Mixin/refmap;
• empacotamento do JAR final.

🧪 Por que esta versão é uma candidata a Release?

Embora a build atual tenha passado pelos testes automatizados e por testes locais dentro do jogo, o comportamento de keybindings pode variar significativamente entre mods.

Por isso, esta versão está sendo publicada como Beta / Release Candidate antes de se tornar a versão final 1.2.0.

Testes em modpacks grandes são especialmente valiosos.

Caso você encontre:

• um falso conflito;
• um conflito que deveria existir, mas não foi detectado;
• problemas ao ignorar/restaurar conflitos;
• textos em chinês quebrados ou ausentes;
• problemas na interface;
• incompatibilidade com outro mod;
• ou qualquer outro comportamento incomum;

por favor, reporte o problema.

❤️ Agradecimento Especial

Um agradecimento especial ao fanren_ pelo feedback detalhado, exemplos de uso real, sugestão do sistema de whitelist/ignorar conflitos, tradução para Chinês Simplificado e pelas ideias adicionais para melhorar o keybindUI.

Uma parte significativa do trabalho que levou à versão 1.2.0 surgiu a partir desse feedback da comunidade.

Obrigado por ajudar a tornar o keybindUI melhor!