2025-01-07 22:58:31 +03:00

1.6 KiB

input library

input.keycode(keyname: str) --> int

Returns key code or -1 if unknown

input.mousecode(mousename: str) --> int

Returns mouse button code or -1 if unknown

input.add_callback(bindname: str, callback: function)

Add binding activation callback. Example:

input.add_callback("hud.inventory", function ()
	print("Inventory open key pressed")
end)

Callback may be added to a key.

input.add_callback("key:space", function ()
    print("Space pressed")
end)

You can also bind the function lifetime to the UI container instead of the HUD. In that case, input.add_callback may be used until the on_hud_open is called.

input.add_callback("key:escape", function ()
    print("NO")
    return true -- prevents previously assigned functions from being called
end, document.root)
input.get_mouse_pos() --> {int, int}

Returns cursor screen position.

input.get_bindings() --> strings array

Returns all binding names.

input.get_binding_text(bindname: str) --> str

Returns text representation of button by binding name.

input.is_active(bindname: str) --> bool

Checks if the binding is active.

input.set_enabled(bindname: str, flag: bool)

Enables/disables binding until leaving the world.

input.is_pressed(code: str) --> bool

Checks input activity using a code consisting of:

  • input type: key or mouse
  • input code: [key name](#key names) or mouse button name (left, middle, right)

Example:

if input.is_pressed("key:enter") then
    ...
end