WolfWiki - User contributions [en]

Server Configuration

2009-08-28T19:57:09Z

Techno:

==Installation==
File installation:
Note that the <tt>etpro</tt> directory should be in the same directory as <tt>etmain</tt>. Do NOT extract the files to etmain
:Linux:
Unzip the server archive to <tt>enemy-territory/etpro/</tt>
:Windows:
Unzip the server archive to <tt>Wolfenstein - Enemy Territory\etpro</tt>
Starting an ETPro server requires <tt>+set fs_game etpro</tt> to be appended to the end of the command line.
:Linux example:
::<tt> ./etded +set fs_game etpro</tt>
:Windows:
::<tt> etded.exe +set fs_game etpro</tt>
:Windows Shortcut:
::Right click on the shortcut for Enemy Territory and select "Properties." In the "Target" Box (Top text box) add <tt>+set fs_game etpro</tt> to the end, after the quotes.
::<tt> "C:\Program Files\Wolfenstein - Enemy Territory\et.exe" +set fs_game etpro</tt> 

''Note'': Starting from version ET 2.60, the Windows executables are et.exe for the game and etded.exe for the server. If you want to run a listen server on Windows start your game with et.exe, otherwise use etded.exe for a dedicated server.

If you want to run 2.56 or earlier servers on Windows, you can only use et.exe and append <tt>+set dedicated 1</tt> (or 2).

