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.
