control-flex (Controller Support)
- By
The built-in Controller Guide lists all gameplay bindings by category — movement, combat, inventory, Shift layers, radial menus, and more. Each row shows the actual controller glyphs for your layout, so you can look up any action without leaving the game.
Open a radial menu with Hold (release to close) or Press (tap to open). Each of the 8 slots can be a key binding, a chat command, or use item. Icons can be auto, item-based, or custom. Up to 5 menus can be bound to different buttons and layers.
Open Options → Controls in Minecraft. Next to Key Binds..., the gamepad button opens the ControlFlex settings screen.
The ControlFlex settings screen for in-game bindings. The sidebar lists Main Layer and Shift 1–4 pages.
ControlFlex supports up to 5 radial menus, each tied to a different layer (Main, Shift 1–4) and open button. Menus open in Hold or Press mode.
ControlFlex lets you assign a vibration pattern to each damage type — fall, fire, drowning, mob/player attack, explosion, other damage, and entity kill.
Description
Control Flex is a client-side controller mod for Minecraft Java Edition, built for players who want full gamepad support — especially in modded packs where vanilla-style bindings are not enough.
What it does
Control Flex maps your controller to Minecraft and mod actions through a flexible binding system:
- Five trigger modes — Press, Release, Hold, Tap, Long Press
- Six layers — Main, Shift 1–4, and GUI (separate bindings while menus are open)
- Combo keys — bind multiple buttons to one action
- Radial menus — up to 5 menus × 8 slots (keys, commands, hotbar items)
- Camera & cursor — right-stick look, virtual mouse, optional slot snap
- Rumble — configurable vibration feedback by damage type
- Mod compatibility — auto-discovers mod KeyMappings; JSON configs for layer rules
Bundled templates (Basic, Bedrock, Recommend) help you get started quickly. Custom templates can be added as JSON files.
1. Five Trigger Modes — One Button, Many Behaviors
Every binding pairs which button with how it fires. ControlFlex supports five trigger modes, so the same face button can tap, hold, or release differently per action.
| Mode | When it fires | Typical use |
|---|---|---|
| Press | On button down | One-shot actions, toggles, opening menus |
| Release | On button up | Layer return, “on let go” actions |
| Hold | While held | Movement modifiers, sustained use, Shift layer switches |
| Tap | Short press under threshold | Quick actions without accidental holds |
| Long Press | Held past threshold | Secondary functions on the same button |
Tap and Long Press thresholds are configurable globally (100–2000 ms) in Other Settings. Layer switches on Main are designed around Hold; return-to-Main rows on Shift layers use Release. Radial menu open bindings support Press and Hold (tap to open vs. hold to keep open).
Mix modes across layers: Hold LB for Shift 1, Tap X to ping, Long Press Y for a mount/dismount mod key — all on the same controller layout.
2. Six Layers — Multiply Your Buttons Without Multiplying Hardware
A standard controller has roughly a dozen face and shoulder inputs; a modpack can expose hundreds of actions. ControlFlex solves that with a six-layer binding model, so one physical button can mean different things depending on context.
Main Layer is your default gameplay map — movement, combat, inventory, hotbar, and mod actions you use every day.
Shift Layers 1–4 are modifier planes. Hold a layer-switch binding on Main (for example LB, RB, or Back) to temporarily activate Shift 1–4, each with its own full binding table. Unassigned slots on a Shift layer inherit the matching Main binding, so you only override what you need. Releasing the switch returns you to Main automatically.
GUI Layer activates whenever a screen is open — chests, crafting, mod UIs, and ControlFlex Settings. Confirm, back, tab switch, scroll, and container helpers (quick-move, take half, etc.) live here, separate from in-world controls, so opening a menu does not fight your gameplay bindings.
Together, six layers turn a limited pad into a deep control surface: walk around on Main, hold LB for combat extras, hold RB for utility binds, and get a clean GUI map the moment you open inventory — without re-plugging or swapping profiles.
3. Combo Keys — Chords for Power Users
When one button is not enough, bind multiple buttons together as a single action — for example LB + Back or LT + A.
Binding combos
During capture, press the first button, then add more within 500 ms. The UI shows the full chord; all buttons must match for the action to fire.
Works with every trigger mode
Combos support Press, Release, Hold, Tap, and Long Press — same rules as single-key binds.
Smart combo engine
- Upgrade rule: activating a larger combo (e.g. A+B+Y) clears smaller active subsets (A+B) so behavior stays predictable.
- Button sharing: one physical button can participate in several combos via reference counting.
- Shift + combo: hold a Shift modifier first, then press a chord on that layer — useful for radial menus and advanced layouts without eating Main-layer slots.
Combo keys are how you fit “modpack density” onto a gamepad: rare actions stay off the main face buttons until you deliberately chord them.
4. Radial Menus — Eight Slots, Five Wheels, Zero Menu Digging
Radial menus give you up to five independent wheels, each with up to eight slots around the stick — open a wheel, aim with the stick, confirm with A (defaults vary by template).
What a slot can do
- Key binding — fire a vanilla or mod KeyMapping
- Chat command — run
/…(macros, home, warp, etc.) - Use item — switch to and use a hotbar slot (e.g. torches, food, tools)
How you open them
Each menu has its own open binding. Press = tap to open (release does not close). Hold = keep the open button held; release closes. Menus 2–5 can sit on Shift layers so Main stays uncluttered.
Customization
- Selection stick: left, right, or both
- Icons: auto, random, default, item ID, or custom texture path
- Layouts persist in
config/controlflex/radial_menu/radial_menus.json - In-game editor: pick icons, reorder slots, set trigger mode per menu
Radial menus are the fast lane for items and commands you use often but do not want on permanent face buttons — eat, place torches, run /home, trigger JEI or Minemenü-style shortcuts, all without opening full inventory or chat every time.
5. Camera & Cursor
- Right-stick look with configurable sensitivity and optional Y-axis invert
- Simulate Mouse mode routes look through the mouse pipeline (useful for combat mods such as Epic Fight)
- Virtual cursor drives GUI with the left stick when a screen is open
- Optional slot snap for precise container targeting
6. Rumble
Configurable vibration feedback by damage type — multiple waveform modes, per-type settings, and intensity bands for light / medium / heavy hits.
7. Mod Compatibility
Auto-discovers mod KeyMappings at startup and exposes them as bindable actions. JSON configs support per-mod layer rules and special flags (e.g. GLFW-compat polling, phase-persistent keys while GUI is open).
8. Templates & Profiles
Bundled layouts: Basic, Bedrock, and Recommend. Switch templates from in-game settings; drop custom JSON files into config/controlflex/templates/ to add your own. Per-template user data is stored under config/controlflex/profiles/.
SDL3 is included for Windows and macOS — no separate install required.
Supported loaders by Minecraft version:
- 1.20.1 — Forge, Fabric
- 1.21.1 — NeoForge, Fabric
- 1.21.11 — NeoForge, Fabric
- 26.1.2 — NeoForge, Fabric
- 26.2 — NeoForge, Fabric
Report issues: https://github.com/ControlFlexMC/control-flex/issues
The control-flex (Controller Support) Team
