TTYClient

A terminal-themed Minecraft client for those who live in the shell.

TTYClient is built around one idea: your Minecraft client should feel as scriptable and customizable as your Linux system. Type client commands starting with a ; prefix, bind keys to chat messages, Minecraft commands, or literal bash scripts, and configure everything through plain JSONC text files - all live-reloaded, no restarts needed.

---

Requirements

• Minecraft 26.1.2 with Fabric Loader ≥ 0.19.1
• Fabric API 0.150.0+26.1.2
• Kotlin for Fabric 1.13.9+kotlin.2.3.10

Installation

Drop ttyclient-*.jar alongside Fabric API and Kotlin for Fabric into your mods/ folder. On first launch, TTYClient creates its config directory at ~/TTYClient/.

---

Usage

Type ; followed by a command in chat. Commands are intercepted client-side and never sent to the server.

Available commands:

;help (alias: ?)                         list all commands
;mcfetch                                 neofetch-style game info
;info [--name|-n] [--version|-v] ...     show TTYClient information
;config                                  open the in-game config editor
;hud (alias: hudeditor)                  open the HUD editor
;module --trigger <module>               trigger a module
;module --toggle <module>                enable or disable a module
;screenshot <copy|upload> <path>         copy/upload screenshot
;debug --toggle <keys>                   toggle key visualizer
;debug --trigger spam <n>                send n test messages

The command prefix (default ;) can be changed in ~/TTYClient/config/general.jsonc.

---

Keybinds

Keybinds live in ~/TTYClient/config/keybinds.jsonc and support multiple execution types:

{ "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" }

Types: client, command, chat, bash, sequence, action, noop

Actions: QuitGame, Disconnect, ShowMultiplayer

---

Modules

Module	Default bind	Description
Zoom	C	Smooth animated FOV zoom, scrollable, hold or toggle
Freelook	X	Detach camera from look direction in third-person
Fullbright	B	Remove darkness via gamma boost or Night Vision
Custom Crosshair	-	15x15 pixel grid crosshair, fully configurable in JSONC, inverted colors support
Custom Chat	I	Resizable chat window, drag to resize, unlimited history, toggleable chat
AutoReconnect	-	Auto-reconnect with countdown after disconnect
RenderUtils	-	Custom shield/totem model transforms, low fire overlay
Screenshots	-	F2 screenshot with copy/open/upload actions in chat, resolution scaling up to 8k
Utils	-	Durability warning: flashing action-bar alert + pling sound
Notifications	-	Toast-style notifications in screen corners with animations and sounds
Performance	-	HUD throttle for improved FPS during gameplay

All module configs are in ~/TTYClient/config/modules/, with live-reload on save.

---

Editors

Config Editor

Press ALT+C or run ;config to open the built-in in-game config editor - JSONC syntax highlighting, inline hex color swatches, undo/redo, and much more.

HUD Editor

Press ALT+H or run ;hud to open the HUD editor - drag to reposition the HUD elements with a visual interface.