{{newin|[[0.9.2]]|092|type=function}}
Loads a gamepad mappings string or file created with [[love.joystick.saveGamepadMappings]].

It also recognizes any SDL gamecontroller mapping string, such as those created with Steam's Big Picture controller configure interface, or this [https://raw.githubusercontent.com/gabomdq/SDL_GameControllerDB/master/gamecontrollerdb.txt nice database]. If a new mapping is loaded for an already known controller GUID, the later version will overwrite the one currently loaded.
== Function ==
Loads a gamepad mappings string from a file.
=== Synopsis ===
<source lang="lua">
love.joystick.loadGamepadMappings( filename )
</source>
=== Arguments ===
{{param|string|filename|The filename to load the mappings string from.}}
=== Returns ===
Nothing.

== Function ==
Loads a gamepad mappings string directly.
=== Synopsis ===
<source lang="lua">
love.joystick.loadGamepadMappings( mappings )
</source>
=== Arguments ===
{{param|string|mappings|The mappings string to load.}}
=== Returns ===
Nothing.

== See Also ==
* [[parent::love.joystick]]
* [[love.joystick.saveGamepadMappings]]
* [[love.joystick.setGamepadMapping]]
* [[Joystick:getGamepadMapping]]
* [[Joystick:isGamepad]]
[[Category:Functions]]
{{#set:Description=Loads a gamepad mappings string or file created with [[love.joystick.saveGamepadMappings]].}}
== Other Languages ==
{{i18n|love.joystick.loadGamepadMappings}}