
BasicallySoftKeys
a mod that allows minecraft to properly use software controlled virtual keys
Screenshots

About this Mod
this mod injects into minecraft input utils, and allows it to properly use virtual keys, sent by programs like LuaMacros
this allows you to use keys from f13 to f25 as additional binds for a USB numpad, or any other extra keyboard you might have
it should work fine with any mods that use minecrafts keybinding
this mod will not work for anything that directly uses hardware keybdinds
heres an example lua macros script that maps numpad buttons to f13-f22
lmc_device_set_name('MACROPAD', '<your device ID>')
lmc_set_handler('MACROPAD', function(button, direction)
local vk = nil
if (button == 45) then vk = 124 -- F13
elseif (button == 35) then vk = 125 -- F14
elseif (button == 40) then vk = 126 -- F15
elseif (button == 34) then vk = 127 -- F16
elseif (button == 37) then vk = 128 -- F17
elseif (button == 39) then vk = 129 -- F18
elseif (button == 36) then vk = 130 -- F19
elseif (button == 38) then vk = 131 -- F20
elseif (button == 33) then vk = 132 -- F21
elseif (button == 107) then vk = 133 -- F22
end
if vk then
if direction == 0 then
lmc_send_input(vk, 0, 2) -- key up
else
lmc_send_input(vk, 0, 0) -- key down
end
end
end)
Available Versions
How to Install BasicallySoftKeys on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.11).
Install Mod
Open the mod browser in the dashboard and search for "BasicallySoftKeys". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.11, 1.21.10, 1.21.9 (+9 more)
Server-side
✗ UnsupportedRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
BasicallySoftKeys server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.11). You can switch loaders with one click in the panel.
Is BasicallySoftKeys compatible with fabric and quilt?
BasicallySoftKeys officially supports fabric, quilt for Minecraft 1.21.11, 1.21.10, 1.21.9. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with BasicallySoftKeys – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if BasicallySoftKeys consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install BasicallySoftKeys with just one click on your server.