
Modrinth · Minecraft mod
TTY-Client
A terminal-themed Minecraft client for those who live in the shell.
Quick answer
Which TTY-Client release matches 26.1.2?
TTY-Client 0.6.1-alpha targets 26.1.2 with Fabric. It must be installed on the client. Do not install it on the dedicated server. All 2 required mods have matching files.
Where it goes
Is TTY-Client required on the client, server, or both?
It must be installed on the client. Do not install it on the dedicated server.
This file is marked client-only.
What else does TTY-Client 0.6.1-alpha need?
0.6.1-alpha on 26.1.2. Every mod below is checked against that same setup.
Install Fabric Language Kotlin, Fabric API first. We found matching files for this game-version and loader setup. 1 comes through another mod in the chain.
1 extra mod was pulled in by another dependency. Indented rows show who needs each one. We only count dependency files that match this setup. A file for another loader does not fill the gap.
Before you install it
Add TTY-Client without breaking your instance.
Built for TTY-Client 0.6.1-alpha on 26.1.2. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use 0.6.1-alpha. It targets 26.1.2 with Fabric; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
Install Fabric Language Kotlin, Fabric API first. We found matching files for this game-version and loader setup. 1 comes through another mod in the chain.
- 03
Put it on the correct side
It must be installed on the client. Do not install it on the dedicated server.
- 04
Pick the file you checked
Use the “Get this file” button beside 0.6.1-alpha. It opens that exact file at the source.
About this project
What does TTY-Client add?
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.
Project description from Modrinth.
Pick your setup
TTY-Client by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
26.2
1 loader build26.1.2
1 loader buildCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
TTY-Client versions and loaders
0.6.1-alpha
ttyclient-0.6.1-alpha.jar
6 Jun 2026
0.6.0-alpha
ttyclient-0.6.0-alpha.jar
6 Jun 2026
0.5.1-alpha
ttyclient-0.5.1-alpha.jar
3 Jun 2026
0.5.0-alpha
ttyclient-0.5.0-alpha.jar
3 Jun 2026
Looking for an older file? The official Modrinth project page is in Resources.