console.CommandOptions
Table used by console.Command class constructor.
Fields
| Name | Type | Description |
|---|---|---|
name | string | The name of the console command/variable. |
description | string? | The help text of the console command/variable. |
flags | integer? | The console command/variable flags. Used in engine internally. C++ Code Valve Wiki Facepunch Wiki |
unregistered | boolean? | If this is set, don't add to linked list, etc. |
development_only | boolean? | Hidden in released products.
Flag is removed automatically if ALLOW_DEVELOPMENT_CVARS is defined in C++. |
game_dll | boolean? | Defined by the game DLL. |
client_dll | boolean? | Defined by the client DLL. |
protected | boolean? | It's a server cvar, but we don't send the data since it's a password, etc.
Sends 1 if it's not blank/zero, 0 otherwise as value.
Garry's Mod never calls cvars.OnConVarChanged for protected variables, so
console.Variable keeps the first value it read and never emits "change". |
sponly | boolean? | This cvar cannot be changed by clients connected to a multiplayer server. |
archive | boolean? | Save the cvar value into either client.vdf or server.vdf. |
notify | boolean? | For server-side cvars, notifies all players with blue chat text when the value gets changed, also makes the convar appear in A2S_RULES. |
userinfo | boolean? | For client-side commands, sends the value to the server. |
cheat | boolean? | In multiplayer, prevents this command/variable from being used unless the server has sv_cheats turned on.
If a client connects to a server where cheats are disabled (which is the default), all client side console variables labeled as cheat are reverted to their default values and can't be changed as long as the client stays connected.
Console commands marked as cheat can't be executed either.
As a general rule of thumb, any client-side command that isn't specifically meant to be configured by users should be marked with this flag, as even the most harmless looking commands can sometimes be misused to cheat.
For server-side only commands you can be more lenient, since these would have no effect when changed by connected clients anyway. |
printable_only | boolean? | This cvar's string cannot contain unprintable characters ( e.g., used for player name etc ). |
unlogged | boolean? | If this is a server-side, don't log changes to the log file / console if we are creating a log. |
never_as_string | boolean? | Tells the engine to never print this console variable as a string. This is used for variables which may contain control characters. |
replicated | boolean? | When set on a console variable, all connected clients will be forced to match the server-side value. This should be used for shared code where it's important that both sides run the exact same path using the same data. (e.g. predicted movement/weapons, game rules) |
demo | boolean? | When starting to record a demo file, explicitly adds the value of this console variable to the recording to ensure a correct playback. |
dont_record | boolean? | Opposite of demo, ensures the cvar is not recorded in demos. |
reload_materials | boolean? | If set and this variable changes, it forces a material reload. |
reload_textures | boolean? | If set and this variable changes, it forces a texture reload. |
not_connected | boolean? | Prevents this variable from being changed while the client is currently in a server, due to the possibility of exploitation of the command (e.g. fps_max). |
material_system_thread | boolean? | Indicates this cvar is read from the material system thread. |
archive_xbox | boolean? | Like archive, but for Xbox 360.
Needless to say, this is not particularly useful to most modders.
Save the cvar value into config.vdf on XBox. |
accessible_from_threads | boolean? | Used as a debugging tool necessary to check material system thread convars. |
server_can_execute | boolean? | The server is allowed to execute this command on clients via ClientCommand/NET_StringCmd/CBaseClientState::ProcessStringCmd. |
server_cannot_query | boolean? | If this is set, then the server is not allowed to query this cvar's value (via IServerPluginHelpers::StartQueryCvarValue). |
clientcmd_can_execute | boolean? | IVEngineClient::ClientCmd is allowed to execute this command. |
material_thread_mask | boolean? | Summary of reload_materials, reload_textures and material_system_thread. |
lua_client | boolean? | Set automatically on all cvars and console commands created by the client Lua state. |
lua_server | boolean? | Set automatically on all cvars and console commands created by the server Lua state. |