Questions

Minecraft Java controller mods vs a mapper on a Mac

Download on the Mac App StoreInputConfig is completely free on the Mac App Store. You don't have to make an account, there are no subscriptions, and nothing is locked. Optimized for Apple silicon.

Choose a mod if you already play a modded instance and want controller prompts in the game. Choose a mapper if you play vanilla, on servers, or on every new release. Minecraft Java Edition has no controller support, on a Mac or anywhere else, so one of the two has to add it: a mod that teaches the game to read a gamepad, or a mapper outside the game that turns the gamepad into the keyboard and mouse Java already reads. I make a mapper, InputConfig, and a mod is still the better choice for some players.

On this page
  1. Know the three controller mods
  2. Compare a mod and a mapper side by side
  3. Choose a mod if
  4. Choose a mapper if
  5. Set up a mod on a Mac
  6. Set up the mapper
  7. Do not use both at once
  8. The short version
  9. Questions

Know the three controller mods

ModLoadersWhat stands out
ControlifyFabric, NeoForgeBuilt on SDL3. Gyro aim, an on-screen keyboard, button guides on screen.
ControllableForge, NeoForge, FabricBuilt on SDL2. Button remapping and a radial menu for extra actions.
MidnightControlsFabric, NeoForge, QuiltController and touchscreen support.

From each mod's Modrinth or CurseForge page, read in September 2026. All three are Java mods, so they run on a Mac wherever the mod loader does, and none of their pages lists a Mac limitation. Check the page for your exact Minecraft version before you install, because a new release leaves a mod behind until its author catches up.

Compare a mod and a mapper side by side

A controller modA mapper (InputConfig)
Needs a mod loaderYesNo
Vanilla MinecraftNoYes
After a Minecraft updateWait for the modWorks the same day
ServersDepends on the server's rules on client modsThe server sees ordinary keyboard and mouse input
Button prompts on screenYesNo, the game still shows keyboard keys
InventoryBuilt for a controllerA mouse pointer on the right stick
Typing in chatControlify has an on-screen keyboardThe Mac keyboard, or the macOS Accessibility Keyboard
Gyro aimControlifyDualSense, DualSense Edge, DualShock 4, Switch Pro Controller and Joy-Con, plus both Steam Controllers and the Switch 2 Pro Controller (experimental)
Other games and appsMinecraft onlyAny app, with a layout that switches on per app

Choose a mod if

  • You already mod. You play a Fabric or NeoForge instance, or a modpack.
  • You want controller prompts. The game itself shows controller buttons and a controller-friendly inventory.
  • You stay on one version. You play on one version for a long time and do not mind waiting after an update.

Choose a mapper if

  • You play vanilla. Or a Realm, or a server that does not allow client mods.
  • You update on day one. You jump to every new release as it lands.
  • Someone else plays too. And you do not want to manage mod loaders for them.
  • You want one controller for everything. The same pad runs other games, the Mac itself, or a layout built around what your hands can do. That last one is why I built InputConfig.

Set up a mod on a Mac

The easy route is a launcher that handles loaders for you, such as the Modrinth App or Prism Launcher: make a Fabric or NeoForge instance for your Minecraft version, add the mod from its search, and launch. Most controller mods need a library mod or two, which the mod's page lists and those launchers fetch for you.

By hand, install the loader, put the mod's .jar in the mods folder, and pick the loader's profile in the Minecraft Launcher.

Finder, Go to Folder: Open Minecraft's mods folder.

~/Library/Application Support/minecraft/mods

What happens: The Finder opens the folder the loader reads mods from.

If the mod does not see your controller, check that the Mac does first, in System Settings, Game Controllers.

Set up the mapper

  1. Pair the controller with the Mac over Bluetooth or USB.
  2. Install InputConfig, free on the Mac App Store, and grant Accessibility when it asks.
  3. Pick the built-in Minecraft preset, or make one with the Smart Preset Maker: search Minecraft, pick your controller.
  4. Press Activate and open Minecraft.
InputConfig's Smart Preset Maker with Minecraft typed in the search field and a controller chosen.
Figure 1. Search Minecraft in the Smart Preset Maker, pick your controller, and the layout is ready.

The Minecraft layout page explains each button and how to tune it.

Do not use both at once

Do not run them at the same time on the same instance: one button press would reach the game twice, once from the mod and once as a key. If you keep a modded instance with Controlify and a vanilla one, leave the InputConfig layout for vanilla and deactivate it before you launch the modded one.

The short version

  • Modded, one version, controller prompts. Use Controlify on Fabric or NeoForge, or Controllable on Forge.
  • Vanilla, servers, every release. Use a mapper.
  • Both instances. Use one at a time, and never both on the same instance.

Pick by how you play, not by which is better on paper.

Questions

What is the best controller mod for Minecraft Java?

Controlify has the longest feature list on Fabric and NeoForge: gyro aim, an on-screen keyboard and on-screen button guides. On Forge, Controllable. If you do not want a mod loader at all, a mapper such as InputConfig.

Does Controlify work on a Mac?

Controlify is built on SDL3, which supports macOS, and its page lists no Mac limitation. If it does not see your controller, check that the Mac sees it in System Settings, Game Controllers, then check the mod's settings.

Can I use a controller in Minecraft Java without mods?

Yes, with a mapper. InputConfig turns the controller into the keyboard and mouse input Java already reads, so it works in vanilla and on any server.

Can a controller mod get me banned?

Controller mods change your input, not the game, but every server sets its own rules on client mods, so read them. A mapper sends ordinary keyboard and mouse input, which a server cannot tell apart from a keyboard.

This page in other languages: Español

Download on the Mac App StoreOpen source on GitHub.

Updated