Mouse&mouse

模组

· 作者 mckafei_CN

Mouse-mouse 是一款适用于 Minecraft 1.21.1 NeoForge 的客户端输入分流模组。它旨在支持本地多实例运行、多套键鼠设备、本地合作实验以及输入测试。

0 本站下载 0 关注 更新于 4 个月前

最新 1.0.2 · 1.21.1 · NeoForge

一键开服(送7天)
Mouse-mouse Logo

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 — 安装模组

  1. 为你的 Minecraft 版本安装 NeoForge 或 Fabric
  2. 将模组 .jar 文件放入 mods/ 文件夹
  3. (仅限 Fabric) 同时安装 Fabric API
  4. 确认 mods/ 中存在 splitter.exe
  5. 启动游戏,然后在游戏内或某个屏幕上按下 Alt + F8 以打开设备选择 UI

使用方法

两名玩家,一台 PC

  1. 启动第一个 Minecraft 实例
  2. 启动第二个 Minecraft 实例
  3. 在第一个窗口中按下 Alt + F8,选择第一组设备,点击 Save(保存)
  4. 在第二个窗口中按下 Alt + F8,选择第二组设备,点击 Save(保存)
  5. 现在两个窗口将分别响应其分配的设备

安全快捷键 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

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源