[TC]触摸控制器 (TouchController) - MC百科

TouchController 简介

TouchController 是一个 Minecraft 模组，能够为 Java 版（Minecraft: Java Edition）带来类似基岩版（Minecraft: Bedrock Edition）的触控功能。它提供了高度自定义的控件布局、多种配置选项以及一些原创控件，旨在为触控操作提供更多可能性。

官方地址

https://github.com/TouchController

https://www.mcmod.cn/class/17432.html

https://modrinth.com/mod/touchcontroller

https://gitee.com/fifth_light/TouchController

https://www.curseforge.com/minecraft/mc-mods/touchcontroller

关于开发组

作者：@fifth_light

联合作者：@bukeyu

美术：@fengzhou0w0

设计、Wiki：@白象_elephant

美术、Wiki：@不想取名的阿peng

吉祥物：@Handsomeprin

开始

游玩须知

支持版本

1.12.2 (Forge)

1.16.5 (Forge, Fabric)

1.20.1 (Forge, Fabric)

1.20.4 (Forge, NeoForge, Fabric)

1.20.6 (Forge, NeoForge, Fabric)

1.21 (Forge, NeoForge, Fabric)

1.21.1 (Forge, NeoForge, Fabric)

1.21.3 (Forge, NeoForge, Fabric)

1.21.4 (Forge, NeoForge, Fabric)

1.21.5 (Forge, NeoForge, Fabric)

1.21.6 (Forge, NeoForge, Fabric)

1.21.7 (Forge, NeoForge, Fabric)

1.21.8 (Forge, NeoForge, Fabric)

支持平台

Windows（版本最低为 Windows 7，支持 x86、x86_64 和 ARM64 架构）

Linux（目前只支持 Wayland 显示协议，不支持 X11（包括 XWayland）；只支持 glibc，暂时不支持 musl；只支持 x86_64、x86、armv7、armv8 架构）

Fold Craft Launcher

Zalith Launcher

Zalith Launcher 2

Angel Aura Amethyst

Pojav Glow·Worm

修改版 PojavLauncher【停止维护】

下载

请务必注意您的游戏版本和 mod 加载器，以及您使用的平台是否支持 TouchController。

使用启动器下载

在模组安装页面中搜索 TouchController。

根据启动器的提示，为对应的 Minecraft 版本和 mod 加载器寻找最新版 TouchController。如果使用 Fabric，还需要安装 Fabric API。

Fabric 版本还可以选择安装 模组菜单（Mod Menu） 以方便进入设置页面。

从网站下载

https://www.mcmod.cn/download/17432.html

https://modrinth.com/mod/touchcontroller/versions

https://www.curseforge.com/minecraft/mc-mods/touchcontroller/files/all?showAlphaFiles=show

https://github.com/TouchController/TouchController/releases

https://gitee.com/fifth_light/TouchController/releases

安装

找到 mod 文件夹，一般在 .minecraft/mods。如果开启了版本隔离，mod 文件夹就在 .minecraft/versions/<游戏版本名称>/mods。

将下载的 TouchController 模组文件放进去，如果使用了 Fabric 版本，还需要安装 Fabric API。

游玩

在 Android 系统中，系统的返回键可以替代 Escape 键的功能，用于关闭物品栏或呼出游戏菜单。

隐藏启动器的控件

大部分启动器都有控件编辑功能，可以删除启动器自带的控件。以 FCL 为例，只需要新建一个空布局，然后删除原布局即可。

定制 TouchController

可以通过多种方法进入 TouchController 的设置界面。

通过模组菜单

打开模组菜单。Forge 自带模组菜单，如果使用 Fabric 加载器，则需要安装模组菜单。

在模组菜单中找到 TouchController，便可以进入设置页面。

通过游戏菜单

打开游戏菜单 -> 选项 -> 按键控制 -> 触摸设置。

不同版本的进入方式可能略有不同。

常见问题

提示“代理未连接”

请检查使用的启动器、平台是否支持 TouchController。

如果启动器支持 TouchController，请确保启动器为最新版本。

您可以点击这里请求支持一个平台或者启动器。iOS 和 macOS 的支持可能不会提供，因为开发者缺少相应的开发环境。

如果确认无误但仍提示“代理未连接”，您可以尝试点击这里反馈一个 bug。

可以进入游戏，但功能异常

