GoldMapper

Input remapper for Minecraft Legacy Console Edition

GoldMapper injects into the game process to remap keyboard, mouse, and gamepad inputs in real time. Designed for use with the Emerald Launcher.

How the hell does it work?

GoldMapper consists of two binaries:

Binary	Role
GoldMapperLauncher.exe	Creates the target process suspended, injects the DLL, then resumes the game
GoldMapperLib.dll	Hooks into the game's input system (WndProc + XInput + SDL3/SDL2) and applies remappings

---

Usage

GoldMapperLauncher.exe <config.json> <game.exe> [game args...]

Example:

GoldMapperLauncher.exe my_mappings.json Minecraft.Client.exe -name GentooUserBtw

---

Configuration

Use the Emerald Launcher input configurator, or create a JSON file with your desired remappings:

{
  "mappings": [
    { "from": "KEY_Z", "to": "KEY_W" },
    { "from": "PAD_A", "to": "KEY_F11" },
    { "from": "KEY_LEFT_CTRL", "to": "PAD_RB" },
    { "from": "DINPUT_0", "to": "PAD_A" }
  ]
}

Supported Input Names

Keyboard (KEY_ prefix):

KEY_A through KEY_Z, KEY_0 through KEY_9, KEY_F1 through KEY_F12, KEY_SPACE, KEY_RETURN, KEY_ESCAPE, KEY_TAB, KEY_BACKSPACE, KEY_DELETE, KEY_INSERT, KEY_HOME, KEY_END, KEY_PAGEUP, KEY_PAGEDOWN, KEY_UP, KEY_DOWN, KEY_LEFT, KEY_RIGHT, KEY_PRINTSCREEN, KEY_PAUSE, KEY_CAPSLOCK, KEY_NUMLOCK, KEY_SCROLLLOCK, KEY_LEFT_SHIFT, KEY_RIGHT_SHIFT, KEY_LEFT_CTRL, KEY_RIGHT_CTRL, KEY_LEFT_ALT, KEY_RIGHT_ALT, KEY_LWIN, KEY_RWIN, KEY_APPS, KEY_NUMPAD0 through KEY_NUMPAD9, KEY_MULTIPLY, KEY_ADD, KEY_SUBTRACT, KEY_DECIMAL, KEY_DIVIDE, KEY_SEMICOLON, KEY_EQUALS, KEY_COMMA, KEY_MINUS, KEY_PERIOD, KEY_SLASH, KEY_GRAVE, KEY_LBRACKET, KEY_BACKSLASH, KEY_RBRACKET, KEY_APOSTROPHE

Gamepad (PAD_ prefix, XInput):

PAD_A, PAD_B, PAD_X, PAD_Y, PAD_LB, PAD_RB, PAD_BACK, PAD_START, PAD_LTHUMB, PAD_RTHUMB, PAD_DPAD_UP, PAD_DPAD_DOWN, PAD_DPAD_LEFT, PAD_DPAD_RIGHT

For the to side, prefix with a pad number to target a specific controller: PAD1_A, PAD2_RB, etc. Without a number (PAD_A), the mapping applies to all controllers.

Mouse (MOUSE_ prefix):

MOUSE_LEFT, MOUSE_RIGHT, MOUSE_MIDDLE

DirectInput (DINPUT_ prefix, from only):

DINPUT_0 through DINPUT_127, maps to button/axis indices from the physical gamepad. Uses SDL's GameController/Gamepad API under the hood to read any connected controller (Xbox, PlayStation, Switch Pro, etc.). SDL handles type detection, button mapping, calibration, and deadzones automatically. Only works as an input source (the from side).

SDL3.dll is loaded at runtime from GoldMapperLib.dll's own directory (which is /resources/ on Emerald), so it does not need to be placed in the game folder. If SDL3.dll is not present, it falls back to SDL2.dll.

SDL Input Hooking

If the game version reads its input through SDL (SDL3 or SDL2) instead of raw Win32 messages + XInput, GoldMapper detects the game's SDL module after injection and hooks its input surface directly:

• SDL_PollEvent / SDL_WaitEvent: gamepad button events are tracked so injected state stays consistent with what the game has already seen
• SDL_GetGamepadButton / SDL_GameControllerGetButton: returns the fully remapped virtual button state (pad-to-pad remaps, cross-device key/mouse/DirectInput to pad mappings)
• SDL_GetGamepadAxis / SDL_GameControllerGetAxis: returns the remapped stick/trigger state, including DirectInput axis overrides

If the game's SDL reads XInput directly (the default backend on Windows), GoldMapper detects this automatically and keeps the remapping on the XInput hook layer instead, so nothing is applied twice. Otherwise, the XInput state is translated into SDL gamepad events and injected into the game's SDL event stream, so pad mappings work even when the game never touches XInput.

Cross-Device Mapping

You can map between any input devices:

From	To	Behavior
KEY_*	KEY_*	Remaps keyboard keys
PAD_*	PAD_*	Remaps gamepad buttons
MOUSE_*	MOUSE_*	Remaps mouse buttons
DINPUT_*	KEY_*	DirectInput button triggers a keyboard key
DINPUT_*	PAD_*	DirectInput button triggers a gamepad button (XInput)
DINPUT_*	MOUSE_*	DirectInput button triggers a mouse button
PAD_*	KEY_*	Gamepad button triggers a keyboard key
KEY_*	PAD_*	Keyboard key triggers a gamepad button
MOUSE_*	PAD_*	Mouse button triggers a gamepad button

Gamepad output always uses XInput.

License

GoldMapper is licensed under the LGPL-2.1 license.