Mouse-mouse
Minecraft 多实例鼠标与键盘输入分流器
让两名玩家共享一台 PC,各自使用自己的设备控制各自的 Minecraft 窗口
此模组的作用
Mouse-mouse 解决一个特定问题:在同一台 PC 上同时游玩两份 Minecraft。
当同一台机器上打开两个 Minecraft 窗口时,它们会争夺相同的鼠标和键盘——只有获得焦点的窗口能正常接收输入。此模组通过 Windows Raw Input 在系统层面捕获原始输入,并将每个设备的操作事件路由到其分配的 Minecraft 实例中,从而使两个窗口独立运行,互不干扰。
功能特性
- 按实例选择设备 —— 每个窗口可以选择自己的鼠标和键盘,无冲突
- 虚拟光标 —— 菜单使用软件光标进行点击、拖拽和滚动,与物理鼠标隔离
- 输入隔离 —— 未分配设备的输入事件会被拦截,不会影响游戏
- 安全快捷键
Alt + F8 —— 随时打开设备选择界面并暂时释放鼠标捕获
- 无需配置文件 —— 设备选择仅存储在内存中;不会写入磁盘
- 多实例协作 —— 两个实例共享一个分流进程;自动检测并跳过重复启动
安装说明
仅限 Windows。 此模组依赖 Windows Raw Input API,无法在 Linux 或 macOS 上运行。
步骤 1 — 下载 splitter.exe
从 GitHub Releases 下载 splitter.exe,并将其放入你的 Minecraft 实例的 mods/ 文件夹中:
.minecraft/mods/
├── Mouse-mouse-NeoForge-x.x.x+mc1.21.1.jar ← 模组 jar 文件
└── splitter.exe ← 必需,需单独下载
splitter.exe 是负责捕获 Raw Input 的进程。模组会在启动时自动运行它。如果 mods/ 文件夹中缺少该文件,模组将无法正常工作。
步骤 2 — 安装模组
- 为你的 Minecraft 版本安装 NeoForge 或 Fabric
- 将模组
.jar 文件放入 mods/ 文件夹
- (仅限 Fabric) 同时安装 Fabric API
- 确认
mods/ 中存在 splitter.exe
- 启动游戏,然后在游戏内或某个屏幕上按下
Alt + F8 以打开设备选择 UI
使用方法
两名玩家,一台 PC
- 启动第一个 Minecraft 实例
- 启动第二个 Minecraft 实例
- 在第一个窗口中按下
Alt + F8,选择第一组设备,点击 Save(保存)
- 在第二个窗口中按下
Alt + F8,选择第二组设备,点击 Save(保存)
- 现在两个窗口将分别响应其分配的设备
安全快捷键 Alt + F8
| 场景 |
效果 |
| 想要更改设备 |
打开设备选择界面 |
| 鼠标被捕获且无法移出窗口 |
暂时释放鼠标捕获 |
| 选错了设备 |
重新进入界面以重新分配或取消选择 |
兼容性
|
要求 |
| Minecraft |
1.21.1 |
| NeoForge |
21.1.x |
| Fabric Loader |
0.16.x 或更高版本 |
| Fabric API |
必需 |
| Java |
21 |
| 操作系统 |
仅限 Windows |
| 本地端口 |
127.0.0.1:19091(localhost,不对外暴露) |
已知限制
- 仅限 Windows 客户端——不支持 Linux 和 macOS
- 设备选择不会持久保存;每次启动后必须重新选择
- 如果端口
19091 已被其他进程占用,模组将无法启动
- 某些虚拟 HID 设备或触控板可能会出现在设备列表中
- 这是一个客户端模组;服务器端无需安装
工作原理
物理设备 A / B
│
▼
splitter.exe (Windows Raw Input)
│ IPC: 127.0.0.1:19091
▼
Minecraft instance A ←── 来自设备 A 的输入
Minecraft instance B ←── 来自设备 B 的输入
启动时,模组会运行 splitter.exe,后者通过 Windows Raw Input 枚举物理输入设备并建立 IPC 通道。每个 Minecraft 实例声明其想要的设备;Java 端随后从这些设备接收原始事件,并通过 Mixin 将其注入 Minecraft 的输入管道。菜单交互通过按实例的虚拟光标处理,因此物理鼠标位置不会直接影响 GUI 状态。
许可证
GPL-3.0-only
Mouse-mouse
Multi-instance mouse & keyboard input splitter for Minecraft
Let two players share one PC, each controlling their own Minecraft window with their own devices
What does this mod do?
Mouse-mouse solves one specific problem: two people playing Minecraft simultaneously on the same PC.
When two Minecraft windows are open on the same machine, they compete for the same mouse and keyboard — only the focused window receives input normally. This mod captures raw input at the system level via Windows Raw Input and routes each device's events to its assigned Minecraft instance, so both windows run independently without interfering with each other.
Features
- Per-instance device selection — each window picks its own mouse and keyboard, no conflicts
- Virtual cursor — menus use a software cursor for clicks, drags, and scrolling, isolated from the physical mouse
- Input isolation — events from unassigned devices are blocked so they don't affect the game
- Safety chord
Alt + F8 — opens the device selection screen at any time and temporarily releases mouse capture
- No config files — device selection is stored only in memory; nothing is written to disk
- Multi-instance cooperation — both instances share one splitter process; duplicate launches are detected and skipped automatically
Installation
Windows only. This mod relies on the Windows Raw Input API and does not work on Linux or macOS.
Step 1 — Download splitter.exe
Download splitter.exe from GitHub Releases and place it in your Minecraft instance's mods/ folder:
.minecraft/mods/
├── Mouse-mouse-NeoForge-x.x.x+mc1.21.1.jar ← mod jar
└── splitter.exe ← required, download separately
splitter.exe is the Raw Input capture process. The mod launches it automatically on startup. If it is missing from mods/, the mod will not function.
Step 2 — Install the mod
- Install NeoForge or Fabric for your Minecraft version
- Drop the mod
.jar into your mods/ folder
- (Fabric only) Also install Fabric API
- Confirm
splitter.exe is present in mods/
- Launch the game, then press
Alt + F8 in-game or on a screen to open the device selection UI
Usage
Two players, one PC
- Start the first Minecraft instance
- Start the second Minecraft instance
- In the first window, press
Alt + F8, select the first set of devices, click Save
- In the second window, press
Alt + F8, select the second set of devices, click Save
- Both windows now respond independently to their assigned devices
Safety chord Alt + F8
| Situation |
Effect |
| Want to change devices |
Opens the device selection screen |
| Mouse is captured and can't leave the window |
Temporarily releases mouse capture |
| Wrong device selected |
Re-enter the screen to reassign or deselect |
Compatibility
|
Requirement |
| Minecraft |
1.21.1 |
| NeoForge |
21.1.x |
| Fabric Loader |
0.16.x or later |
| Fabric API |
Required |
| Java |
21 |
| OS |
Windows only |
| Local port |
127.0.0.1:19091 (localhost, not exposed externally) |
Known Limitations
- Windows clients only — Linux and macOS are not supported
- Device selection is not persisted; you must re-select after every launch
- If port
19091 is already in use by another process, the mod will fail to start
- Some virtual HID devices or touchpads may appear in the device list
- This is a client-side mod; the server does not need it installed
How It Works
Physical devices A / B
│
▼
splitter.exe (Windows Raw Input)
│ IPC: 127.0.0.1:19091
▼
Minecraft instance A ←── input from device A
Minecraft instance B ←── input from device B
On startup, the mod launches splitter.exe, which enumerates physical input devices via Windows Raw Input and opens an IPC channel. Each Minecraft instance claims the devices it wants; the Java side then receives raw events from those devices and injects them into Minecraft's input pipeline via Mixin. Menu interaction is handled through a per-instance virtual cursor, so the physical mouse position does not directly affect GUI state.
License
GPL-3.0-only
评论 0
登录后参与评分
还没有评论,来抢沙发吧