KeySplit

🇬🇧 English

Dedicate a second physical keyboard entirely to shortcuts and mod keybindings — zero conflict with your main keyboard.

KeySplit is a client-side NeoForge mod for players who run out of available keys due to the sheer number of mods installed. Instead of hunting for free key combinations on your main keyboard, plug in a second keyboard and dedicate it entirely to shortcuts, macros-free remapping, and mod actions.

✨ Features

• Automatic device detection — an in-game setup flow detects your secondary keyboard the moment you press a key on it, no manual configuration file editing required.
• Full action library — bind any key on your secondary keyboard to any vanilla Minecraft action or any keybinding registered by another installed mod. The list is scanned live, so it always matches your current modpack.
• Simple, visual config screen — accessible directly from the vanilla Controls menu. Add a mapping, remove a mapping, see everything at a glance.
• Real in-game triggering — bound keys genuinely fire the target action (movement, attack, inventory, mod hotkeys...), not just a visual mockup.

⚠️ Alpha status — please read

KeySplit is early alpha software, macOS-only for now (Windows support is planned, pending a tester with a Windows machine — reach out if you'd like to help).

• No conflict protection yet: KeySplit does not currently prevent a bound key from also triggering its normal vanilla action if that key is shared with your main keyboard. For a clean experience today, bind keys your main keyboard doesn't already use (numpad, F13+, etc.) rather than duplicating existing bindings.
• Config is not saved between sessions yet — persistent storage is actively being worked on.
• Expect rough edges. Feedback and bug reports are very welcome.

🔧 Requirements

• NeoForge, Minecraft 26.1.x
• macOS (Windows not yet supported)
• A second physical USB keyboard
• macOS will prompt for Input Monitoring permission (System Settings → Privacy & Security) the first time KeySplit detects your keyboards — this is required for the mod to distinguish between your two keyboards.

🙏 Credits

Developed by Zyldros, with development assistance from Claude AI.

Special thanks to Bideco, creator and developer of Lattice, for invaluable technical guidance on macOS keyboard capture.

---

🇫🇷 Français

Dédiez un second clavier physique entièrement aux raccourcis et aux touches de mods — sans aucun conflit avec votre clavier principal.

KeySplit est un mod NeoForge côté client destiné aux joueurs qui manquent de touches disponibles à cause du nombre de mods installés. Plutôt que de chasser des combinaisons de touches libres sur votre clavier principal, branchez un second clavier et dédiez-le entièrement aux raccourcis et aux actions de mods.

✨ Fonctionnalités

• Détection automatique du périphérique — un écran de configuration en jeu détecte votre second clavier dès que vous appuyez sur une touche, sans fichier de configuration à éditer à la main.
• Bibliothèque d'actions complète — associez n'importe quelle touche de votre second clavier à n'importe quelle action Minecraft vanilla ou à n'importe quel raccourci enregistré par un autre mod installé. La liste est scannée en direct, donc toujours à jour avec votre modpack actuel.
• Écran de configuration simple et visuel — accessible directement depuis le menu Contrôles vanilla. Ajoutez un mapping, supprimez-en un, visualisez tout en un coup d'œil.
• Déclenchement réel en jeu — les touches associées déclenchent réellement l'action ciblée (déplacement, attaque, inventaire, raccourcis de mods...), pas juste un aperçu visuel.

⚠️ Statut alpha — merci de lire

KeySplit est un logiciel en alpha précoce, macOS uniquement pour l'instant (le support Windows est prévu, en attente d'un testeur disposant d'une machine Windows — contactez-moi si vous souhaitez aider).

• Pas encore de protection contre les conflits : KeySplit n'empêche pas encore qu'une touche associée déclenche aussi son action vanilla normale si cette touche est partagée avec votre clavier principal. Pour une expérience propre dès maintenant, associez des touches que votre clavier principal n'utilise pas déjà (pavé numérique, F13+, etc.) plutôt que de dupliquer des raccourcis existants.
• La configuration n'est pas encore sauvegardée entre les sessions — le stockage persistant est en cours de développement actif.
• Attendez-vous à quelques aspérités. Les retours et rapports de bugs sont les bienvenus.

🔧 Prérequis

• NeoForge, Minecraft 26.1.x
• macOS (Windows non supporté pour l'instant)
• Un second clavier physique USB
• macOS demandera l'autorisation Surveillance des entrées (Réglages Système → Confidentialité et sécurité) lors de la première détection de vos claviers par KeySplit — nécessaire pour que le mod distingue vos deux claviers.

🙏 Crédits

Développé par Zyldros, avec l'assistance au développement de Claude AI.

Remerciements particuliers à Bideco, créateur et développeur de Lattice, pour ses précieux conseils techniques sur la capture clavier macOS.