请检查您使用的启动器、平台、游戏版本、mod 加载器是否为受支持的，并确保安装了前置模组。

您可以点击这里反馈一个 bug，请详细说明情况，提供日志以及复现流程。

游戏崩溃

出现报错窗口

游戏窗口内可能会显示错误原因（例如 mod 加载器版本过低、缺少前置等），您可以依照上面的指引尝试修复错误。

如果您不能修复错误，可以报告 BUG。

没有出现窗口

启动器可能会为您提供一些信息，您可以根据启动器提供的信息尝试修复错误。

如果启动器没有提供有效信息、提示与其他 mod 冲突或者您不能修复错误，可以报告 BUG。

报告 bug

只安装了 TouchController 以及前置

请检查您使用的启动器、平台、游戏版本、mod 加载器是否为受支持的，确保安装了前置模组。

您可以点击这里反馈一个 bug，反馈时请详细地说明情况，提供日志以及复现流程。

安装了其他 mod

首先请检查您的环境是否受支持。

您可以单独安装 TouchController 以及前置进行测试，如果仍出现 bug，请报告给开发者。

您可以移除其他 mod，再一一添加，测试是哪个 mod 导致的 bug，并报告给开发者。

您可以点击这里反馈 bug，并提供详细信息。

在整合包中使用 TouchController

您可以尝试移除 TouchController。如果移除后仍出现异常，那么可能不是 TouchController 导致的 bug。

在整合包中使用 TouchController 可能会导致 bug。

如果整合包中 mod 较少，您可以依照上面的步骤测试 mod 冲突。

如果 mod 过多无法测试，您可以直接反馈 bug。

机制

锚点机制

锚点机制旨在适配不同大小的屏幕，使得控件布局在任何设备上都可用。

锚点共有 9 种，分别为屏幕四角、屏幕四边的中心、屏幕中心。

无论画面边框如何变化，控件相对其锚点的位置始终不变。

静默转头

这个机制起源于 #148 和 #153，解决了在不开启分离控制时，使用某些物品（如水桶）无法在点击位置正确交互的问题。

Minecraft 服务端在处理某些物品的使用时，会忽略客户端发送的目标位置，而是根据玩家的实际朝向来确认目标。这导致了点击屏幕放水，水却放在准星位置的现象。

为了解决这个问题，TouchController 加入了静默转头的机制。当手持在“需要修正使用方向的物品”列表中配置的物品时，点击屏幕交互后，TouchController 会在一帧内完成“转头对准点击位置 -> 交互 -> 转头恢复原位”的动作。由于速度极快，客户端和服务端都不会渲染转头动作，从而实现了在点击位置进行交互的效果。

输入适配

TouchController 能够在您选中输入框时自动弹出触摸键盘，并能让输入框在键盘弹出时移动到键盘顶部以方便输入。此功能目前主要支持 TouchController 的 GUI，对原版 GUI 的支持计划在未来实现。

Windows 系统：需要系统能识别触摸屏，并在系统设置中开启相关功能（例如 Windows 11 的设置 -> 时间和语言 -> 输入 -> 触摸键盘）。

Linux 系统：在 Wayland 下实现了 text_input_v3 协议，由合成器决定是否弹出键盘。

Android 系统：相关功能需要启动器的支持。

自定义控件

TouchController 几乎所有的控件都基于一个灵活的自定义架构。在“自定义控件布局”页面中，您可以添加、修改控件，并将其保存为模板以便复用。

外观

您可以为控件的正常和激活状态配置不同的外观。可配置项包括：

填充：使用纯色填充控件，可设置边框、边框颜色和文本边距。控件大小随文本长度变化。

固定贴图：使用 TouchController 内置的任何贴图作为控件外观，可调整缩放，最高为400%。

自适应贴图：选择一些控件背景作为自定义控件的背景，大小随文本长度变化，可设置文本边距。

操作

动作

您可为控件绑定操作，包括：

无：不做任何操作。

键位：执行 Minecraft “按键绑定”中的操作。可设置为触发后锁定（持续激活），锁定类型有开始、停止和反转。

玩家操作：触发玩家的特定动作，如开始/停止疾跑、停止飞行等。

游戏操作：触发游戏操作，如打开游戏菜单、聊天界面等。

图层条件：切换、启用或禁用某个自定义图层条件。

触发

按压：手指按下控件的瞬间触发。

