Back to mods
KeySwitch project artwork

CurseForge · Minecraft mod

KeySwitch

Key Switch is a client-side Minecraft mod for NeoForge that resolves key binding conflicts between mods.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which KeySwitch release should I use?

Updated today
Latest stable file keyswitch-1.1.0-26.3-NeoForge.jar
Game version 26.3
Loader NeoForge

keyswitch-1.1.0-26.3-NeoForge.jar targets 26.3 with NeoForge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.

Where it goes

Is KeySwitch required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release NeoForge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does keyswitch-1.1.0-26.3-NeoForge.jar need?

keyswitch-1.1.0-26.3-NeoForge.jar. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add KeySwitch without breaking your instance.

Built for keyswitch-1.1.0-26.3-NeoForge.jar. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use keyswitch-1.1.0-26.3-NeoForge.jar. It targets 26.3 with NeoForge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside keyswitch-1.1.0-26.3-NeoForge.jar. It opens that exact file at the source.

About this project

What does KeySwitch add?

Key Switch \按键切换

中文描述在下方

Key Switch is a client-side Minecraft mod for NeoForge that resolves key binding conflicts between mods. When several mods assign the same key, Key Switch lets the player decide which binding fires — without opening a configuration panel or interrupting the current action.

Background

In a heavily modded environment, it is common for multiple mods to register the same key. Vanilla Minecraft only allows one binding to receive a given key press, so the remaining mods either fail to respond or behave unexpectedly. Key Switch addresses this problem at the input layer.

Features

Long-press and wheel switching

  • Hold a shared key (400 ms by default, configurable) and scroll the mouse wheel. A compact card appears above the hotbar, listing every binding currently assigned to that key.
  • Scroll the wheel to move the highlight, then release the key to confirm. The selected binding becomes the only one that triggers.
  • The other bindings on the same key are replaced with “unbound key”, which is exactly equivalent to unbinding them manually. Mods that poll the key therefore cannot detect the press — regardless of whether they use consumeClick(), isDown(), matches(), or a key handler running inside a screen.
  • The switch requires no panel click and does not interrupt the player's operation.

Reliable binding persistence

  • Real bindings are recorded in config/keyswitch/state.json.
  • Bindings are restored before options.txt is written, when the Key Binds screen is opened, and on every game restart.
  • Removing the mod or rebinding keys manually does not cause any binding to be lost.

Control key whitelist

  • Movement bindings — WASD, jump, sneak, sprint, and use/attack/pick block — are protected by default.
  • Holding a whitelisted key never starts wheel switching, and whitelisted bindings are never replaced with “unbound”.
  • Conflicts that involve whitelisted keys can still be managed from the overview screen.

Overview screen

  • Press the overview key (default F8) to list every key shared by multiple bindings.
  • From the overview, the player can inspect a conflict in detail, allow or block individual bindings, or restore the vanilla behaviour so that every binding on the key triggers again.

Configuration

  • All adjustable options are located in config/keyswitch-client.toml, including the long-press delay, whether switching works inside screens, mouse-button long-press support, whether the game pauses, message toggles, and the whitelist.
  • The configuration supports hot reload and is also available as a configuration screen in the mod list.

按键切换

按键切换(Key Switch) 是一款面向 NeoForge 的客户端模组,用于解决模组之间的按键绑定冲突。当多个模组为同一个按键注册绑定时,玩家可以自行决定触发其中哪一项——无需打开配置面板,也不会打断当前操作。

背景

在多模组化环境中,多个模组注册同一按键的情况相当常见。原版 Minecraft 只允许一个绑定接收某次按键输入,其余模组要么无法响应,要么产生非预期行为。按键切换在输入层面解决这一问题。

功能特性

长按与滚轮切换

  • 按住共用键(默认 400 毫秒,可配置)并滚动鼠标滚轮,快捷栏上方将出现一个紧凑卡片,列出该按键上的全部绑定。
  • 滚动滚轮移动高亮,松开按键即确认。选中的绑定将成为唯一触发项。
  • 同一按键上的其余绑定会被替换为「无按键」,与手动解绑完全等效。因此,依赖轮询按键的模组无法检测到这次按键——无论其使用 consumeClick()、isDown()、matches(),还是在界面内部自行监听按键。
  • 切换过程不弹出界面、无需点击,不会打断玩家的操作。

可靠的绑定持久化

  • 真实绑定记录于 config/keyswitch/state.json。
  • 绑定会在写入 options.txt 之前、进入「按键绑定」界面时,以及每次游戏启动时自动还原。
  • 卸载本模组或手动改键均不会丢失绑定。

控制键白名单

  • 移动相关绑定——WASD、跳跃、下蹲、疾跑、使用/攻击/选取方块——默认受到保护。
  • 长按白名单按键不会进入滚轮切换,白名单内的绑定也永远不会被替换为「无按键」。
  • 涉及白名单按键的冲突仍可通过总览界面进行管理。

总览界面

  • 按下总览键(默认 F8)可列出所有被多个绑定共用的按键。
  • 在总览界面中,玩家可以查看冲突详情、逐项放行或屏蔽单个绑定,或恢复原版行为,使该按键上的全部绑定重新触发。

配置

  • 全部可调选项位于 config/keyswitch-client.toml,包括长按判定时间、界面内是否生效、鼠标按键长按支持、是否暂停游戏、提示开关以及白名单。
  • 配置支持热重载,并可在模组列表中通过配置界面进行调整。

Project description from CurseForge.

Pick your setup

KeySwitch by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

4 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

KeySwitch versions and loaders

5 of 5 releases match

Looking for an older file? The official CurseForge project page is in Resources.