Garry's Mod Wiki

Revision Difference

Global.CreateConVar#562644

<function name="CreateConVar" parent="Global" type="libraryfunc"> <description>Creates a console variable (<page>ConVar</page>), in general these are for things like gamemode/server settings. <warning>Do not use the FCVAR_NEVER_AS_STRING and FCVAR_REPLICATED flags together, as this can cause the console variable to have strange values on the client.</warning> </description> <realm>Shared and Menu</realm> <args> <arg name="name" type="string">Name of the <page>ConVar</page>. This cannot be a name of an engine console command or console variable. It will throw an error if it is. If it is the same name as another lua ConVar, it will return that ConVar object.</arg> <arg name="value" type="string">Default value of the convar. Can also be a number.</arg> <arg name="flags" type="number" alttype="table" default="FCVAR_NONE">Flags of the convar, see <page>Enums/FCVAR</page>, either as bitflag or as table.</arg> <arg name="helptext" type="string" default="">The help text to show in the console.</arg> <arg name="min" type="number" default="nil">If set, the ConVar cannot be changed to a number lower than this value.</arg> <arg name="max" type="number" default="nil">If set, the ConVar cannot be changed to a number higher than this value.</arg> </args> <rets> <ret name="" type="ConVar">The convar created.</ret> </rets> </function> ⤶ <example>⤶ <description>Code that will create a Convar and a chatprint with the content of the convar.</description>⤶ <code>⤶ local convar = CreateConVar("convar_example", "1", {FCVAR_ARCHIVE, FCVAR_NOTIFY, FCVAR_REPLICATED}, "This is a server-side convar.")⤶ concommand.Add("print_convar", function(ply)⤶ if !IsValid(ply) or !ply:IsAdmin() then return end⤶ ply:ChatPrint("Server ConVar value: " .. GetConVar("convar_example"):GetString())⤶ end)⤶ </code>⤶ <output>Server Convar value: 1</output>⤶ ⤶ </example>