Configuration & Input - Redesigned

First and foremost, a warning: this feature description is based on initial game research, and may not be implementable the way described here, or even worthwhile at all.


The current game configuration system is somewhat of a mess. There’s a global per-system settings.xml (which does not change names based on the computer name, this is fun when you’ve set OneDrive to synchronize your Documents folder), there’s also an encrypted set of cfg.dat and pc_settings.bin (renamed to fivem_set.bin in the past) as well as control override XML files if setting any controls.

On top of that, this system is not extensible for our purposes, can’t be controlled by script resources (and if it could, it’d be allowing archived settings to be overwritten), and we have a perfectly fine Quake-style console system that could be used for expanding upon this.


A good first step would be replacing the entire configuration persistence system (settings.xml and ‘profile settings’ such as the non-graphical options in the game settings menu) with a few convars bound to the raw setting structures. These would then be saved to a Quake-style config.cfg file automatically by means of implementing the Archive flag.

For those unfamiliar with Quake, imagine a configuration file like this:

// just a snippet, not a full example
seta video_screenWidth 1920
seta video_screenHeight 1080
seta graphics_tessellation 2
seta profile_displayGps false

These would effectively be toggleable using the console on the client, the classical game settings menu, as well as a new settings menu implemented in NUI, probably.


It’s the current plan to replace the game keyboard/mouse-button input system with a custom system also inspired by Quake binds. This is the part that has been researched the least, as the input system in GTA is a monstrous overcomplicated… thing.

For the time being, controllers are out of scope and would still be handled by the original GTA input code.

Basic functionality

Similar to Quake, ideally, a few commands would exist bound to specific game controls, such as +nextCamera, +interactionMenu, +reload, +vehMoveLeftOnly, with accompanying - versions as well.

These would then be bound using a bind command, which would also persist to configuration:

bind "r" "+reload"
bind "v" "+nextCamera"

# this is a good one to wonder about, should this be multiple bind commands?
# should ; splitting be implemented for +/- detection?
# should we implement +vstr?
bind "a" "+vehMoveLeftOnly; +moveLeftOnly"

A frontend for these bindings will also exist, preferably keeping the existing game binding menu in place.


Of course, bindings in Quake don’t necessarily have to be directly related to a specific input. See these examples of things that would be possible for users to easily do:

Automating a menu

seta openMenu "+interactionMenu; wait 5; -interactionMenu"
seta menuDown "+cellphoneDown; wait 5; -cellphoneDown"
seta menuEnter "+cellphoneSelect; wait 5; -cellphoneSelect"
bind "f5" "vstr openMenu; vstr menuDown; vstr menuDown; vstr menuEnter; vstr menuDown; vstr menuEnter"

Executing specific commands

bind w "+moveUpOnly; say I'm walking forward, watch out!"
bind numMultiply "ooc pls help me i dont like rp"

Toggle toggle there’s a toggle

# holding f3 would disable the HUD option in game settings temporarily
seta hudOn "profile_hudMode 1"
seta hudOff "profile_hudMode 0"
bind f3 "+vstr hudOff hudOn"
# or pressing, with a `toggle` command
bind f6 "toggle profile_hudMode 1 0"

Resource support

Now, we get into the hard part: resources should be able to specify a few defaults, which would either be saved in a per-server configuration (gbind for global configuration?) or a resource-specific configuration (rbind for resource-specific binds?) where if the user is on a server with that specific resource these persistent defaults will be loaded and potentially (temporarily!) override the user’s global game defaults.

However, there’s no easy way to tag a specific bind value as being specific to a resource - one option would be to always disallow bind for server scripts, and make sbind/rbind exist to create server/resource-specific overrides, both from user settings (rbind chat t "+mpTextChatAll") and resource script defaults (SetResourceBind('t', '+mpTextChatAll') from chat, for example).

This also leaves the question of “what to do with the binding UI in game settings” somewhat unanswered.

Suggestions in this regard would be welcomed! It appears MTA:SA also redoes the game input system to support binds, maybe someone can chip in about how it works there?



These posts are actually very interesting and worthwhile to read :open_book:


Just amazing how things are moving forward these DAYS!


Very interesting :smile:




Holy hell, just what I want.


Hi all,

How can i “get” the registred key by user ? For display.

Ok, my bad, just by using it : GetRegisteredCommands

1 Like

Is there a way to get the key value of a RegisterKeyMapping ?

1 Like

Yes, create a binding. Doesn’t matter if it works yes or no, then bind the key you want to it. ( In-game ) After that check inside your %appdata%\citizenfx folder. In there there will be a file called fivem.cfg and ontop you can see the binding you set for it and the key value.

To see your binds you can just type bind in the console and then it will print all the registered binds, also you can go to settings -> key binds -> FiveM. but I think he meant to get the key value from the developer side and not the player, which you can use after to show help tips with the keys the player changed it to. So the official answer is not yet, as written in the cookbook

These bindings will be editable by the user in the ‘key bindings’ option (only 1 binding per command yet, no secondary binding), and depending on user demand we’ll add a helper for computing the right hashes to use with ~INPUT_~-style display as well for help hints and similar.

but maybe there is a way to get it and they didn’t officially release it yet

1 Like

if you correctly hash the command and append that hash it should work at least for text display in help pop-ups and hopefully for the get control native too

Hello, how do you get the text. I did not understand the hash.

2 posts were split to a new topic: Key mappings: any cleanup option?