==Warnings==
WARNING: Server improperly installed! Incorrect fs_game setting! Please notify administrator.
:Incorrect <tt>+set fs_game</tt> string. Make sure it is set to <tt>+set fs_game etpro</tt>.
fs_game is write protected.
:You must start your server via the command line (Or by changing the shortcut) with the <tt>+set fs_game etpro</tt> command. 
Client .pk3 missing!
:The PK3 file that is contained in the server install file is missing. Download the [http://bani.anime.net/etpro/download.html server install] again and place the PK3 file in the server's ETPro directory. 
Incorrect client .pk3 installed on server!
:The PK3 file mentioned above does not match the version of the server. Download the PK3 (And possibly updated server) from the [http://bani.anime.net/etpro/download.html download page].
Multiple client .pk3 versions installed on server!
:This means that the server has more than one ETPro client PK3. Remove the older versions from the server's ETPro directory.
:This can also happen from having fs_game set twice in your shortcut or config. 
Incorrect ET version!
:This happens when you are attempting to install ETPro on a non-patched ET server. Download the [http://games.activision.com/games/wolfenstein patch] and try again. 
Cvar dedicated is 0! Some features will break!
:ETPro is meant to be installed on a dedicated server. Set the server to dedicated by using <tt>+set dedicated 2</tt> in the command-line used to start the server. 
etpro_cheats.dat is corrupt or missing!
:The ETPro database file for positively identifying cheats has either been corrupted or does not exist on the server. Download a recent version of [http://etpro.anime.net/etpro_cheats.dat the database].
 
==Other Errors==
Server sends users the ETPro PK3 file over and over. 
:If you are using download redirects, make sure that the download path is set correctly if changed between versions. eg: If the old PK3 was in <tt>server/etpro2</tt> and the new version is in <tt>server/etpro3</tt> and the redirect path in the server configuration was not changed, it would send the old ETPro 2.x files; which not being what the server is using, it would cause the download to start again. 
:If you are redirecting to an http or ftp server, make sure the pk3 on the http/ftp server exactly matches the pk3 on the game server.
:Some http servers may incorrectly try to send pk3 files as text/plain, which will corrupt downloads. Make sure they are sent as application/octet-stream:
*WARNING*: PunkBuster Reports PB Server Running Old Version Cx.xxx 
Windows:
:Run <tt>\Wolfenstein - Enemy territory\pb\pbweb.exe</tt> 
Linux:
:Run <tt>/path_to_et_server/pb/pbweb.x86</tt> (first chmod +x pbweb.x86) 

==Tips for server admins==
In general, the ettv/etded process should be restarted every 20 days or less. If the server is running on windows, the OS should be restarted at the same time.

Q: Why do my logs and console keep getting flooded with stuff like this:
saneClientCommand: 5 obj -1

A: See [[ETPro:Server_cvar_list|b_showClientCmds]] in the server cvar list.

Q: rcon stopped working

A: Your server has been up for more than 49 days, you need to restart it.

Q: All clients trying to connect to my ettv server get stuck awaiting gamestate, even though the network is fine.

A: restart it.

==Campaign configuration==
Campaigns are created by editing a file with the extension ".campaign".

This is the structure of a .campaign file :

<pre>
{
name ""
shortname ""
description ""
maps ""
mapTC 374 374
type "wolfmp"
}
</pre>

<table border="1">
<tr><th>Key</th><th>Value</th></tr>
<tr><td>name</td><td>This is displayed at the start of a match when awaiting players to readyup, on the score screen, and also in the top-right of the map loading screen. It can be a maximum of 31 characters long, though to stay within the graphic background of the loading screen, and to preserve the "xofx" text, 13 characters is the maximum. Color codes can be used.</td></tr>
<tr><td>shortname</td><td>The name used to call the campaign using the "campaign" and "nextcampaign" commands.</td></tr>
<tr><td>description</td><td>The information displayed on the map loading screen. The available character resolution is 23x26. "\n" is used for a new-line and colour codes can be used.</td></tr>
<tr><td>maps</td><td>A semi-colon (";") separated list of maps (up to 10). The map name is the filename found in the \maps folder of the PK3 file, minus the .bsp extension.</td></tr>
<tr><td>mapTC</td><td>Texture Coordinates -- the x, y location on the map image for the upper left when drawing the small version of the map (e.g. in the server creation menu, or during intermission.)</td></tr>
<tr><td>type</td><td>Leave this as the default ("wolfmp")</td></tr>
</table>

Example :
<pre>
{
name "^0My ^1Campaign"
shortname "myCamp"
description "^1This is an example campaign.\n^0Map 1 : Goldrush\nMap 2 : Adlernest\nMap 3 : Oasis"
maps "goldrush;adlernest;oasis"
mapTC 374 374
type "wolfmp"
}
</pre>

The compeleted .campaign file is then usually placed in the "scripts/" directory of either servers' etpro/ directory directly, or in a PK3 file on the server. The difference between the two methods is that if the .campaign file is placed directly on the server, the client wont have the campaign information, and therefore the campaign name, description and number of maps information sections will be empty.

The .campaign file is then referenced using the CVAR b_campaignfile, for example :
<pre>
b_campaignfile "scripts/myCampaign.campaign"
</pre>

Once the campaign file is loaded, the campaign shortname's contained within can be called, using the "campaign" and "nextcampaign" commands, eg :
<pre>
campaign myCamp
nextcampaign myNewCamp
</pre>

==Configuration:==
[[:Category:ETPro:Server_Cvars|ETPro Server CVAR Explanations]]

[[ETPro:Pluggable Config Files]]

[http://bani.anime.net/banimod/forums/viewforum.php?f=13 Server Admin Forums]

[http://rtcw.jolt.co.uk/content/enemy_territory/server_guide/index.html DG's Advanced Server Guide]

[http://et.d1p.de/etadmin_mod/wiki/index.php/User:Phats#Advanced_Campaign_Structure_-_Using_etadmin_mod____.28Prototype.29 Advanced Campaign Structure - Using etadmin_mod (Prototype)]

[http://tjw.org/etded/ tjw's chrooted linux server guide]
[[Category:ETPro]]

Server Configuration

2009-08-15T07:20:03Z

Techno:

==Installation==
File installation:
Note that the <tt>etpro</tt> directory should be in the same directory as <tt>etmain</tt>. Do NOT extract the files to etmain
:Linux:
Unzip the server archive to <tt>enemy-territory/etpro/</tt>
:Windows:
Unzip the server archive to <tt>Wolfenstein - Enemy Territory\etpro</tt>
Starting an ETPro server requires <tt>+set fs_game etpro</tt> to be appended to the end of the command line.
:Linux example:
::<tt> ./etded +set fs_game etpro</tt>
:Windows:
::<tt> etded.exe +set fs_game etpro</tt>
:Windows Shortcut:
::Right click on the shortcut for Enemy Territory and select "Properties." In the "Target" Box (Top text box) add <tt>+set fs_game etpro</tt> to the end, after the quotes.
::<tt> "C:\Program Files\Wolfenstein - Enemy Territory\et.exe" +set fs_game etpro</tt> 

''Note'': Starting from version ET 2.60, the Windows executables are et.exe for the game and etded.exe for the server. If you want to run a listen server on Windows start your game with et.exe, otherwise use etded.exe for a dedicated server.

If you want to run 2.56 or earlier servers on Windows, you can only use et.exe and append <tt>+set dedicated 1</tt> (or 2).

==Warnings==
WARNING: Server improperly installed! Incorrect fs_game setting! Please notify administrator.
:Incorrect <tt>+set fs_game</tt> string. Make sure it is set to <tt>+set fs_game etpro</tt>.
fs_game is write protected.
:You must start your server via the command line (Or by changing the shortcut) with the <tt>+set fs_game etpro</tt> command. 
Client .pk3 missing!
:The PK3 file that is contained in the server install file is missing. Download the [http://bani.anime.net/etpro/download.html server install] again and place the PK3 file in the server's ETPro directory. 
Incorrect client .pk3 installed on server!
:The PK3 file mentioned above does not match the version of the server. Download the PK3 (And possibly updated server) from the [http://bani.anime.net/etpro/download.html download page].
Multiple client .pk3 versions installed on server!
:This means that the server has more than one ETPro client PK3. Remove the older versions from the server's ETPro directory.
:This can also happen from having fs_game set twice in your shortcut or config. 
Incorrect ET version!
:This happens when you are attempting to install ETPro on a non-patched ET server. Download the [http://games.activision.com/games/wolfenstein patch] and try again. 
Cvar dedicated is 0! Some features will break!
:ETPro is meant to be installed on a dedicated server. Set the server to dedicated by using <tt>+set dedicated 2</tt> in the command-line used to start the server. 
etpro_cheats.dat is corrupt or missing!
:The ETPro database file for positively identifying cheats has either been corrupted or does not exist on the server. Download a recent version of [http://etpro.anime.net/etpro_cheats.dat the database].
 
==Other Errors==
Server sends users the ETPro PK3 file over and over. 
:If you are using download redirects, make sure that the download path is set correctly if changed between versions. eg: If the old PK3 was in <tt>server/etpro2</tt> and the new version is in <tt>server/etpro3</tt> and the redirect path in the server configuration was not changed, it would send the old ETPro 2.x files; which not being what the server is using, it would cause the download to start again. 
:If you are redirecting to an http or ftp server, make sure the pk3 on the http/ftp server exactly matches the pk3 on the game server.
:Some http servers may incorrectly try to send pk3 files as text/plain, which will corrupt downloads. Make sure they are sent as application/octet-stream:
*WARNING*: PunkBuster Reports PB Server Running Old Version Cx.xxx 
Windows:
:Run <tt>\Wolfenstein - Enemy territory\pb\pbweb.exe</tt> 
Linux:
:Run <tt>/path_to_et_server/pb/pbweb.x86</tt> (first chmod +x pbweb.x86) 

==Tips for server admins==
In general, the ettv/etded process should be restarted every 20 days or less. If the server is running on windows, the OS should be restarted at the same time.

Q: Why do my logs and console keep getting flooded with stuff like this:
saneClientCommand: 5 obj -1

A: See [[ETPro:Server_cvar_list|b_showClientCmds]] in the server cvar list.

Q: rcon stopped working

A: Your server has been up for more than 49 days, you need to restart it.

Q: All clients trying to connect to my ettv server get stuck awaiting gamestate, even though the network is fine.

A: restart it.

==Campaign configuration:==
Campaigns are created by editing a file with the extension ".campaign".

This is the structure of a .campaign file :

<pre>
{
name ""
shortname ""
description ""
maps ""
mapTC 374 374
type "wolfmp"
}
</pre>

<table border="1">
<tr><th>Key</th><th>Value</th></tr>
<tr><td>name</td><td>This is displayed at the start of a match when awaiting players to readyup, on the score screen, and also in the top-right of the map loading screen. It can be a maximum of 31 characters long, though to stay within the graphic background of the loading screen, and to preserve the "xofx" text, 13 characters is the maximum. Color codes can be used.</td></tr>
<tr><td>shortname</td><td>The name used to call the campaign using the "campaign" and "nextcampaign" commands.</td></tr>
<tr><td>description</td><td>The information displayed on the map loading screen. The available character resoltion is 23x26. "\n" is used for a new-line and colour codes can be used.</td></tr>
<tr><td>maps</td><td>A semi-colon (";") separated list of maps (up to 10). The map name is the filename found in the \maps folder of the PK3 file, minus the .bsp extension.</td></tr>
<tr><td>mapTC</td><td>Leave this as the default ("374 374")</td></tr>
<tr><td>type</td><td>Leave this as the default ("wolfmp")</td></tr>
</table>

Example :
<pre>
{
name "^0My ^1Campaign"
shortname "myCamp"
description "^1This is an example campaign.\n^0Map 1 : Goldrush\nMap 2 : Aldernest\nMap 3 : Oasis"
maps "goldrush;aldernest;oasis"
mapTC 374 374
type "wolfmp"
}
</pre>

The compeleted .campaign file is then usually placed in the "scripts/" directory of either servers' etpro/ directory directly, or in a PK3 file on the server. The difference between the two methods is that if the .campaign file is placed directly on the server, the client wont have the campaign information, and therefore the campaign name, description and number of maps information sections will be empty.

The .campaign file is then referenced using the CVAR b_campaignfile, for example :
<pre>
b_campaignfile "scripts/myCampaign.campaign"
</pre>

Once the campaign file is loaded, the campaign shortname's contained within can be called, using the "campaign" and "nextcampaign" commands, eg :
<pre>
campaign myCamp
nextcampaign myNewCamp
</pre>

==Configuration:==
[[:Category:ETPro:Server_Cvars|ETPro Server CVAR Explanations]]

[[ETPro:Pluggable Config Files]]

[http://bani.anime.net/banimod/forums/viewforum.php?f=13 Server Admin Forums]

[http://rtcw.jolt.co.uk/content/enemy_territory/server_guide/index.html DG's Advanced Server Guide]

[http://et.d1p.de/etadmin_mod/wiki/index.php/User:Phats#Advanced_Campaign_Structure_-_Using_etadmin_mod____.28Prototype.29 Advanced Campaign Structure - Using etadmin_mod (Prototype)]

[http://tjw.org/etded/ tjw's chrooted linux server guide]
[[Category:ETPro]]

Configstring

2009-08-14T09:08:17Z

Techno:

__NOEDITSECTION__

Configstrings can be accessed with <code>[[Lua_Mod_API#configstrings|et.trap_GetConfigstring]]</code> and <code>[[Lua_Mod_API#configstrings|et.trap_SetConfigstring]]</code> and the [[Lua_Mod_API#string_utility_functions|String utility functions]].

==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 [http://www.sonic.net/~rfm/et/lua/etconst.lua 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 <code>et.trap_GetConfigstring(slotNumber)</code> but must use <code>et.trap_GetConfigstring(et.CS_PLAYERS + slotNumber)</code>.

<pitatable columns=3 headlines="key;name;description" widths="40;220;450" headerfontcolor="#FFFFFF">
n;Nick;Player nickname
t;Team;1=Axis, 2=Allies, 3=Spectators
c;Class;0=Soldier, 1=Medic, 2=Engineer, 3=FieldOps, 4=CovertOps
r;Rank;0-10
m;Medals;0=Highest Battle Sense, 1=Best Engineer, 2=Best Medic, 3=Best Field Ops, 4=Highest Light Weapons, 5=Best Soldier, 6=Best Covert Ops
s;Skills;Battle Sense, Engineering, First Aid, Signals, Light Weapons, Heavy Weapons, Covert Operations [0-4]
dn;Disguised name;
dr;Disguised rank;
w;Weapon;2=Lugar, 3=MP40, 5=Panzerfaust, 6=Flamethrower, 7=Colt, 8=Thomson 10=Sten, 23=Engineer K43, 24=Engineer M1 Garand, 25=Covert Ops M1 Garand, 31=Mobile MG42, 32=Covert Ops K43 33=FG42, 35=Mortar, 37=Akimbo Colts, 38=Akimbo Lugars, 47=Silenced Akimbo Colts, 48=Silenced Akimbo Luagrs
lw;Latched weapon;Weapon on next spawn
sw;Latched secondary weapon;Secondary weapon on next spawn
ref;Referee;Referee status (0=not ref, 1=ref)
p;Privilege level;0=Peon, referee (vote), referee (password), semiadmin, rconauth - etpro only
ss;Stat Saver; Stats have been restored by stat saver, etpro only (0=No, 1=Yes)
sc;Shoutcaster;etpro only (0=No, 1=Yes)
tv;ETTV slave;etpro only (0=No, 1=Yes)
</pitatable>

==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==
<code>et.CS_PLAYERS = 689</code> for those of you that don't use [[User:ReyalP|etconst.lua]].

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

[[Category:ETPro]]
[[Category:Lua]]
[[Category:ETPro:Mods]]

Configstring

2009-08-14T09:06:06Z

Techno:

__NOEDITSECTION__

Configstrings can be accessed with <code>[[Lua_Mod_API#configstrings|et.trap_GetConfigstring]]</code> and <code>[[Lua_Mod_API#configstrings|et.trap_SetConfigstring]]</code> and the [[Lua_Mod_API#string_utility_functions|String utility functions]].

==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 [http://www.sonic.net/~rfm/et/lua/etconst.lua 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 <code>et.trap_GetConfigstring(slotNumber)</code> but must use <code>et.trap_GetConfigstring(et.CS_PLAYERS + slotNumber)</code>.

<pitatable columns=3 headlines="key;name;description" widths="40;220;450" headerfontcolor="#FFFFFF">
n;Nick;Player nickname
t;Team;1=Axis, 2=Allies, 3=Spectators
c;Class;0=Soldier, 1=Medic, 2=Engineer, 3=FieldOps, 4=CovertOps
r;Rank;0-10
m;Medals;0=Highest Battle Sense, 1=Best Engineer, 2=Best Medic, 3=Best Field Ops, 4=Highest Light Weapons, 5=Best Soldier, 6=Best Covert Ops
s;Skills;Battle Sense, Engineering, First Aid, Signals, Light Weapons, Heavy Weapons, Covert Operations [0-4]
dn;Disguised name;
dr;Disguised rank;
w;Weapon;2=Lugar, 3=MP40, 5=Panzerfaust, 6=Flamethrower, 7=Colt, 8=Thomson 10=Sten, 23=Engineer K43, 24=Engineer M1 Garand, 25=Covert Ops M1 Garand, 31=Mobile MG42, 32=Covert Ops K43 33=FG42, 35=Mortar, 37=Akimbo Colts, 38=Akimbo Lugars, 47=Akimbo Silenced Colts, 48=Akimbo Silenced Luagrs
lw;Latched weapon;Weapon on next spawn
sw;Latched secondary weapon;Secondary weapon on next spawn
ref;Referee;Referee status (0=not ref, 1=ref)
p;Privilege level;0=Peon, referee (vote), referee (password), semiadmin, rconauth - etpro only
ss;Stat Saver; Stats have been restored by stat saver, etpro only (0=No, 1=Yes)
sc;Shoutcaster;etpro only (0=No, 1=Yes)
tv;ETTV slave;etpro only (0=No, 1=Yes)
</pitatable>

==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==
<code>et.CS_PLAYERS = 689</code> for those of you that don't use [[User:ReyalP|etconst.lua]].

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

[[Category:ETPro]]
[[Category:Lua]]
[[Category:ETPro:Mods]]

Configstring

2009-08-14T08:32:18Z

Techno:

__NOEDITSECTION__

Configstrings can be accessed with <code>[[Lua_Mod_API#configstrings|et.trap_GetConfigstring]]</code> and <code>[[Lua_Mod_API#configstrings|et.trap_SetConfigstring]]</code> and the [[Lua_Mod_API#string_utility_functions|String utility functions]].

==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 [http://www.sonic.net/~rfm/et/lua/etconst.lua 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 <code>et.trap_GetConfigstring(slotNumber)</code> but must use <code>et.trap_GetConfigstring(et.CS_PLAYERS + slotNumber)</code>.

<pitatable columns=3 headlines="key;name;description" widths="40;220;450" headerfontcolor="#FFFFFF">
n;Nick;Player nickname
t;Team;1=Axis, 2=Allies, 3=Spectators
c;Class;0=Soldier, 1=Medic, 2=Engineer, 3=FieldOps, 4=CovertOps
r;Rank;0-10
m;Medals;0=Highest Battle Sense, 1=Best Engineer, 2=Best Medic, 3=Best Field Ops, 4=Highest Light Weapons, 5=Best Soldier, 6=Best Covert Ops
s;Skills;Battle Sense, Engineering, First Aid, Signals, Light Weapons, Heavy Weapons, Covert Operations [0-4]
dn;Disguised name;
dr;Disguised rank;
w;Weapon;3=MP40, 5=Panzerfaust, 6=Flamethrower, 8=Thomson 10=Sten, 23=Engineer K43, 24=Engineer M1 Garand, 25=Covert Ops M1 Garand, 31=Mobile MG42, 32=Covert Ops K43 33=FG42, 35=Mortar
lw;Latched weapon;Weapon on next spawn
sw;Latched secondary weapon;Secondary weapon on next spawn
ref;Referee;Referee status (0=not ref, 1=ref)
p;Privilege level;0=Peon, referee (vote), referee (password), semiadmin, rconauth - etpro only
ss;Stat Saver; Stats have been restored by stat saver, etpro only (0=No, 1=Yes)
sc;Shoutcaster;etpro only (0=No, 1=Yes)
tv;ETTV slave;etpro only (0=No, 1=Yes)
</pitatable>

==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==
<code>et.CS_PLAYERS = 689</code> for those of you that don't use [[User:ReyalP|etconst.lua]].

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

[[Category:ETPro]]
[[Category:Lua]]
[[Category:ETPro:Mods]]

Configstring

2009-08-14T08:26:15Z

Techno:

__NOEDITSECTION__

Configstrings can be accessed with <code>[[Lua_Mod_API#configstrings|et.trap_GetConfigstring]]</code> and <code>[[Lua_Mod_API#configstrings|et.trap_SetConfigstring]]</code> and the [[Lua_Mod_API#string_utility_functions|String utility functions]].

==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 [http://www.sonic.net/~rfm/et/lua/etconst.lua 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 <code>et.trap_GetConfigstring(slotNumber)</code> but must use <code>et.trap_GetConfigstring(et.CS_PLAYERS + slotNumber)</code>.

<pitatable columns=3 headlines="key;name;description" widths="40;220;450" headerfontcolor="#FFFFFF">
n;Nick;Player nickname
t;Team;1=Axis, 2=Allies, 3=Spectators
c;Class;0=Soldier, 1=Medic, 2=Engineer, 3=FieldOps, 4=CovertOps
r;Rank;0-10
m;Medals;0-7
s;Skills;0-4
dn;Disguised name;
dr;Disguised rank;
w;Weapon;3=MP40, 5=Panzerfaust, 6=Flamethrower, 8=Thomson 10=Sten, 23=Engineer K43, 24=Engineer M1 Garand, 25=Covert Ops M1 Garand, 31=Mobile MG42, 32=Covert Ops K43 33=FG42, 35=Mortar
lw;Latched weapon;Weapon on next spawn
sw;Latched secondary weapon;Secondary weapon on next spawn
ref;Referee;Referee status (0=not ref, 1=ref)
p;Privilege level;0=Peon, referee (vote), referee (password), semiadmin, rconauth - etpro only
ss;Stat Saver; Stats have been restored by stat saver, etpro only (0=No, 1=Yes)
sc;Shoutcaster;etpro only (0=No, 1=Yes)
tv;ETTV slave;etpro only (0=No, 1=Yes)
</pitatable>

==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==
<code>et.CS_PLAYERS = 689</code> for those of you that don't use [[User:ReyalP|etconst.lua]].

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

[[Category:ETPro]]
[[Category:Lua]]
[[Category:ETPro:Mods]]