Skip to content

Fix/linux nonlatin keyboard layout #17514

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
TheCyberAngel wants to merge 3 commits into
base: master
Choose a base branch
from
+132 −4
Open

Fix/linux nonlatin keyboard layout #17514

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
4db64e2
Fix Linux keyboard input on non-Latin layouts
TheCyberAngel May 18, 2026
7e7f51b
Ignore local patch files
TheCyberAngel May 18, 2026
326948a
Merge branch 'FakeFishGames:master' into fix/linux-nonlatin-keyboard-…
TheCyberAngel Jul 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .gitignore
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -58,3 +58,4 @@ Deploy/DeployAll/PrivateKey.*

#Rider
*.DotSettings.user
*.patch
13 changes: 12 additions & 1 deletion Libraries/MonoGame.Framework/Src/MonoGame.Framework/Input/Keyboard.SDL.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,18 @@ public static Keys QwertyToCurrentLayout(Keys qwertyKey)
_ => -1
};
if (scancode < 0) { return qwertyKey; }
return KeyboardUtil.ToXna(Sdl.Keyboard.GetKeyFromScancode(scancode));

var key = KeyboardUtil.ToXna(Sdl.Keyboard.GetKeyFromScancode(scancode));

// On non-Latin layouts SDL_GetKeyFromScancode returns a layout-dependent
// keycode that may not map to XNA Keys. Fall back to physical scancode,
// otherwise resetting default bindings can produce Keys.None.
if (key == Keys.None)
{
key = KeyboardUtil.ToXnaFromScancode(scancode);
}

return key;
}
}
}
68 changes: 68 additions & 0 deletions Libraries/MonoGame.Framework/Src/MonoGame.Framework/Input/KeyboardUtil.SDL.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -196,6 +196,74 @@ public static int ApplyModifiers(int chr, Sdl.Keyboard.Keymod mods)
}
return chr;
}

public static Keys ToXnaFromScancode(int scancode)
{
switch (scancode)
{
case 4: return Keys.A;
case 5: return Keys.B;
case 6: return Keys.C;
case 7: return Keys.D;
case 8: return Keys.E;
case 9: return Keys.F;
case 10: return Keys.G;
case 11: return Keys.H;
case 12: return Keys.I;
case 13: return Keys.J;
case 14: return Keys.K;
case 15: return Keys.L;
case 16: return Keys.M;
case 17: return Keys.N;
case 18: return Keys.O;
case 19: return Keys.P;
case 20: return Keys.Q;
case 21: return Keys.R;
case 22: return Keys.S;
case 23: return Keys.T;
case 24: return Keys.U;
case 25: return Keys.V;
case 26: return Keys.W;
case 27: return Keys.X;
case 28: return Keys.Y;
case 29: return Keys.Z;

case 30: return Keys.D1;
case 31: return Keys.D2;
case 32: return Keys.D3;
case 33: return Keys.D4;
case 34: return Keys.D5;
case 35: return Keys.D6;
case 36: return Keys.D7;
case 37: return Keys.D8;
case 38: return Keys.D9;
case 39: return Keys.D0;

case 40: return Keys.Enter;
case 41: return Keys.Escape;
case 42: return Keys.Back;
case 43: return Keys.Tab;
case 44: return Keys.Space;

case 79: return Keys.Right;
case 80: return Keys.Left;
case 81: return Keys.Down;
case 82: return Keys.Up;

case 224: return Keys.LeftControl;
case 225: return Keys.LeftShift;
case 226: return Keys.LeftAlt;
case 227: return Keys.LeftWindows;
case 228: return Keys.RightControl;
case 229: return Keys.RightShift;
case 230: return Keys.RightAlt;
case 231: return Keys.RightWindows;

default:
return Keys.None;
}
}

}
}

54 changes: 51 additions & 3 deletions Libraries/MonoGame.Framework/Src/MonoGame.Framework/SDL/SDLGamePlatform.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -137,9 +137,48 @@ private void SdlRunLoop()
{
var key = KeyboardUtil.ToXna(ev.Key.Keysym.Sym);

if (!_keys.Contains(key)) _keys.Add(key);
// On non-Latin layouts SDL keycode can be a Cyrillic/Unicode symbol
// that MonoGame's key map does not recognize. In that case, fall back
// to the physical scancode so gameplay bindings like WASD still work.
if (key == Keys.None)
{
key = KeyboardUtil.ToXnaFromScancode(ev.Key.Keysym.Scancode);
}

if (key != Keys.None && !_keys.Contains(key))
{
_keys.Add(key);
}

// Keep text input layout-aware. This must not use scancode,
// otherwise chat/text fields would break for non-English input.
char character = (char)KeyboardUtil.ApplyModifiers(ev.Key.Keysym.Sym, ev.Key.Keysym.Mod);

if ((int)((char)ev.Key.Keysym.Sym) != ev.Key.Keysym.Sym)
{
character = '\0';
}

_view.CallKeyDown(character, key);
}else if (ev.Type == Sdl.EventType.KeyDown)
{
var key = KeyboardUtil.ToXna(ev.Key.Keysym.Sym);

// On non-Latin layouts SDL keycode can be a Cyrillic/Unicode symbol
// that MonoGame's key map does not recognize. In that case, fall back
// to the physical scancode so gameplay bindings like WASD still work.
if (key == Keys.None)
{
key = KeyboardUtil.ToXnaFromScancode(ev.Key.Keysym.Scancode);
}

if (key != Keys.None && !_keys.Contains(key))
{
_keys.Add(key);
}

//TODO: rethink all of this
// Keep text input layout-aware. This must not use scancode,
// otherwise chat/text fields would break for non-English input.
char character = (char)KeyboardUtil.ApplyModifiers(ev.Key.Keysym.Sym, ev.Key.Keysym.Mod);

if ((int)((char)ev.Key.Keysym.Sym) != ev.Key.Keysym.Sym)
Expand All @@ -152,7 +191,16 @@ private void SdlRunLoop()
else if (ev.Type == Sdl.EventType.KeyUp)
{
var key = KeyboardUtil.ToXna(ev.Key.Keysym.Sym);
_keys.Remove(key);

if (key == Keys.None)
{
key = KeyboardUtil.ToXnaFromScancode(ev.Key.Keysym.Scancode);
}

if (key != Keys.None)
{
_keys.Remove(key);
}
}
else if (ev.Type == Sdl.EventType.TextEditing)
{
Expand Down