Changelog

Quacky's Better Keybinds — Version 1.0.0

Release Date: June 3, 2026

---

Overview

Quacky's Better Keybinds lets you rebind any action in the game to any key, mouse button, or combo. Multiple binds per action, optional order-sensitive combos, and smart conflict resolution. In-game ModMenu UI. Client-side only.

---

Features

Binding

• Bind Anything — every action in the Controls menu is bindable, vanilla and modded
• Multiple Binds — assign as many separate combos to one action as you want
• Combos — chain keyboard keys and mouse buttons (Shift + Left Click, Ctrl + Alt + P)
• Mouse Support — all 8 mouse buttons including side buttons (MOUSE4–MOUSE8)
• Order-Sensitive Option — per bind, require the exact press order or allow any order
• Smart Conflict Resolution — most specific combo wins (Shift + Click beats Click)
• Edge Detection — actions fire on press, held state tracked per combo

Capture

• Multi-Key Capture — press your whole combo; it records every key in order
• Auto-Finalize — capture locks in 3 seconds after the last key, no confirm needed
• Cancel — press ESC mid-capture to discard
• Live Feedback — countdown timer and the running combo shown while recording

Action List

• Live From Game — actions read straight from the game's KeyMapping registry
• Search — filter the full action list by name or id
• Categories — actions carry their in-game category label

Management

• Bind List — every saved bind shown in one scrollable panel
• One-Click Remove — red X on each row deletes that bind
• Persistence — all binds auto-save to JSON on every change and on close

User Interface

• ModMenu Integration — entire GUI in-game, no manual config files
• Scrollable Panels — action list and bind list scroll independently
• Order Toggle — one button flips order sensitivity for the next bind

---

Technical Highlights

Performance

• Zero-Allocation Polling — input state reuses collections each tick
• Screen Guard — bind processing skips entirely while any screen is open
• Direct KeyMapping Drive — no event spoofing; sets the real mapping state

Architecture

Input System

• InputManager — polls GLFW for 70+ keys and 8 mouse buttons each tick
• InputState — current/previous frame tracking for edge detection
• Press-order tracking — held keys recorded in press order for order-sensitive binds

Binding System

• BindTrigger — immutable combo, ordered or unordered, with match logic
• ActionBinding — one action to many triggers, most-specific match
• BindingManager — per-tick resolve and drive
• ConflictResolver — specificity-based winner selection

Action System

• ActionRegistry — built from Minecraft.options.keyMappings, refreshed on GUI open
• ActionDefinition — id, display name, category, target KeyMapping

Trigger Mechanism

• KeyMapping.setDown held while the combo is held (continuous actions)
• clickCount bumped via KeyMappingAccessor mixin on the press edge (discrete actions)

Mixin Injection Points

• KeyMappingAccessor — exposes private clickCount for discrete-action simulation

Compatibility

Minecraft	1.21.11 (exact; API drift)
Loaders	Fabric 0.19.2+ required
Dependencies	Fabric API, ModMenu (no optional mods)
Launchers	Lunar Client, Modrinth App, Feather, vanilla Fabric
Conflicts	None — drives the game's real KeyMappings, so modded actions bind too

---

File Structure

config/
└── quackys-better-keybinds.json     # action id -> list of triggers (keys + ordered flag)

---

Installation

1. Install Fabric Loader ≥ 0.19.2 for MC 1.21.11
2. Add to mods/:
   • Fabric API 0.141.4+1.21.11 or newer
   • ModMenu 17.0.0 or newer
   • quackys-better-keybinds-1.0.0.jar
3. Launch game via Fabric

---

Usage

1. Open Mod Menu → Quacky's Better Keybinds
2. Search and select an action
3. Click Set Keys, press your combo (auto-finalizes after 3s)
4. Toggle Order for press-order sensitivity
5. Save Bind to add it; red X to remove
6. Close screen to persist

---

Known Limitations

• Binds do not fire while a screen or menu is open, so they cannot operate GUIs
• Actions with no registered KeyMapping cannot be bound (nothing to drive)

---

License

MIT. Quack responsibly.

Author

DeQuackDealer

---

Build Info

JAR	35 KB
Gradle	9.4.0
Loom	1.16.2
Java	21