Key Rebinding - fe-art/Toolscreen GitHub Wiki

Enabling Key Rebinding

  1. Go to Advanced > Inputs > Keyboard.
  2. Enable Key Rebinding.
  3. Click Open Keyboard Layout to see a visual layout of your keys.

Right-click on any key to configure it.

Keyboard layout with right-click menu

Full Rebind

A full rebind changes a key to behave entirely as another key, for both game actions and typing.

  1. Right-click a key on the keyboard layout.
  2. Select Full Rebind.
  3. Click the key field and press the key you want it to become on your keyboard.

Example: If you full-rebind G to P, then pressing G outputs P everywhere. This means F3+G (normally chunk borders) would trigger F3+P (pause on lost focus) instead.

If you need F3+G to still toggle chunk borders while typing P in chat, use a Split Rebind instead.

Split Rebind

A split rebind lets you set different outputs for game actions and typing.

  • Triggers - What the key does for game actions (hotbar slots, F3 combos, backspace, etc.).
  • Types - What character the key types in chat or the recipe book.
  1. Right-click a key and select Split Rebind.
  2. Set the Triggers output (the game action key).
  3. Set the Types output (the chat character).

Example: Split-rebind G so it triggers G for game binds but types P in chat. Now F3+G still toggles chunk borders, but typing in chat produces P.

Important: The Triggers output affects any key that has a game action: hotbar slots, F3 combos, Backspace, Home (for search/crafting), etc. You can't put one of these on Types only. Types only affects what character appears in chat or the recipe book.

Shift Layer Rebinding

You can make a key output a different character when Shift is held:

  1. Right-click a key and select Split Rebind.
  2. Set the normal Types character.
  3. Set the Types Shift character (what it types when holding Shift).

Example: Set G to type U normally and E when holding Shift, while triggering H for game binds.

Custom Unicode Characters

To output a custom Unicode character when pressing a key:

  1. Right-click a key on the layout.
  2. Click Custom.
  3. Paste in the Unicode character.
  4. Some characters may show as a question mark in the config, but they will work correctly in-game.
  5. Click Apply.

Go to the game chat and press the key to verify the Unicode character appears.

Unicode character input

Toggling Rebinds with a Hotkey

If you want to temporarily disable rebinds (e.g., to type normally in chat):

  1. Go to Advanced > Inputs > Keyboard.
  2. Set a hotkey for Toggle Rebinds (e.g., L).

Press the hotkey to toggle rebinds on and off. You can see the current rebind status in the indicator.

To unbind a toggle hotkey, click on it and press Clear.

Rebinding System Keys (Alt, Alt-Tab, Alt-F4)

If you rebind Alt to another key (e.g., H), pressing Alt+Tab to switch windows won't work because the system sees H+Tab.

To fix this:

  1. Go to Advanced > Inputs > Keyboard.
  2. Enable Allow System Alt-Tab. There is also a separate toggle for Allow Alt-F4.

With this enabled, Alt+Tab will still switch windows as expected, even though Alt is rebound.

Note: If Alt is rebound and you have it set as a mode hotkey (e.g., Wide), make sure to change the Wide hotkey to a different key. Otherwise pressing Alt will trigger the mode switch instead of typing the rebound character.

Resolve Rebind Targets for Hotkeys

This setting (under Advanced > Inputs > Keyboard) controls whether Toolscreen hotkeys use the rebound key or the original key.

Example: If Alt is rebound to H and you set a hotkey to H:

  • Enabled: Pressing Alt triggers the hotkey (because Alt becomes H, and H is the hotkey).
  • Disabled: Pressing Alt does not trigger the hotkey. Only pressing the actual H key does.

Disable this if you don't want rebound keys to accidentally trigger hotkeys.