按下：手指按下控件后持续触发（只能绑定键位）。

松开：手指松开控件的瞬间触发。

双击：手指双击控件时触发，可设置判定间隔。

自定义布局

TouchController 提供两种布局模式：预设模式和自定义模式。预设模式提供预设选项的切换，而自定义模式则提供对各个元素的详细控制。您可以在设置中随时切换这两种模式。

预设系统

预设系统可以让您在不同的布局之间快捷切换，并直接进行修改。

所有的布局编辑都在一个预设中进行。

TouchController 内置了多种预设供您选择和使用。

您可以在预设列表中对预设进行排序、复制、重命名和修改设置（如分离控制、触摸手势等）。

图层系统

图层系统用于在不同情况下（如飞行、划船时）显示不同的控件。

每个图层都可以配置显示条件，满足条件的图层会叠加显示。

所有控件都必须在图层中创建。

图层编辑

在此页面，您可以编辑图层名称和条件。条件分为三种标签页：

预置条件：游戏内的状态，如游泳中、飞行中、潜行中等。

手持物品：当玩家手持指定物品时满足条件。

自定义条件：由用户创建和控制的条件，可与自定义控件联动。

条件状态

永不：条件满足时不显示图层。

包含：条件满足时显示图层。

必要：所有标记为“必要”的条件都满足时才显示图层。

自定义图层条件

这是为通过自定义控件控制图层而设计的机制。自定义图层条件与预设绑定，不同预设间的条件互不干扰。您可以在图层编辑页面添加、重命名和删除这些条件。

特性

触控圈

曾用名：触摸准星（TouchController v0.1.x 及以前）

外观

触控圈实际上是一个同心二十四边形。

触控圈及其破坏进度都以反色渲染。

挖掘方块

特性

触控圈当前只能同时存在一个，代表 TouchController 识别的当前手指。

打开分离控制后将不会显示触控圈。

触控圈激活后能代替原有的十字准星来瞄准方块或实体。

使用弓敲钟

自定义布局的特性

控件被拖出窗口外会自动弹回。

如果控件在窗口边缘，调整窗口大小后控件可能会位于窗口外。

被锁定的控件会拥有红色描边，而非普通的白色描边。

管理预设的特性

如果页面宽度不足，原本在页面下方的控件样式选项将移至右侧。

GUI

设置界面

界面框架

页面标题

当前页面的标题会显示在返回按钮上。

当前标签页的标题会显示在顶栏居中。

顶栏按钮

返回：由“<”和页面标题组成，点击会返回上一级或退出设置并保存修改。

重置：可选择重置当前标签页、布局设置或所有设置。

撤销：丢弃所有未保存的更改。

取消：丢弃所有未保存的更改，并退出设置界面。

标签页：关于

此标签页展示了 TouchController 的相关信息、版本号、作者、贡献者、许可协议以及使用的第三方库信息。

关于页面

标签页：通用

常规

此标签页是进入设置界面后默认显示的页面，其中的所有选项均为开关。

屏蔽鼠标移动：默认启用。在系统将触摸输入映射为鼠标输入时启用，可避免意外的视角移动。

屏蔽鼠标点击：默认启用。在系统将触摸输入映射为鼠标输入时启用，可避免错误的破坏和使用操作。

禁用光标锁定：默认禁用。使游戏不捕获鼠标焦点，允许光标移出游戏窗口。

屏蔽快捷栏按键输入：默认禁用。部分移动端启动器在点击快捷栏时会发送数字键，启用此项可屏蔽这些输入。

震动反馈：默认启用。破坏方块时提供触感反馈（目前主要支持 Android 平台）。

快速主副手交换：默认禁用。启用后，双击快捷栏中的格子可交换主副手物品。

控制

此标签页中的所有选项均为滑杆。

视角移动灵敏度：默认 495 度。设置手指划过一个屏幕宽度时视野旋转的角度。

长按检测阈值：默认 2%。判断点击是长按还是移动所需的最小移动距离（屏幕宽度的百分比）。

长按检测时间：默认 5 刻。判断点击是否为长按所需的最小按下时间。

触控圈

此标签页中的所有选项均为滑杆。

半径：默认 36 像素。触控圈的半径，会与游戏的“界面尺寸”相乘。

边框宽度：默认 2 像素。触控圈的边框宽度，同样会与“界面尺寸”相乘。

