TTY-客户端

TTY-客户端

一个为在shell中生存的人而设计的终端主题Minecraft客户端。

管理

TTY-客户端预览查看大图

TTYClient

一个为终端爱好者打造的终端主题 Minecraft 客户端。

TTYClient 围绕一个核心理念构建：让你的 Minecraft 客户端像 Linux 系统一样可脚本化、可自定义。使用 ; 前缀输入客户端命令，将按键绑定到聊天消息、Minecraft 指令或直接的 bash 脚本，并通过纯 JSONC 文本文件配置一切——所有更改即时生效，无需重启。

系统要求

安装

将 ttyclient-*.jar 与 Fabric API 和 Fabric 版 Kotlin 一同放入 mods/ 文件夹。首次启动时，TTYClient 会在 ~/TTYClient/ 目录下创建配置文件夹。

使用方法

在聊天栏中输入 ; 后跟命令。这些命令在客户端侧被拦截，绝不会发送至服务器。

可用命令：

;help (别名: ?)                         列出所有命令
;mcfetch                                 显示类似 neofetch 风格的游戏信息
;info [--name|-n] [--version|-v] ...    显示 TTYClient 信息
;config                                  打开游戏内配置编辑器
;hud (别名: hudeditor)                  打开 HUD 编辑器
;module --trigger <module>               触发某个模块
;module --toggle <module>                启用或禁用某个模块
;screenshot <copy|upload> <path>         复制/上传截图
;debug --toggle <keys>                   切换按键可视化
;debug --trigger spam <n>                发送 n 条测试消息

命令前缀（默认为 ;）可在 ~/TTYClient/config/general.jsonc 中更改。

按键绑定

按键绑定配置位于 ~/TTYClient/config/keybinds.jsonc，支持多种执行类型：

{ "bind": "ALT+C",    "type": "client",  "exec": "config" },
{ "bind": "C",        "type": "client",  "exec": "module --trigger zoom" },
{ "bind": "CTRL+F1",  "type": "command", "exec": "gamemode creative" },
{ "bind": "F9",       "type": "bash",    "exec": "notify-send 'test notify'" },
{ "bind": "DELETE",   "type": "action",  "exec": "Disconnect" }

类型：client、command、chat、bash、sequence、action、noop

操作： QuitGame、Disconnect、ShowMultiplayer

模块

模块 默认按键 描述
缩放 C 平滑动画 FOV 缩放，可滚动调节，支持按住或切换模式
自由视角 X 在第三人称模式下，将摄像头与视角方向分离
亮度增强 B 通过伽马值提升或夜视效果消除黑暗
自定义准星 - 15x15 像素网格准星，完全可通过 JSONC 配置，支持反色显示
自定义聊天栏 I 可调整大小的聊天窗口，拖动调节尺寸，无限历史记录，支持聊天开关
自动重连 - 断开连接后自动重连，并显示倒计时
渲染工具 - 自定义盾牌/图腾模型变换，低火遮挡效果
截图 - F2 截图，支持复制/打开/上传操作，分辨率最高支持 8k
实用工具 - 耐久度警告：闪烁动作栏警报 + 提示音
通知 - 屏幕角落弹出式通知，带动画和音效
性能优化 - 游戏内 HUD 限帧，提升 FPS

所有模块的配置文件位于 ~/TTYClient/config/modules/，保存后立即生效。

编辑器

配置编辑器

按 ALT+C 或输入 ;config 打开内置的游戏内配置编辑器——支持 JSONC 语法高亮、内联十六进制颜色预览、撤销/重做等功能。

HUD 编辑器

按 ALT+H 或输入 ;hud 打开 HUD 编辑器——通过可视化界面拖拽调整 HUD 元素位置。