Configstring

From WolfWiki


Configstrings can be accessed with et.trap_GetConfigstring and et.trap_SetConfigstring and the String utility functions.

Contents

What are Configstrings

  • Configstrings are strings that are set on the server, and automatically sent to each client.
  • Configstrings are often, but not always, in the from of an infostring (a backslash delimited set of key\value pairs)
  • Each configstring is identified by a number, which is usually given refered to by a name #defined in the ET gamecode.
  • A group of related configstrings (such as CS_PLAYERS) usually only have a symbolic name for the first value, with a number (entity number in the case of CS_PLAYERS) added to to get a particular value.
  • Most configstrings have a specific meaning to the gamecode. You can use the etmain SDK find out what they do, but beware that etpro does not do things exactly the same as etmain.
  • A list of configstring numbers and names can be found in etconst.lua

User Configstring

A user Configstring gets written in the log file with a line starting with UserInfoChanged which mustn't be mistaken for one with Userinfo.

To access a user's Configstring you can't just use et.trap_GetConfigstring(slotNumber) but must use et.trap_GetConfigstring(et.CS_PLAYERS + slotNumber).

keynamedescription
nNick 
tTeam1=Axis, 2=Allies, 3=Spectators
cClass0=Soldier, 1=Medic, 2=Engineer, 3=FieldOps, 4=CovertOps
rRank 
mMedals 
sSkills 
dnDisguised name 
drDisguised rank 
wWeapon 
lwLatched weaponWeapon on next spawn
swLatched secondary weaponSecondary weapon on next spawn
refRefereeReferee status (0=not ref, 1=ref)
pPrivilege level0=Peon, referee (vote), referee (password), semiadmin, rconauth - etpro only
ssStat Saver Stats restored by stat saver
scShoutcasteretpro only
tvETTV slaveetpro only


LUA Example

et.CS_PLAYERS = 689

-- get the name of client #3 using configstrings
local cs = et.trap_GetConfigstring(et.CS_PLAYERS + 3)
local name = et.Info_ValueForKey(cs, "n")

Notes

et.CS_PLAYERS = 689 for those of you that don't use etconst.lua.


Source: http://bani.anime.net/banimod/forums/viewtopic.php?t=5412