初始进度：默认 0.5。破坏方块时，在触控圈中心渲染的初始进度圆圈半径占总半径的比例。

调试

此标签页中的所有选项均为开关，且默认禁用。

显示指针位置：在屏幕上绘制所有触摸点及其唯一 ID。

触摸模拟：将鼠标输入模拟为触摸输入，同时会屏蔽触摸和鼠标点击。

标签页：物品

可长按使用的物品

手持此标签页内配置的物品时，对准任何地方长按都可以使用。您可以通过白名单、黑名单、物品堆叠组件或物品子类来进行配置。每个列表都可以通过点击按钮进入相应的配置页面。

手持时显示准星的物品

手持此标签页内配置的物品时会始终显示准星。配置方式同上。

需要修正使用方向的物品

使用此标签页内配置的物品时会进行静默转头。配置方式同上。

子页面：管理控件预设

此页面用于配置由开发团队提供的控件预设。

管理预设页面

样式

贴图风格：单选列表，选择控件的视觉风格。

不透明度：滑杆，调整所有控件的不透明度（物品栏按钮除外）。

大小：滑杆，调整所有控件的大小（物品栏按钮除外）。

布局

控制方式：单选列表，选择“点击屏幕交互”或“使用准星瞄准”（即是否启用“分离控制”）。

通过按钮攻击与交互：选项，默认启用。启用后将关闭触摸手势，仅使用按钮攻击与交互（需要“使用准星瞄准”）。

移动方式：单选列表，选择“方向键”或“摇杆”。

使用摇杆疾跑：选项，默认禁用。摇杆推到 110% 后触发疾跑。

交换跳跃与潜行：选项，默认禁用（有前置条件）。

疾跑按键：下拉菜单，选择疾跑按钮的位置。

使用原版聊天界面：选项，默认禁用。

分离控制+按钮交互的游戏内效果

子页面：自定义控件布局

此页面可以完全自定义控件的布局、外观和功能。

全局高亮控件

顶栏

返回按钮、粘贴控件、删除控件、展开编辑菜单、撤销和重做。

边栏

属性：编辑选中控件的属性，如名称、锁定、锚点、不透明度和各种触发选项。下方可进行复制、剪切操作。工具栏包含全局锁定、高亮、保存为模板等功能。自定义控件属性

控件：从内置控件或您保存的模板控件中添加新控件到布局中。添加控件

图层：管理布局图层，包括添加、删除、复制、编辑和排序。

预设：管理布局预设，包括添加、删除、复制、编辑和排序。

子页面：物品列表

此页面用于配置各种物品白名单和黑名单。页面分为两部分：左侧是已添加的物品列表，右侧是可供选择的物品表，支持从默认物品表或原版创造/生存物品栏中选择。

物品列表-原版物品栏

子页面：组件列表

此页面用于根据物品的堆叠组件来配置列表。页面同样分为左右两部分，左侧是已添加的组件，右侧是所有可用的组件列表，您可以进行添加或移除操作。

聊天界面

此页面使用了仿基岩版的风格，只能通过绑定了“打开聊天界面”动作的自定义控件来打开。

框架：顶部是标题和退出按钮。底部包含用于弹出键盘的按钮、输入框和发送按钮。快捷指令功能暂未实现。

功能：支持自动弹出键盘，并可设置行距和文本颜色。

控件

控件样式

图集

图集是对控件视觉风格的分类，目前有四种：

经典 (classic)：基岩版旧版贴图风格。

新样式 (new)：基岩版当前使用的扁平化贴图风格。

经典扩展 (classic_extension)：新版图标和旧版控件背景。

新样式回归 (new_regression)：旧版图标和新版控件背景。

图标

图标指的是控件中的图案，不同图标表达了不同的功能或含义。

游戏内控件

大部分内置控件基于自定义控件实现，但也有一些拥有特殊设置的控件：

方向键

可设置是否显示斜向按键。

可调整按钮间的边距。

中心按钮可独立调整大小和激活贴图，并拥有“普通”、“滑动无锁定”和“滑动锁定”等多种触发类型。

虚拟摇杆

可分别调整背景和手柄的大小。

可设置“摇杆推到 110% 触发疾跑”。

可设置“激活时提高不透明度”。

划船按钮

一个特殊的双按钮控件，用于控制船的转向和前进。按左按钮右转，按右按钮左转，同时按前进。

划船