WolfWiki - User contributions [en]

User:ReyalP

2008-04-01T23:32:12Z

ReyalP: /* ETPro/Lua libraries, modules and examples */

http://www.sonic.net/~rfm/et/bananet.png
==ETPro/Lua libraries, modules and examples==
;Follow the link to the source code for more detailed information about each item.
;Exploit fixes [http://bani.anime.net/banimod/forums/viewtopic.php?t=6777 see this thread for details] last updated April 1 2008 (no foolin')
[http://www.collectivecomputing.com/~reed/et/lua/combinedfixes.lua combinedfixes.lua]
* prevent crash or information disclosure via the ws command (previously wsfix.lua)
* perform some sanity checking on userinfo (previously userinfocheck.lua)
* prevent crash from etpro guid hacks. (previously guidcheck.lua)
* limit number of connections from a given IP. (previously fakeplimit.lua)
Note the individual fixes were previously available in separate modules, however they now depend on each other so I am no longer maintaining the individual modules. You can find the old modules in obsolete/ from the above URL, but be aware that they have '''NOT''' been upated to reflect the latest bug fixes.
;Older stuff
*[http://www.sonic.net/~rfm/et/lua/autoref.lua autoref.lua] lua module to give people referee status, based on IP or PB GUID. Requires etconst.lua '''WARNING''': The GUID this uses might be spoofed by malicious clients. The IP might also be spoofed if you don't use combinedfixes.lua
*[http://www.sonic.net/~rfm/et/lua/etconst.lua etconst.lua] some common constants from the et header files, converted to lua.
*[http://www.sonic.net/~rfm/et/lua/luacon.lua luacon.lua] library provides a lua command in the server console, for interactive testing.
*[http://www.sonic.net/~rfm/et/lua/luaconmod.lua luaconmod.lua] runs luacon as module.
*[http://www.sonic.net/~rfm/et/lua/cvarobj.lua cvarobj.lua] metamethods example. Allows using cvars like normal lua variables.
*[http://www.sonic.net/~rfm/et/lua/dumptable.lua dumptable.lua] recursively display contents of a table.
*[http://www.sonic.net/~rfm/et/lua/obsolete/noteamflood.lua noteamflood.lua] prevent people from flooding "team" commands. No longer needed with etpro 3.2.6.

==Map editing stuff==
; tjlview, a plugin for viewing [[TrickJumpLines]] in [http://www.qeradiant.com/ GtkRadiant 1.4]
* [http://www.sonic.net/~rfm/et/readme_tjlview-a0.1.txt readme]
* [http://www.sonic.net/~rfm/et/tjlview-a0.1-src.zip source]
* [http://www.sonic.net/~rfm/et/tjlview-linux.zip windows and linux binaries]
; readme for bkgrnd2d plugin (the plugin itself is included in GTKRadiant 1.4)
* [http://www.sonic.net/~rfm/et/readme_bkgrnd2d-b0.25.txt readme_bkgrnd2d-b0.25.txt]

==Contact==
* '''email''' reyalp (at) gmail.com 
* '''[[IRC]]''' #etpro on freenode or quakenet, #n-warriors on gamesurge

[[Category:ETPro:Mods]]

User:ReyalP

2008-03-24T03:23:34Z

ReyalP: /* ETPro/Lua libraries, modules and examples */

http://www.sonic.net/~rfm/et/bananet.png
==ETPro/Lua libraries, modules and examples==
;Follow the link to the source code for more detailed information about each item.
;Exploit fixes [http://bani.anime.net/banimod/forums/viewtopic.php?t=6777 see this thread for details] last updated March 23 2008.
*[http://www.collectivecomputing.com/~reed/et/lua/wsfix.lua wsfix.lua] prevent crash or information disclosure via the ws command
*[http://www.collectivecomputing.com/~reed/et/lua/userinfocheck.lua userinfocheck.lua] perform some sanity checking on userinfo
*[http://www.collectivecomputing.com/~reed/et/lua/guidcheck.lua guidcheck.lua] prevent crash from etpro guid hacks. Note you '''MUST''' use userinfocheck.lua with this, or use combined fixes.
*[http://www.collectivecomputing.com/~reed/et/lua/fakeplimit.lua fakeplimit.lua] limit number of connections from a given IP. This should not be used without userinfocheck.lua, as the IP might be spoofed otherwise.
*[http://www.collectivecomputing.com/~reed/et/lua/combinedfixes.lua combinedfixes.lua] all of the above merged into a single module.
;Older stuff
*[http://www.sonic.net/~rfm/et/lua/autoref.lua autoref.lua] lua module to give people referee status, based on IP or PB GUID. Requires etconst.lua WARNING: The GUID this uses might be spoofed by malicious clients. The IP might also be spoofed if you don't use userinfocheck.lua
*[http://www.sonic.net/~rfm/et/lua/etconst.lua etconst.lua] some common constants from the et header files, converted to lua.
*[http://www.sonic.net/~rfm/et/lua/luacon.lua luacon.lua] library provides a lua command in the server console, for interactive testing.
*[http://www.sonic.net/~rfm/et/lua/luaconmod.lua luaconmod.lua] runs luacon as module.
*[http://www.sonic.net/~rfm/et/lua/cvarobj.lua cvarobj.lua] metamethods example. Allows using cvars like normal lua variables.
*[http://www.sonic.net/~rfm/et/lua/dumptable.lua dumptable.lua] recursively display contents of a table.
*[http://www.sonic.net/~rfm/et/lua/noteamflood.lua noteamflood.lua] prevent people from flooding "team" commands. No longer needed with etpro 3.2.6.

==Map editing stuff==
; tjlview, a plugin for viewing [[TrickJumpLines]] in [http://www.qeradiant.com/ GtkRadiant 1.4]
* [http://www.sonic.net/~rfm/et/readme_tjlview-a0.1.txt readme]
* [http://www.sonic.net/~rfm/et/tjlview-a0.1-src.zip source]
* [http://www.sonic.net/~rfm/et/tjlview-linux.zip windows and linux binaries]
; readme for bkgrnd2d plugin (the plugin itself is included in GTKRadiant 1.4)
* [http://www.sonic.net/~rfm/et/readme_bkgrnd2d-b0.25.txt readme_bkgrnd2d-b0.25.txt]

==Contact==
* '''email''' reyalp (at) gmail.com 
* '''[[IRC]]''' #etpro on freenode or quakenet, #n-warriors on gamesurge

[[Category:ETPro:Mods]]

Lua Mod API

2008-03-23T21:42:00Z

ReyalP: warning about etprint

__NOEDITSECTION__
[[ETPro]] now supports server-side mods via the [http://www.lua.org/ Lua] scripting language. For more information about Lua, visit the [http://www.lua.org/manual/5.0/ Reference manual], the online edition of the book [http://www.lua.org/pil/ Programming in Lua] or the [http://lua-users.org/wiki/ lua-users wiki]. A list of text editors for coding LUA can be found [http://wiki.ptokax.ath.cx/doku.php/misc/editors here].

ETPro has an embedded Lua 5.0.2 interpreter, and if present will load user-defined scripts from the ETPro directory. It also provides an "et" library of function calls for Lua that allow access to the server engine, and provides callbacks so a server side mod may trigger on specific server events.

The following standard Lua libraries are initialized by default and available to ETPro Lua scripts:
[http://www.lua.org/manual/5.0/manual.html#5.1 basic], [http://www.lua.org/manual/5.0/manual.html#5.4 table], [http://www.lua.org/manual/5.0/manual.html#5.6 i/o], [http://www.lua.org/manual/5.0/manual.html#5.7 os] (available features vary depending on your OS), [http://www.lua.org/manual/5.0/manual.html#5.3 string], [http://www.lua.org/manual/5.0/manual.html#5.5 math].

A list of ETPro mods can be found [[:Category:ETPro:Mods|here]].

A tutorial about ETPro Lua scripting can be found [[Lua Tutorials|here]].

API requests can be discussed at the [[Talk:Lua_Mod_API|Lua Mod API talk page]].

==client commands==
===lua_status===
:lists all currently loaded lua modules.
:''lua mods cannot override this client command.''

==server commands==
===lua_status===
:lists all currently loaded lua modules.

==cvars==
===lua_modules===
:(default "", disabled)
:space separated list of lua modules for ETPro to load. modules will be run in the order listed.

===lua_allowedmodules===
:(default "", disabled)
:if set, only lua modules with the matching sha1 signatures listed in this cvar will be allowed to load.
 
:changing either cvar will cause all currently loaded modules to :quit and be unloaded until the next map_restart. 
 

==et library calls==

===modules===
et.RegisterModname( '''modname''' )
:Registers a descriptive string '''modname''' for this mod.
'''vmnumber''' = et.FindSelf()
:Returns a number indicating the VM slot the current mod is loaded into.
'''modname''', '''signature''' = et.FindMod( '''vmnumber''' )
:Returns the '''modname''' and sha1 '''signature''' for the mod loaded in the VM slot '''vmnumber'''. Returns nil, nil if the VM slot is invalid.
'''success''' = et.IPCSend( '''vmnumber''', '''message''' )
:Sends the string '''message''' to the mod in the VM slot indicated by '''vmnumber'''. The mod receiving '''message''' must have an ''et_IPCReceive()'' callback. If the message is successfully sent, '''success''' will be 1. On failure it will be 0. See the [[Lua:IPC|Lua IPC]] page for a simple example.
 

===printing===
et.G_Print( '''text''' )
:Prints the string '''text''' to the server console.
et.G_LogPrint( '''text''' )
:Prints the string '''text''' to the server console and writes it to the server log.
 

===argument handling===
These functions are to be used within the [[#commands|command callback functions]]. 
'''args''' = et.ConcatArgs( '''index''' )
:Returns all arguments beginning from '''index''' concatenated into a single string '''args'''
'''argcount''' = et.trap_Argc()
:Returns a number indicating the number of command line arguments in the command buffer.
'''arg''' = et.trap_Argv( '''argnum''' )
:Returns the contents of the command line argument '''argnum'''.
 

===cvars===
'''cvarvalue''' = et.trap_Cvar_Get( '''cvarname''' )
:Returns the value of the cvar '''cvarname''' as a string. If there is no cvar named '''cvarname''', returns a zero length string.
et.trap_Cvar_Set( '''cvarname''', '''cvarvalue''' )
:Sets the cvar '''cvarname''' to '''cvarvalue'''
 

===configstrings===
'''configstringvalue''' = et.trap_GetConfigstring( '''index''' )
:Returns the string '''configstringvalue''' containing the contents of the configstring '''index'''
et.trap_SetConfigstring( '''index''', '''configstringvalue''' )
:Sets the configstring '''index''' to the string '''configstringvalue'''
 

===server===
et.trap_SendConsoleCommand( '''when''', '''command''' )
:Sends the command '''command''' to the server console, to be executed '''when''' (see et.EXEC_* constants)
 

===clients===
et.trap_DropClient( '''clientnum''', '''reason''', '''ban_time''' )
:Disconnects '''clientnum''' from the server, with descriptive string '''reason''' reported to clients. '''ban_time''' is the time in seconds to ban the client from the server. '''ban_time''' is optional and may be entirely omitted, in which case the ban time defaults to the cvar ''b_defaultbantime''
et.trap_SendServerCommand( '''clientnum''', '''[[SendServerCommand|command]]''' )
:Sends the command '''[[SendServerCommand|command]]''' to the client '''clientnum'''. If '''clientnum''' is -1, the '''[[SendServerCommand|command]]''' is broadcast to all connected clients.
et.G_Say( '''clientNum''', '''mode''', '''text''' )
:Sends a chat command on behalf of client '''clientNum''' with the mode '''mode''' (see et.SAY_* constants) and chat text '''text'''.
et.ClientUserinfoChanged( '''clientNum''' )
:Loads the new [[Userinfo]] of '''clientNum''' and stores it in the configstring and client variables
 

===userinfo===
'''userinfo''' = et.trap_GetUserinfo( '''clientnum''' )
:Returns the contents of the [[Userinfo]] string for the client '''clientnum'''
et.trap_SetUserinfo( '''clientnum''', '''userinfo''' )
:Sets the [[Userinfo]] string for the client '''clientnum''' to '''userinfo'''
 

===string utility functions===
'''infostring''' = et.Info_RemoveKey( '''infostring''', '''key''' )
:Removes key '''key''' from infostring '''infostring''' and returns the modified infostring.
'''infostring''' = et.Info_SetValueForKey( '''infostring''', '''key''', '''value''' )
:Sets the key '''key''' in the infostring '''infostring''' to '''value''' and returns the modified infostring. If '''value''' is an empty string, '''key''' is removed from the string.
'''keyvalue''' = et.Info_ValueForKey( '''infostring''', '''key''' )
:Returns the value of the key '''key''' in the infostring '''infostring'''. If '''key''' is not present in the string, an empty string is returned.
'''cleanstring''' = et.Q_CleanStr( '''string''' )
:Returns '''string''' stripped of all color codes
 

===ET filesystem===
'''fd''', '''len''' = et.trap_FS_FOpenFile( '''filename''', '''mode''' )
:Attempts to open the file '''filename''' with the access mode '''mode''' (see et.FS_ constants). Returns the filedescriptor '''fd''' and file length '''len'''. On error, '''len''' returns -1.
'''filedata''' = et.trap_FS_Read( fd, count )
:Reads '''count''' bytes from filedescriptor '''fd'''.
'''count''' = et.trap_FS_Write( '''filedata''', '''count''', '''fd''' )
:Attempts to write '''count''' bytes of '''filedata''' to filedescriptor '''fd'''. Returns number of bytes successfully written.
et.trap_FS_Rename( '''oldname''', '''newname''' )
:Renames file '''oldname''' to '''newname'''.
et.trap_FS_FCloseFile( '''fd''' )
:Closes filedescriptor '''fd'''
 

===indexes===
'''soundindex''' = et.G_SoundIndex( '''filename''' )
:Returns an index to the soundfile indicated by '''filename'''
'''modelindex''' = et.G_ModelIndex( '''filename''' )
:Returns an index to the model indicated by '''filename'''
 

===sound===
et.G_globalSound( '''sound''' )
:Plays the global sound indicated by the filename '''sound'''.
et.G_Sound( '''entnum''', '''soundindex''' )
:Plays the sound '''soundindex''' at the location of entity '''entnum'''
 

===miscellaneous===
'''milliseconds''' = et.trap_Milliseconds()
:Returns a number indicating the current server time in milliseconds.
et.G_Damage( '''target''', '''inflictor''', '''attacker''', '''damage''', '''[[etdamage|dflags]]''', '''[[etdamage|mod]]''' )
:Does '''damage''' amount of damage on '''target''' inflicted by '''inflictor''' and cased by '''attacker'''
:'''target''', '''inflictor''', '''attacker''' are entity numbers
:'''[[etdamage|dflags]]''' is a [[Bitmask-cvar|bitflag]] number to decide how the damage is inflickted, see '''[[etdamage|dflags]]''' [[etdamage|flaglist]]
:'''[[etdamage|mod]]''' is a number from 0 up to 64 o set the type of damage, see '''[[etdamage|mod]]''' [[etdamage|list]]
 

===entities===
'''entnum''' = et.G_Spawn()
:Spawns a new entity and returns the new entity number.
'''entnum''' = et.G_TempEntity( '''origin''', '''event''' )
:Spawns a new TempEntity of event type '''event''' and places it at '''origin''' in the world.
et.G_FreeEntity( '''entnum''' )
:Frees the entity '''entnum'''
'''spawnval''' = et.G_GetSpawnVar( '''entnum''', '''key''' )
:Returns the value of spawnvar '''key''' for entity '''entnum'''
et.G_SetSpawnVar( '''entnum''', '''key''', '''value''' )
:Sets the spawnvar '''key''' to '''value''' for entity '''entnum'''
'''integer entnum''' = et.G_SpawnGEntityFromSpawnVars( string spawnvar, string spawnvalue, ... )
:This function can only be called inside the '''et_InitGame''' callback
et.trap_LinkEntity( '''entnum''' )
:Links the entity '''entnum'''
et.trap_UnlinkEntity( '''entnum''' )
:Unlinks the entity '''entnum'''
'''(variable)''' = et.gentity_get ( '''entnum''', '''[[Fieldname]]''' '',arrayindex'' )
:Gets the value of '''[[Fieldname]]''' from entity '''entnum''' out of the g_entity struct. For NULL entities or clients, ''nil'' is returned. 
:''arrayindex'' is used to specify which element of an array entity field to get. It is required when accessing array type fields. Entity field array indexes start at 0.
et.gentity_set( '''entnum''', '''[[Fieldname]]''', ''arrayindex,'' '''(value)''' )
:Sets the value of '''[[Fieldname]]''' from entity '''entnum''' in the g_entity struct to '''(value)'''
:''arrayindex'' is used to specify which element of an array entity field to set.
et.G_AddEvent( '''ent''', '''event''', '''eventparm'''' )
:Adds event '''event''' whit eventparameter '''eventparm'''' to entity '''ent'''
 

==callbacks==

===qagame execution===
et_InitGame( '''levelTime''', '''randomSeed''', '''restart''' )
:Called when qagame initializes. '''levelTime''' is the current level time in milliseconds. '''randomSeed''' is a number that can be used to seed random number generators. '''restart''' indicates if et_InitGame() is being called due to a map restart (1) or not (0).
et_ShutdownGame( '''restart''' )
:Called when qagame shuts down. '''restart''' indicates if the shutdown is being called due to a map_restart (1) or not (0).
et_RunFrame( '''levelTime''' )
:Called when qagame runs a server frame. '''levelTime''' is the current level time in milliseconds.
et_Quit()
:Called when ETPro unloads the mod. The mod should close all open filedescriptors and perform all cleanup.
 

===client management===
'''rejectreason''' = et_ClientConnect( '''clientNum''', '''firstTime''', '''isBot''' )
:Called when a client attempts to connect to the server. '''clientNum''' is the client slot id, '''firstTime''' indicates if this is a new connection (1) or a reconnection (0). '''isBot''' indicates if the client is a bot (1) or not (0). If the mod accepts the connection, it should return nil. Otherwise, the mod should return a string describing the reason the client connection was rejected.
et_ClientDisconnect( '''clientNum''' )
:Called when a client disconnects. '''clientNum''' is the client slot id.
et_ClientBegin( '''clientNum''' )
:Called when a client begins (becomes active, and enters the gameworld). '''clientNum''' is the client slot id.
et_ClientUserinfoChanged( '''clientNum''' )
:Called when a client's [[Userinfo]] string has changed. '''clientNum''' is the client slot id.
:'''note:''' In ETPro 3.2.6 and below, this only gets called when the players CS_PLAYERS config string changes, rather than every time the userinfo changes. This only happens for a subset of userinfo fields.
et_ClientSpawn( '''clientNum''', '''revived''' )
:Called when a client is spawned. '''clientNum''' is the client slot id. '''revived''' is 1 if the client was spawned by being revived.
 

===commands===
'''intercepted''' = et_ClientCommand( '''clientNum''', '''command''' )
:Called when a command is received from a client. '''clientNum''' is the client slot id. '''command''' is the command. The mod should return 1 if the command was intercepted by the mod, and 0 if the command was ignored by the mod and should be passed through to the server (and other mods in the chain).
:The actual command can be accessed through the [[#argument_handling|argument handling]] functions, as seen in the [[ETPro:Lua Sample Code]].
'''intercepted''' = et_ConsoleCommand()
:Called when a command is entered on the server console. The mod should return 1 if the command was intercepted by the mod, and 0 if the command was ignored by the mod and should be passed through to the server (and other mods in the chain).
:The actual command can be accessed through the [[#argument_handling|argument handling]] functions, as seen in the [[ETPro:Lua Sample Code]].
 

===xp===
et_UpgradeSkill( '''cno''', '''skill''' )
:Called when client on slot '''cno''' gets an upgrade on skill '''skill'''. Return -1 to override (abort) the qagame function, anything else to "passthrough". Callback may modify skills (or do anything else it wants) during passthrough.
et_SetPlayerSkill( '''cno''', '''skill''' )
:Called when clients (on slot '''cno''') skill level '''skill''' is set. Return -1 to override (abort) the qagame function, anything else to "passthrough". Callback may modify skills (or do anything else it wants) during passthrough.
 

===miscellaneous===
et_IPCReceive( '''vmnumber''', '''message''' )
:Called when another mod sends an et.IPCSend() message to this mod. '''vmnumber''' is the VM slot number of the sender, and '''message''' is the message.
et_Print( '''text''' )
:Called whenever the server or qagame prints a string to the console.
:'''WARNING!''' ''text'' may contain a player name + their chat message. This makes it '''very easy''' to spoof. '''DO NOT TRUST STRINGS OBTAINED IN THIS WAY'''
et_Obituary( '''victim''', '''killer''', '''meansOfDeath''' )
:Called whenever a player is killed.
 

==predefined constants==
et.EXEC_NOW 
et.EXEC_INSERT 
et.EXEC_APPEND 
et.FS_READ 
et.FS_WRITE 
et.FS_APPEND 
et.FS_APPEND_SYNC 
et.SAY_ALL 
et.SAY_TEAM 
et.SAY_BUDDY 
et.SAY_TEAMNL 
 
et.HOSTARCH
:set to WIN32 or UNIX depending on the host architecture qagame is running on.
LUA_PATH
:set to fs_homepath/fs_game/?.lua in order to ease use of the [http://www.lua.org/pil/8.1.html require] function.
 

==configs==
If a config is loaded, all modules are shutdown and reloaded. If a ''certified'' config is loaded, all modules are shutdown and reloaded, and additionally the following functions are disabled: '''require()''', '''loadfile()''', '''loadlib()''', '''loadstring()''', '''dofile()''' 
 

==caveats==
Like qagame, lua modules are unloaded and reloaded on map_restart and map changes. This means that all global variables and other information is lost. Mods may choose to store persistent data in cvars or external files. 
 

==FAQ==

Q: OMG I hate the libary prefix et.* on everything!!11!1oneone 
A: table.foreach(et, function (func, value) _G[func] = value; end)

Q: How do a reload my lua file without restarting the whole server? 
A: Use ''map_restart'', ''reset_match'' or simply change the map.

Q: Can I see some sample code? 
A: [[ETPro:Lua Sample Code|Lua sample code]]

Q: Is there a list of [[ETPro]] Lua mods? 
A: Yes, [[:Category:ETPro:Mods|here]].

Q: OMG my mod doesn't work! 
A: Make sure you added your mod's filename to the lua_modules cvar (e.g. set lua_modules mymod.lua).

Q: OMG why has et_ClientSay been removed? 
A: That's a secret but, to keep the function as it was, just add the following code to your et_ClientCommand() function 
<pre> -- et_ClientSay had to be removed in order to intercept all commands
-- so here's a wrapper for that
arg0 = et.trap_Argv(0) -- get the main command

if arg0 == "say" then
return et_ClientSay( clientNum, et.SAY_ALL, et.ConcatArgs(1))
elseif arg0 == "say_team" then
return et_ClientSay( clientNum, et.SAY_TEAM, et.ConcatArgs(1))
elseif arg0 == "say_buddy" then
return et_ClientSay( clientNum, et.SAY_BUDDY, et.ConcatArgs(1))
elseif arg0 == "say_teamnl" then
return et_ClientSay( clientNum, et.SAY_TEAMNL, et.ConcatArgs(1))
end
-- et_ClientSay wrapper end
</pre>

[[Category:Lua]]

WolfWiki:Community Portal

2007-11-07T00:42:31Z

ReyalP: /* Leagues / Competitions */ twl no longer does et

The WolfWiki Community portal is a place to list community news sites, competitions, mod sites, and other ET/ETPro related resources. Links added here should be of general interest to the ET community, not just promotion of a particular clan or server.
== News Sites ==

* [http://www.et-center.com/ ET-Center]
* [http://www.crossfire.nu/ Crossfire.nu]
* [http://www.gamestv.org/ GamesTV.org]
* [http://www.swertcw.com/ sweRTCW]
* [http://www.planetwolfenstein.com/ Planet Wolfenstein]
* [http://www.etnation.co.uk/ ETNation.co.uk]
* [http://www.splashdamage.com/ SplashDamage.com]
* [http://www.planetwolfenstein.de/ PlanetWolfenstein.de]
* [http://www.rtcw.co.uk/ rtcw.co.uk]
* [http://velocity.lunarpages.com/index.html Unofficial Enemy Territory Strategy Guide]
* [http://www.planetwolfenstein.com/4newbies/ RTCW 4 Newbies]
* [http://www.enemy-territory.com Enemy Territory Resource Site]
* [http://www.geheimgemein.de/kallisti/ Kallisti.et Enemy Territory Fun Community]
* [http://www.et-scene.de/news.php ET-Scene.de (German)]

== Leagues / Competitions ==

* [http://www.clanbase.com/ Clanbase]
* [http://www.sta-league.org/ Stronger Than All]
* [http://www.et-cup.net/ ET-Cup]
* [http://www.warleagues.com/ Warleagues]
* [http://www.frenchy-cup.com/ Frenchy-Cup european]
* [http://et-gather.be/ #et.gather Fast Gaming Cup]
* [http://www.gamearena.com.au/forums/et/ GameArena - Australian Community]

== Mods ==

* [http://stealthy.foolishgames.net/ FalckonET]
* [http://www.truecombat.com/intro.php TC:Elite]
* [http://www.omni-bot.com/ Omni-Bot]
* [http://www.priceofpeace.net/ The Price of Peace]
* [http://www.etpub.org/news.php ETPub]
* [http://jaymod.clanfu.org/ Jaymod]
* [http://www.splashdamage.com/index.php?name=pnPHPbb2&file=viewtopic&t=7522 ET-Mod-Project-List]

Fieldname

2007-05-24T22:18:59Z

ReyalP: warning on field descriptions.

__NOEDITSECTION__
==Entity Fieldnames==
List of fields supported by [[Lua Mod API#entities|et.gentity_get() and et.gentity_set()]] functions 
<pitatable columns=3 headlines="field;type;access" widths="180;120;60" headerfontcolor="#FFFFFF">
activator;entity;RO;
chain;entity;RW;
classname;string;RW;
client.inactivityTime;integer;RW;
client.inactivityWarning;qboolean;RW;
clipmask;integer;?;
closespeed;float;RW;
count;integer;RW;
count2;integer;RW;
damage;integer;RW;
deathType;meansOfDeath_t;RW;
delay;float;RW;
dl_atten;integer;RW;
dl_color;vec3;RW;
dl_shader;string;RO;
dl_stylestring;string;RO;
duration;float;RW;
end_size;integer;RW;
enemy;entity;RW;
flags;bitflag;RO;
harc;float;RW;
health;integer;RW;
inuse;qboolean;RO;
isProp;qboolean;RO;
item;string;RW;
key;integer;RW;
message;string;RW;
methodOfDeath;integer;RW;
mg42BaseEnt;integer;RW;
missionLevel;integer;RW;
model;string;RO;
model2;string;RO;
nextTrain;entity;RW;
noise_index;integer;RW;
origin;vec3;RW;
pers.connected;connected_t;?;
pers.netname;string;?;
pers.localClient;qboolean;?;
pers.initialSpawn;qboolean;?;
pers.enterTime;integer;?;
pers.connectTime;integer;?;
pers.teamState.state;teamstatestate_t;?;
pers.voteCount;integer;?;
pers.teamVoteCount;integer;?;
pers.complaints;integer;?;
pers.complaintClient;integer;?;
pers.complaintEndTime;integer;?;
pers.lastReinforceTime;integer;?;
pers.applicationClient;integer;?;
pers.applicationEndTime;integer;?;
pers.invitationClient;integer;?;
pers.invitationEndTime;integer;?;
pers.propositionClient;integer;?;
pers.propositionClient2;integer;?;
pers.propositionEndTime;integer;?;
pers.autofireteamEndTime;integer;?;
pers.autofireteamCreateEndTime;integer;?;
pers.autofireteamJoinEndTime;integer;?;
pers.lastSpawnTime;integer;?;
pers.ready;qboolean;?;
prevTrain;entity;RW;
props_frame_state;integer;RO;
ps.stats;integer array;RW;
ps.persistant;integer array;RW;
ps.ping;integer;?;
ps.powerups;integer array;RW;
ps.ammo;integer array;RW;
ps.ammoclip;integer array;RW;
r.absmax;vec3;RO;
r.absmin;vec3;RO;
r.bmodel;qboolean;RO;
r.contents;integer;RW;
r.currentAngles;vec3;RW;
r.currentOrigin;vec3;RW;
r.eventTime;integer;RW;
r.linkcount;integer;RO;
r.linked;qboolean;RO;
r.maxs;vec3;RW;
r.mins;vec3;RW;
r.ownerNum;integer;RW;
r.singleClient;integer;RW;
r.svFlags;integer;RW;
r.worldflags;integer;RO;
radius;integer;RW;
random;float;RW;
rotate;vec3;RW;
s.angles;vec3;RW;
s.angles2;vec3;RW;
s.apos;trajectory;RW;
s.clientNum;integer;RW;
s.constantLight;integer;RW;
s.density;integer;RW;
s.dl_intensity;integer;RW;
s.dmgFlags;integer;RW;
s.eFlags;integer;RW;
s.eType;integer;?;
s.effect1Time;integer;RW;
s.effect2Time;integer;RW;
s.effect3Time;integer;RW;
s.frame;integer;RW;
s.groundEntityNum;integer;RO;
s.loopSound;integer;RW;
s.modelindex;integer;RW;
s.modelindex2;integer;RW;
s.number;integer;RO;
s.onFireEnd;integer;RW;
s.onFireStart;integer;RW;
s.origin;vec3;?;
s.origin2;vec3;?;
s.pos;trajectory;RW;
s.powerups;integer;RO;
s.solid;integer;RW;
s.teamNum;integer;RW;
s.time;integer;RW;
s.time2;integer;RW;
s.weapon;integer;RO;
scriptName;string;RO;
sess.sessionTeam;team_t;RW;
sess.spectatorTime;integer;RW;
sess.spectatorState;spectatorState_t;RW;
sess.spectatorClient;entity;RW;
sess.latchSpectatorClient;integer;RW;
sess.playerType;integer;RW;
sess.playerWeapon;integer;RW;
sess.playerWeapon2;integer;RW;
sess.spawnObjectiveIndex;integer;RW;
sess.latchPlayerType;integer;RW;
sess.latchPlayerWeapon;integer;RW;
sess.latchPlayerWeapon2;integer;RW;
sess.damage_given;integer;RW;
sess.damage_received;integer;RW;
sess.deaths;integer;RW;
sess.game_points;integer;RW;
sess.gibs;integer;RW;
sess.kills;integer;RW;
sess.medals;integer array;RW;
sess.muted;qboolean;RW;
sess.rank;integer;RW;
sess.referee;integer;RW;
sess.rounds;integer;RW;
sess.semiadmin;integer;RW;
sess.skill;integer array;RW;
sess.spec_invite;integer;RW;
sess.spec_team;integer;RW;
sess.suicides;integer;RW;
sess.team_damage;integer;RW;
sess.team_kills;integer;RW;
sess.team_received;integer;RW;
sess.aWeaponStats;weapon_stat_t;RW;
spawnflags;integer;RO;
spawnitem;string;RO;
speed;float;RW;
splashDamage;integer;RW;
splashMethodOfDeath;integer;RW;
splashRadius;integer;RW;
start_size;integer;RW;
tagName;string;RO;
tagParent;entity;RW;
takedamage;boolean;RW;
tankLink;entity;RW;
target;string;RW;
TargetAngles;vec3;RW;
TargetFlag;integer;RO;
targetname;string;RO;
teamchain;entity;RW;
teammaster;entity;RW;
track;string;RO;
varc;float;RW;
wait;float;RW;
waterlevel;integer;RO;
watertype;integer;RO;
</pitatable>
:''note'': all the sess.* fields will return nil unless the entity is associated with client slot < sv_maxclients.
:''note'': all array variables need to be get or set with an additional parameter.

----

==ET variable types==

===qboolean===
:a '''qboolean''' is a boolean value.
:0 is represented by the lua value false
:1 is represented by the lua value true

----

===vec3===
:a '''vec3_t''' is a 3-element array of numbers (C definition: typedef float vec3_t[3];). It is usually used to store and process coordinates in 3D space. 
:In etpro-lua a vector is an array (table indexed by integers) containing 3 numbers. It can be accessed by
:doing:
<pre>
origin = et.gentity_get(entNum,"r.currentOrigin") --a vec3 value
x,y,z = origin[1],origin[2],origin[3]</pre>

----

===array===
:The fields listed as having type '''array''' represent an entity value which is an array. Individual elements of the array are accessed by passing the desired index in the ''arrayindex'' argument to the et.gentity_get and et.gentity_set functions. Valid array indexes are integers from 0 up to some field specific maximum. The ''arrayindex'' argument is '''required''' when accessing array type fields, so only one element of an array can be accessed in a given call to the gentity_* functions. 

----

===trajectory===
:a '''trajectory''' is returned as a lua table described below
<pre>{
trDuration = <number>, --- int
trTime = <number>, -- int
trType = <number>, -- see below for allowed values
trBase = <vec3_t>, -- vec3, as described above
trDelta = <vec3_t> -- also a vec3
}</pre>
: the allowed values for trType (along with the enum names and original comments from the ET source), are as follows. Note
: that not all values make sense for all entity types
<pitatable columns=3 headlines="number;type;discription" widths="40;160;450" headerfontcolor="#FFFFFF">
1;TR_STATIONARY;
2;TR_INTERPOLATE;non-parametric, but interpolate between snapshots;
3;TR_LINEAR;
4;TR_LINEAR_STOP;
5;TR_LINEAR_STOP_BACK;reverse movement can be different than forward;
6;TR_SINE;value = base + sin( time / duration ) * delta;
7;TR_GRAVITY;
8;TR_GRAVITY_LOW;
9;TR_GRAVITY_FLOAT;super low grav with no gravity acceleration;
10;TR_GRAVITY_PAUSED;has stopped, but trace to see if it should be switched back to TR_GRAVITY;
11;TR_ACCELERATE;
12;TR_DECCELERATE;
13;TR_SPLINE;
14;TR_LINEAR_PATH;
</pitatable>

----

===entity===
:The fields listed as having type '''enitity''' return an entity number or nil. Entity numbers are integers from 0 through 1023. Some of the entity numbers have special meanings:
:0 - (sv_privateclients - 1) are reserved for clients who connect with the private slot password
:0 - 63 are reserved for clients. A client's entity number is also its client number (as shown by /players for example)
:1022 is the '''worldspawn''' entity
:1023 is '''ENTITYNUM_NONE''' which is used instead of null in C under some circumstances to indicate no entity. This is needed where an entity number will be passed over the network.
:''Note'': Some other fields not listed as type 'entity' may take an entity number value. '''mg42BaseEnt''' and '''s.number''' are examples. 

----

===meansOfDeath===
:a '''meansOfDeath_t''' is a number indicating the [[etdamage|Method of Death]] Click [[etdamage|here]] for a list with possible value's

== Field details ==
'''WARNING'''
The following are incomplete, and likely contain errors. Also be aware that the meaning of many fields depends on which entity the field belongs to. "damage" on one entity may have a completely different meaning on another. When in doubt, consult the ET source. ETPro may differ slightly, but the majority of entity fields are the same. The full meaning of a given field can ONLY be obtained from the source.

=== classname ===
Entity class name.
* ''nil'' if entity is not in use
* ''player'' for game client
* ''team_WOLF_objective'' for objective entity
etc.

=== client.inactivityTime ===
Timestamp of when the client was last active. Seems to be 44000000 + server uptime in ms.

=== damage ===
Probably related to damage entity deals (e.g. fire, barbed wire). 2 for player entity.

=== health ===
Health of the entity (e.g. player's health for a client, damage needed to disable stationary MG for stationary MG etc.)

=== inuse ===
Indicates whether the entity number is used. Specially for entity numbers reserved for clients, indicates whether client slot is used.

=== message ===
Message associated with the entity (e.g. "Side door" for side door objective entity). nil for player entities.

=== origin ===
* for living player and some visible entities (like tank), position in map
* dosen't work for spectating player

=== s.origin ===
* for spectator in freelook, the spectator's position

=== pers.netname ===
For player, their nickname.

=== ps.ammo ===
Array. For each weapon, tells how many bullets/whatever the player has in spare clips.

=== ps.ammoclip ===
Array. For each weapon, tells how many bullets/whatever the player has in current clip.

=== sess.sessionTeam ===
Player's team:
* 1 = red
* 2 = blue
* 3 = spectator

=== sess.spectatorState ===
* 1 = free spectator
* 2 = spectator following another player

=== sess.spectatorClient ===
Entity number of player the spectator is following.

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

Talk:Fieldname

2007-05-24T22:13:55Z

ReyalP: /* ps.velocity */

someone feel free to make this table pretty.

Roger that. --Rookie One 03:31, 13 November 2005 (PST)

// Comment by Deus 13:22, 13 November 2005 (CET)
I liked the former one more.
I thought about some colorisation like red for readonly and green for r/w. maybe some mouseover stuff, or just the one tr light the next darker, to have a better viewability ?
// End of Deus Comment

Alright, I'll restore the previous borders and add some colour. --Rookie One 04:33, 13 November 2005 (PST)

That was just my suggestion. Maybe this differs from banis view of beautification :) --Deus 04:46, 13 November 2005 (PST)

== use of color...bad! ==

use of color to convey specific data (ro/rw) is bad. red/green is the worst possible choice too :) 
consider someone who is colorblind. check the article via http://colorfilter.wickline.org/ to see how bad this is.
but it looks bad even for those who aren't color blind :P

Yeah, reyalP, I also thought it's weird to initialize the table like that, but wasn't sure. ;) --Rookie One 06:26, 17 November 2005 (PST)

== Question ==

Is there a article describing each fieldname?
: No. To understand what they do, you need to look at the ET gamecode. Some Quake3 coding articles might also help you. It would be nice if someone documented some of the more common/interesting ones, but documenting them all would be a huge task. In the future, if you are looking for something, you can see all the pages in the wiki at [[Special:Allpages]]. If you have questions about specific fields, you can try asking on the [http://bani.anime.net/banimod/forums/viewforum.php?f=17 ETPro modding forum] Also, please sign your comments with <nowiki>~~~~</nowiki>
::- [[User:ReyalP|ReyalP]] 18:53, 15 May 2006 (PDT)
::I added descriptions of fields I *think* I know meaning of. Most times it's a wild guess based on my observations tho. Hope someone will correct my mistakes and add some more. -[[User:Major Zeman|Major Zeman]] 02:28, 20 May 2007 (PDT)

I ve waited for a week and my account is still not activated by admin :<

[[User:Kotoko|Kotoko]] 00:01, 16 May 2006 (PDT)

== making 'flags' writable ==

What about making the field ''flags'' read-write? I run a trickjump server and it would be very handy if I could give people the nofatigue flag so they never go out of stamina.
:Maybe [[User:Nano|Nano]]'s adrenaline.lua is a solution for you? (yeah I know responding to one year old commants again) -[[User:Major Zeman|Major Zeman]] 09:44, 21 May 2007 (PDT)

== ps.velocity ==
Any chance of getting ps.velocity field as R/W in some next etpro release? -[[User:Major Zeman|Major Zeman]] 09:44, 21 May 2007 (PDT)
: Yes, this will most likely be in the next release. The lua API talk page is the place to request features BTW. -15:13, 24 May 2007 (PDT)

User talk:ReyalP

2007-05-07T00:05:20Z

ReyalP: /* unref? */

in your etconst it says at top : <code>-- [23:10] <|Rain|> 2 became CS_ETPRO_INFO instead of CS_MUSIC, because I needed the version info before any more configstrings were parsed
-- [23:10] <|Rain|> and CS_MUSIC moved up to 53<code> but u still got CS_MUSIC at 2 --2good

:yup. Since I had no idea what you'd do with either of those config strings, I just left things as I got them found them in the etmain sdk. [[User:ReyalP|ReyalP]]

three [[User:ReyalP|ReyalP]] or [[User:ReyalP|ReyalP]] 13:25, 16 November 2005 (PST) four ?

thats nice but oh well ok i dont care i dont use it myself its a lityle this i made out of my debuglib that was a print function that works like a printf you add variables and dont care but it is since it will check each variable first [[User:=FF=im2good4u|=FF=Im2good4u]] 13:45, 16 November 2005 (PST)

== autoref.lua ==

I '''<3''' this module. Thanks. --[[User:Ouroboro|ouroboro]] 16:50, 12 June 2006 (PDT)

== unref? ==

Hi, don't you know about any way, rcon or lua, how to unref a client that has reffed themselves with password? You can't unref them from ref, neither through /rcon ref unreferee [num].

I tired with lua, I can make the client think they got reffed/unreffed using configstrings (keys "ref" and "p"), but the server still sees no change in the client status. - [[User:Major Zeman|Major Zeman]] 07:00, 6 May 2007 (PDT)
:kick them and change the ref pass ?
:you could also try changing sess.referee - [[User:ReyalP|ReyalP]] 15:02, 6 May 2007 (PDT)
::lol, that's basically the "solution" I took. I think I tried sess.referee too, I might try to put it all together later. Thanks anyways :) - [[User:Major Zeman|Major Zeman]] 15:30, 6 May 2007 (PDT)
:::you may be able to get some insight by looking at the ref commands in the ET SDK. Of course, etpro doesn't do everything exactly the same way. - [[User:ReyalP|ReyalP]] 17:05, 6 May 2007 (PDT)

User talk:ReyalP

2007-05-06T22:02:14Z

ReyalP:

in your etconst it says at top : <code>-- [23:10] <|Rain|> 2 became CS_ETPRO_INFO instead of CS_MUSIC, because I needed the version info before any more configstrings were parsed
-- [23:10] <|Rain|> and CS_MUSIC moved up to 53<code> but u still got CS_MUSIC at 2 --2good

:yup. Since I had no idea what you'd do with either of those config strings, I just left things as I got them found them in the etmain sdk. [[User:ReyalP|ReyalP]]

three [[User:ReyalP|ReyalP]] or [[User:ReyalP|ReyalP]] 13:25, 16 November 2005 (PST) four ?

thats nice but oh well ok i dont care i dont use it myself its a lityle this i made out of my debuglib that was a print function that works like a printf you add variables and dont care but it is since it will check each variable first [[User:=FF=im2good4u|=FF=Im2good4u]] 13:45, 16 November 2005 (PST)

== autoref.lua ==

I '''<3''' this module. Thanks. --[[User:Ouroboro|ouroboro]] 16:50, 12 June 2006 (PDT)

== unref? ==

Hi, don't you know about any way, rcon or lua, how to unref a client that has reffed themselves with password? You can't unref them from ref, neither through /rcon ref unreferee [num].

I tired with lua, I can make the client think they got reffed/unreffed using configstrings (keys "ref" and "p"), but the server still sees no change in the client status.
:- [[User:Major Zeman|Major Zeman]] 07:00, 6 May 2007 (PDT)
:kick them and change the ref pass ?
:you could also try changing sess.referee - [[User:ReyalP|ReyalP]] 15:02, 6 May 2007 (PDT)

User:ReyalP

2007-04-27T20:33:06Z

ReyalP: /* ETPro/Lua libraries, modules and examples */ sploits

http://www.sonic.net/~rfm/et/bananet.png
==ETPro/Lua libraries, modules and examples==
;Follow the link to the source code for more detailed information about each item.
;Exploit fixes [http://bani.anime.net/banimod/forums/viewtopic.php?t=6777 see this thread for details]
*[http://www.collectivecomputing.com/~reed/et/lua/wsfix.lua wsfix.lua] prevent crash or information disclosure via the ws command
*[http://www.collectivecomputing.com/~reed/et/lua/userinfocheck.lua userinfocheck.lua] perform some sanity checking on userinfo
*[http://www.collectivecomputing.com/~reed/et/lua/guidcheck.lua guidcheck.lua] prevent crash from etpro guid hacks
*[http://www.collectivecomputing.com/~reed/et/lua/fakeplimit.lua fakeplimit.lua] limit number of connections from a given IP. This should not be used without userinfocheck.lua, as the IP might be spoofed otherwise.
*[http://www.collectivecomputing.com/~reed/et/lua/combinedfixes.lua combinedfixes.lua] all of the above merged into a single module.
;Older stuff
*[http://www.sonic.net/~rfm/et/lua/autoref.lua autoref.lua] lua module to give people referee status, based on IP or PB GUID. Requires etconst.lua WARNING: The GUID this uses might be spoofed by malicious clients. The IP might also be spoofed if you don't use userinfocheck.lua
*[http://www.sonic.net/~rfm/et/lua/etconst.lua etconst.lua] some common constants from the et header files, converted to lua.
*[http://www.sonic.net/~rfm/et/lua/luacon.lua luacon.lua] library provides a lua command in the server console, for interactive testing.
*[http://www.sonic.net/~rfm/et/lua/luaconmod.lua luaconmod.lua] runs luacon as module.
*[http://www.sonic.net/~rfm/et/lua/cvarobj.lua cvarobj.lua] metamethods example. Allows using cvars like normal lua variables.
*[http://www.sonic.net/~rfm/et/lua/dumptable.lua dumptable.lua] recursively display contents of a table.
*[http://www.sonic.net/~rfm/et/lua/noteamflood.lua noteamflood.lua] prevent people from flooding "team" commands. No longer needed with etpro 3.2.6.

==Map editing stuff==
; tjlview, a plugin for viewing [[TrickJumpLines]] in [http://www.qeradiant.com/ GtkRadiant 1.4]
* [http://www.sonic.net/~rfm/et/readme_tjlview-a0.1.txt readme]
* [http://www.sonic.net/~rfm/et/tjlview-a0.1-src.zip source]
* [http://www.sonic.net/~rfm/et/tjlview-linux.zip windows and linux binaries]
; readme for bkgrnd2d plugin (the plugin itself is included in GTKRadiant 1.4)
* [http://www.sonic.net/~rfm/et/readme_bkgrnd2d-b0.25.txt readme_bkgrnd2d-b0.25.txt]

==Contact==
* '''email''' reyalp (at) gmail.com 
* '''[[IRC]]''' #etpro on freenode or quakenet, #n-warriors on gamesurge

[[Category:ETPro:Mods]]

SemiAdmin

2007-04-24T02:23:17Z

ReyalP: /* b_semiAdminCmds# */ cvars and cfgs

'''Semi Admins''' are admins who can perform only certain commands without having full referee or rcon access.
The commands each semiadmin can perform and the password each needs for logging in are defined via cvars.

==cvar overview==

{| cellspacing="2" cellpadding="2"
|- style="background: #CCCCFF;"
!width="200"|cvar
!width="100"|default
!description
|- style="background-color: #F4F4F4;"
|<tt style="color: green;">b_semiAdminLevels</tt>
|align="center"|0
|The number of semiadmin levels.
|- style="background-color: #EEEEEE;"
|<tt style="color: green;">b_semiAdminPass#</tt>
|align="center" style="color: gray;"|undefined
|Defines the password for each semiadmin level, where # is the level to set the password for.
|- style="background-color: #F4F4F4;"
|<tt style="color:green;">b_semiAdminCmds#</tt>
|align="center" style="color: gray;"|undefined
|A space-seperated list of commands a level # semiadmin can use.
|}

==cvar descriptions==

===b_semiAdminLevels===

Defines the number of semiadmin levels to use. Valid values are 0–999. The default value of 0 disables semiadmin functionality.
set b_semiAdminLevels 3 // you will have 3 semiadmin levels

===b_semiAdminPass#===

Sets the password for each semiadmin level. # is the level to set the password for. Every level must have its own password.
set b_semiAdminPass1 "foo" // foo is the password to log in as a level 1 semiadmin

===b_semiAdminCmds#===

A space-seperated list of commands a semiadmin with level # is allowed to perform. Be carefull with commands like <code>set</code>, <code>exec</code>, <code>vstr</code> etc.
set b_semiAdminCmds1 "clientkick say kick"

In addition to built in commands, you can permit semi-admins to exec .cfg files or vstr cvars.
If blah is in b_semiAdminCmds# <code>sa blah</code> looks for a file named blah.cfg and then a cvar named blah.cvar, and finally a builtin command named blah.

==Example configuration==

set b_semiAdminLevels "3" // we will have 3 semiadmin levels
set b_semiAdminPass1 "foo" // foo is the password for level 1
set b_semiAdminPass2 "bar" // the password for level 2
set b_semiAdminPass3 "foobar"
set b_semiAdminPass4 "wrong" // will not work since we have only defined 3 semiadmin levels
set b_semiAdminCmds1 "say map_restart"
set b_semiAdminCmds2 "kick say clientkick g_friendyfire" // level 2 is allowed to change the cvar g_friendlyfire
set b_semiAdminCmds3 "set kick clientkick exec"

The above lines will create 3 semiadmin levels. Each level has its own password and an own list of commands which can be used by a semiadmin with that level.

==Usage of the semiadmin functionality==

To log in as a semiadmin use the command <code>/semiadminlogin <password></code> or the shorter one <code>/sal <password></code>. Performing a command is done via the commands <code>/semiadmin <command></code> or <code>/sa <command></code>.

Some commands send information back, like the rcon command <code>status</code>. These information will not be sent back to the semiadmin.

Typing <code>/sa</code> without any parameters will give you a list of commands you’re allowed to perform.

/sal baz // login with the password baz
/semiadmin say Hello all // perform the command "say Hello all"
/sa // shows you a list of commands you’re able to perform

[[Category:ETPro]]

User talk:Major Zeman

2007-04-21T01:32:12Z

ReyalP:

Just a quick note: the cl_guid in userinfo is pretty easy to spoof. -[[User:ReyalP|ReyalP]] 15:18, 20 April 2007 (PDT)

:- Is that the etpro one or the pb's one? Thought it was pb's one :S (fortunately I don't use it for anything important) Any suggestions what would be better there? Anyways, thanks for the warning --[[User:Major Zeman|Major Zeman]] 15:28, 20 April 2007 (PDT)
:: cl_guid is the pb GUID. If you are just using it for stats restore or something like that, it's not an issue. If you are using it for authentication, you should be aware of this. You could get it from sending PB commands (which get it internally rather than from userinfo AFAIK) to the console and reading it back from the log file, but this is a serious pain. It is also still possible to spoof, although much harder. Even if you are using it for authentication, to steal someone elses ID would require knowing their full PB GUID, which isn't normally visible to other players. Of course, server logs and PB screenshots can leak this information out. -[[User:ReyalP|ReyalP]] 18:32, 20 April 2007 (PDT)

User talk:Major Zeman

2007-04-20T22:18:57Z

ReyalP:

Just a quick note: the cl_guid in userinfo is pretty easy to spoof. -[[User:ReyalP|ReyalP]] 15:18, 20 April 2007 (PDT)

ETTV:Viewer's Guide

2007-04-04T04:28:14Z

ReyalP: /* Known Issues */ support requests don't go here.

== ETTV Viewer's Guide ==
=== Introduction ===
ETTV is a modification that allows anybody to spectate Enemy Territory matches without actually being on the server the teams are playing on. The purpose is so that you have have thousands of people all able to watch an exciting match live, without being able to interfere or otherwise cause problems with the match.

The ETTV modification is supplied within the ETPro modification, you do not need any further modification unless you intend to run an [[ETTV:Server_Configuration|ETTV Server]].

=== Watching ETTV ===
Simply connect to an ETTV server like any other Enemy Territory server. Once you are connected it will look and feel very much like you are in spectator mode on any normal server.

There are some issues which occur frequently enough to make it worth noting here, however.

* ETTV servers frequently do not allow clients (that's you/your game) to auto-download any missing files. You should try to ensure you '''have the correct patch, modification and custom map versions before you join'''. This is usually, but not necessarily the latest official version. If you do not have the correct versions you may be unable to join, or disconnected at some point during viewing.

* '''Do not be concerned about interfering with the match''', you cant. The ETTV server you join is essentially playing a live demo of the match which is actually being played on another server. You can spectate freely and talk crap with the other viewers on the same ETTV server, thats it. Chat from ETTV viewers is distinguished from chat in the match by the red "ETTV" preceding it.

* '''Connecting via IP address''' (command-line or console) is identical to any other Enemy Territory server. If you've been given the IP address of an ETTV server and are wondering what to do with it, open the console (usually by pressing the key under ESCape, often the ~ or ` key) and use the following command (including the forwardslash) - <tt>/connect ip.add.ress:port</tt>
:(for example: <tt>/connect 62.75.178.112:27962</tt>)

=== Additional Controls ===
* cycle between everybody on the server (who shows up on the scoresheet)
:fire <tt><Left Mouse button></tt>
* cycle following only objective carriers
:Prone + (fire / altweapon) <tt><X + LeftMouse></tt>
* cycle following only spectators / shoutcasters
:Zoom + (fire / altweapon) <tt><nowiki></nowiki></tt>
* Jump directly to following a player in view
: Press activate while pointing crosshair at player
* return to free floating mode.
: Press jump or activate <tt><Spacebar></tt>

=== Generally Useful Tips ===
* Chats from other ETTV spectators can be hidden with the console command <tt>/tvchat off</tt>, and re-enabled with <tt>/tvchat on</tt>. All chat done on ETTV won't be seen on the game server (luckily). If certain chatters start to irritate you, you can easily ignore specific people with the <tt>/ignore</tt> command and can use the <tt>/unignore</tt> command to show their chat messages again.

* To spectate a specific player through their eyes, open console and put in the command <tt>/players</tt>, and notice the player number. Now just <tt>/follow x</tt>. If you're new to Enemy Territory, you might find it most entertaining to follow a shoutcaster, if there is one.

* Viewing ETTV in a window can be convenient while you find other IP's, talk in IRC, or access WinAmp, for example. To do this, you can go to the options screen and set a resolution which is smaller than your desktop screen resolution, and then select windowed mode. Alternatively, enter <tt>/r_mode 3</tt> into console, and then hit ALT+Enter.

* Normal cvar restrictions dont apply when viewing demos, nor do they (usually) when viewing ETTV. This is OK because you're not playing against anyone. Several leagues remove the foliage (all the grassy stuff) on Radar because it hurts performance and, some say, isnt good for competitive gaming. As an ETTV viewer you can remove it via console: <tt>/r_drawfoliage 0</tt>. To further incrase performance you can remove wolffog (an effect which "adds" fog to the map, sometimes restricting the viewing distance [e.g. Railgun]) by setting <tt>r_wolffog 0</tt>. You might want to ensure that is reset to 1 before you join a normal gameserver however.

* ETTV is generally not live; normally a few minute long delay is added so competing teams cannot have another member watching and sending participants advantagous information.

== Shoutcasts ==
A [http://en.wikipedia.org/wiki/Shoutcast shoutcast] is essentially a match commentary, broadcast over something akin to internet radio. The shoutcaster is usually someone heavily involved with the ET community and listening to the shoutcast greatly enhances the entertainment value of ETTV.

A shoutcast is completely seperate from ETTV however, to listen to a shoutcast you will need to open the URL with a suitable program - [http://winamp.com/ WinAmp] being one of many such programs. The shoutcast URL is often available at the same place you found the ETTV details for the match you want to watch.

Like ETTV, shoutcasts are usually not totally live - normally a few minutes delay is added so competing teams cannot have another member watching or listening in and sending participants advantagous information. Typically ETTV has a longer delay than the shoutcast does, so the result is ETTV and shoutcast are out of sync.

Fortunately it isnt the other way around, because you can pause WinAmp to syncronise the two. Simply listen for some event in the shoutcast (often shoutcaster will read out the time on the clock for this purpose, or you can listen for event's like 'FIGHT!' or 'dynamite planted') and immediately hit pause. When the event occurs in ETTV, hit play again. This can be easier if you view ETTV in windowed mode, also if you make a mistake and pause WinAmp for too long, reconnect to the shoutcast URL.

== Replaying ETTV demos on a local Windows server ==

If you have ETTV Demo files (*.tv84), you can watch them locally on your windows machine. in order to do so, you will need a ETTV-Server. Download the latest version (currently: http://bani.anime.net/banimod/forums/viewtopic.php?t=6529) and proceed with the following steps:

* Extract all files except tvgame.mp.i386.(so|dll) into your "Wolfenstein - Enemy Territory" root directory (not etmain).
* The tvgame.mp.i386.(so|dll) file goes into the etpro directory.
* Put the *.tv_84 files in your etpro\demos directory
* Create a shortcut to ETTV.exe (Right click in explorer windows, "new..." -> "Shortcut").
* Change the program call in the shortcut (Right click, "Properties") to: '"path\ettv.exe" +set fs_game etpro +set ettv_autoplay 1 +demo demo0000'

When you double click on the shortcut, ETTV should come up displaying a console and starting the playback. Note that the demo files are required to be named like demo0000.tv_84, demo0001.tv_84, etc. in order to work like this. The server will autoplay all demos in successive order. You can now start your ET and connect to your local server (choose "Internet Play", then "connect to IP" 127.0.0.1.

==== Known Issues ====
You have to install the complete etpro package for servers - the pk3 file that clients have is not enough.

You may encounter MAX_GAMESTATE_CHARS while playing back demos. To prevent this, make sure only the .pk3 files actually required to play the demo are installed, and make sure things like serverinfo cvars, motds etc are as short as possible. If you still encounter this after taking these steps, posting on the [http://bani.anime.net/banimod/forums/viewforum.php?f=18 ETTV forum] is suggested.

This short How-To was written on request for gamestv.org, they are hereby permitted to use this text on their own site.

== External Links ==
* [http://www.gamestv.org/ GamesTV.org] is an ETTV listings site.
* [http://www.radioitg.com/schedule.php Radio iTG's schedule] is a source of shoutcasts.
* [http://www.gamestah.com/ Gamestah] is a source of Australian shoutcasts.

[[Category:ETTV]]

Fieldname

2007-03-06T03:55:44Z

ReyalP: make boolean description more accurate

__NOEDITSECTION__
==Entity Fieldnames==
List of fields supported by [[Lua Mod API#entities|et.gentity_get() and et.gentity_set()]] functions 
<pitatable columns=3 headlines="field;type;access" widths="180;120;60" headerfontcolor="#FFFFFF">
activator;entity;RO;
chain;entity;RW;
classname;string;RW;
client.inactivityTime;integer;RW;
client.inactivityWarning;qboolean;RW;
clipmask;integer;?;
closespeed;float;RW;
count;integer;RW;
count2;integer;RW;
damage;integer;RW;
deathType;meansOfDeath_t;RW;
delay;float;RW;
dl_atten;integer;RW;
dl_color;vec3;RW;
dl_shader;string;RO;
dl_stylestring;string;RO;
duration;float;RW;
end_size;integer;RW;
enemy;entity;RW;
flags;bitflag;RO;
harc;float;RW;
health;integer;RW;
inuse;qboolean;RO;
isProp;qboolean;RO;
item;string;RW;
key;integer;RW;
message;string;RW;
methodOfDeath;integer;RW;
mg42BaseEnt;integer;RW;
missionLevel;integer;RW;
model;string;RO;
model2;string;RO;
nextTrain;entity;RW;
noise_index;integer;RW;
origin;vec3;RW;
pers.connected;connected_t;?;
pers.netname;string;?;
pers.localClient;qboolean;?;
pers.initialSpawn;qboolean;?;
pers.enterTime;integer;?;
pers.connectTime;integer;?;
pers.teamState.state;teamstatestate_t;?;
pers.voteCount;integer;?;
pers.teamVoteCount;integer;?;
pers.complaints;integer;?;
pers.complaintClient;integer;?;
pers.complaintEndTime;integer;?;
pers.lastReinforceTime;integer;?;
pers.applicationClient;integer;?;
pers.applicationEndTime;integer;?;
pers.invitationClient;integer;?;
pers.invitationEndTime;integer;?;
pers.propositionClient;integer;?;
pers.propositionClient2;integer;?;
pers.propositionEndTime;integer;?;
pers.autofireteamEndTime;integer;?;
pers.autofireteamCreateEndTime;integer;?;
pers.autofireteamJoinEndTime;integer;?;
pers.lastSpawnTime;integer;?;
pers.ready;qboolean;?;
prevTrain;entity;RW;
props_frame_state;integer;RO;
ps.stats;integer array;RW;
ps.persistant;integer array;RW;
ps.ping;integer;?;
ps.powerups;integer array;RW;
ps.ammo;integer array;RW;
ps.ammoclip;integer array;RW;
r.absmax;vec3;RO;
r.absmin;vec3;RO;
r.bmodel;qboolean;RO;
r.contents;integer;RW;
r.currentAngles;vec3;RW;
r.currentOrigin;vec3;RW;
r.eventTime;integer;RW;
r.linkcount;integer;RO;
r.linked;qboolean;RO;
r.maxs;vec3;RW;
r.mins;vec3;RW;
r.ownerNum;integer;RW;
r.singleClient;integer;RW;
r.svFlags;integer;RW;
r.worldflags;integer;RO;
radius;integer;RW;
random;float;RW;
rotate;vec3;RW;
s.angles;vec3;RW;
s.angles2;vec3;RW;
s.apos;trajectory;RW;
s.clientNum;integer;RW;
s.constantLight;integer;RW;
s.density;integer;RW;
s.dl_intensity;integer;RW;
s.dmgFlags;integer;RW;
s.eFlags;integer;RW;
s.eType;integer;?;
s.effect1Time;integer;RW;
s.effect2Time;integer;RW;
s.effect3Time;integer;RW;
s.frame;integer;RW;
s.groundEntityNum;integer;RO;
s.loopSound;integer;RW;
s.modelindex;integer;RW;
s.modelindex2;integer;RW;
s.number;integer;RO;
s.onFireEnd;integer;RW;
s.onFireStart;integer;RW;
s.origin;vec3;?;
s.origin2;vec3;?;
s.pos;trajectory;RW;
s.powerups;integer;RO;
s.solid;integer;RW;
s.teamNum;integer;RW;
s.time;integer;RW;
s.time2;integer;RW;
s.weapon;integer;RO;
scriptName;string;RO;
sess.sessionTeam;team_t;RW;
sess.spectatorTime;integer;RW;
sess.spectatorState;spectatorState_t;RW;
sess.spectatorClient;integer;RW;
sess.latchSpectatorClient;integer;RW;
sess.playerType;integer;RW;
sess.playerWeapon;integer;RW;
sess.playerWeapon2;integer;RW;
sess.spawnObjectiveIndex;integer;RW;
sess.latchPlayerType;integer;RW;
sess.latchPlayerWeapon;integer;RW;
sess.latchPlayerWeapon2;integer;RW;
sess.damage_given;integer;RW;
sess.damage_received;integer;RW;
sess.deaths;integer;RW;
sess.game_points;integer;RW;
sess.gibs;integer;RW;
sess.kills;integer;RW;
sess.medals;integer array;RW;
sess.muted;qboolean;RW;
sess.rank;integer;RW;
sess.referee;integer;RW;
sess.rounds;integer;RW;
sess.semiadmin;integer;RW;
sess.skill;integer array;RW;
sess.spec_invite;integer;RW;
sess.spec_team;integer;RW;
sess.suicides;integer;RW;
sess.team_damage;integer;RW;
sess.team_kills;integer;RW;
sess.team_received;integer;RW;
sess.aWeaponStats;weapon_stat_t;RW;
spawnflags;integer;RO;
spawnitem;string;RO;
speed;float;RW;
splashDamage;integer;RW;
splashMethodOfDeath;integer;RW;
splashRadius;integer;RW;
start_size;integer;RW;
tagName;string;RO;
tagParent;entity;RW;
takedamage;boolean;RW;
tankLink;entity;RW;
target;string;RW;
TargetAngles;vec3;RW;
TargetFlag;integer;RO;
targetname;string;RO;
teamchain;entity;RW;
teammaster;entity;RW;
track;string;RO;
varc;float;RW;
wait;float;RW;
waterlevel;integer;RO;
watertype;integer;RO;
</pitatable>
:''note'': all the sess.* fields will return nil unless the entity is associated with client slot < sv_maxclients.
:''note'': all array variables need to be get or set with an additional parameter.

----

==ET variable types==

===qboolean===
:a '''qboolean''' is a boolean value.
:0 is represented by the lua value false
:1 is represented by the lua value true

----

===vec3===
:a '''vec3_t''' is a 3-element array of numbers (C definition: typedef float vec3_t[3];). It is usually used to store and process coordinates in 3D space. 
:In etpro-lua a vector is an array (table indexed by integers) containing 3 numbers. It can be accessed by
:doing:
<pre>
origin = et.gentity_get(entNum,"r.currentOrigin") --a vec3 value
x,y,z = origin[1],origin[2],origin[3]</pre>

----

===array===
:The fields listed as having type '''array''' represent an entity value which is an array. Individual elements of the array are accessed by passing the desired index in the ''arrayindex'' argument to the et.gentity_get and et.gentity_set functions. Valid array indexes are integers from 0 up to some field specific maximum. The ''arrayindex'' argument is '''required''' when accessing array type fields, so only one element of an array can be accessed in a given call to the gentity_* functions. 

----

===trajectory===
:a '''trajectory''' is returned as a lua table described below
<pre>{
trDuration = <number>, --- int
trTime = <number>, -- int
trType = <number>, -- see below for allowed values
trBase = <vec3_t>, -- vec3, as described above
trDelta = <vec3_t> -- also a vec3
}</pre>
: the allowed values for trType (along with the enum names and original comments from the ET source), are as follows. Note
: that not all values make sense for all entity types
<pitatable columns=3 headlines="number;type;discription" widths="40;160;450" headerfontcolor="#FFFFFF">
1;TR_STATIONARY;
2;TR_INTERPOLATE;non-parametric, but interpolate between snapshots;
3;TR_LINEAR;
4;TR_LINEAR_STOP;
5;TR_LINEAR_STOP_BACK;reverse movement can be different than forward;
6;TR_SINE;value = base + sin( time / duration ) * delta;
7;TR_GRAVITY;
8;TR_GRAVITY_LOW;
9;TR_GRAVITY_FLOAT;super low grav with no gravity acceleration;
10;TR_GRAVITY_PAUSED;has stopped, but trace to see if it should be switched back to TR_GRAVITY;
11;TR_ACCELERATE;
12;TR_DECCELERATE;
13;TR_SPLINE;
14;TR_LINEAR_PATH;
</pitatable>

----

===entity===
:The fields listed as having type '''enitity''' return an entity number or nil. Entity numbers are integers from 0 through 1023. Some of the entity numbers have special meanings:
:0 - (sv_privateclients - 1) are reserved for clients who connect with the private slot password
:0 - 63 are reserved for clients. A client's entity number is also its client number (as shown by /players for example)
:1022 is the '''worldspawn''' entity
:1023 is '''ENTITYNUM_NONE''' which is used instead of null in C under some circumstances to indicate no entity. This is needed where an entity number will be passed over the network.
:''Note'': Some other fields not listed as type 'entity' may take an entity number value. '''mg42BaseEnt''' and '''s.number''' are examples. 

----

===meansOfDeath===
:a '''meansOfDeath_t''' is a number indicating the [[etdamage|Method of Death]] Click [[etdamage|here]] for a list with possible value's

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

Lua Mod API

2007-02-28T05:01:43Z

ReyalP: et_ClientUserinfoChanged note, old et.G_TempEntity warning

__NOEDITSECTION__
[[ETPro]] now supports server-side mods via the [http://www.lua.org/ Lua] scripting language. For more information about Lua, visit the [http://www.lua.org/manual/5.0/ Reference manual], the online edition of the book [http://www.lua.org/pil/ Programming in Lua] or the [http://lua-users.org/wiki/ lua-users wiki].

ETPro has an embedded Lua 5.0.2 interpreter, and if present will load user-defined scripts from the ETPro directory. It also provides an "et" library of function calls for Lua that allow access to the server engine, and provides callbacks so a server side mod may trigger on specific server events.

The following standard Lua libraries are initialized by default and available to ETPro Lua scripts:
[http://www.lua.org/manual/5.0/manual.html#5.1 basic], [http://www.lua.org/manual/5.0/manual.html#5.4 table], [http://www.lua.org/manual/5.0/manual.html#5.6 i/o], [http://www.lua.org/manual/5.0/manual.html#5.7 os] (available features vary depending on your OS), [http://www.lua.org/manual/5.0/manual.html#5.3 string], [http://www.lua.org/manual/5.0/manual.html#5.5 math].

A list of ETPro mods can be found [[:Category:ETPro:Mods|here]].

A tutorial about ETPro Lua scripting can be found [[Lua Tutorials|here]].

API requests can be discussed at the [[Talk:Lua_Mod_API|Lua Mod API talk page]].

==client commands==
===lua_status===
:lists all currently loaded lua modules.
:''lua mods cannot override this client command.''

==server commands==
===lua_status===
:lists all currently loaded lua modules.

==cvars==
===lua_modules===
:(default "", disabled)
:space separated list of lua modules for ETPro to load. modules will be run in the order listed.

===lua_allowedmodules===
:(default "", disabled)
:if set, only lua modules with the matching sha1 signatures listed in this cvar will be allowed to load.
 
:changing either cvar will cause all currently loaded modules to :quit and be unloaded until the next map_restart. 
 

==et library calls==

===modules===
et.RegisterModname( '''modname''' )
:Registers a descriptive string '''modname''' for this mod.
'''vmnumber''' = et.FindSelf()
:Returns a number indicating the VM slot the current mod is loaded into.
'''modname''', '''signature''' = et.FindMod( '''vmnumber''' )
:Returns the '''modname''' and sha1 '''signature''' for the mod loaded in the VM slot '''vmnumber'''. Returns nil, nil if the VM slot is invalid.
'''success''' = et.IPCSend( '''vmnumber''', '''message''' )
:Sends the string '''message''' to the mod in the VM slot indicated by '''vmnumber'''. The mod receiving '''message''' must have an ''et_IPCReceive()'' callback. If the message is successfully sent, '''success''' will be 1. On failure it will be 0. See the [[Lua:IPC|Lua IPC]] page for a simple example.
 

===printing===
et.G_Print( '''text''' )
:Prints the string '''text''' to the server console.
et.G_LogPrint( '''text''' )
:Prints the string '''text''' to the server console and writes it to the server log.
 

===argument handling===
These functions are to be used within the [[#commands|command callback functions]]. 
'''args''' = et.ConcatArgs( '''index''' )
:Returns all arguments beginning from '''index''' concatenated into a single string '''args'''
'''argcount''' = et.trap_Argc()
:Returns a number indicating the number of command line arguments in the command buffer.
'''arg''' = et.trap_Argv( '''argnum''' )
:Returns the contents of the command line argument '''argnum'''.
 

===cvars===
'''cvarvalue''' = et.trap_Cvar_Get( '''cvarname''' )
:Returns the value of the cvar '''cvarname''' as a string. If there is no cvar named '''cvarname''', returns a zero length string.
et.trap_Cvar_Set( '''cvarname''', '''cvarvalue''' )
:Sets the cvar '''cvarname''' to '''cvarvalue'''
 

===configstrings===
'''configstringvalue''' = et.trap_GetConfigstring( '''index''' )
:Returns the string '''configstringvalue''' containing the contents of the configstring '''index'''
et.trap_SetConfigstring( '''index''', '''configstringvalue''' )
:Sets the configstring '''index''' to the string '''configstringvalue'''
 

===server===
et.trap_SendConsoleCommand( '''when''', '''command''' )
:Sends the command '''command''' to the server console, to be executed '''when''' (see et.EXEC_* constants)
 

===clients===
et.trap_DropClient( '''clientnum''', '''reason''', '''ban_time''' )
:Disconnects '''clientnum''' from the server, with descriptive string '''reason''' reported to clients. '''ban_time''' is the time in seconds to ban the client from the server. '''ban_time''' is optional and may be entirely omitted, in which case the ban time defaults to the cvar ''b_defaultbantime''
et.trap_SendServerCommand( '''clientnum''', '''[[SendServerCommand|command]]''' )
:Sends the command '''[[SendServerCommand|command]]''' to the client '''clientnum'''. If '''clientnum''' is -1, the '''[[SendServerCommand|command]]''' is broadcast to all connected clients.
et.G_Say( '''clientNum''', '''mode''', '''text''' )
:Sends a chat command on behalf of client '''clientNum''' with the mode '''mode''' (see et.SAY_* constants) and chat text '''text'''.
et.ClientUserinfoChanged( '''clientNum''' )
:Loads the new [[Userinfo]] of '''clientNum''' and stores it in the configstring and client variables
 

===userinfo===
'''userinfo''' = et.trap_GetUserinfo( '''clientnum''' )
:Returns the contents of the [[Userinfo]] string for the client '''clientnum'''
et.trap_SetUserinfo( '''clientnum''', '''userinfo''' )
:Sets the [[Userinfo]] string for the client '''clientnum''' to '''userinfo'''
 

===string utility functions===
'''infostring''' = et.Info_RemoveKey( '''infostring''', '''key''' )
:Removes key '''key''' from infostring '''infostring''' and returns the modified infostring.
'''infostring''' = et.Info_SetValueForKey( '''infostring''', '''key''', '''value''' )
:Sets the key '''key''' in the infostring '''infostring''' to '''value''' and returns the modified infostring. If '''value''' is an empty string, '''key''' is removed from the string.
'''keyvalue''' = et.Info_ValueForKey( '''infostring''', '''key''' )
:Returns the value of the key '''key''' in the infostring '''infostring'''. If '''key''' is not present in the string, an empty string is returned.
'''cleanstring''' = et.Q_CleanStr( '''string''' )
:Returns '''string''' stripped of all color codes
 

===ET filesystem===
'''fd''', '''len''' = et.trap_FS_FOpenFile( '''filename''', '''mode''' )
:Attempts to open the file '''filename''' with the access mode '''mode''' (see et.FS_ constants). Returns the filedescriptor '''fd''' and file length '''len'''. On error, '''len''' returns -1.
'''filedata''' = et.trap_FS_Read( fd, count )
:Reads '''count''' bytes from filedescriptor '''fd'''.
'''count''' = et.trap_FS_Write( '''filedata''', '''count''', '''fd''' )
:Attempts to write '''count''' bytes of '''filedata''' to filedescriptor '''fd'''. Returns number of bytes successfully written.
et.trap_FS_Rename( '''oldname''', '''newname''' )
:Renames file '''oldname''' to '''newname'''.
et.trap_FS_FCloseFile( '''fd''' )
:Closes filedescriptor '''fd'''
 

===indexes===
'''soundindex''' = et.G_SoundIndex( '''filename''' )
:Returns an index to the soundfile indicated by '''filename'''
'''modelindex''' = et.G_ModelIndex( '''filename''' )
:Returns an index to the model indicated by '''filename'''
 

===sound===
et.G_globalSound( '''sound''' )
:Plays the global sound indicated by the filename '''sound'''.
et.G_Sound( '''entnum''', '''soundindex''' )
:Plays the sound '''soundindex''' at the location of entity '''entnum'''
 

===miscellaneous===
'''milliseconds''' = et.trap_Milliseconds()
:Returns a number indicating the current server time in milliseconds.
et.G_Damage( '''target''', '''inflictor''', '''attacker''', '''damage''', '''[[etdamage|dflags]]''', '''[[etdamage|mod]]''' )
:Does '''damage''' amount of damage on '''target''' inflicted by '''inflictor''' and cased by '''attacker'''
:'''target''', '''inflictor''', '''attacker''' are entity numbers
:'''[[etdamage|dflags]]''' is a [[Bitmask-cvar|bitflag]] number to decide how the damage is inflickted, see '''[[etdamage|dflags]]''' [[etdamage|flaglist]]
:'''[[etdamage|mod]]''' is a number from 0 up to 64 o set the type of damage, see '''[[etdamage|mod]]''' [[etdamage|list]]
 

===entities===
'''entnum''' = et.G_Spawn()
:Spawns a new entity and returns the new entity number.
'''entnum''' = et.G_TempEntity( '''origin''', '''event''' )
:Spawns a new TempEntity of event type '''event''' and places it at '''origin''' in the world.
et.G_FreeEntity( '''entnum''' )
:Frees the entity '''entnum'''
'''spawnval''' = et.G_GetSpawnVar( '''entnum''', '''key''' )
:Returns the value of spawnvar '''key''' for entity '''entnum'''
et.G_SetSpawnVar( '''entnum''', '''key''', '''value''' )
:Sets the spawnvar '''key''' to '''value''' for entity '''entnum'''
'''integer entnum''' = et.G_SpawnGEntityFromSpawnVars( string spawnvar, string spawnvalue, ... )
:This function can only be called inside the '''et_InitGame''' callback
et.trap_LinkEntity( '''entnum''' )
:Links the entity '''entnum'''
et.trap_UnlinkEntity( '''entnum''' )
:Unlinks the entity '''entnum'''
'''(variable)''' = et.gentity_get ( '''entnum''', '''[[Fieldname]]''' '',arrayindex'' )
:Gets the value of '''[[Fieldname]]''' from entity '''entnum''' out of the g_entity struct. For NULL entities or clients, ''nil'' is returned. 
:''arrayindex'' is used to specify which element of an array entity field to get. It is required when accessing array type fields. Entity field array indexes start at 0.
et.gentity_set( '''entnum''', '''[[Fieldname]]''', ''arrayindex,'' '''(value)''' )
:Sets the value of '''[[Fieldname]]''' from entity '''entnum''' in the g_entity struct to '''(value)'''
:''arrayindex'' is used to specify which element of an array entity field to set.
et.G_AddEvent( '''ent''', '''event''', '''eventparm'''' )
:Adds event '''event''' whit eventparameter '''eventparm'''' to entity '''ent'''
 

==callbacks==

===qagame execution===
et_InitGame( '''levelTime''', '''randomSeed''', '''restart''' )
:Called when qagame initializes. '''levelTime''' is the current level time in milliseconds. '''randomSeed''' is a number that can be used to seed random number generators. '''restart''' indicates if et_InitGame() is being called due to a map restart (1) or not (0).
et_ShutdownGame( '''restart''' )
:Called when qagame shuts down. '''restart''' indicates if the shutdown is being called due to a map_restart (1) or not (0).
et_RunFrame( '''levelTime''' )
:Called when qagame runs a server frame. '''levelTime''' is the current level time in milliseconds.
et_Quit()
:Called when ETPro unloads the mod. The mod should close all open filedescriptors and perform all cleanup.
 

===client management===
'''rejectreason''' = et_ClientConnect( '''clientNum''', '''firstTime''', '''isBot''' )
:Called when a client attempts to connect to the server. '''clientNum''' is the client slot id, '''firstTime''' indicates if this is a new connection (1) or a reconnection (0). '''isBot''' indicates if the client is a bot (1) or not (0). If the mod accepts the connection, it should return nil. Otherwise, the mod should return a string describing the reason the client connection was rejected.
et_ClientDisconnect( '''clientNum''' )
:Called when a client disconnects. '''clientNum''' is the client slot id.
et_ClientBegin( '''clientNum''' )
:Called when a client begins (becomes active, and enters the gameworld). '''clientNum''' is the client slot id.
et_ClientUserinfoChanged( '''clientNum''' )
:Called when a client's [[Userinfo]] string has changed. '''clientNum''' is the client slot id.
:'''note:''' In ETPro 3.2.6 and below, this only gets called when the players CS_PLAYERS config string changes, rather than every time the userinfo changes. This only happens for a subset of userinfo fields.
et_ClientSpawn( '''clientNum''', '''revived''' )
:Called when a client is spawned. '''clientNum''' is the client slot id. '''revived''' is 1 if the client was spawned by beeying revived.
 

===commands===
'''intercepted''' = et_ClientCommand( '''clientNum''', '''command''' )
:Called when a command is received from a client. '''clientNum''' is the client slot id. '''command''' is the command. The mod should return 1 if the command was intercepted by the mod, and 0 if the command was ignored by the mod and should be passed through to the server (and other mods in the chain).
:The actual command can be accessed through the [[#argument_handling|argument handling]] functions, as seen in the [[ETPro:Lua Sample Code]].
'''intercepted''' = et_ConsoleCommand()
:Called when a command is entered on the server console. The mod should return 1 if the command was intercepted by the mod, and 0 if the command was ignored by the mod and should be passed through to the server (and other mods in the chain).
:The actual command can be accessed through the [[#argument_handling|argument handling]] functions, as seen in the [[ETPro:Lua Sample Code]].
 

===xp===
et_UpgradeSkill( '''cno''', '''skill''' )
:Called when client on slot '''cno''' gets an upgrade on skill '''skill'''. Return -1 to override (abort) the qagame function, anything else to "passthrough". Callback may modify skills (or do anything else it wants) during passthrough.
et_SetPlayerSkill( '''cno''', '''skill''' )
:Called when clients (on slot '''cno''') skill level '''skill''' is set. Return -1 to override (abort) the qagame function, anything else to "passthrough". Callback may modify skills (or do anything else it wants) during passthrough.
 

===miscellaneous===
et_IPCReceive( '''vmnumber''', '''message''' )
:Called when another mod sends an et.IPCSend() message to this mod. '''vmnumber''' is the VM slot number of the sender, and '''message''' is the message.
et_Print( '''text''' )
:Called whenever the server or qagame prints a string to the console.
et_Obituary( '''victim''', '''killer''', '''meansOfDeath''' )
:Called whenever a player is killed.
 

==predefined constants==
et.EXEC_NOW 
et.EXEC_INSERT 
et.EXEC_APPEND 
et.FS_READ 
et.FS_WRITE 
et.FS_APPEND 
et.FS_APPEND_SYNC 
et.SAY_ALL 
et.SAY_TEAM 
et.SAY_BUDDY 
et.SAY_TEAMNL 
 
et.HOSTARCH
:set to WIN32 or UNIX depending on the host architecture qagame is running on.
LUA_PATH
:set to fs_homepath/fs_game/?.lua in order to ease use of the [http://www.lua.org/pil/8.1.html require] function.
 

==configs==
If a config is loaded, all modules are shutdown and reloaded. If a ''certified'' config is loaded, all modules are shutdown and reloaded, and additionally the following functions are disabled: '''require()''', '''loadfile()''', '''loadlib()''', '''loadstring()''', '''dofile()''' 
 

==caveats==
Like qagame, lua modules are unloaded and reloaded on map_restart and map changes. This means that all global variables and other information is lost. Mods may choose to store persistent data in cvars or external files. 
 

==FAQ==

Q: OMG I hate the libary prefix et.* on everything!!11!1oneone 
A: table.foreach(et, function (func, value) _G[func] = value; end)

Q: How do a reload my lua file without restarting the whole server? 
A: Use ''map_restart'', ''reset_match'' or simply change the map.

Q: Can I see some sample code? 
A: [[ETPro:Lua Sample Code|Lua sample code]]

Q: Is there a list of [[ETPro]] Lua mods? 
A: Yes, [[:Category:ETPro:Mods|here]].

Q: OMG my mod doesn't work! 
A: Make sure you added your mod's filename to the lua_modules cvar (e.g. set lua_modules mymod.lua).

Q: OMG why has et_ClientSay been removed? 
A: That's a secret but, to keep the function as it was, just add the following code to your et_ClientCommand() function 
<pre> -- et_ClientSay had to be removed in order to intercept all commands
-- so here's a wrapper for that
arg0 = et.trap_Argv(0) -- get the main command

if arg0 == "say" then
return et_ClientSay( clientNum, et.SAY_ALL, et.ConcatArgs(1))
elseif arg0 == "say_team" then
return et_ClientSay( clientNum, et.SAY_TEAM, et.ConcatArgs(1))
elseif arg0 == "say_buddy" then
return et_ClientSay( clientNum, et.SAY_BUDDY, et.ConcatArgs(1))
elseif arg0 == "say_teamnl" then
return et_ClientSay( clientNum, et.SAY_TEAMNL, et.ConcatArgs(1))
end
-- et_ClientSay wrapper end
</pre>

[[Category:Lua]]

ETPro:Pluggable Config Files

2007-02-26T04:36:17Z

ReyalP: setl limits

ETPro supports '''Pluggable Config Files'''. These files provide servers the use of additional features not available from traditional <tt>.cfg</tt> files.

==Creation and Installation==
Config files must be located in <tt>etpro/configs</tt> and their names must end in <tt>.config </tt>

==Config file format==
The following shows the .config syntax. This is not a complete config, the ... indicates that in a real config many similar commands would follow

configname "^/foobar^f 6v6"
// config for 6v6 foobar league
version 1.2.3.4 foobar6v6.version.foobarleague.com
init
{
setl sv_pure 1
setl sv_cheats 0
setl g_gametype 3
...
command "pb_sv_enable"
command "pb_sv_kicklen 1"
command "pb_sv_cvarempty"
...
}
map default
{
set g_userTimeLimit 0
setl g_useralliedrespawntime 0
setl g_useraxisrespawntime 0
setl b_moverscale 1
}
map radar
{
set g_userTimeLimit 12
command "forcecvar r_drawfoliage 0"
mapscripthash <sha1 hash>
}
...
signature <sig>
===Config file details===
;comments : any text following // is a comment and is ignored

;version w.x.y.z some.dns.name : ET will check that version matches the IP returned form some.dns.name If it does, ETPro displays the message "config is latest version available" to all players in warmup. '''not fully implemented''' - etpro doesn't currently do the DNS check.

;configname <name> : defines the name of the config. This name is displayed to players in warmup, but is '''not''' used to refer to the config in config related commands. The name may contain ET [[Color Codes]]

;init : The init block is executed only once, when the config is loaded by referee or rcon/console. It is never reloaded.

;map <mapname>|default : The map blocks are loaded on every map_restart. The parameter is the mapname to match to. A parameter of default will execute that block for all maps. map blocks are executed in order from first to last. Generally you want your default block first, and then specific map blocks to override it.

;signature <sig> : provides crypotgraphic signature to verify that that the config is unmodified. ETPro displays the message "config is certified" to all players in warmup. The signature must be generated by the etpro team.

'''init''' and '''map''' are followed by a block, delimited by curly braces {}. Each block can contain the following keywords

;set <cvarname> "value" : sets the specified cvar to the specified value.
;setl <cvarname> "value" : sets the specified cvar to the specified value, and locks it so that it cannot be changed by rcon, forcecvar or other means until the config is unloaded
note: setl names and values are limited to 63 characters in etpro versions up to and including 3.2.6
;command "command text" : execute "command text"
;mapscripthash <sha1 hash> : Require a particular mapscript be used for a map. Must appear in a non-default map section. The hash can be found by loading the map and checking the value of the readonly server cvar b_mapscripthash, or be obtained using external hashing tools like sha1sum (1). If the mapscript does not match when the map is loaded, a message will be sent to all players, and the config will be unloaded.

==Config related commands==
;callvote | ref config <config file name> : set the current config by vote or ref.
;config <config file name>|none : set the current config from the server console, or unload the current config. Settings set by the config remain in effect, but are no longer locked. Map specific blocks are no longer in effect.
''notes'':
:*<tt>config none</tt> can only be used from the console (or rcon) not ref or vote.
:*you must use the filename of the .config (minus the .config extension), not the 'configname' contained in the .config file. The 'configname' is a longer (possibly colored etc) descriptive name.
:*'''do not''' try to load a config with <tt>set config <configname></tt>. This will cause the <tt>config</tt> and <tt>ref config</tt> commands to stop working until the server is restarted.

==Common pitfalls to watchout for==
*Any cvar that isn't a number (vote_allow_config, b_watermark, b_levels_medic etc) must have quotes around it's value, even if its value is a single character.
*XP levels lists should not have commas in them (b_levels_medic etc)
*Putting cvars in groups alphabetically as above makes it a lot easier to maintain and verify.
*Make sure there is an extra newline at the end of the file (after the closing '}')
*Test your <tt>.config</tt> - you can do this simply by putting it in your /etpro/configs directory, and starting ET with <tt>+set dedicated 2 +exec server.cfg</tt>, then calling the <tt>.config</tt> with <tt>/config NAME</tt>. The console will report any major syntax errors in the <tt>.config</tt>
*Make sure to include all relevant gameplay-related cvars. Most are included in [http://bani.anime.net/banimod/forums/viewtopic.php?t=4558#43204 this list].

==Getting Your Configuration Certified==
The easiest way is to send a private message to [http://bani.anime.net/banimod/forums/profile.php?mode=viewprofile&u=2 bani] or [http://bani.anime.net/banimod/forums/profile.php?mode=viewprofile&u=800 Rain] or [http://bani.anime.net/banimod/forums/profile.php?mode=viewprofile&u=1462 zinx] or [http://bani.anime.net/banimod/forums/profile.php?mode=viewprofile&u=761 ReyalP] with the URL using the [http://bani.anime.net/banimod/forums/privmsg.php?folder=sentbox ETPro forums], including a link to the <tt>.config</tt> hosted on the league's website.

An alternate way, if the first way fails, is to talk to one of the [[ETPro Developer]]s on [[IRC]].

==See also==
*[[Cvar Restrictions]]
*[[Forced Cvars]]
*[[WolfWiki:Community_Portal#Leagues / Competitions]] is a good place to find full config file examples.

[[Category:ETPro]]

Fieldname

2007-02-25T02:20:30Z

ReyalP: Im2spelling4u

__NOEDITSECTION__
==Entity Fieldnames==
List of fields supported by [[Lua Mod API#entities|et.gentity_get() and et.gentity_set()]] functions 
<pitatable columns=3 headlines="field;type;access" widths="180;120;60" headerfontcolor="#FFFFFF">
activator;entity;RO;
chain;entity;RW;
classname;string;RW;
client.inactivityTime;integer;RW;
client.inactivityWarning;qboolean;RW;
clipmask;integer;?;
closespeed;float;RW;
count;integer;RW;
count2;integer;RW;
damage;integer;RW;
deathType;meansOfDeath_t;RW;
delay;float;RW;
dl_atten;integer;RW;
dl_color;vec3;RW;
dl_shader;string;RO;
dl_stylestring;string;RO;
duration;float;RW;
end_size;integer;RW;
enemy;entity;RW;
flags;bitflag;RO;
harc;float;RW;
health;integer;RW;
inuse;qboolean;RO;
isProp;qboolean;RO;
item;string;RW;
key;integer;RW;
message;string;RW;
methodOfDeath;integer;RW;
mg42BaseEnt;integer;RW;
missionLevel;integer;RW;
model;string;RO;
model2;string;RO;
nextTrain;entity;RW;
noise_index;integer;RW;
origin;vec3;RW;
pers.connected;connected_t;?;
pers.netname;string;?;
pers.localClient;qboolean;?;
pers.initialSpawn;qboolean;?;
pers.enterTime;integer;?;
pers.connectTime;integer;?;
pers.teamState.state;teamstatestate_t;?;
pers.voteCount;integer;?;
pers.teamVoteCount;integer;?;
pers.complaints;integer;?;
pers.complaintClient;integer;?;
pers.complaintEndTime;integer;?;
pers.lastReinforceTime;integer;?;
pers.applicationClient;integer;?;
pers.applicationEndTime;integer;?;
pers.invitationClient;integer;?;
pers.invitationEndTime;integer;?;
pers.propositionClient;integer;?;
pers.propositionClient2;integer;?;
pers.propositionEndTime;integer;?;
pers.autofireteamEndTime;integer;?;
pers.autofireteamCreateEndTime;integer;?;
pers.autofireteamJoinEndTime;integer;?;
pers.lastSpawnTime;integer;?;
pers.ready;qboolean;?;
prevTrain;entity;RW;
props_frame_state;integer;RO;
ps.stats;integer array;RW;
ps.persistant;integer array;RW;
ps.ping;integer;?;
ps.powerups;integer array;RW;
ps.ammo;integer array;RW;
ps.ammoclip;integer array;RW;
r.absmax;vec3;RO;
r.absmin;vec3;RO;
r.bmodel;qboolean;RO;
r.contents;integer;RW;
r.currentAngles;vec3;RW;
r.currentOrigin;vec3;RW;
r.eventTime;integer;RW;
r.linkcount;integer;RO;
r.linked;qboolean;RO;
r.maxs;vec3;RW;
r.mins;vec3;RW;
r.ownerNum;integer;RW;
r.singleClient;integer;RW;
r.svFlags;integer;RW;
r.worldflags;integer;RO;
radius;integer;RW;
random;float;RW;
rotate;vec3;RW;
s.angles;vec3;RW;
s.angles2;vec3;RW;
s.apos;trajectory;RW;
s.clientNum;integer;RW;
s.constantLight;integer;RW;
s.density;integer;RW;
s.dl_intensity;integer;RW;
s.dmgFlags;integer;RW;
s.eFlags;integer;RW;
s.eType;integer;?;
s.effect1Time;integer;RW;
s.effect2Time;integer;RW;
s.effect3Time;integer;RW;
s.frame;integer;RW;
s.groundEntityNum;integer;RO;
s.loopSound;integer;RW;
s.modelindex;integer;RW;
s.modelindex2;integer;RW;
s.number;integer;RO;
s.onFireEnd;integer;RW;
s.onFireStart;integer;RW;
s.origin;vec3;?;
s.origin2;vec3;?;
s.pos;trajectory;RW;
s.powerups;integer;RO;
s.solid;integer;RW;
s.teamNum;integer;RW;
s.time;integer;RW;
s.time2;integer;RW;
s.weapon;integer;RO;
scriptName;string;RO;
sess.sessionTeam;team_t;RW;
sess.spectatorTime;integer;RW;
sess.spectatorState;spectatorState_t;RW;
sess.spectatorClient;integer;RW;
sess.latchSpectatorClient;integer;RW;
sess.playerType;integer;RW;
sess.playerWeapon;integer;RW;
sess.playerWeapon2;integer;RW;
sess.spawnObjectiveIndex;integer;RW;
sess.latchPlayerType;integer;RW;
sess.latchPlayerWeapon;integer;RW;
sess.latchPlayerWeapon2;integer;RW;
sess.damage_given;integer;RW;
sess.damage_received;integer;RW;
sess.deaths;integer;RW;
sess.game_points;integer;RW;
sess.gibs;integer;RW;
sess.kills;integer;RW;
sess.medals;integer array;RW;
sess.muted;qboolean;RW;
sess.rank;integer;RW;
sess.referee;integer;RW;
sess.rounds;integer;RW;
sess.semiadmin;integer;RW;
sess.skill;integer array;RW;
sess.spec_invite;integer;RW;
sess.spec_team;integer;RW;
sess.suicides;integer;RW;
sess.team_damage;integer;RW;
sess.team_kills;integer;RW;
sess.team_received;integer;RW;
sess.aWeaponStats;weapon_stat_t;RW;
spawnflags;integer;RO;
spawnitem;string;RO;
speed;float;RW;
splashDamage;integer;RW;
splashMethodOfDeath;integer;RW;
splashRadius;integer;RW;
start_size;integer;RW;
tagName;string;RO;
tagParent;entity;RW;
takedamage;boolean;RW;
tankLink;entity;RW;
target;string;RW;
TargetAngles;vec3;RW;
TargetFlag;integer;RO;
targetname;string;RO;
teamchain;entity;RW;
teammaster;entity;RW;
track;string;RO;
varc;float;RW;
wait;float;RW;
waterlevel;integer;RO;
watertype;integer;RO;
</pitatable>
:''note'': all the sess.* fields will return nil unless the entity is associated with client slot < sv_maxclients.
:''note'': all array variables need to be get or set with an additional parameter.

----

==ET variable types==

===qboolean===
:a '''qboolean''' is a number representing a boolean value.
:0 is false
:1 is true

----

===vec3===
:a '''vec3_t''' is a 3-element array of numbers (C definition: typedef float vec3_t[3];). It is usually used to store and process coordinates in 3D space. 
:In etpro-lua a vector is an array (table indexed by integers) containing 3 numbers. It can be accessed by
:doing:
<pre>
origin = et.gentity_get(entNum,"r.currentOrigin") --a vec3 value
x,y,z = origin[1],origin[2],origin[3]</pre>

----

===array===
:The fields listed as having type '''array''' represent an entity value which is an array. Individual elements of the array are accessed by passing the desired index in the ''arrayindex'' argument to the et.gentity_get and et.gentity_set functions. Valid array indexes are integers from 0 up to some field specific maximum. The ''arrayindex'' argument is '''required''' when accessing array type fields, so only one element of an array can be accessed in a given call to the gentity_* functions. 

----

===trajectory===
:a '''trajectory''' is returned as a lua table described below
<pre>{
trDuration = <number>, --- int
trTime = <number>, -- int
trType = <number>, -- see below for allowed values
trBase = <vec3_t>, -- vec3, as described above
trDelta = <vec3_t> -- also a vec3
}</pre>
: the allowed values for trType (along with the enum names and original comments from the ET source), are as follows. Note
: that not all values make sense for all entity types
<pitatable columns=3 headlines="number;type;discription" widths="40;160;450" headerfontcolor="#FFFFFF">
1;TR_STATIONARY;
2;TR_INTERPOLATE;non-parametric, but interpolate between snapshots;
3;TR_LINEAR;
4;TR_LINEAR_STOP;
5;TR_LINEAR_STOP_BACK;reverse movement can be different than forward;
6;TR_SINE;value = base + sin( time / duration ) * delta;
7;TR_GRAVITY;
8;TR_GRAVITY_LOW;
9;TR_GRAVITY_FLOAT;super low grav with no gravity acceleration;
10;TR_GRAVITY_PAUSED;has stopped, but trace to see if it should be switched back to TR_GRAVITY;
11;TR_ACCELERATE;
12;TR_DECCELERATE;
13;TR_SPLINE;
14;TR_LINEAR_PATH;
</pitatable>

----

===entity===
:The fields listed as having type '''enitity''' return an entity number or nil. Entity numbers are integers from 0 through 1023. Some of the entity numbers have special meanings:
:0 - (sv_privateclients - 1) are reserved for clients who connect with the private slot password
:0 - 63 are reserved for clients. A client's entity number is also its client number (as shown by /players for example)
:1022 is the '''worldspawn''' entity
:1023 is '''ENTITYNUM_NONE''' which is used instead of null in C under some circumstances to indicate no entity. This is needed where an entity number will be passed over the network.
:''Note'': Some other fields not listed as type 'entity' may take an entity number value. '''mg42BaseEnt''' and '''s.number''' are examples. 

----

===meansOfDeath===
:a '''meansOfDeath_t''' is a number indicating the [[etdamage|Method of Death]] Click [[etdamage|here]] for a list with possible value's

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

Talk:Lua Mod API

2007-02-25T01:19:39Z

ReyalP: /* et_ClientSay ? */

please call et_Obituary() and et_Print() at the end of the engine function because we can do better output then. example: the engine output (ETPlayer killed himself.) is after the lua output (Hahaha! ETPlayer seems to be a selfkill noob!). thx!! --[[User:Pdi|pdi]] 09:13, 26 December 2006 (PST)
:It is called at the beginning of the function so lua mods can override obituary and print entirely if they want. I can make a separate lua hook which is called at the end of the function, eg et_ObituaryPost and et_PrintPost. [[User:Bani|Bani]] 11:52, 3 January 2007 (PST)
::Ok, this sounds good to me! Big THX!! :) Please have also a look at field section of this page! ;) --[[User:Pdi|pdi]] 05:41, 4 January 2007 (PST)

Can we have a intercepted version of '''et_ClientUserinfoChanged()''' to return '''1''' to intercept it with a mod and return '''0''' to pass it through to the server? THX!! --[[User:Pdi|pdi]] 00:54, 7 February 2007 (PST)
:I don't understand what you want here. You should already be able to call trap_SetUserinfo from et_ClientUserinfoChanged if you want to modify the values. --[[User:ReyalP|ReyalP]] 19:00, 8 February 2007 (PST)
::I found another way to do that. Sorry, but didn't need that anymore. --[[User:Pdi|pdi]] 12:16, 9 February 2007 (PST)
----

== IPC stuff ==

<hr>
i would like a et_IPCReceive whit an return value so u can send info back on a request

i would like a et_IPCSend that can send to all lua mods then them mods can decide if the wana use that message or not
[[User:=FF=im2good4u|=FF=Im2good4u]] 12:35, 8 January 2006 (PST)
<hr>
et_IPCReceive wouldn't send it to the other mod... afaik... so just use another send
just et_IPCSend to all modules (afaik, you can even send to ones not there), simple loop function
[[User:gotenks|gotenks]] 20:04, 8 January 2006 (CST)

yeh probely but its not verry handy its better to get the good vmnumber or to e able to send on mod filenames

apart from that returning a value will be more handy since tnhe u cna contine in 1 funtion else u got to reacise it in the recieve funtion [[User:=FF=im2good4u|=FF=Im2good4u]] 10:45, 9 January 2006 (PST)

== Fields for the next release ==
I think Kotoko wants the '''ps.velocity''' field here. It would be a good idea, I think. --[[User:FARMICEUDICAL|FARMICEUDICAL]] 20:23, 5 December 2006 (PST)

bani: RW access to all "sess.*" fields (sess.skillpoints, sess.startskillpoints, sess.startxptotal, ...) would be great. thanx! --[[User:Pdi|pdi]] 05:55, 2 August 2006 (PDT)

bani: please make all "pers.*" fields (pers.clientTimeNudge, pers.clientMaxPackets, ...) available. thanx! --[[User:Pdi|pdi]] 01:04, 17 August 2006 (PDT)
:you can get timenudge and maxpackets from the userinfo --[[User:ReyalP|ReyalP]] 20:19, 18 August 2006 (PDT)
::i know, but i ask for all pers.* fields. pers.clientTimeNudge and pers.clientMaxPackets are only examples. :) --[[User:Pdi|pdi]] 01:56, 21 August 2006 (PDT)

bani: will we have rw access to those fields (all sess.* and all pers.*) with next update? please!! --[[User:Pdi|pdi]] 07:02, 19 October 2006 (PDT)
: we are not going to add all the fields. A lot of them don't make sense for lua mods. Explain which ones you need --[[User:ReyalP|ReyalP]] 20:57, 5 February 2007 (PST)
::Ok, didn't know why i'm asking for (long time ago) but fields for xp/skill (sess.skillpoints array - if i remember) control would be great. THX!! --[[User:Pdi|pdi]] 00:54, 7 February 2007 (PST)

'''ps.weapon''', so arbitrary weapons can be added to or removed from arbitrary classes. For example, trickjump servers don't like Field Ops spamming airstrikes or artillery, but they do appreciate the ammo they give out. --[[User:FARMICEUDICAL|FARMICEUDICAL]] 21:09, 5 December 2006 (PST)
: ps.weapon won't do that for you. ps.weapon'''s''' might :) --[[User:ReyalP|ReyalP]] 17:14, 6 December 2006 (PST)

Okay then, '''ps.weapon''' so that medics can be set to spawn with the adrenaline needle out instead of the smg. --[[User:FARMICEUDICAL|FARMICEUDICAL]] 03:23, 11 December 2006 (PST)

Please give read access to '''g_campaignInfo_t''' in a field like '''campaignInfo'''. Thx!! --[[User:Pdi|pdi]] 08:57, 7 January 2007 (PST)

== LoadLib ==

Add loadlib ppl it says u have lua basic included but not loadlib !!

(on windows it gives an error attept to call global load lin a nil valua)[[User:=FF=im2good4u|=FF=Im2good4u]] 05:16, 15 February 2006 (PST)

== XP control not just skill ==

I would like to request RW access to the "sess.skillpoints" array

At least a callback on et.G_AddSkillPoints ( '''cno''', '''skill''', '''points''' ) [[User:=FF=im2good4u|=FF=Im2good4u]] 07:45, 8 March 2006 (PST)

== Locations ==
[22:08:57] <Vetinari> [NW]reyalP: if you're exposing map coords, it would
be nice to have something like et.PostitionName( et.gentity_get(id, "r.currentOrigin"))
<-- location name or map coords "(B, 3)", so I don't have to parse the _loc.dat ;->

== et_ClientSay ? ==
err.. what's this:
-- et_ClientSay had to be removed in order to intercept all commands
-- so here's a wrapper for that
arg0 = et.trap_Argv(0) -- get the main command
if arg0 == "say" then
return et_ClientSay( clientNum, et.SAY_ALL, et.ConcatArgs(1))

This should be
return et.G_Say( clientNum, et.SAY_ALL, et.ConcatArgs(1))
?

:No, et_ClientSay is a function you would define yourself to filter or do something with chats. It was it's own callback in earlier version of the API. -[[User:ReyalP|ReyalP]] 17:19, 24 February 2007 (PST)

SendServerCommand

2007-02-22T02:50:33Z

ReyalP: some notes

__NOEDITSECTION__
et.trap_SendServerCommand() is used to send a command from the server to one or more clients. The first argument is the slot number of the client the command will be sent to. If it's equal to -1, the command will be broadcast to all clients.

The following commands can be issued with this function:

==Printing==
===Print===
* "'''print''' \"''Message''\n\""
:'''print''' prints ''Message'' to the client's console.

===Center Print MoO===
* "'''cpm''' \"''Message''\n\"" 
:'''cpm''' prints ''Message'' to the client's annoucement area and console.

===Center Print===
* "'''cp''' \"''Message''\n\"" 
:'''cp''' prints ''Message'' to the center of the client's screen.

===Banner Print===
* "'''b''' ''locations'' \"''Message''\n\"" 
:'''b''' prints ''Message'' to the client's banner ''locations'' 
:the ''locations'' can be a number from 0 to 248
:For compatibility, the old-style locations (from 0-4) are also supported. 
:8 - player chat area 
:16 - left popup area (not recommended) 
:32 - centered above the chat area 
:64 - console only 
:128 - banner area (recommended)(top of screen)

===Scores Print===
* "'''sc''' \"''Message''\n\"" 
:'''sc''' prints ''Message'' to the client's console and writes it to the statsdump file.

==Chatting==
===Chat===
* "'''c''' ''ClientNum'' \"''Message''\"" 
:'''c''' prints ''Message'' as a global chat message on behalf of the client specified by ''ClientNum''.

===Team Chat===
* "'''tc''' ''ClientNum'' \"''Message''\" ''X-Location'' ''Y-Location'' ''Z-Location''" 
:'''tc''' prints ''Message'' as a team chat message on behalf of the client specified by ''ClientNum'', 
:the ''X,Y,Z-Location's'' are optional parematers that represent the client's location, 
:if the ''X,Y,Z-Location's'' are left out then the message will be printed without a location.

===Fireteam Chat===
* "'''bc''' ''ClientNum'' \"''Message''\" ''X-Location'' ''Y-Location'' ''Z-Location''". 
:'''bc''' prints ''Message'' as a fireteam chat message on behalf of the client specified by ''ClientNum'', 
:the ''X,Y,Z-Location's'' are parematers that represent the client's location.

==Voice Chat==
===Global Voice Chat===
* "'''vchat''' ''VoiceOnly'' ''ClientNum'' 50 ''Vsay-String'' ''Vsay-Number'' \"''Custom-Message''\"". 
:'''vchat''' sends a global voice chat ''Vsay-String'' on behalf of the client specified by ''ClientNum''. 
:''Vsay-Number'' is by default random, however, it can be set by the player by passing parameters to the vsay command (/vsay <''Vsay-Number''> <''Vsay-String''>), ''Vsay-Number'' represents the vsay number of Vsay as listed in the .voice files. 
:''Custom-Message'' is by default \"\" (empty), otherwise it's the message that gets printed in the chat area.
:if ''VoiceOnly'' is 0 it will print a chat message on behalf of ''ClientNum'' contaning the message 
:if ''VoiceOnly'' is 1 it will only do the sound but not the message

===Team Voice Chat===
* "'''vtchat''' ''VoiceOnly'' ''ClientNum'' 50 ''Vsay-String'' ''X-Location'' ''Y-Location'' ''Z-Location'' ''Vsay-Number'' \"''Custom-Message''\"" 
:'''vchat''' sends a team voice chat ''Vsay-String'' a on behalf of client ''ClienNtum''. 
:''Vsay-Number'' is by default random, however, it can be set by the player by passing parameters to the vsay command (/vsay <''Vsay-Number''> <''Vsay-String''>), ''Vsay-Number'' represents the vsay number of Vsay as listed in the .voice files. 
:the ''X,Y,Z-Location's'' parematers the represent the clients location. 
:''Custom-Message'' is by default \"\" (empty), otherwise it's the message that gets printed in the chat area.
:if ''VoiceOnly'' is 0 it will print a chat message on behalf of ''ClientNum'' contaning the message 
:if ''VoiceOnly'' is 1 it will only do the sound but not the message

===Fireteam Voice Chat===
* "'''vtchat''' ''VoiceOnly'' ''ClientNum'' 50 ''Fireteam-String'' ''X-Location'' ''Y-Location'' ''Z-Location'' ''Vsay-Number'' \"''Custom-Message''\"" 
:'''vchat''' will team voice chat ''Vsay-String'' on behalf of client ''ClienNum''. 
:''Vsay-Number'' is by default random, however, it can be set by the player by passing parameters to the vsay command (/vsay <''Vsay-Number''> <''Vsay-String''>), ''Vsay-Number'' represents the vsay number of Vsay as listed in the .voice files. 
:the ''X,Y,Z-Location's'' parematers the represent the clients location. 
:''Custom-Message'' is by default \"\" (empty), otherwise it's the message that gets printed in the chat area.
:if ''VoiceOnly'' is 0 it will print a chat message on behalf of ''ClientNum'' contaning the message 
:if ''VoiceOnly'' is 1 it will only do the sound but not the message

==Fireteam==
===Application===
* "'''application''' ''Number''"
:'''application''' shows a fireteam invation message to the client. 
:if ''Number'' > -1 - the "accept ... application to join your fireteam" message shows up. In this case ''Number'' is the ClientNum of the applying client. 
:if ''Number'' == -1 - the "your aplication has been submitted" message shows up. 
:if ''Number'' == -2 - the "your aplication failed" message shows up. 
:if ''Number'' == -3 - the "your aplication has been approved" message shows up. 
:if ''Number'' == -4 - the "your aplication reply has been sent" message shows up.

===Proposition===
* "'''proposition''' ''Number'' ''Number2''"
:'''proposition''' shows a fireteam proposition message to the client. 
:if ''Number'' > -1 - the "accept ... proposition to invite ... to your fireteam" message shows up. In this case ''Number'' is the ClientNum of the proposed client, and ''Number2'' is the ClientNum of the proposing player. 
:if ''Number'' == -1 - the "your proposition has been submitted" message shows up. 
:if ''Number'' == -2 - the "your proposition was rejected" message shows up. 
:if ''Number'' == -3 - the "your proposition was accepted" message shows up. 
:if ''Number'' == -4 - the "your proposition reply has been sent" message shows up. 
:''Number2'' is an optional paramater only used when ''Number'' > -1.

===Invitation===
* "'''invitation''' ''Number''"
:'''invitation''' shows the fireteam invation message to the client. 
:if ''Number'' > -1 - the "accept .. invitation to join your fireteam" message shows up. In this case ''Number'' is the ClientNum of the applying client. 
:if ''Number'' == -1 - the "your invitation has been submitted" message shows up. 
:if ''Number'' == -2 - the "your invitation rejected" message shows up. 
:if ''Number'' == -3 - the "your invitation was accepted" message shows up. 
:if ''Number'' == -4 - the "your invitation reply has been sent" message shows up.

==Others==
===Complaining===
* "'''complaint''' ''Number''" 
:'''complaint''' shows the complaint vote message to the client. 
:if ''Number'' > 1 - the vote shows up. In this case ''Number'' is the ClientNum of the teamkilling player. 
:if ''Number'' == -1 - the "complaint filed" message shows up. 
:if ''Number'' == -2 - the "complaint dismissed" message shows up.

===Spawning===
* "'''setspawnpt''' ''Number''" 
:'''setspawnpt''' sets the client game selected spawnpoint to number ''number''.

===Kicking===
* "'''disconnect''' \"''reason''\"" 
:'''disconnect''' will disconnect the client it has been send with a "Server disconnected" message 
:''reason'' is an optional parameter to show a reason after "Server disconnected"
'''note:''' use trap_DropClient instead.

===Configstrings===
* "'''cs''' ''Number'' \"''String''\"" 
: '''cs''' will set the clients configstringnumber ''Number'' to the ''String''
'''Note:''' Setting individual players configstrings this way is probably a Bad Idea.

===Shaders===
* "'''remapShader''' \"''OldShader''\" \"''NewShader''\" ''#''" 
: '''remapShader''' replaces any texture ''OldShader'' with ''NewShader'' 
: ''#'' is the Timeoffset, which currently should be left as ''0''.

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

ETPro:Pluggable Config Files

2007-02-20T00:44:51Z

ReyalP: mmm hash

ETPro supports '''Pluggable Config Files'''. These files provide servers the use of additional features not available from traditional <tt>.cfg</tt> files.

==Creation and Installation==
Config files must be located in <tt>etpro/configs</tt> and their names must end in <tt>.config </tt>

==Config file format==
The following shows the .config syntax. This is not a complete config, the ... indicates that in a real config many similar commands would follow

configname "^/foobar^f 6v6"
// config for 6v6 foobar league
version 1.2.3.4 foobar6v6.version.foobarleague.com
init
{
setl sv_pure 1
setl sv_cheats 0
setl g_gametype 3
...
command "pb_sv_enable"
command "pb_sv_kicklen 1"
command "pb_sv_cvarempty"
...
}
map default
{
set g_userTimeLimit 0
setl g_useralliedrespawntime 0
setl g_useraxisrespawntime 0
setl b_moverscale 1
}
map radar
{
set g_userTimeLimit 12
command "forcecvar r_drawfoliage 0"
mapscripthash <sha1 hash>
}
...
signature <sig>
===Config file details===
;comments : any text following // is a comment and is ignored

;version w.x.y.z some.dns.name : ET will check that version matches the IP returned form some.dns.name If it does, ETPro displays the message "config is latest version available" to all players in warmup. '''not fully implemented''' - etpro doesn't currently do the DNS check.

;configname <name> : defines the name of the config. This name is displayed to players in warmup, but is '''not''' used to refer to the config in config related commands. The name may contain ET [[Color Codes]]

;init : The init block is executed only once, when the config is loaded by referee or rcon/console. It is never reloaded.

;map <mapname>|default : The map blocks are loaded on every map_restart. The parameter is the mapname to match to. A parameter of default will execute that block for all maps. map blocks are executed in order from first to last. Generally you want your default block first, and then specific map blocks to override it.

;signature <sig> : provides crypotgraphic signature to verify that that the config is unmodified. ETPro displays the message "config is certified" to all players in warmup. The signature must be generated by the etpro team.

'''init''' and '''map''' are followed by a block, delimited by curly braces {}. Each block can contain the following keywords

;set <cvarname> "value" : sets the specified cvar to the specified value.
;setl <cvarname> "value" : sets the specified cvar to the specified value, and locks it so that it cannot be changed by rcon, forcecvar or other means until the config is unloaded
;command "command text" : execute "command text"
;mapscripthash <sha1 hash> : Require a particular mapscript be used for a map. Must appear in a non-default map section. The hash can be found by loading the map and checking the value of the readonly server cvar b_mapscripthash, or be obtained using external hashing tools like sha1sum (1). If the mapscript does not match when the map is loaded, a message will be sent to all players, and the config will be unloaded.

==Config related commands==
;callvote | ref config <config file name> : set the current config by vote or ref.
;config <config file name>|none : set the current config from the server console, or unload the current config. Settings set by the config remain in effect, but are no longer locked. Map specific blocks are no longer in effect.
''notes'':
:*<tt>config none</tt> can only be used from the console (or rcon) not ref or vote.
:*you must use the filename of the .config (minus the .config extension), not the 'configname' contained in the .config file. The 'configname' is a longer (possibly colored etc) descriptive name.
:*'''do not''' try to load a config with <tt>set config <configname></tt>. This will cause the <tt>config</tt> and <tt>ref config</tt> commands to stop working until the server is restarted.

==Common pitfalls to watchout for==
*Any cvar that isn't a number (vote_allow_config, b_watermark, b_levels_medic etc) must have quotes around it's value, even if its value is a single character.
*XP levels lists should not have commas in them (b_levels_medic etc)
*Putting cvars in groups alphabetically as above makes it a lot easier to maintain and verify.
*Make sure there is an extra newline at the end of the file (after the closing '}')
*Test your <tt>.config</tt> - you can do this simply by putting it in your /etpro/configs directory, and starting ET with <tt>+set dedicated 2 +exec server.cfg</tt>, then calling the <tt>.config</tt> with <tt>/config NAME</tt>. The console will report any major syntax errors in the <tt>.config</tt>
*Make sure to include all relevant gameplay-related cvars. Most are included in [http://bani.anime.net/banimod/forums/viewtopic.php?t=4558#43204 this list].

==Getting Your Configuration Certified==
The easiest way is to send a private message to [http://bani.anime.net/banimod/forums/profile.php?mode=viewprofile&u=2 bani] or [http://bani.anime.net/banimod/forums/profile.php?mode=viewprofile&u=800 Rain] or [http://bani.anime.net/banimod/forums/profile.php?mode=viewprofile&u=1462 zinx] or [http://bani.anime.net/banimod/forums/profile.php?mode=viewprofile&u=761 ReyalP] with the URL using the [http://bani.anime.net/banimod/forums/privmsg.php?folder=sentbox ETPro forums], including a link to the <tt>.config</tt> hosted on the league's website.

An alternate way, if the first way fails, is to talk to one of the [[ETPro Developer]]s on [[IRC]].

==See also==
*[[Cvar Restrictions]]
*[[Forced Cvars]]
*[[WolfWiki:Community_Portal#Leagues / Competitions]] is a good place to find full config file examples.

[[Category:ETPro]]

Talk:Lua Mod API

2007-02-09T03:00:49Z

ReyalP:

some of this can be done via function et_Print(text).. but this would greatly simplify life, 
my wish list for christmas: 
- getUserEguid(cno) - get a client's etpro guid? 
- repair gentity_set for vec3 - scotty fix the transporter please 
:[http://bani.anime.net/banimod/forums/viewtopic.php?t=6279 fixed.]--[[User:Bani|Bani]] 17:56, 22 December 2005 (PST)

please call et_Obituary() and et_Print() at the end of the engine function because we can do better output then. example: the engine output (ETPlayer killed himself.) is after the lua output (Hahaha! ETPlayer seems to be a selfkill noob!). thx!! --[[User:Pdi|pdi]] 09:13, 26 December 2006 (PST)
:It is called at the beginning of the function so lua mods can override obituary and print entirely if they want. I can make a separate lua hook which is called at the end of the function, eg et_ObituaryPost and et_PrintPost. [[User:Bani|Bani]] 11:52, 3 January 2007 (PST)
::Ok, this sounds good to me! Big THX!! :) Please have also a look at field section of this page! ;) --[[User:Pdi|pdi]] 05:41, 4 January 2007 (PST)

Can we have a intercepted version of '''et_ClientUserinfoChanged()''' to return '''1''' to intercept it with a mod and return '''0''' to pass it through to the server? THX!! --[[User:Pdi|pdi]] 00:54, 7 February 2007 (PST)
:I don't understand what you want here. You should already be able to call trap_SetUserinfo from et_ClientUserinfoChanged if you want to modify the values. --[[User:ReyalP|ReyalP]] 19:00, 8 February 2007 (PST)
----

== IPC stuff ==

<hr>
i would like a et_IPCReceive whit an return value so u can send info back on a request

i would like a et_IPCSend that can send to all lua mods then them mods can decide if the wana use that message or not
[[User:=FF=im2good4u|=FF=Im2good4u]] 12:35, 8 January 2006 (PST)
<hr>
et_IPCReceive wouldn't send it to the other mod... afaik... so just use another send
just et_IPCSend to all modules (afaik, you can even send to ones not there), simple loop function
[[User:gotenks|gotenks]] 20:04, 8 January 2006 (CST)

yeh probely but its not verry handy its better to get the good vmnumber or to e able to send on mod filenames

apart from that returning a value will be more handy since tnhe u cna contine in 1 funtion else u got to reacise it in the recieve funtion [[User:=FF=im2good4u|=FF=Im2good4u]] 10:45, 9 January 2006 (PST)

== Fields for the next release ==
I think Kotoko wants the '''ps.velocity''' field here. It would be a good idea, I think. --[[User:FARMICEUDICAL|FARMICEUDICAL]] 20:23, 5 December 2006 (PST)

bani: RW access to all "sess.*" fields (sess.skillpoints, sess.startskillpoints, sess.startxptotal, ...) would be great. thanx! --[[User:Pdi|pdi]] 05:55, 2 August 2006 (PDT)

bani: please make all "pers.*" fields (pers.clientTimeNudge, pers.clientMaxPackets, ...) available. thanx! --[[User:Pdi|pdi]] 01:04, 17 August 2006 (PDT)
:you can get timenudge and maxpackets from the userinfo --[[User:ReyalP|ReyalP]] 20:19, 18 August 2006 (PDT)
::i know, but i ask for all pers.* fields. pers.clientTimeNudge and pers.clientMaxPackets are only examples. :) --[[User:Pdi|pdi]] 01:56, 21 August 2006 (PDT)

bani: will we have rw access to those fields (all sess.* and all pers.*) with next update? please!! --[[User:Pdi|pdi]] 07:02, 19 October 2006 (PDT)
: we are not going to add all the fields. A lot of them don't make sense for lua mods. Explain which ones you need --[[User:ReyalP|ReyalP]] 20:57, 5 February 2007 (PST)
::Ok, didn't know why i'm asking for (long time ago) but fields for xp/skill (sess.skillpoints array - if i remember) control would be great. THX!! --[[User:Pdi|pdi]] 00:54, 7 February 2007 (PST)

'''ps.weapon''', so arbitrary weapons can be added to or removed from arbitrary classes. For example, trickjump servers don't like Field Ops spamming airstrikes or artillery, but they do appreciate the ammo they give out. --[[User:FARMICEUDICAL|FARMICEUDICAL]] 21:09, 5 December 2006 (PST)
: ps.weapon won't do that for you. ps.weapon'''s''' might :) --[[User:ReyalP|ReyalP]] 17:14, 6 December 2006 (PST)

Okay then, '''ps.weapon''' so that medics can be set to spawn with the adrenaline needle out instead of the smg. --[[User:FARMICEUDICAL|FARMICEUDICAL]] 03:23, 11 December 2006 (PST)

Please give read access to '''g_campaignInfo_t''' in a field like '''campaignInfo'''. Thx!! --[[User:Pdi|pdi]] 08:57, 7 January 2007 (PST)

== LoadLib ==

Add loadlib ppl it says u have lua basic included but not loadlib !!

(on windows it gives an error attept to call global load lin a nil valua)[[User:=FF=im2good4u|=FF=Im2good4u]] 05:16, 15 February 2006 (PST)
----
== XP control not just skill ==

I would like to request RW access to the "sess.skillpoints" array

At least a callback on et.G_AddSkillPoints ( '''cno''', '''skill''', '''points''' ) [[User:=FF=im2good4u|=FF=Im2good4u]] 07:45, 8 March 2006 (PST)

Talk:Lua Mod API

2007-02-06T04:57:02Z

ReyalP: /* Fields for the next release */

some of this can be done via function et_Print(text).. but this would greatly simplify life, 
my wish list for christmas: 
- getUserEguid(cno) - get a client's etpro guid? 
- repair gentity_set for vec3 - scotty fix the transporter please 
:[http://bani.anime.net/banimod/forums/viewtopic.php?t=6279 fixed.]--[[User:Bani|Bani]] 17:56, 22 December 2005 (PST)

please call et_Obituary() and et_Print() at the end of the engine function because we can do better output then. example: the engine output (ETPlayer killed himself.) is after the lua output (Hahaha! ETPlayer seems to be a selfkill noob!). thx!! --[[User:Pdi|pdi]] 09:13, 26 December 2006 (PST)
:It is called at the beginning of the function so lua mods can override obituary and print entirely if they want. I can make a separate lua hook which is called at the end of the function, eg et_ObituaryPost and et_PrintPost. [[User:Bani|Bani]] 11:52, 3 January 2007 (PST)
::Ok, this sounds good to me! Big THX!! :) Please have also a look at field section of this page! ;) --[[User:Pdi|pdi]] 05:41, 4 January 2007 (PST)
----

== IPC stuff ==

<hr>
i would like a et_IPCReceive whit an return value so u can send info back on a request

i would like a et_IPCSend that can send to all lua mods then them mods can decide if the wana use that message or not
[[User:=FF=im2good4u|=FF=Im2good4u]] 12:35, 8 January 2006 (PST)
<hr>
et_IPCReceive wouldn't send it to the other mod... afaik... so just use another send
just et_IPCSend to all modules (afaik, you can even send to ones not there), simple loop function
[[User:gotenks|gotenks]] 20:04, 8 January 2006 (CST)

yeh probely but its not verry handy its better to get the good vmnumber or to e able to send on mod filenames

apart from that returning a value will be more handy since tnhe u cna contine in 1 funtion else u got to reacise it in the recieve funtion [[User:=FF=im2good4u|=FF=Im2good4u]] 10:45, 9 January 2006 (PST)

== Fields for the next release ==
I think Kotoko wants the '''ps.velocity''' field here. It would be a good idea, I think. --[[User:FARMICEUDICAL|FARMICEUDICAL]] 20:23, 5 December 2006 (PST)

bani: RW access to all "sess.*" fields (sess.skillpoints, sess.startskillpoints, sess.startxptotal, ...) would be great. thanx! --[[User:Pdi|pdi]] 05:55, 2 August 2006 (PDT)

bani: please make all "pers.*" fields (pers.clientTimeNudge, pers.clientMaxPackets, ...) available. thanx! --[[User:Pdi|pdi]] 01:04, 17 August 2006 (PDT)
:you can get timenudge and maxpackets from the userinfo --[[User:ReyalP|ReyalP]] 20:19, 18 August 2006 (PDT)
::i know, but i ask for all pers.* fields. pers.clientTimeNudge and pers.clientMaxPackets are only examples. :) --[[User:Pdi|pdi]] 01:56, 21 August 2006 (PDT)

bani: will we have rw access to those fields (all sess.* and all pers.*) with next update? please!! --[[User:Pdi|pdi]] 07:02, 19 October 2006 (PDT)
: we are not going to add all the fields. A lot of them don't make sense for lua mods. Explain which ones you need --[[User:ReyalP|ReyalP]] 20:57, 5 February 2007 (PST)

'''ps.weapon''', so arbitrary weapons can be added to or removed from arbitrary classes. For example, trickjump servers don't like Field Ops spamming airstrikes or artillery, but they do appreciate the ammo they give out. --[[User:FARMICEUDICAL|FARMICEUDICAL]] 21:09, 5 December 2006 (PST)
: ps.weapon won't do that for you. ps.weapon'''s''' might :) --[[User:ReyalP|ReyalP]] 17:14, 6 December 2006 (PST)

Okay then, '''ps.weapon''' so that medics can be set to spawn with the adrenaline needle out instead of the smg. --[[User:FARMICEUDICAL|FARMICEUDICAL]] 03:23, 11 December 2006 (PST)

Please give read access to '''g_campaignInfo_t''' in a field like '''campaignInfo'''. Thx!! --[[User:Pdi|pdi]] 08:57, 7 January 2007 (PST)

== LoadLib ==

Add loadlib ppl it says u have lua basic included but not loadlib !!

(on windows it gives an error attept to call global load lin a nil valua)[[User:=FF=im2good4u|=FF=Im2good4u]] 05:16, 15 February 2006 (PST)
----
== XP control not just skill ==

I would like to request RW access to the "sess.skillpoints" array

At least a callback on et.G_AddSkillPoints ( '''cno''', '''skill''', '''points''' ) [[User:=FF=im2good4u|=FF=Im2good4u]] 07:45, 8 March 2006 (PST)

Talk:Lua Mod API

2007-02-06T04:10:16Z

ReyalP: remove fixed/invalid stuff

some of this can be done via function et_Print(text).. but this would greatly simplify life, 
my wish list for christmas: 
- getUserEguid(cno) - get a client's etpro guid? 
- repair gentity_set for vec3 - scotty fix the transporter please 
:[http://bani.anime.net/banimod/forums/viewtopic.php?t=6279 fixed.]--[[User:Bani|Bani]] 17:56, 22 December 2005 (PST)

please call et_Obituary() and et_Print() at the end of the engine function because we can do better output then. example: the engine output (ETPlayer killed himself.) is after the lua output (Hahaha! ETPlayer seems to be a selfkill noob!). thx!! --[[User:Pdi|pdi]] 09:13, 26 December 2006 (PST)
:It is called at the beginning of the function so lua mods can override obituary and print entirely if they want. I can make a separate lua hook which is called at the end of the function, eg et_ObituaryPost and et_PrintPost. [[User:Bani|Bani]] 11:52, 3 January 2007 (PST)
::Ok, this sounds good to me! Big THX!! :) Please have also a look at field section of this page! ;) --[[User:Pdi|pdi]] 05:41, 4 January 2007 (PST)
----

== IPC stuff ==

<hr>
i would like a et_IPCReceive whit an return value so u can send info back on a request

i would like a et_IPCSend that can send to all lua mods then them mods can decide if the wana use that message or not
[[User:=FF=im2good4u|=FF=Im2good4u]] 12:35, 8 January 2006 (PST)
<hr>
et_IPCReceive wouldn't send it to the other mod... afaik... so just use another send
just et_IPCSend to all modules (afaik, you can even send to ones not there), simple loop function
[[User:gotenks|gotenks]] 20:04, 8 January 2006 (CST)

yeh probely but its not verry handy its better to get the good vmnumber or to e able to send on mod filenames

apart from that returning a value will be more handy since tnhe u cna contine in 1 funtion else u got to reacise it in the recieve funtion [[User:=FF=im2good4u|=FF=Im2good4u]] 10:45, 9 January 2006 (PST)

== Fields for the next release ==
I think Kotoko wants the '''ps.velocity''' field here. It would be a good idea, I think. --[[User:FARMICEUDICAL|FARMICEUDICAL]] 20:23, 5 December 2006 (PST)

bani: RW access to all "sess.*" fields (sess.skillpoints, sess.startskillpoints, sess.startxptotal, ...) would be great. thanx! --[[User:Pdi|pdi]] 05:55, 2 August 2006 (PDT)

bani: please make all "pers.*" fields (pers.clientTimeNudge, pers.clientMaxPackets, ...) available. thanx! --[[User:Pdi|pdi]] 01:04, 17 August 2006 (PDT)
:you can get timenudge and maxpackets from the userinfo --[[User:ReyalP|ReyalP]] 20:19, 18 August 2006 (PDT)
::i know, but i ask for all pers.* fields. pers.clientTimeNudge and pers.clientMaxPackets are only examples. :) --[[User:Pdi|pdi]] 01:56, 21 August 2006 (PDT)

bani: will we have rw access to those fields (all sess.* and all pers.*) with next update? please!! --[[User:Pdi|pdi]] 07:02, 19 October 2006 (PDT)

'''ps.weapon''', so arbitrary weapons can be added to or removed from arbitrary classes. For example, trickjump servers don't like Field Ops spamming airstrikes or artillery, but they do appreciate the ammo they give out. --[[User:FARMICEUDICAL|FARMICEUDICAL]] 21:09, 5 December 2006 (PST)
: ps.weapon won't do that for you. ps.weapon'''s''' might :) --[[User:ReyalP|ReyalP]] 17:14, 6 December 2006 (PST)

Okay then, '''ps.weapon''' so that medics can be set to spawn with the adrenaline needle out instead of the smg. --[[User:FARMICEUDICAL|FARMICEUDICAL]] 03:23, 11 December 2006 (PST)

Please give read access to '''g_campaignInfo_t''' in a field like '''campaignInfo'''. Thx!! --[[User:Pdi|pdi]] 08:57, 7 January 2007 (PST)

== LoadLib ==

Add loadlib ppl it says u have lua basic included but not loadlib !!

(on windows it gives an error attept to call global load lin a nil valua)[[User:=FF=im2good4u|=FF=Im2good4u]] 05:16, 15 February 2006 (PST)
----
== XP control not just skill ==

I would like to request RW access to the "sess.skillpoints" array

At least a callback on et.G_AddSkillPoints ( '''cno''', '''skill''', '''points''' ) [[User:=FF=im2good4u|=FF=Im2good4u]] 07:45, 8 March 2006 (PST)

Lua Mod API

2007-02-02T04:53:35Z

ReyalP: os :?

__NOEDITSECTION__
[[ETPro]] now supports server-side mods via the [http://www.lua.org/ Lua] scripting language. For more information about Lua, visit the [http://www.lua.org/manual/5.0/ Reference manual], the online edition of the book [http://www.lua.org/pil/ Programming in Lua] or the [http://lua-users.org/wiki/ lua-users wiki].

ETPro has an embedded Lua 5.0.2 interpreter, and if present will load user-defined scripts from the ETPro directory. It also provides an "et" library of function calls for Lua that allow access to the server engine, and provides callbacks so a server side mod may trigger on specific server events.

The following standard Lua libraries are initialized by default and available to ETPro Lua scripts:
[http://www.lua.org/manual/5.0/manual.html#5.1 basic], [http://www.lua.org/manual/5.0/manual.html#5.4 table], [http://www.lua.org/manual/5.0/manual.html#5.6 i/o], [http://www.lua.org/manual/5.0/manual.html#5.7 os] (available features vary depending on your OS), [http://www.lua.org/manual/5.0/manual.html#5.3 string], [http://www.lua.org/manual/5.0/manual.html#5.5 math].

A list of ETPro mods can be found [[:Category:ETPro:Mods|here]].

A tutorial about ETPro Lua scripting can be found [[Lua Tutorials|here]].

API requests can be discussed at the [[Talk:Lua_Mod_API|Lua Mod API talk page]].

==client commands==
===lua_status===
:lists all currently loaded lua modules.
:''lua mods cannot override this client command.''

==server commands==
===lua_status===
:lists all currently loaded lua modules.

==cvars==
===lua_modules===
:(default "", disabled)
:space separated list of lua modules for ETPro to load. modules will be run in the order listed.

===lua_allowedmodules===
:(default "", disabled)
:if set, only lua modules with the matching sha1 signatures listed in this cvar will be allowed to load.
 
:changing either cvar will cause all currently loaded modules to :quit and be unloaded until the next map_restart. 
 

==et library calls==

===modules===
et.RegisterModname( '''modname''' )
:Registers a descriptive string '''modname''' for this mod.
'''vmnumber''' = et.FindSelf()
:Returns a number indicating the VM slot the current mod is loaded into.
'''modname''', '''signature''' = et.FindMod( '''vmnumber''' )
:Returns the '''modname''' and sha1 '''signature''' for the mod loaded in the VM slot '''vmnumber'''. Returns nil, nil if the VM slot is invalid.
'''success''' = et.IPCSend( '''vmnumber''', '''message''' )
:Sends the string '''message''' to the mod in the VM slot indicated by '''vmnumber'''. The mod receiving '''message''' must have an ''et_IPCReceive()'' callback. If the message is successfully sent, '''success''' will be 1. On failure it will be 0.
 

===printing===
et.G_Print( '''text''' )
:Prints the string '''text''' to the server console.
et.G_LogPrint( '''text''' )
:Prints the string '''text''' to the server console and writes it to the server log.
 

===argument handling===
These functions are to be used within the [[#commands|command callback functions]]. 
'''args''' = et.ConcatArgs( '''index''' )
:Returns all arguments beginning from '''index''' concatenated into a single string '''args'''
'''argcount''' = et.trap_Argc()
:Returns a number indicating the number of command line arguments in the command buffer.
'''arg''' = et.trap_Argv( '''argnum''' )
:Returns the contents of the command line argument '''argnum'''.
 

===cvars===
'''cvarvalue''' = et.trap_Cvar_Get( '''cvarname''' )
:Returns the value of the cvar '''cvarname''' as a string. If there is no cvar named '''cvarname''', returns a zero length string.
et.trap_Cvar_Set( '''cvarname''', '''cvarvalue''' )
:Sets the cvar '''cvarname''' to '''cvarvalue'''
 

===configstrings===
'''configstringvalue''' = et.trap_GetConfigstring( '''index''' )
:Returns the string '''configstringvalue''' containing the contents of the configstring '''index'''
et.trap_SetConfigstring( '''index''', '''configstringvalue''' )
:Sets the configstring '''index''' to the string '''configstringvalue'''
 

===server===
et.trap_SendConsoleCommand( '''when''', '''command''' )
:Sends the command '''command''' to the server console, to be executed '''when''' (see et.EXEC_* constants)
 

===clients===
et.trap_DropClient( '''clientnum''', '''reason''', '''ban_time''' )
:Disconnects '''clientnum''' from the server, with descriptive string '''reason''' reported to clients. '''ban_time''' is the time in seconds to ban the client from the server. '''ban_time''' is optional and may be entirely omitted, in which case the ban time defaults to the cvar ''b_defaultbantime''
et.trap_SendServerCommand( '''clientnum''', '''[[SendServerCommand|command]]''' )
:Sends the command '''[[SendServerCommand|command]]''' to the client '''clientnum'''. If '''clientnum''' is -1, the '''[[SendServerCommand|command]]''' is broadcast to all connected clients.
et.G_Say( '''clientNum''', '''mode''', '''text''' )
:Sends a chat command on behalf of client '''clientNum''' with the mode '''mode''' (see et.SAY_* constants) and chat text '''text'''.
et.ClientUserinfoChanged( '''clientNum''' )
:Loads the new [[Userinfo]] of '''clientNum''' and stores it in the configstring and client variables
 

===userinfo===
'''userinfo''' = et.trap_GetUserinfo( '''clientnum''' )
:Returns the contents of the [[Userinfo]] string for the client '''clientnum'''
et.trap_SetUserinfo( '''clientnum''', '''userinfo''' )
:Sets the [[Userinfo]] string for the client '''clientnum''' to '''userinfo'''
 

===string utility functions===
'''infostring''' = et.Info_RemoveKey( '''infostring''', '''key''' )
:Removes key '''key''' from infostring '''infostring''' and returns the modified infostring.
'''infostring''' = et.Info_SetValueForKey( '''infostring''', '''key''', '''value''' )
:Sets the key '''key''' in the infostring '''infostring''' to '''value''' and returns the modified infostring. If '''value''' is an empty string, '''key''' is removed from the string.
'''keyvalue''' = et.Info_ValueForKey( '''infostring''', '''key''' )
:Returns the value of the key '''key''' in the infostring '''infostring'''. If '''key''' is not present in the string, an empty string is returned.
'''cleanstring''' = et.Q_CleanStr( '''string''' )
:Returns '''string''' stripped of all color codes
 

===ET filesystem===
'''fd''', '''len''' = et.trap_FS_FOpenFile( '''filename''', '''mode''' )
:Attempts to open the file '''filename''' with the access mode '''mode''' (see et.FS_ constants). Returns the filedescriptor '''fd''' and file length '''len'''. On error, '''len''' returns -1.
'''filedata''' = et.trap_FS_Read( fd, count )
:Reads '''count''' bytes from filedescriptor '''fd'''.
'''count''' = et.trap_FS_Write( '''filedata''', '''count''', '''fd''' )
:Attempts to write '''count''' bytes of '''filedata''' to filedescriptor '''fd'''. Returns number of bytes successfully written.
et.trap_FS_Rename( '''oldname''', '''newname''' )
:Renames file '''oldname''' to '''newname'''.
et.trap_FS_FCloseFile( '''fd''' )
:Closes filedescriptor '''fd'''
 

===indexes===
'''soundindex''' = et.G_SoundIndex( '''filename''' )
:Returns an index to the soundfile indicated by '''filename'''
'''modelindex''' = et.G_ModelIndex( '''filename''' )
:Returns an index to the model indicated by '''filename'''
 

===sound===
et.G_globalSound( '''sound''' )
:Plays the global sound indicated by the filename '''sound'''.
et.G_Sound( '''entnum''', '''soundindex''' )
:Plays the sound '''soundindex''' at the location of entity '''entnum'''
 

===miscellaneous===
'''milliseconds''' = et.trap_Milliseconds()
:Returns a number indicating the current server time in milliseconds.
et.G_Damage( '''target''', '''inflictor''', '''attacker''', '''damage''', '''[[etdamage|dflags]]''', '''[[etdamage|mod]]''' )
:Does '''damage''' amount of damage on '''target''' inflicted by '''inflictor''' and cased by '''attacker'''
:'''target''', '''inflictor''', '''attacker''' are entity numbers
:'''[[etdamage|dflags]]''' is a [[Bitmask-cvar|bitflag]] number to decide how the damage is inflickted, see '''[[etdamage|dflags]]''' [[etdamage|flaglist]]
:'''[[etdamage|mod]]''' is a number from 0 up to 64 o set the type of damage, see '''[[etdamage|mod]]''' [[etdamage|list]]
 

===entities===
'''entnum''' = et.G_Spawn()
:Spawns a new entity and returns the new entity number.
'''entnum''' = et.G_TempEntity( '''origin''', '''event''' )
:Spawns a new TempEntity of event type '''event''' and places it at '''origin''' in the world.
:'''Warning:''' up to and including ETPro 3.2.4 the signature of the method is broken and expects four instead of two parameters. To successfully call it, you need to prepend the parameter list with two dummy parameters like et.G_TempEntity( 0, 0, origin, event ). Use this method with care, because in future ETPro versions it will probably be corrected to the one stated above and might break your script.
et.G_FreeEntity( '''entnum''' )
:Frees the entity '''entnum'''
'''spawnval''' = et.G_GetSpawnVar( '''entnum''', '''key''' )
:Returns the value of spawnvar '''key''' for entity '''entnum'''
et.G_SetSpawnVar( '''entnum''', '''key''', '''value''' )
:Sets the spawnvar '''key''' to '''value''' for entity '''entnum'''
'''integer entnum''' = et.G_SpawnGEntityFromSpawnVars( string spawnvar, string spawnvalue, ... )
:This function can only be called inside the '''et_InitGame''' callback
et.trap_LinkEntity( '''entnum''' )
:Links the entity '''entnum'''
et.trap_UnlinkEntity( '''entnum''' )
:Unlinks the entity '''entnum'''
'''(variable)''' = et.gentity_get ( '''entnum''', '''[[Fieldname]]''' '',arrayindex'' )
:Gets the value of '''[[Fieldname]]''' from entity '''entnum''' out of the g_entity struct. For NULL entities or clients, ''nil'' is returned. 
:''arrayindex'' is used to specify which element of an array entity field to get. It is required when accessing array type fields. Entity field array indexes start at 0.
et.gentity_set( '''entnum''', '''[[Fieldname]]''', ''arrayindex,'' '''(value)''' )
:Sets the value of '''[[Fieldname]]''' from entity '''entnum''' in the g_entity struct to '''(value)'''
:''arrayindex'' is used to specify which element of an array entity field to set.
et.G_AddEvent( '''ent''', '''event''', '''eventparm'''' )
:Adds event '''event''' whit eventparameter '''eventparm'''' to entity '''ent'''
 

==callbacks==

===qagame execution===
et_InitGame( '''levelTime''', '''randomSeed''', '''restart''' )
:Called when qagame initializes. '''levelTime''' is the current level time in milliseconds. '''randomSeed''' is a number that can be used to seed random number generators. '''restart''' indicates if et_InitGame() is being called due to a map restart (1) or not (0).
et_ShutdownGame( '''restart''' )
:Called when qagame shuts down. '''restart''' indicates if the shutdown is being called due to a map_restart (1) or not (0).
et_RunFrame( '''levelTime''' )
:Called when qagame runs a server frame. '''levelTime''' is the current level time in milliseconds.
et_Quit()
:Called when ETPro unloads the mod. The mod should close all open filedescriptors and perform all cleanup.
 

===client management===
'''rejectreason''' = et_ClientConnect( '''clientNum''', '''firstTime''', '''isBot''' )
:Called when a client attempts to connect to the server. '''clientNum''' is the client slot id, '''firstTime''' indicates if this is a new connection (1) or a reconnection (0). '''isBot''' indicates if the client is a bot (1) or not (0). If the mod accepts the connection, it should return nil. Otherwise, the mod should return a string describing the reason the client connection was rejected.
et_ClientDisconnect( '''clientNum''' )
:Called when a client disconnects. '''clientNum''' is the client slot id.
et_ClientBegin( '''clientNum''' )
:Called when a client begins (becomes active, and enters the gameworld). '''clientNum''' is the client slot id.
et_ClientUserinfoChanged( '''clientNum''' )
:Called when a client's [[Userinfo]] string has changed. '''clientNum''' is the client slot id.
et_ClientSpawn( '''clientNum''', '''revived''' )
:Called when a client is spawned. '''clientNum''' is the client slot id. '''revived''' is 1 if the client was spawned by beeying revived.
 

===commands===
'''intercepted''' = et_ClientCommand( '''clientNum''', '''command''' )
:Called when a command is received from a client. '''clientNum''' is the client slot id. '''command''' is the command. The mod should return 1 if the command was intercepted by the mod, and 0 if the command was ignored by the mod and should be passed through to the server (and other mods in the chain).
:The actual command can be accessed through the [[#argument_handling|argument handling]] functions, as seen in the [[ETPro:Lua Sample Code]].
'''intercepted''' = et_ConsoleCommand()
:Called when a command is entered on the server console. The mod should return 1 if the command was intercepted by the mod, and 0 if the command was ignored by the mod and should be passed through to the server (and other mods in the chain).
:The actual command can be accessed through the [[#argument_handling|argument handling]] functions, as seen in the [[ETPro:Lua Sample Code]].
 

===xp===
et_UpgradeSkill( '''cno''', '''skill''' )
:Called when client on slot '''cno''' gets an upgrade on skill '''skill'''. Return -1 to override (abort) the qagame function, anything else to "passthrough". Callback may modify skills (or do anything else it wants) during passthrough.
et_SetPlayerSkill( '''cno''', '''skill''' )
:Called when clients (on slot '''cno''') skill level '''skill''' is set. Return -1 to override (abort) the qagame function, anything else to "passthrough". Callback may modify skills (or do anything else it wants) during passthrough.
 

===miscellaneous===
et_IPCReceive( '''vmnumber''', '''message''' )
:Called when another mod sends an et.IPCSend() message to this mod. '''vmnumber''' is the VM slot number of the sender, and '''message''' is the message.
et_Print( '''text''' )
:Called whenever the server or qagame prints a string to the console.
et_Obituary( '''victim''', '''killer''', '''meansOfDeath''' )
:Called whenever a player is killed.
 

==predefined constants==
et.EXEC_NOW 
et.EXEC_INSERT 
et.EXEC_APPEND 
et.FS_READ 
et.FS_WRITE 
et.FS_APPEND 
et.FS_APPEND_SYNC 
et.SAY_ALL 
et.SAY_TEAM 
et.SAY_BUDDY 
et.SAY_TEAMNL 
 
et.HOSTARCH
:set to WIN32 or UNIX depending on the host architecture qagame is running on.
LUA_PATH
:set to fs_homepath/fs_game/?.lua in order to ease use of the [http://www.lua.org/pil/8.1.html require] function.
 

==configs==
If a config is loaded, all modules are shutdown and reloaded. If a ''certified'' config is loaded, all modules are shutdown and reloaded, and additionally the following functions are disabled: '''require()''', '''loadfile()''', '''loadlib()''', '''loadstring()''', '''dofile()''' 
 

==caveats==
Like qagame, lua modules are unloaded and reloaded on map_restart and map changes. This means that all global variables and other information is lost. Mods may choose to store persistent data in cvars or external files. 
 

==FAQ==

Q: OMG I hate the libary prefix et.* on everything!!11!1oneone 
A: table.foreach(et, function (func, value) _G[func] = value; end)

Q: How do a reload my lua file without restarting the whole server? 
A: Change maps, use map_restart or reset_match

Q: Can I see some sample code? 
A: [[ETPro:Lua Sample Code|Lua sample code]]

Q: Is there a list of [[ETPro]] mods? 
A: Yes, [[:Category:ETPro:Mods|here]].

Q: OMG my mod doesn't work! 
A: Make sure you added your mod's filename to the lua_modules cvar (e.g. set lua_modules mymod.lua).

Q: OMG why has et_ClientSay been removed? 
A: Thats a secret but, to keep the function as it was, just add the following code to your et_ClientCommand() function 
<pre> -- et_ClientSay had to be removed in order to intercept all commands
-- so here's a wrapper for that
arg0 = et.trap_Argv(0) -- get the main command

if arg0 == "say" then
return et_ClientSay( clientNum, et.SAY_ALL, et.ConcatArgs(1))
elseif arg0 == "say_team" then
return et_ClientSay( clientNum, et.SAY_TEAM, et.ConcatArgs(1))
elseif arg0 == "say_buddy" then
return et_ClientSay( clientNum, et.SAY_BUDDY, et.ConcatArgs(1))
elseif arg0 == "say_teamnl" then
return et_ClientSay( clientNum, et.SAY_TEAMNL, et.ConcatArgs(1))
end
-- et_ClientSay wrapper end
</pre>

[[Category:Lua]]

Network Diagnostics

2007-02-01T09:49:45Z

ReyalP:

If you are having lag in game, seeing yellow, red or excessive spikes in the [[Lagometer]], experiencing long times in awaiting gamestate, or seeing [[AntiWarp]] triggered a lot in etpro, you can do some basic testing on your connection with <tt>ping</tt> and <tt>tracert</tt>. The following examples use windows command names and options, linux is slightly different.

First, tracert to somewhere (don't really matter, use the IP of an ET server you like to play on, or your ISPs website or google) like this, in a command prompt:
tracert www.google.com
The output will be something like this:
Tracing route to www.l.google.com [66.102.7.99]
over a maximum of 30 hops:
1 <1 ms <1 ms <1 ms 192.168.1.1 [192.168.1.1]
2 14 ms 13 ms 13 ms rdns.of.your.isp.gateway [1.2.3.4]
3 13 ms 14 ms 13 ms rdns.of.some.other.router[5.6.7.8]
...

The first hop (with the < 1ms ping times) either your router or modem. The next hop is usually the far end of your broadband line. If thing ping time of the second hop is also very low (<10ms) it is your modem, and the hop after that is the other end. Don't be alarmed if some of the later hops drop packets in tracert, as a fair number of routers drop these, even when they forward normal traffic without problems. In general, if one hop drops all packets, but the subsequent hops still work, it just means that particular device doesn't respond to tracert packets.

To test your connection between you and your router, use:
ping -n 100 -l 1000 <ip.of.your.router>
The -n 100 means to use 100 packets, and the -l 1000 means use 1000 byte packets (that's a lower case L). Larger packets are far more likely to show up line problems.

This should give zero packet loss and <10ms pings. If it gives you packet loss, either your router sucks, your Ethernet cable is bad, or perhaps some setting for your Ethernet card is incompatible.

To test your line (the connection from your house to your ISPs equipment), find the IP of the first hop that isn't your router or modem (i.e. the first one that has a >10ms time in the tracert output), and ping it with the same command. Any packet loss most likely indicates a problem (unless its 100%, in which case, it is likely that router is simply ignoring your pings). The pings times should be fairly steady if there is no other traffic on the line, typically in the range of 20-80 ms for DSL or cable with this packet size. If there is any significant packet loss, chances are you need to complain to your ISP. If there is significant variation (+/- 20% or more) and your line does not have other traffic on it, that may also indicate a problem.

You can move on down the IPs listed in the tracert using the same method, if you want, however, if the problem is in a router that is more than a couple hops away, chances are it is a temporary issue, and you can't do much to get it fixed.

Server Configuration

2007-01-07T04:54:08Z

ReyalP: tjw etded guide

==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.
==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

2007-01-07T04:18:18Z

ReyalP: tips

ETTVd

2007-01-07T01:33:36Z

ReyalP: disclaimer

<table width="98%" cellpadding="0" cellspacing="0">
<tr>
<td colspan="2">
<div style="border:1px solid #AAAAAA; padding:0em 1em 1em 1em; background-color:#F9F9F9;">http://arni.name/etpro/ettvd_small.png
logo kindly provided by conr4d

ETTVd is a control daemon for ETTV servers and manages your live broadcasts, demos and and replays. It's completely written in PHP. '''note:''' ETTVd is not developed or supported by the ETTV/ETPro team. Questions or comments should be directed to the ETTVd authors.
</div>
</td>
</tr>
<tr>
<td width="50%" valign="top">
<div style="margin-right:10px; margin-top:5px; border:1px solid #AAAAAA; padding:0em 0em 0em 1em; background-color:#F9F9F9;">
'''Download:''' 
[http://arni.name/etpro/ETTVd_2.02.zip ETTVd v2.02] 
    [http://eicher.homelinux.com/ettvd/ETTVd_b2.01.zip Mirror 1] (Eicher) (b2.01) 
    [http://eraser.homelinux.com/kai/etpro/ETTVd_b2.tar Mirror 2] (engee) (b2.00) 

[http://arni.name/etpro/screenshots/ Screenshots] (Webinterface)
</div>
<div style="margin-top:10px; margin-right:10px; padding:0em 0em 0em 1em; border:1px solid #AAAAAA; background-color:#F9F9F9;">
'''Quicklinks:''' 
* [[ETTVd:commands]]
* [[ETTVd:Readme]]
* [[Requirements]]
* [[ETTVd:Known_Bugs]]
</div>
</td>
<td width="50%" valign="top">
<div style="margin-top:5px; border:1px solid #AAAAAA; padding:0em 1em 1em 1em; background-color:#F9F9F9;">
'''Feature Summary:''' ([[Features|entire list]])
* Replay of recorded games
* Multiple broadcast servers showing the same or different games in Live, Semi-Live or Replay mode.
* Announcer for next game, current game both ingame and in sv_hostname
* Spam protection with a sticky mute system (/reconnect doesnt help)
* Display of intermediate maptimes
* Ingame admin commands !mute, !kick, !reclist, etc
* Simultanious recording of as many games as you want (limited by cpu/ram)
* Constantly maintaining the correct ettv_delay
* Start of recording when enough players are ready
* Recording pause when players leave the server
* Disconnect from matchserver after timeout
* Fully painless matchserver crash recovery
* Recovery of all sorts of ettv broadcaster crashes (replayers continue where they crashed)
* Complete demo management for archiving
* Replay Playlists or playing specific games again
* Maximum recorders, replayers, slots that can be spawned from the control interface
* A fully featured webinterface (by skooli)
* Most settings configurable in a single file
* ETTVoD ready
</div>
</td>
</tr>
</table>

AntiWarp

2006-12-11T06:13:11Z

ReyalP: /* Controlling the antiwarp system */

ET Pro implements an antiwarp system to keep players from "warping" or "teleporting" around, accidentally or intentionally.

== Controlling the antiwarp system ==

'''b_antiwarp''' is a server cvar which controls the antiwarp system. The possible settings are:
<pre>0 - disabled. ET Pro does no antiwarp at all.
1 - enabled (default). ET Pro keeps players from "warping"</pre>

== What is "warping" ==

"Warping" occurs when the server receives several new commands for a player in a very short period of time. This happens because packets from the player were lost or never sent. The player will appear to cross a great distance in a very short period of time, making them hard to hit and possibly allowing them to avoid landmine damage.

== How the antiwarp system keeps players from warping ==

The antiwarp system in ET Pro delays commands when they are received too quickly. Thus, when a player sends 700ms worth of commands in 50ms, the commands will be spread out over 700ms, causing the player to move smoothly to other players. This affects the player who sent the commands too quickly only by increasing their ping, and will not keep increasing ping endlessly - at maximum, the added ping is the highest ping the player is actually getting. If temporary network issues cause ping to increase beyond a sensible number, the player can stand still for a moment and their ping will normalize.

== Antiwarp on the lagometer ==
If antiwarp is triggered, it shows up on the [[Lagometer]] as a translucent green like this. The drop at the end shows how the added lag of antiwarp drops off if you stop for a moment.

http://www.collectivecomputing.com/~reed/et/etss/lagometer-antiwarp.jpg
[[Category:ETPro:Server_Cvars]]

Talk:Lua Mod API

2006-12-07T01:14:24Z

ReyalP: /* Fields for the next release */

- et.G_SlotSound( slotnum, soundindex ) -> Plays the sound soundindex at for the player @ slotnum only. --[[User:RoadKillPuppy|RoadKillPuppy]] 14:17, 16 December 2005 (PST)
:you can do this with tempentities and SVF_SINGLECLIENT ...
:--[[User:Bani|Bani]] 17:32, 16 December 2005 (PST)

----
some of this can be done via function et_Print(text).. but this would greatly simplify life, 
my wish list for christmas: 
- getUserEguid(cno) - get a client's etpro guid? 
- repair gentity_set for vec3 - scotty fix the transporter please 
:[http://bani.anime.net/banimod/forums/viewtopic.php?t=6279 fixed.]--[[User:Bani|Bani]] 17:56, 22 December 2005 (PST)

trap sen server cmd is a ET engine trap the comand u send it send to the client and recived as a server command no a client command

to add ill well that would be al ot of coding for not much [[User:=FF=im2good4u|=FF=Im2good4u]] 12:12, 20 December 2005 (PST)

aight thnx. 
heres another api request, i'd like to be able to get a clients xp directly. et.gentity_get(cno, "sess.game_points") seems to return 0 always (?) 
--[[User:Hadr0|Hadr0]] 15:38, 21 December 2005 (PST)
:oh nevermind, i see this can be done now with xp = et.gentity_get(cno, "ps.stats", 8)
:nice... --[[User:Hadr0|Hadr0]] 16:58, 23 December 2005 (PST)
--------
add a way to determine if a client is 999, and if possible why he's 999 (loading, connecting, loosing packets, etc) 
--Gotenks

999 means: server has not been sent data from client for > 1000 ms. So there is no way to certainly tell why.
The timeoutflag is stored in the pmflags IIRC. Don't know if lua can read them right now. --[[User:Deus|Deus]] 23:12, 22 December 2005 (PST) 
Still would like access to the ping, or a dummy variable if they are 999, but also the ammount of time they are inactive. 
--[[User:Gotenks|Gotenks]] (Sorry for double post) 1:53, 31 December 2005 (CST)
:[http://bani.anime.net/banimod/forums/viewtopic.php?t=6291 fixed].--[[User:Bani|Bani]] 02:40, 7 February 2006 (PST)
----
Access to weapon stats during game similar to end of round stats that are displayed. 
--[[User:LethalInjection|LethalInjection]] 23:52, 22 December 2005 (PST)
:[http://bani.anime.net/banimod/forums/viewtopic.php?t=6291 fixed].--[[User:Bani|Bani]] 02:40, 7 February 2006 (PST)

----

== IPC stuff ==

<hr>
i would like a et_IPCReceive whit an return value so u can send info back on a request

i would like a et_IPCSend that can send to all lua mods then them mods can decide if the wana use that message or not
[[User:=FF=im2good4u|=FF=Im2good4u]] 12:35, 8 January 2006 (PST)
<hr>
et_IPCReceive wouldn't send it to the other mod... afaik... so just use another send
just et_IPCSend to all modules (afaik, you can even send to ones not there), simple loop function
[[User:gotenks|gotenks]] 20:04, 8 January 2006 (CST)

yeh probely but its not verry handy its better to get the good vmnumber or to e able to send on mod filenames

apart from that returning a value will be more handy since tnhe u cna contine in 1 funtion else u got to reacise it in the recieve funtion [[User:=FF=im2good4u|=FF=Im2good4u]] 10:45, 9 January 2006 (PST)

<hr>
bani i need a console print function on the client that does sepport ascii plz [[User:=FF=im2good4u|=FF=Im2good4u]] 12:49, 12 January 2006 (PST)
:et.trap_SendServerCommand( clientnum, "print \"hello ascii console on the client\n\" ) ) --[[User:Bani|Bani]] 22:33, 15 January 2006 (PST)
<hr>
bani: how about a et_sound(id, sound) event? [[User:gotenks|gotenks]] 20:45, 17 January 2006 (CST)
:[http://wolfwiki.anime.net/index.php/ETPro:Lua_Mod_API#sound et.G_Sound( entnum, soundindex )] --[[User:Bani|Bani]] 22:07, 18 January 2006 (PST)
:bani, i was referring to an on event call, so when a sound is played et_sound(id,sound) would be called.[[User:gotenks|gotenks]] 21:45, 20 January 2006 (CST)
::most sounds are clientside... this would not be of much use. --[[User:Bani|Bani]] 04:42, 22 January 2006 (PST)
:::except for checking when something like a killing spree sound is activated--[[User:gotenks|gotenks]] 07:54, 23 January 2006 (CST)
:::::There would be no way for you to know what sound was activated. You can't get a filename from the soundindex.--[[User:Bani|Bani]] 10:19, 24 January 2006 (PST)
:::::This is a case where IPCSend/IPCReceive would be useful, so mods can notify each other of specific events.--[[User:Bani|Bani]] 02:40, 7 February 2006 (PST)

----
== Fields for the next release ==
Is it possible to get a player's live angles? Fieldname "s.angles" only gives the spawn angles. Tried "rotate", "s.angles2", "TargetAngles", "r.currentAngles" as well but they just give 0.000000 for each element. thanks for any help --[[User:Hadr0|Hadr0]] 01:35, 25 January 2006 (PST)
:This will be fixed in the next release, where you will get access to ps.viewangles--[[User:Bani|Bani]] 02:33, 7 February 2006 (PST)

Would it be possible to set the player's liveangle?Just like setting one's position(origin).I would also like to set player's velocities(maybe a vec3 field), 'speed' is not working. --[[User:Kotoko|Kotoko]] 06:06, 26 May 2006 (PDT)
:viewangles is what you want --[[User:ReyalP|ReyalP]] 14:00, 26 May 2006 (PDT)
Seems i get it ..It WILL BE AVAILABLE at NEXT release ..not now .. right?-_- [[User:Kotoko|Kotoko]] 22:49, 26 May 2006 (PDT)
:I think Kotoko wants the '''ps.velocity''' field here. It would be a good idea, I think. --[[User:FARMICEUDICAL|FARMICEUDICAL]] 20:23, 5 December 2006 (PST)

bani: please give access to fieldname 's.eventParm'. --[[User:Pdi|pdi]] 01:52, 6 July 2006 (PDT)

bani: RW access to all "sess.*" fields (sess.skillpoints, sess.startskillpoints, sess.startxptotal, ...) would be great. thanx! --[[User:Pdi|pdi]] 05:55, 2 August 2006 (PDT)

bani: please make all "pers.*" fields (pers.clientTimeNudge, pers.clientMaxPackets, ...) available. thanx! --[[User:Pdi|pdi]] 01:04, 17 August 2006 (PDT)
:you can get timenudge and maxpackets from the userinfo --[[User:ReyalP|ReyalP]] 20:19, 18 August 2006 (PDT)
::i know, but i ask for all pers.* fields. pers.clientTimeNudge and pers.clientMaxPackets are only examples. :) --[[User:Pdi|pdi]] 01:56, 21 August 2006 (PDT)

bani: will we have rw access to those fields (all sess.* and all pers.*) with next update? please!! --[[User:Pdi|pdi]] 07:02, 19 October 2006 (PDT)

'''ps.weapon''', so arbitrary weapons can be added to or removed from arbitrary classes. For example, trickjump servers don't like Field Ops spamming airstrikes or artillery, but they do appreciate the ammo they give out. --[[User:FARMICEUDICAL|FARMICEUDICAL]] 21:09, 5 December 2006 (PST)
: ps.weapon won't do that for you. ps.weapon'''s''' might :) --[[User:ReyalP|ReyalP]] 17:14, 6 December 2006 (PST)

== LoadLib ==

Add loadlib ppl it says u have lua basic included but not loadlib !!

(on windows it gives an error attept to call global load lin a nil valua)[[User:=FF=im2good4u|=FF=Im2good4u]] 05:16, 15 February 2006 (PST)
----
== XP control not just skill ==

I would like to request RW access to the "sess.skillpoints" array

At least a callback on et.G_AddSkillPoints ( '''cno''', '''skill''', '''points''' ) [[User:=FF=im2good4u|=FF=Im2good4u]] 07:45, 8 March 2006 (PST)

Client Configuration

2006-11-22T02:36:19Z

ReyalP: /* Warnings */

==Client Side Install==
;To play ETPro online
Simply connect to an ETPro server with downloads enabled on your client. 
;To host your own game
Download the desired ETPro .zip from the [http://etpro.anime.net/download.html ETPro download page] and unzip it into your ET directory, then start ET with fs_game set as described below. 
For additional information see the [http://wolfwiki.anime.net/index.php/ETPro:Server_Configuration Server Configuration page]
;To play demos
<ul>
<li>Open the [http://bani.anime.net/etpro/download.html PK3] in a program that can handle <tt>zip</tt> files. Extract the following files to the ETPro directory:
:cgame_mp_x86.dll
:ui_mp_x86.dll
<li>Start the client with the <tt>+set fs_game etpro</tt>.
<ul><li>Command line: Append <tt>+set fs_game etpro</tt> to the command line.
<li>Windows Shortcut: Append <tt>+set fs_game etpro</tt> to the target box, usually after <tt>"C:\Program Files\Wolfenstein - Enemy Territory"</tt>. Make sure to place it after the double-quote.</ul>
</ul>

==Warnings==
While viewing a demo: Client/Server game mismatch: 'Enemy Territory/ET pro 
While viewing a demo: Unknown event: 131 
While viewing a demo: BG_EvaluateTrajectory: unknown trType: 0 
While viewing a demo: BG_IndexForString: unknown token 'NOT' 
:This happens when you use the wrong client to playback ETPro 3 demos. The solution is to extract cgame_mp_x86.dll and ui_mp_x86.dll from the most recent [http://bani.anime.net/etpro/download.html ETPro PK3] and put it in your ETPro directory.

While viewing a demo: demo file was truncated or CL_ReadDemoMessage: demoMsglen > MAX_MSGLEN:
:This happens when cl_autorecord is non-zero. Set cl_autorecord to 0
:the above messages could also be caused by a corrupt demo file.

==Related links==
*[http://rarlabs.com/download.htm WinRAR] - Can open PK3 files (Recommended).
*[http://www.winzip.com WinZip] - Can open PK3 files.
*[[:Category:ETPro:Client Cvars|Client cvars]].
*[[Client cvar list]].
*[[Server Configuration]].
*[[Performance Tuning]].

==Additional troubleshooting==
Most problems with hosting games and playing demos, as well as some problems with playing online, are caused by having multiple versions of the etpro files present, or simply having too many files.
;For reliable demo playback and local hosting
* There should be only one etpro-X_Y_Z.pk3 in your etpro directory.
* Unless you have a specific reason to do otherwise, always use the most recent version. ETPro is backwards compatible with older demos, as well as demos from etmain.
* The ui and cgame .dll files in the etpro directory must match those in the etpro .pk3 file. Extract them as described above.
* Many servers force you to download additional skin packs, sound packs, other content. All of this will be present in demo playback or hosted games, unless your move the corresponding files to somewhere that outside of etpro or etmain, or delete them.
*In addition to the etpro .pk3 the following are required by ET.
** mp_bin.pk3
** pak0.pk3
** pak1.pk3
** pak2.pk3
To play back a demo, you must also have the .pk3 corresponding to the map it was recorded on. All other .pk3 files may be safely deleted or moved to another directory.

[[Category:ETPro]]

ETPro:Pluggable Config Files

2006-11-14T22:00:59Z

ReyalP: /* Config file details */ mapscripthash

ETPro supports '''Pluggable Config Files'''. These files provide servers the use of additional features not available from traditional <tt>.cfg</tt> files.

==Creation and Installation==
Config files must be located in <tt>etpro/configs</tt> and their names must end in <tt>.config </tt>

==Config file format==
The following shows the .config syntax. This is not a complete config, the ... indicates that in a real config many similar commands would follow

configname "^/foobar^f 6v6"
// config for 6v6 foobar league
version 1.2.3.4 foobar6v6.version.foobarleague.com
init
{
setl sv_pure 1
setl sv_cheats 0
setl g_gametype 3
...
command "pb_sv_enable"
command "pb_sv_kicklen 1"
command "pb_sv_cvarempty"
...
}
map default
{
set g_userTimeLimit 0
setl g_useralliedrespawntime 0
setl g_useraxisrespawntime 0
setl b_moverscale 1
}
map radar
{
set g_userTimeLimit 12
command "forcecvar r_drawfoliage 0"
}
...
signature deadbeefdeadbeefdeadbeefdeadbeefdeadbeef
===Config file details===
;comments : any text following // is a comment and is ignored

;version w.x.y.z some.dns.name : ET will check that version matches the IP returned form some.dns.name If it does, ETPro displays the message "config is latest version available" to all players in warmup. '''not fully implemented''' - etpro doesn't currently do the DNS check.

;configname <name> : defines the name of the config. This name is displayed to players in warmup, but is '''not''' used to refer to the config in config related commands. The name may contain ET [[Color Codes]]

;init : The init block is executed only once, when the config is loaded by referee or rcon/console. It is never reloaded.

;map <mapname>|default : The map blocks are loaded on every map_restart. The parameter is the mapname to match to. A parameter of default will execute that block for all maps. map blocks are executed in order from first to last. Generally you want your default block first, and then specific map blocks to override it.

;signature <sig> : provides crypotgraphic signature to verify that that the config is unmodified. ETPro displays the message "config is certified" to all players in warmup. The signature must be generated by the etpro team.

'''init''' and '''map''' are followed by a block, delimited by curly braces {}. Each block can contain the following keywords

;set <cvarname> "value" : sets the specified cvar to the specified value.
;setl <cvarname> "value" : sets the specified cvar to the specified value, and locks it so that it cannot be changed by rcon, forcecvar or other means until the config is unloaded
;command "command text" : execute "command text"
;mapscripthash <hash> : Require a particular mapscript be used for a map. Must appear in a non-default map section. The hash can be found by loading the map and checking the value of the readonly server cvar b_mapscripthash. If the mapscript does not match when the map is loaded, a message will be sent to all players, and the config will be unloaded.

==Config related commands==
;callvote | ref config <config file name> : set the current config by vote or ref.
;config <config file name>|none : set the current config from the server console, or unload the current config. Settings set by the config remain in effect, but are no longer locked. Map specific blocks are no longer in effect.
''notes'':
:*<tt>config none</tt> can only be used from the console (or rcon) not ref or vote.
:*you must use the filename of the .config (minus the .config extension), not the 'configname' contained in the .config file. The 'configname' is a longer (possibly colored etc) descriptive name.
:*'''do not''' try to load a config with <tt>set config <configname></tt>. This will cause the <tt>config</tt> and <tt>ref config</tt> commands to stop working until the server is restarted.

==Common pitfalls to watchout for==
*Any cvar that isn't a number (vote_allow_config, b_watermark, b_levels_medic etc) must have quotes around it's value, even if its value is a single character.
*XP levels lists should not have commas in them (b_levels_medic etc)
*Putting cvars in groups alphabetically as above makes it a lot easier to maintain and verify.
*Make sure there is an extra newline at the end of the file (after the closing '}')
*Test your <tt>.config</tt> - you can do this simply by putting it in your /etpro/configs directory, and starting ET with <tt>+set dedicated 2 +exec server.cfg</tt>, then calling the <tt>.config</tt> with <tt>/config NAME</tt>. The console will report any major syntax errors in the <tt>.config</tt>
*Make sure to include all relevant gameplay-related cvars. Most are included in [http://bani.anime.net/banimod/forums/viewtopic.php?t=4558#43204 this list].

==Getting Your Configuration Certified==
The easiest way is to send a private message to [http://bani.anime.net/banimod/forums/profile.php?mode=viewprofile&u=2 bani] or [http://bani.anime.net/banimod/forums/profile.php?mode=viewprofile&u=800 Rain] or [http://bani.anime.net/banimod/forums/profile.php?mode=viewprofile&u=1462 zinx] or [http://bani.anime.net/banimod/forums/profile.php?mode=viewprofile&u=761 ReyalP] with the URL using the [http://bani.anime.net/banimod/forums/privmsg.php?folder=sentbox ETPro forums], including a link to the <tt>.config</tt> hosted on the league's website.

An alternate way, if the first way fails, is to talk to one of the [[ETPro Developer]]s on [[IRC]].

==See also==
*[[Cvar Restrictions]]
*[[Forced Cvars]]
*[[WolfWiki:Community_Portal#Leagues / Competitions]] is a good place to find full config file examples.

[[Category:ETPro]]

Lagometer

2006-10-20T07:28:23Z

ReyalP: cg_lagometer 2

Enemy Territory provides a small graph with some network information which can be enabled by setting cg_lagometer to 1. Although this is not a feature specific to ET Pro, it has never been well-documented.

The lagometer consists of two graphs--the upper is the frame graph, and the lower is the snapshot graph. New data is added to the frame graph every time the client renders a frame (so this graph will move faster at higher framerates), and new data is added to the snapshot graph every time a snapshot packet is received from the server.

==Snapshot Graph==
The snapshot graph is the easiest to understand--it is essentially a graph of the latency (ping) between you and the server. The graph's colors provide some additional information: green is normal, yellow indicates that the snapshot was delayed so that the server would not exceed the rate value (either rate on your client, or sv_maxRate on the server, whichever is lower), and red indicates that a snapshot was lost entirely (i.e. a snapshot sent by the server never made it to the client, probably due to network problems.)

http://www.themuffin.net/etpro/lagometer-snap.png

In the above image, arrow 1 points to a normal snapshot with a ping of about 130ms, arrow 2 points to 700ms of packet loss,
and arrow 3 points to 2 snapshots that were delayed to stay under the rate limit.

==Frame Graph==
The frame graph is a little more complicated, and requires some background information about how Enemy Territory's network code works for a full understanding. In Enemy Territory, each client runs at a non-fixed frame rate (depending on configuration, system performance, etc.) while the server runs at a fixed rate of 20 frames per second. After running each frame, the server will send a snapshot to every client (so long as the client's snaps and rate settings allows it) describing everything that has changed since the previous snapshot. When the client receives this snapshot, it interpolates the values between the old snapshot and the snapshot that was just received--that is, it smooths out the movement so that things in the map don't appear to be jumping around when the client is drawing frames faster than the server is sending them. If the client doesn't receive a snapshot, it may have to guess where an object is going to be in order to keep things looking normal.

The client and the server each keep track of the current game time, and the differences between these times are expressed in the frame graph as well as object movement. For a simple example of this, imagine that the server has sent you two snapshots, snapshot a at time 12350, and snapshot b at time 12400¹, and then imagine that the client's current time is 12375. The client will interpolate² the position sent in snapshot a and in snapshot b to determine that the object in question should be drawn in the middle of the two points sent (because 12375 (the time our client is drawing for) is exactly halfway between 12350 and 12400.)

In the situation presented in the previous paragraph, imagine the client's time is 12425 and that no additional snapshots have been received yet. In order to maintain fluid motion, the client will need to guess where objects will be (using the last known position, angle, and velocity.) The calculation for this is quite not as easy to explain, so an example has been omitted for brevity.

The frame graph in the lagometer represents how far the time used for currently drawn image is away from the most recently received snapshot, and whether the client interpolated or extrapolated to obtain the positions used. Normally, the client interpolates positions, which is represented in blue on the lagometer; the graph height will spike downwards when a new snapshot is received, then crawl upwards towards the baseline), although it will sometimes be yellow to indicate extrapolation (and the graph will crawl upwards away from the baseline as the client extrapolates farther and farther from the last known data.) Since the cl_timenudge cvar causes the world to be rendered a certain number of milliseconds behind or ahead of the client's internal time, negative values may cause extrapolation during normal gameplay. For example, in the first situation described above (where the client's time is 12375), a cl_timenudge value of -30 would end up pushing the time used for rendering up to 12405 (which is newer than the data we have), so a small amount of extrapolation (5ms) would be required here.

http://www.themuffin.net/etpro/lagometer-frame.png

In the above image, arrow 1 points to an interpolated frame immediately after a new snapshot was received,
and arrow 2 points to a frame where a fair bit of extrapolation was performed.

==AntiWarp==
If etpro [[AntiWarp]] is triggered, it the delay added by the antiwarp system is represented by translucent green bars
in ths snapshot graph, like this

http://www.collectivecomputing.com/~reed/et/etss/lagometer-antiwarp.jpg
==FPSometer==
In etpro, cg_lagometer 2 replaces the standard ET lagometer with a graph of frame time. The bars hight shows the time required to render a frame, and they are color coded as follows
* Red > 35ms
* Yellow > 20ms
* Green <= 20ms

'''Footnotes'''
----

'''¹''' Note the increase of exactly 50 -- remember that the server is running at 20 frames per second, so:
<table border="0"><tr><td valign="center">1 frame ·</td><td align="center">1000ms (1 second)<hr style="border-top: solid #000 1px;">20 frames</td><td>= 50ms</td></tr></table>

'''²''' This is technically called ''linear interpolation'' (the simplest interpolation method), which is sometimes abbreviated to ''lerp''ing.

[[Category:ETPro:Client_Cvars]]

Network Diagnostics

2006-10-19T22:26:23Z

ReyalP: tired of pasting this in different forums

If you are having lag in game, experiencing long times in awaiting gamestate, or seeing [[AntiWarp]] triggered a lot in etpro, you can do some basic testing on your connection with <tt>ping</tt> and <tt>tracert</tt>. The following examples use windows command names and options, linux is slightly different.

First, tracert to somewhere (don't really matter, use the IP of an ET server you like to play on, or your ISPs website or google) like this, in a command prompt:
tracert www.google.com
The output will be something like this:
Tracing route to www.l.google.com [66.102.7.99]
over a maximum of 30 hops:
1 <1 ms <1 ms <1 ms 192.168.1.1 [192.168.1.1]
2 14 ms 13 ms 13 ms rdns.of.your.isp.gateway [1.2.3.4]
3 13 ms 14 ms 13 ms rdns.of.some.other.router[5.6.7.8]
...

The first hop (with the < 1ms ping times) either your router or modem. The next hop is usually the far end of your broadband line. If thing ping time of the second hop is also very low (<10ms) it is your modem, and the hop after that is the other end. Don't be alarmed if some of the later hops drop packets in tracert, as a fair number of routers drop these, even when they forward normal traffic without problems. In general, if one hop drops all packets, but the subsequent hops still work, it just means that particular device doesn't respond to tracert packets.

To test your connection between you and your router, use:
ping -n 100 -l 1000 <ip.of.your.router>
The -n 100 means to use 100 packets, and the -l 1000 means use 1000 byte packets (that's a lower case L). Larger packets are far more likely to show up line problems.

This should give zero packet loss and <10ms pings. If it gives you packet loss, either your router sucks, your Ethernet cable is bad, or perhaps some setting for your Ethernet card is incompatible.

To test your line (the connection from your house to your ISPs equipment), find the IP of the first hop that isn't your router or modem (i.e. the first one that has a >10ms time in the tracert output), and ping it with the same command. Any packet loss most likely indicates a problem (unless its 100%, in which case, it is likely that router is simply ignoring your pings). The pings times should be fairly steady if there is no other traffic on the line, typically in the range of 20-80 ms for DSL or cable with this packet size. If there is any significant packet loss, chances are you need to complain to your ISP. If there is significant variation (+/- 20% or more) and your line does not have other traffic on it, that may also indicate a problem.

You can move on down the IPs listed in the tracert using the same method, if you want, however, if the problem is in a router that is more than a couple hops away, chances are it is a temporary issue, and you can't do much to get it fixed.

ETPro:Pluggable Config Files

2006-10-19T22:05:38Z

ReyalP: /* Getting Your Configuration Certified */

ETPro supports '''Pluggable Config Files'''. These files provide servers the use of additional features not available from traditional <tt>.cfg</tt> files.

==Creation and Installation==
Config files must be located in <tt>etpro/configs</tt> and their names must end in <tt>.config </tt>

==Config file format==
The following shows the .config syntax. This is not a complete config, the ... indicates that in a real config many similar commands would follow

configname "^/foobar^f 6v6"
// config for 6v6 foobar league
version 1.2.3.4 foobar6v6.version.foobarleague.com
init
{
setl sv_pure 1
setl sv_cheats 0
setl g_gametype 3
...
command "pb_sv_enable"
command "pb_sv_kicklen 1"
command "pb_sv_cvarempty"
...
}
map default
{
set g_userTimeLimit 0
setl g_useralliedrespawntime 0
setl g_useraxisrespawntime 0
setl b_moverscale 1
}
map radar
{
set g_userTimeLimit 12
command "forcecvar r_drawfoliage 0"
}
...
signature deadbeefdeadbeefdeadbeefdeadbeefdeadbeef
===Config file details===
;comments : any text following // is a comment and is ignored

;version w.x.y.z some.dns.name : ET will check that version matches the IP returned form some.dns.name If it does, ETPro displays the message "config is latest version available" to all players in warmup. '''not fully implemented''' - etpro doesn't currently do the DNS check.

;configname <name> : defines the name of the config. This name is displayed to players in warmup, but is '''not''' used to refer to the config in config related commands. The name may contain ET [[Color Codes]]

;init : The init block is executed only once, when the config is loaded by referee or rcon/console. It is never reloaded.

;map <mapname>|default : The map blocks are loaded on every map_restart. The parameter is the mapname to match to. A parameter of default will execute that block for all maps. map blocks are executed in order from first to last. Generally you want your default block first, and then specific map blocks to override it.

;signature <sig> : provides crypotgraphic signature to verify that that the config is unmodified. ETPro displays the message "config is certified" to all players in warmup. The signature must be generated by the etpro team.

'''init''' and '''map''' are followed by a block, delimited by curly braces {}. Each block can contain the following keywords

;set <cvarname> "value" : sets the specified cvar to the specified value.
;setl <cvarname> "value" : sets the specified cvar to the specified value, and locks it so that it cannot be changed by rcon, forcecvar or other means until the config is unloaded
;command "command text" : execute "command text"

==Config related commands==
;callvote | ref config <config file name> : set the current config by vote or ref.
;config <config file name>|none : set the current config from the server console, or unload the current config. Settings set by the config remain in effect, but are no longer locked. Map specific blocks are no longer in effect.
''notes'':
:*<tt>config none</tt> can only be used from the console (or rcon) not ref or vote.
:*you must use the filename of the .config (minus the .config extension), not the 'configname' contained in the .config file. The 'configname' is a longer (possibly colored etc) descriptive name.
:*'''do not''' try to load a config with <tt>set config <configname></tt>. This will cause the <tt>config</tt> and <tt>ref config</tt> commands to stop working until the server is restarted.

==Common pitfalls to watchout for==
*Any cvar that isn't a number (vote_allow_config, b_watermark, b_levels_medic etc) must have quotes around it's value, even if its value is a single character.
*XP levels lists should not have commas in them (b_levels_medic etc)
*Putting cvars in groups alphabetically as above makes it a lot easier to maintain and verify.
*Make sure there is an extra newline at the end of the file (after the closing '}')
*Test your <tt>.config</tt> - you can do this simply by putting it in your /etpro/configs directory, and starting ET with <tt>+set dedicated 2 +exec server.cfg</tt>, then calling the <tt>.config</tt> with <tt>/config NAME</tt>. The console will report any major syntax errors in the <tt>.config</tt>
*Make sure to include all relevant gameplay-related cvars. Most are included in [http://bani.anime.net/banimod/forums/viewtopic.php?t=4558#43204 this list].

==Getting Your Configuration Certified==
The easiest way is to send a private message to [http://bani.anime.net/banimod/forums/profile.php?mode=viewprofile&u=2 bani] or [http://bani.anime.net/banimod/forums/profile.php?mode=viewprofile&u=800 Rain] or [http://bani.anime.net/banimod/forums/profile.php?mode=viewprofile&u=1462 zinx] or [http://bani.anime.net/banimod/forums/profile.php?mode=viewprofile&u=761 ReyalP] with the URL using the [http://bani.anime.net/banimod/forums/privmsg.php?folder=sentbox ETPro forums], including a link to the <tt>.config</tt> hosted on the league's website.

An alternate way, if the first way fails, is to talk to one of the [[ETPro Developer]]s on [[IRC]].

==See also==
*[[Cvar Restrictions]]
*[[Forced Cvars]]
*[[WolfWiki:Community_Portal#Leagues / Competitions]] is a good place to find full config file examples.

[[Category:ETPro]]

Lagometer

2006-10-19T21:55:12Z

ReyalP: antiwarp, formatting

Enemy Territory provides a small graph with some network information which can be enabled by setting cg_lagometer to 1. Although this is not a feature specific to ET Pro, it has never been well-documented.

The lagometer consists of two graphs--the upper is the frame graph, and the lower is the snapshot graph. New data is added to the frame graph every time the client renders a frame (so this graph will move faster at higher framerates), and new data is added to the snapshot graph every time a snapshot packet is received from the server.

==Snapshot Graph==
The snapshot graph is the easiest to understand--it is essentially a graph of the latency (ping) between you and the server. The graph's colors provide some additional information: green is normal, yellow indicates that the snapshot was delayed so that the server would not exceed the rate value (either rate on your client, or sv_maxRate on the server, whichever is lower), and red indicates that a snapshot was lost entirely (i.e. a snapshot sent by the server never made it to the client, probably due to network problems.)

http://www.themuffin.net/etpro/lagometer-snap.png

In the above image, arrow 1 points to a normal snapshot with a ping of about 130ms, arrow 2 points to 700ms of packet loss,
and arrow 3 points to 2 snapshots that were delayed to stay under the rate limit.

==Frame Graph==
The frame graph is a little more complicated, and requires some background information about how Enemy Territory's network code works for a full understanding. In Enemy Territory, each client runs at a non-fixed frame rate (depending on configuration, system performance, etc.) while the server runs at a fixed rate of 20 frames per second. After running each frame, the server will send a snapshot to every client (so long as the client's snaps and rate settings allows it) describing everything that has changed since the previous snapshot. When the client receives this snapshot, it interpolates the values between the old snapshot and the snapshot that was just received--that is, it smooths out the movement so that things in the map don't appear to be jumping around when the client is drawing frames faster than the server is sending them. If the client doesn't receive a snapshot, it may have to guess where an object is going to be in order to keep things looking normal.

The client and the server each keep track of the current game time, and the differences between these times are expressed in the frame graph as well as object movement. For a simple example of this, imagine that the server has sent you two snapshots, snapshot a at time 12350, and snapshot b at time 12400¹, and then imagine that the client's current time is 12375. The client will interpolate² the position sent in snapshot a and in snapshot b to determine that the object in question should be drawn in the middle of the two points sent (because 12375 (the time our client is drawing for) is exactly halfway between 12350 and 12400.)

In the situation presented in the previous paragraph, imagine the client's time is 12425 and that no additional snapshots have been received yet. In order to maintain fluid motion, the client will need to guess where objects will be (using the last known position, angle, and velocity.) The calculation for this is quite not as easy to explain, so an example has been omitted for brevity.

The frame graph in the lagometer represents how far the time used for currently drawn image is away from the most recently received snapshot, and whether the client interpolated or extrapolated to obtain the positions used. Normally, the client interpolates positions, which is represented in blue on the lagometer; the graph height will spike downwards when a new snapshot is received, then crawl upwards towards the baseline), although it will sometimes be yellow to indicate extrapolation (and the graph will crawl upwards away from the baseline as the client extrapolates farther and farther from the last known data.) Since the cl_timenudge cvar causes the world to be rendered a certain number of milliseconds behind or ahead of the client's internal time, negative values may cause extrapolation during normal gameplay. For example, in the first situation described above (where the client's time is 12375), a cl_timenudge value of -30 would end up pushing the time used for rendering up to 12405 (which is newer than the data we have), so a small amount of extrapolation (5ms) would be required here.

http://www.themuffin.net/etpro/lagometer-frame.png

In the above image, arrow 1 points to an interpolated frame immediately after a new snapshot was received,
and arrow 2 points to a frame where a fair bit of extrapolation was performed.

==AntiWarp==
If etpro [[AntiWarp]] is triggered, it the delay added by the antiwarp system is represented by translucent green bars
in ths snapshot graph, like this

http://www.collectivecomputing.com/~reed/et/etss/lagometer-antiwarp.jpg

'''Footnotes'''
----

'''¹''' Note the increase of exactly 50 -- remember that the server is running at 20 frames per second, so:
<table border="0"><tr><td valign="center">1 frame ·</td><td align="center">1000ms (1 second)<hr style="border-top: solid #000 1px;">20 frames</td><td>= 50ms</td></tr></table>

'''²''' This is technically called ''linear interpolation'' (the simplest interpolation method), which is sometimes abbreviated to ''lerp''ing.

[[Category:ETPro:Client_Cvars]]

AntiWarp

2006-10-19T21:51:55Z

ReyalP: linky

ET Pro implements an antiwarp system to keep players from "warping" or "teleporting" around, accidentally or intentionally.

== Controlling the antiwarp system ==

'''b_antiwarp''' controls the antiwarp system. The possible settings are:
<pre>0 - disabled. ET Pro does no antiwarp at all.
1 - enabled (default). ET Pro keeps players from "warping"</pre>

== What is "warping" ==

"Warping" occurs when the server receives several new commands for a player in a very short period of time. This happens because packets from the player were lost or never sent. The player will appear to cross a great distance in a very short period of time, making them hard to hit and possibly allowing them to avoid landmine damage.

== How the antiwarp system keeps players from warping ==

The antiwarp system in ET Pro delays commands when they are received too quickly. Thus, when a player sends 700ms worth of commands in 50ms, the commands will be spread out over 700ms, causing the player to move smoothly to other players. This affects the player who sent the commands too quickly only by increasing their ping, and will not keep increasing ping endlessly - at maximum, the added ping is the highest ping the player is actually getting. If temporary network issues cause ping to increase beyond a sensible number, the player can stand still for a moment and their ping will normalize.

== Antiwarp on the lagometer ==
If antiwarp is triggered, it shows up on the [[Lagometer]] as a translucent green like this. The drop at the end shows how the added lag of antiwarp drops off if you stop for a moment.

http://www.collectivecomputing.com/~reed/et/etss/lagometer-antiwarp.jpg
[[Category:ETPro:Server_Cvars]]

Client Configuration

2006-10-19T00:33:27Z

ReyalP: /* Warnings */ cl_autorecord

==Client Side Install==
;To play ETPro online
Simply connect to an ETPro server with downloads enabled on your client. 
;To host your own game
Download the desired ETPro .zip from the [http://etpro.anime.net/download.html ETPro download page] and unzip it into your ET directory, then start ET with fs_game set as described below. 
For additional information see the [http://wolfwiki.anime.net/index.php/ETPro:Server_Configuration Server Configuration page]
;To play demos
<ul>
<li>Open the [http://bani.anime.net/etpro/download.html PK3] in a program that can handle <tt>zip</tt> files. Extract the following files to the ETPro directory:
:cgame_mp_x86.dll
:ui_mp_x86.dll
<li>Start the client with the <tt>+set fs_game etpro</tt>.
<ul><li>Command line: Append <tt>+set fs_game etpro</tt> to the command line.
<li>Windows Shortcut: Append <tt>+set fs_game etpro</tt> to the target box, usually after <tt>"C:\Program Files\Wolfenstein - Enemy Territory"</tt>. Make sure to place it after the double-quote.</ul>
</ul>

==Warnings==
While viewing a demo: Client/Server game mismatch: 'Enemy Territory/ET pro 
While viewing a demo: Unknown event: 131 
While viewing a demo: BG_EvaluateTrajectory: unknown trType: 0 
While viewing a demo: BG_IndexForString: unknown token 'NOT' 
:This happens when you use the wrong client to playback ETPro 3 demos. The solution is to extract cgame_mp_x86.dll and ui_mp_x86.dll from the most recent [http://bani.anime.net/etpro/download.html ETPro PK3] and put it in your ETPro directory.

While viewing a demo: demo file was truncated or various other errors (TODO):
:This happens when cl_autorecord is non-zero. Set cl_autorecord to 0

==Related links==
*[http://rarlabs.com/download.htm WinRAR] - Can open PK3 files (Recommended).
*[http://www.winzip.com WinZip] - Can open PK3 files.
*[[:Category:ETPro:Client Cvars|Client cvars]].
*[[Client cvar list]].
*[[Server Configuration]].
*[[Performance Tuning]].

==Additional troubleshooting==
Most problems with hosting games and playing demos, as well as some problems with playing online, are caused by having multiple versions of the etpro files present, or simply having too many files.
;For reliable demo playback and local hosting
* There should be only one etpro-X_Y_Z.pk3 in your etpro directory.
* Unless you have a specific reason to do otherwise, always use the most recent version. ETPro is backwards compatible with older demos, as well as demos from etmain.
* The ui and cgame .dll files in the etpro directory must match those in the etpro .pk3 file. Extract them as described above.
* Many servers force you to download additional skin packs, sound packs, other content. All of this will be present in demo playback or hosted games, unless your move the corresponding files to somewhere that outside of etpro or etmain, or delete them.
*In addition to the etpro .pk3 the following are required by ET.
** mp_bin.pk3
** pak0.pk3
** pak1.pk3
** pak2.pk3
To play back a demo, you must also have the .pk3 corresponding to the map it was recorded on. All other .pk3 files may be safely deleted or moved to another directory.

[[Category:ETPro]]

AntiWarp

2006-10-19T00:16:11Z

ReyalP: lagometer and spelling fixes

ET Pro implements an antiwarp system to keep players from "warping" or "teleporting" around, accidentally or intentionally.

== Controlling the antiwarp system ==

'''b_antiwarp''' controls the antiwarp system. The possible settings are:
<pre>0 - disabled. ET Pro does no antiwarp at all.
1 - enabled (default). ET Pro keeps players from "warping"</pre>

== What is "warping" ==

"Warping" occurs when the server receives several new commands for a player in a very short period of time. This happens because packets from the player were lost or never sent. The player will appear to cross a great distance in a very short period of time, making them hard to hit and possibly allowing them to avoid landmine damage.

== How the antiwarp system keeps players from warping ==

The antiwarp system in ET Pro delays commands when they are received too quickly. Thus, when a player sends 700ms worth of commands in 50ms, the commands will be spread out over 700ms, causing the player to move smoothly to other players. This affects the player who sent the commands too quickly only by increasing their ping, and will not keep increasing ping endlessly - at maximum, the added ping is the highest ping the player is actually getting. If temporary network issues cause ping to increase beyond a sensible number, the player can stand still for a moment and their ping will normalize.

== Antiwarp on the lagometer ==
If antiwarp is triggered, it shows up on the lagometer as a translucent green like this. The drop at the end shows how the added lag of antiwarp drops off if you stop for a moment.

http://www.collectivecomputing.com/~reed/et/etss/lagometer-antiwarp.jpg
[[Category:ETPro:Server_Cvars]]

WolfWiki:Community Portal

2006-09-05T01:23:09Z

ReyalP: hen admin msg

The WolfWiki Community portal is a place to list community news sites, competitions, mod sites, and other ET/ETPro related resources. Links added here should be of general interest to the ET community, not just promotion of a particular clan or server.
== News Sites ==

* [http://www.et-center.com/ ET-Center]
* [http://www.xfire.be/ Xfire.be]
* [http://www.gamestv.org/ GamesTV.org]
* [http://www.swertcw.com/ sweRTCW]
* [http://www.planetwolfenstein.com/ Planet Wolfenstein]
* [http://www.etnation.co.uk/ ETNation.co.uk]
* [http://www.splashdamage.com/ SplashDamage.com]
* [http://www.planetwolfenstein.de/ PlanetWolfenstein.de]
* [http://www.rtcw.co.uk/ rtcw.co.uk]
* [http://velocity.lunarpages.com/index.html Unofficial Enemy Territory Strategy Guide]
* [http://www.planetwolfenstein.com/4newbies/ RTCW 4 Newbies]
* [http://www.enemy-territory.com Enemy Territory Resource Site]
* [http://www.geheimgemein.de/kallisti/ Kallisti.et Enemy Territory Fun Community]
* [http://www.et-scene.de/news.php ET-Scene.de (German)]

== Leagues / Competitions ==

* [http://www.clanbase.com/ Clanbase]
* [http://www.teamwarfare.com/ TeamWarfare League]
* [http://www.sta-league.org/ Stronger Than All]
* [http://www.et-cup.net/ ET-Cup]
* [http://www.warleagues.com/ Warleagues]
* [http://www.frenchy-cup.com/ Frenchy-Cup european]
* [http://et-gather.be/ #et.gather Fast Gaming Cup]

== Mods ==

* [http://stealthy.foolishgames.net/ FalckonET]
* [http://www.truecombat.com/intro.php TC:Elite]
* [http://www.omni-bot.com/ Omni-Bot]
* [http://www.priceofpeace.net/ The Price of Peace]
* [http://www.etpub.org/news.php ETPub]
* [http://jaymod.clanfu.org/ Jaymod]
* [http://www.splashdamage.com/index.php?name=pnPHPbb2&file=viewtopic&t=7522 ET-Mod-Project-List]

WolfWiki:Community Portal

2006-09-05T01:18:07Z

ReyalP: /* Leagues / Competitions */ cgl-> dead

== News Sites ==

* [http://www.et-center.com/ ET-Center]
* [http://www.xfire.be/ Xfire.be]
* [http://www.gamestv.org/ GamesTV.org]
* [http://www.swertcw.com/ sweRTCW]
* [http://www.planetwolfenstein.com/ Planet Wolfenstein]
* [http://www.etnation.co.uk/ ETNation.co.uk]
* [http://www.splashdamage.com/ SplashDamage.com]
* [http://www.planetwolfenstein.de/ PlanetWolfenstein.de]
* [http://www.rtcw.co.uk/ rtcw.co.uk]
* [http://velocity.lunarpages.com/index.html Unofficial Enemy Territory Strategy Guide]
* [http://www.planetwolfenstein.com/4newbies/ RTCW 4 Newbies]
* [http://www.enemy-territory.com Enemy Territory Resource Site]
* [http://www.geheimgemein.de/kallisti/ Kallisti.et Enemy Territory Fun Community]
* [http://www.et-scene.de/news.php ET-Scene.de (German)]

== Leagues / Competitions ==

* [http://www.clanbase.com/ Clanbase]
* [http://www.teamwarfare.com/ TeamWarfare League]
* [http://www.sta-league.org/ Stronger Than All]
* [http://www.et-cup.net/ ET-Cup]
* [http://www.warleagues.com/ Warleagues]
* [http://www.frenchy-cup.com/ Frenchy-Cup european]
* [http://et-gather.be/ #et.gather Fast Gaming Cup]

== Mods ==

* [http://stealthy.foolishgames.net/ FalckonET]
* [http://www.truecombat.com/intro.php TC:Elite]
* [http://www.omni-bot.com/ Omni-Bot]
* [http://www.priceofpeace.net/ The Price of Peace]
* [http://www.etpub.org/news.php ETPub]
* [http://jaymod.clanfu.org/ Jaymod]
* [http://www.splashdamage.com/index.php?name=pnPHPbb2&file=viewtopic&t=7522 ET-Mod-Project-List]

WolfWiki talk:Community Portal

2006-09-05T01:12:48Z

ReyalP:

The vote is: "Prohibit clans from being listed on the community portal page"
Addendum: The number of clans is rather large. Another page, perhaps?
:For --[[User:WeblionX|WeblionX]] 09:22, 4 September 2006 (PDT)
Not only is the number of clans rather large, most don't last two weeks. And who would want to keep the list up to date?
:For --[[User:Lagger|Lagger]] 12:35, 4 September 2006 (PDT)
WolfWiki isn't a recruitment center.
:For --[[User:Ouroboro|ouroboro]] 15:25, 4 September 2006 (PDT)
I don't think clan pages have any place on wolfwiki if they have some community resource, they can link to that but not just "OMGZ L@@K MY CLANZ PAGE"
:For --[[User:ReyalP|ReyalP]] 18:12, 4 September 2006 (PDT)

Configstring

2006-08-28T22:19:04Z

ReyalP: general info about configstrings

__NOEDITSECTION__

Configstrings can be accessed with [[Lua_Mod_API#configstrings|et.trap_GetConfigstring and et.trap_SetConfigstring]] 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.collectivecomputing.com/~reed/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 et.trap_GetConfigstring(slotNumber) but must use et.trap_GetConfigstring(et.CS_PLAYERS + slotNumber)

<pitatable columns=3 headlines="key;name;description" widths="40;220;450" headerfontcolor="#FFFFFF">
n;Nick;
t;Team;1=Axis, 2=Allies, 3=Spectators
c;Class;0=Soldier, 1=Medic, 2=Engineer, 3=FieldOps, 4=CovertOps
r;Rank;
m;Medals;
s;Skills;
dn;Disguised name;
dr;Disguised rank;
w;Weapon
lw;Latched weapon;Weapon on next spawn
sw;Latched secondary weapon;Secondary weapon on next spawn
p;Privilege level;0=Peon, referee (vote), referee (password), semiadmin, rconauth - etpro only
ss;Stat Saver; Stats restored by stat saver;etpro only
sc;Shoutcaster;etpro only
tv;ETTV slave;etpro only
</pitatable>

== 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

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

Talk:Lua Mod API

2006-08-19T03:19:55Z

ReyalP: /* Fields for the next release */

- et.G_SlotSound( slotnum, soundindex ) -> Plays the sound soundindex at for the player @ slotnum only. --[[User:RoadKillPuppy|RoadKillPuppy]] 14:17, 16 December 2005 (PST)
:you can do this with tempentities and SVF_SINGLECLIENT ...
:--[[User:Bani|Bani]] 17:32, 16 December 2005 (PST)

----
some of this can be done via function et_Print(text).. but this would greatly simplify life, 
my wish list for christmas: 
- getUserEguid(cno) - get a client's etpro guid? 
- repair gentity_set for vec3 - scotty fix the transporter please 
:[http://bani.anime.net/banimod/forums/viewtopic.php?t=6279 fixed.]--[[User:Bani|Bani]] 17:56, 22 December 2005 (PST)

trap sen server cmd is a ET engine trap the comand u send it send to the client and recived as a server command no a client command

to add ill well that would be al ot of coding for not much [[User:=FF=im2good4u|=FF=Im2good4u]] 12:12, 20 December 2005 (PST)

aight thnx. 
heres another api request, i'd like to be able to get a clients xp directly. et.gentity_get(cno, "sess.game_points") seems to return 0 always (?) 
--[[User:Hadr0|Hadr0]] 15:38, 21 December 2005 (PST)
:oh nevermind, i see this can be done now with xp = et.gentity_get(cno, "ps.stats", 8)
:nice... --[[User:Hadr0|Hadr0]] 16:58, 23 December 2005 (PST)
--------
add a way to determine if a client is 999, and if possible why he's 999 (loading, connecting, loosing packets, etc) 
--Gotenks

999 means: server has not been sent data from client for > 1000 ms. So there is no way to certainly tell why.
The timeoutflag is stored in the pmflags IIRC. Don't know if lua can read them right now. --[[User:Deus|Deus]] 23:12, 22 December 2005 (PST) 
Still would like access to the ping, or a dummy variable if they are 999, but also the ammount of time they are inactive. 
--[[User:Gotenks|Gotenks]] (Sorry for double post) 1:53, 31 December 2005 (CST)
:[http://bani.anime.net/banimod/forums/viewtopic.php?t=6291 fixed].--[[User:Bani|Bani]] 02:40, 7 February 2006 (PST)
----
Access to weapon stats during game similar to end of round stats that are displayed. 
--[[User:LethalInjection|LethalInjection]] 23:52, 22 December 2005 (PST)
:[http://bani.anime.net/banimod/forums/viewtopic.php?t=6291 fixed].--[[User:Bani|Bani]] 02:40, 7 February 2006 (PST)

----

== IPC stuff ==

<hr>
i would like a et_IPCReceive whit an return value so u can send info back on a request

i would like a et_IPCSend that can send to all lua mods then them mods can decide if the wana use that message or not
[[User:=FF=im2good4u|=FF=Im2good4u]] 12:35, 8 January 2006 (PST)
<hr>
et_IPCReceive wouldn't send it to the other mod... afaik... so just use another send
just et_IPCSend to all modules (afaik, you can even send to ones not there), simple loop function
[[User:gotenks|gotenks]] 20:04, 8 January 2006 (CST)

yeh probely but its not verry handy its better to get the good vmnumber or to e able to send on mod filenames

apart from that returning a value will be more handy since tnhe u cna contine in 1 funtion else u got to reacise it in the recieve funtion [[User:=FF=im2good4u|=FF=Im2good4u]] 10:45, 9 January 2006 (PST)

<hr>
bani i need a console print function on the client that does sepport ascii plz [[User:=FF=im2good4u|=FF=Im2good4u]] 12:49, 12 January 2006 (PST)
:et.trap_SendServerCommand( clientnum, "print \"hello ascii console on the client\n\" ) ) --[[User:Bani|Bani]] 22:33, 15 January 2006 (PST)
<hr>
bani: how about a et_sound(id, sound) event? [[User:gotenks|gotenks]] 20:45, 17 January 2006 (CST)
:[http://wolfwiki.anime.net/index.php/ETPro:Lua_Mod_API#sound et.G_Sound( entnum, soundindex )] --[[User:Bani|Bani]] 22:07, 18 January 2006 (PST)
:bani, i was referring to an on event call, so when a sound is played et_sound(id,sound) would be called.[[User:gotenks|gotenks]] 21:45, 20 January 2006 (CST)
::most sounds are clientside... this would not be of much use. --[[User:Bani|Bani]] 04:42, 22 January 2006 (PST)
:::except for checking when something like a killing spree sound is activated--[[User:gotenks|gotenks]] 07:54, 23 January 2006 (CST)
:::::There would be no way for you to know what sound was activated. You can't get a filename from the soundindex.--[[User:Bani|Bani]] 10:19, 24 January 2006 (PST)
:::::This is a case where IPCSend/IPCReceive would be useful, so mods can notify each other of specific events.--[[User:Bani|Bani]] 02:40, 7 February 2006 (PST)

----
== Fields for the next release ==
Is it possible to get a player's live angles? Fieldname "s.angles" only gives the spawn angles. Tried "rotate", "s.angles2", "TargetAngles", "r.currentAngles" as well but they just give 0.000000 for each element. thanks for any help --[[User:Hadr0|Hadr0]] 01:35, 25 January 2006 (PST)
:This will be fixed in the next release, where you will get access to ps.viewangles--[[User:Bani|Bani]] 02:33, 7 February 2006 (PST)

Would it be possible to set the player's liveangle?Just like setting one's position(origin).I would also like to set player's velocities(maybe a vec3 field), 'speed' is not working. --[[User:Kotoko|Kotoko]] 06:06, 26 May 2006 (PDT)
:viewangles is what you want --[[User:ReyalP|ReyalP]] 14:00, 26 May 2006 (PDT)
Seems i get it ..It WILL BE AVAILABLE at NEXT release ..not now .. right?-_- [[User:Kotoko|Kotoko]] 22:49, 26 May 2006 (PDT)

bani: please give access to fieldname 's.eventParm'. --[[User:Pdi|pdi]] 01:52, 6 July 2006 (PDT)

bani: RW access to all "sess.*" fields (sess.skillpoints, sess.startskillpoints, sess.startxptotal, ...) would be great. thanx! --[[User:Pdi|pdi]] 05:55, 2 August 2006 (PDT)

bani: please make all "pers.*" fields (pers.clientTimeNudge, pers.clientMaxPackets, ...) available. thanx! --[[User:Pdi|pdi]] 01:04, 17 August 2006 (PDT)
:you can get timenudge and maxpackets from the userinfo --[[User:ReyalP|ReyalP]] 20:19, 18 August 2006 (PDT)

== LoadLib ==

Add loadlib ppl it says u have lua basic included but not loadlib !!

(on windows it gives an error attept to call global load lin a nil valua)[[User:=FF=im2good4u|=FF=Im2good4u]] 05:16, 15 February 2006 (PST)
----
== XP control not just skill ==

I would like to request RW access to the "sess.skillpoints" array

At least a callback on et.G_AddSkillPoints ( '''cno''', '''skill''', '''points''' ) [[User:=FF=im2good4u|=FF=Im2good4u]] 07:45, 8 March 2006 (PST)

Memory cvars

2006-07-17T06:15:43Z

ReyalP: /* Sound */ stray bbcode

==Determining memory usage==
===Sound===
'''s_list''' will display a list of all sounds and whether they're currently in RAM, along with a summary at the end, e.g.:

0[16bit] : sound/weapons/mortar/mortarf1.wav[paged out]
53950[16bit] : sound/etpro/osp_fight.wav[resident ]
52808[16bit] : sound/etpro/osp_goat.wav[resident ]
Total resident: 45634975

105060 bytes (0.10MB) free sound buffer memory, 50521500 bytes (48.18MB) total used
92463100 bytes (88.18MB) sound buffer memory have been allocated since the last SND_setup

This example is with <tt>com_soundmegs 48</tt>, and it shows that if I wanted to keep ''all'' the sound in memory, I'd want to shoot for soundmegs 96 or so. In reality, that's probably overkill (some large sounds, like the per-level voiceover in the limbo menu, are rarely used), but I'm pretty sure they're all loaded when you load the level, regardless (and just freed again if you use up soundmegs.) So, basically, a high-ish soundmegs is good, but setting it ''really'' high probably won't help much unless you have a really slow/busy disk but a lot of RAM.

===Hunk and Zone===
'''meminfo''' will display information about the hunk and the zone:
67108864 bytes ( 64.00 MB) total hunk <- current com_hunkMegs
25165824 bytes ( 24.00 MB) total zone <- current com_zoneMegs

0 bytes ( 0.00 MB) low mark
42606880 bytes ( 40.63 MB) low permanent
5864568 bytes ( 5.59 MB) low tempHighwater <- top low hunk usage from temporary allocations

0 bytes ( 0.00 MB) high mark
384 bytes ( 0.00 MB) high permanent
82624 bytes ( 0.08 MB) high temp
18769504 bytes ( 17.90 MB) high tempHighwater <- top high hunk usage from temporary allocations

42607264 bytes ( 40.63 MB) total hunk in use <- current hunk in use
18769120 bytes ( 17.90 MB) unused highwater <- temporary hunk memory that wasn't reused

2055832 bytes ( 1.96 MB) in 3088 zone blocks <- current zone usage
0 bytes ( 0.00 MB) in dynamic botlib
1110492 bytes ( 1.06 MB) in dynamic renderer
945340 bytes ( 0.90 MB) in dynamic other
82888 bytes ( 0.08 MB) in small Zone memory

(note the comments to the right of each line)
So, the client uses a fair bit of hunk memory (adding together the total hunk and the unused highwater, my com_hunkmegs of 64 looks pretty good), a ''lot'' of sound memory, and very little zone memory.

User talk:Dersaidin

2006-07-05T21:20:03Z

ReyalP:

Good work but I'll give you a heads-up: ReyalP might end up slapping you with the preview stick ;-). [[User:Deej|deej]] 06:53, 5 July 2006 (PDT)

He is not the only one ... --[[User:Deus|Deus]] 11:41, 5 July 2006 (PDT)

well I would, but I don't want to discourage him from cleaning stuff up :D --[[User:ReyalP|ReyalP]] 14:20, 5 July 2006 (PDT)

User:ReyalP

2006-06-10T00:44:33Z

ReyalP: /* ETPro/Lua libraries, modules and examples */

http://www.sonic.net/~rfm/et/bananet.png
==ETPro/Lua libraries, modules and examples==
;Follow the link to the source code for more detailed information about each item.
*[http://www.sonic.net/~rfm/et/lua/autoref.lua autoref.lua] lua module to give people referee status, based on IP or PB GUID. Requires etconst.lua 
*[http://www.sonic.net/~rfm/et/lua/etconst.lua etconst.lua] some common constants from the et header files, converted to lua.
*[http://www.sonic.net/~rfm/et/lua/luacon.lua luacon.lua] library provides a lua command in the server console, for interactive testing.
*[http://www.sonic.net/~rfm/et/lua/luaconmod.lua luaconmod.lua] runs luacon as module.
*[http://www.sonic.net/~rfm/et/lua/cvarobj.lua cvarobj.lua] metamethods example. Allows using cvars like normal lua variables.
*[http://www.sonic.net/~rfm/et/lua/dumptable.lua dumptable.lua] recursively display contents of a table.
*[http://www.sonic.net/~rfm/et/lua/noteamflood.lua noteamflood.lua] prevent people from flooding "team" commands.

==Map editing stuff==
; tjlview, a plugin for viewing [[TrickJumpLines]] in [http://www.qeradiant.com/ GtkRadiant 1.4]
* [http://www.sonic.net/~rfm/et/readme_tjlview-a0.1.txt readme]
* [http://www.sonic.net/~rfm/et/tjlview-a0.1-src.zip source]
* [http://www.sonic.net/~rfm/et/tjlview-linux.zip windows and linux binaries]
; readme for bkgrnd2d plugin (the plugin itself is included in GTKRadiant 1.4)
* [http://www.sonic.net/~rfm/et/readme_bkgrnd2d-b0.25.txt readme_bkgrnd2d-b0.25.txt]

==Contact==
* '''email''' reyalp (at) gmail.com 
* '''[[IRC]]''' #etpro on freenode or quakenet, #n-warriors on gamesurge

[[Category:ETPro:Mods]]

Talk:Lua Mod API

2006-05-26T21:00:04Z

ReyalP: section bettar :x

- et.G_SlotSound( slotnum, soundindex ) -> Plays the sound soundindex at for the player @ slotnum only. --[[User:RoadKillPuppy|RoadKillPuppy]] 14:17, 16 December 2005 (PST)
:you can do this with tempentities and SVF_SINGLECLIENT ...
:--[[User:Bani|Bani]] 17:32, 16 December 2005 (PST)

----
some of this can be done via function et_Print(text).. but this would greatly simplify life, 
my wish list for christmas: 
- getUserEguid(cno) - get a client's etpro guid? 
- repair gentity_set for vec3 - scotty fix the transporter please 
:[http://bani.anime.net/banimod/forums/viewtopic.php?t=6279 fixed.]--[[User:Bani|Bani]] 17:56, 22 December 2005 (PST)
- et.trap_SendServerCommand(cno, "kill") - punish client as alternative to setting health 
--[[User:Hadr0|Hadr0]] 02:10, 20 December 2005 (PST) 
:You can use et.G_Damage() in the new test version to do that.--[[User:Bani|Bani]] 01:38, 23 December 2005 (PST)

trap sen server cmd is a ET engine trap the comand u send it send to the client and recived as a server command no a client command

to add ill well that would be al ot of coding for not much [[User:=FF=im2good4u|=FF=Im2good4u]] 12:12, 20 December 2005 (PST)

aight thnx. 
heres another api request, i'd like to be able to get a clients xp directly. et.gentity_get(cno, "sess.game_points") seems to return 0 always (?) 
--[[User:Hadr0|Hadr0]] 15:38, 21 December 2005 (PST)
:oh nevermind, i see this can be done now with xp = et.gentity_get(cno, "ps.stats", 8)
:nice... --[[User:Hadr0|Hadr0]] 16:58, 23 December 2005 (PST)
--------
add a way to determine if a client is 999, and if possible why he's 999 (loading, connecting, loosing packets, etc) 
--Gotenks

999 means: server has not been sent data from client for > 1000 ms. So there is no way to certainly tell why.
The timeoutflag is stored in the pmflags IIRC. Don't know if lua can read them right now. --[[User:Deus|Deus]] 23:12, 22 December 2005 (PST) 
Still would like access to the ping, or a dummy variable if they are 999, but also the ammount of time they are inactive. 
--[[User:Gotenks|Gotenks]] (Sorry for double post) 1:53, 31 December 2005 (CST)
:[http://bani.anime.net/banimod/forums/viewtopic.php?t=6291 fixed].--[[User:Bani|Bani]] 02:40, 7 February 2006 (PST)
----
Access to weapon stats during game similar to end of round stats that are displayed. 
--[[User:LethalInjection|LethalInjection]] 23:52, 22 December 2005 (PST)
:[http://bani.anime.net/banimod/forums/viewtopic.php?t=6291 fixed].--[[User:Bani|Bani]] 02:40, 7 February 2006 (PST)

----

== IPC stuff ==

<hr>
i would like a et_IPCReceive whit an return value so u can send info back on a request

i would like a et_IPCSend that can send to all lua mods then them mods can decide if the wana use that message or not
[[User:=FF=im2good4u|=FF=Im2good4u]] 12:35, 8 January 2006 (PST)
<hr>
et_IPCReceive wouldn't send it to the other mod... afaik... so just use another send
just et_IPCSend to all modules (afaik, you can even send to ones not there), simple loop function
[[User:gotenks|gotenks]] 20:04, 8 January 2006 (CST)

yeh probely but its not verry handy its better to get the good vmnumber or to e able to send on mod filenames

apart from that returning a value will be more handy since tnhe u cna contine in 1 funtion else u got to reacise it in the recieve funtion [[User:=FF=im2good4u|=FF=Im2good4u]] 10:45, 9 January 2006 (PST)

<hr>
bani i need a console print function on the client that does sepport ascii plz [[User:=FF=im2good4u|=FF=Im2good4u]] 12:49, 12 January 2006 (PST)
:et.trap_SendServerCommand( clientnum, "print \"hello ascii console on the client\n\" ) ) --[[User:Bani|Bani]] 22:33, 15 January 2006 (PST)
<hr>
bani: how about a et_sound(id, sound) event? [[User:gotenks|gotenks]] 20:45, 17 January 2006 (CST)
:[http://wolfwiki.anime.net/index.php/ETPro:Lua_Mod_API#sound et.G_Sound( entnum, soundindex )] --[[User:Bani|Bani]] 22:07, 18 January 2006 (PST)
:bani, i was referring to an on event call, so when a sound is played et_sound(id,sound) would be called.[[User:gotenks|gotenks]] 21:45, 20 January 2006 (CST)
::most sounds are clientside... this would not be of much use. --[[User:Bani|Bani]] 04:42, 22 January 2006 (PST)
:::except for checking when something like a killing spree sound is activated--[[User:gotenks|gotenks]] 07:54, 23 January 2006 (CST)
:::::There would be no way for you to know what sound was activated. You can't get a filename from the soundindex.--[[User:Bani|Bani]] 10:19, 24 January 2006 (PST)
:::::This is a case where IPCSend/IPCReceive would be useful, so mods can notify each other of specific events.--[[User:Bani|Bani]] 02:40, 7 February 2006 (PST)

----
== Fields for the next release ==
Is it possible to get a player's live angles? Fieldname "s.angles" only gives the spawn angles. Tried "rotate", "s.angles2", "TargetAngles", "r.currentAngles" as well but they just give 0.000000 for each element. thanks for any help --[[User:Hadr0|Hadr0]] 01:35, 25 January 2006 (PST)
:This will be fixed in the next release, where you will get access to ps.viewangles--[[User:Bani|Bani]] 02:33, 7 February 2006 (PST)

Would it be possible to set the player's liveangle?Just like setting one's position(origin).I would also like to set player's velocities(maybe a vec3 field), 'speed' is not working. --[[User:Kotoko|Kotoko]] 06:06, 26 May 2006 (PDT)
:viewangles is what you want --[[User:ReyalP|ReyalP]] 14:00, 26 May 2006 (PDT)
== LoadLib ==

Add loadlib ppl it says u have lua basic included but not loadlib !!

(on windows it gives an error attept to call global load lin a nil valua)[[User:=FF=im2good4u|=FF=Im2good4u]] 05:16, 15 February 2006 (PST)
----
== XP control not just skill ==

I would like to request RW access to the "sess.skillpoints" array

At least a callback on et.G_AddSkillPoints ( '''cno''', '''skill''', '''points''' ) [[User:=FF=im2good4u|=FF=Im2good4u]] 07:45, 8 March 2006 (PST)

Map scripting

2006-05-17T04:08:43Z

ReyalP: describe some mapscript cvars

==General information==
In [[ETPro]] version 3 the [[ETPro]] team has improved and changed the scripting system to a quite big extent. This article presents some of the new [[ETPro]] map scripting features.

Some things cannot be done by scripting. These include:
* making a part of terrain mineable/unmineable.

==mapscript related cvars==
* [[b_mapscriptdirectory]] is an etpro cvar which specifies what directory too look for the map script. As always, the game looks under fs_game first, so you should not include etpro or etmain in the value of b_mapscriptdirectory. If not specified, the default is <tt>maps/</tt>. ETPro includes bug fix only scripts in <tt>etpro/maps</tt> and modified scripts in <tt>etpro/etpromapscripts</tt>
* [[g_scriptname]] is an etmain cvar which specifies the filename of the script to be used. It is reset every time a map is loaded. The default is to use <tt>mapname.script</tt> or <tt>mapname_lms.script</tt>.
* [[g_scriptdebug]] 1 outputs verbose information about the script in the server console.

==Scripting Examples by [http://bani.anime.net/banimod/forums/profile.php?mode=viewprofile&u=226 duke'ku]==
Here I'll show a few examples of the new scripting allowed in ETPro, and attempt to explain what exactly it's doing. First off, I'll start with a simple example, where a model (in this case, a dinghy) is inserted into the map.

<pre>create
{
scriptname "dinghy1"
origin "2650 600 100"
classname "misc_gamemodel"
modelscale 1
contents 1
mins "-90 -90 -25"
maxs "90 90 25"
clipmask 1
model "models/mapobjects/dinghy_sd/dinghy.md3"
}</pre>

This isn't exactly the cleanest example of scripting (mainly due to my lackluster job of clipping the model off,) but what it produces is this:
http://games.theteamkillers.net/rtcw/dinghy/2004-01-14-234844-battery.jpg

Now, to break down how it works. The create{ } command will place an entity into the map, at the spot specified by the "origin" key. The scriptname specifies the name that the entity will have in the map, and it is what seperates it from other entities in the map (which can cause quite a few problems).

<pre>create
{
scriptname "dinghy1"
origin "2650 600 100"
}</pre>

The code above will do nothing, it creates an entity (not even of a specified type, it will do nothing) and places into the map at 2650,600,100. To find your position on a map to place an entity (you'll need to find an origin for almost every entity), use the command "/viewpos".

<pre>create
{
scriptname "dinghy1"
origin "2650 600 100"
classname "misc_gamemodel"
}</pre>

Now, the code has advanced a bit further and the entity now has a specified type, misc_gamemodel. A misc_gamemodel is a model placed into the map during load (compared to a misc_model, which are permanently static objects that get compiled into the map at compile). Misc_gamemodels can be used for almost anything, from walls (although this would be a terrible way of making a map) to moving tanks (all of the vehicles, construction boxes, command posts, etc. in game are all misc_gamemodels), but in this script it's just used for placing a model (provided with the ET mapping tools, available at http://www.qeradiant.com).

<pre>create
{
scriptname "dinghy1"
origin "2650 600 100"
classname "misc_gamemodel"
modelscale 1
contents 1
}</pre>

Now, the model has a defined scale, 1. A scale of .5 would cause it to be half of the size of the model in the file that will be referenced, and a scale of 2 would cause it to be twice the size. Most flags that are used on an entity can be found in the entities.def file that is provided with the mapping tools.

<pre>create
{
scriptname "dinghy1"
origin "2650 600 100"
classname "misc_gamemodel"
modelscale 1
contents 1
mins "-90 -90 -25"
maxs "90 90 25"
clipmask 1
model "models/mapobjects/dinghy_sd/dinghy.md3"
}</pre>

Now, for the clipping. The contents flag specifies the type of surfaceflag that the entity will be. Surfaceflags that are defined in the ET source (found in src/game/surfaceflags.h, if you're interested) are listed [http://bani.anime.net/banimod/forums/viewtopic.php?t=3328&start=0#surfaceflags here]. The mins and maxs specify how far out from the origin of the model (in each direction) the clipping will extend to. The coordinates on this model aren't accurate, but they get the job done.

This was a very basic example of scripting, and now I'll be listing some more advanced examples of scripting.

===Example 1: Battery's Back Door and Dynamite===
<pre>//bani
create
{
scriptName "backdoor"
classname "func_explosive"
targetname "backdoor"
origin "4608 -4594 1024"
mins "-63 -10 0"
maxs "63 10 128"
spawnflags 1 // AXIS_OBJECTIVE(1)
eflags 65536 // EF_FAKEBMODEL
svflags 1 // SVF_NOCLIENT
}

//bani
create
{
scriptName "backdoor_obj"
classname "trigger_objective_info"
targetname "backdoor_obj"
target "backdoor"
origin "4608 -4601 1024"
mins "-95 -85 0"
maxs "95 85 128"
spawnflags 17 // AXIS_OBJECTIVE(1) | CUSTOMIMAGE
track "the Back Door"
shortname "Back Door"
customaxisimage "gfx/limbo/cm_radar_maindoor"
}

//bani - bug fixes
create
{
scriptName "bugfix1"
classname "func_fakebrush"
origin "3632 -4313 881"
contents 65536 // CONTENTS_PLAYERCLIP
mins "-40 -1 -20"
maxs "40 1 10"
}</pre>

===Example 2: Fueldump and Spawning at the Command Post===
<pre>create
{
scriptName "fueldumphq_obj"
classname "team_WOLF_objective"
targetname "fueldumphq_obj"
origin "-10853 -2036 6" // z = CC_FILTER_ALLIES(2) | CC_FILTER_SPAWNS(4)
spawnflags 2 // TEAM_ALLIES(2)
}

create
{
scriptName "fueldumphq_spawn1"
classname "team_CTF_bluespawn"
targetname "fueldumphq_spawn"
origin "11072 -2448 512"
spawnflags 2 // TEAM_ALLIES
}

create
{
scriptName "fueldumphq_spawn2"
classname "team_CTF_bluespawn"
targetname "fueldumphq_spawn"
origin "-10995 -2448 512"
spawnflags 2 // TEAM_ALLIES
}

create
{
scriptName "fueldumphq_spawn3"
classname "team_CTF_bluespawn"
targetname "fueldumphq_spawn"
origin "-10918 -2448 512"
spawnflags 2 // TEAM_ALLIES
}

create
{
scriptName "fueldumphq_spawn4"
classname "team_CTF_bluespawn"
targetname "fueldumphq_spawn"
origin "-10841 -2448 512"
spawnflags 2 // TEAM_ALLIES
}

create
{
scriptName "fueldumphq_spawn5"
classname "team_CTF_bluespawn"
targetname "fueldumphq_spawn"
origin "11072 -2288 512"
spawnflags 2 // TEAM_ALLIES
}

create
{
scriptName "fueldumphq_spawn6"
classname "team_CTF_bluespawn"
targetname "fueldumphq_spawn"
origin "-10995 -2288 512"
spawnflags 2 // TEAM_ALLIES
}

create
{
scriptName "fueldumphq_spawn7"
classname "team_CTF_bluespawn"
targetname "fueldumphq_spawn"
origin "-10918 -2288 512"
spawnflags 2 // TEAM_ALLIES
}

create
{
scriptName "fueldumphq_spawn8"
classname "team_CTF_bluespawn"
targetname "fueldumphq_spawn"
origin "-10841 -2288 512"
spawnflags 2 // TEAM_ALLIES
}</pre>

Hopefully you'll be able to understand what each of those flags are doing. If you can't figure it out, see if you can figure it out from the [http://games.theteamkillers.net/rtcw/ent/ entities.def] file (from [http://user.tninet.se/~fzo823r/], this is not the original ET entities.def file but everything in it should work - it contains new things that weren't included with the stock def), or come and bug the [[ETPro]] team (|Rain|, [av]bani, zinx, fretn, s2ikkyo) on [irc://irc.freenode.net/etpro irc.freenode.net, #etpro].

===Contents Flags===
* SOLID 1 
* LIGHTGRID 4• 
* LAVA 8 
* SLIME 16 
* WATER 32 
* FOG 64 
* MISSILECLIP 128 
* ITEM 256 
* MOVER 16384 
* AREAPORTAL 32768• 
* PLAYERCLIP 65536 
* MONSTERCLIP 131072° 
* TELEPORTER 262144 
* JUMPPAD 524288 
* CLUSTERPORTAL 1048576• 
* DONOTENTER 2097152° 
* DONOTENTER_LARGE 4194304° 
* ORIGIN 16777216 
* BODY 33554432• 
* CORPSE 67108864• 
* DETAIL 134217728• 
* STRUCTURAL 268435456• 
* TRANSLUCENT 536870912 
* TRIGGER 1073741824 
* NODROP 2147483648 

Not all of these surfaceflags will work, but the ones you will want to use should work. If you've tested something and it doesn't work properly, send an email to dukeku AT theteamkillers DOT net and I'll fix it here.

° These, as far as I know, are bot only commands - they will have no effect on other players. 
• These are flags that should not be used in a script, they're either reserved for strict-in game usage that doesn't relate to something that you would do in a script such as this, or are reserved for entities that are compiled into the map and have absolutely no use in game.

'''Originally posted in the [http://bani.anime.net/banimod/forums/ ETPro forums] by [http://bani.anime.net/banimod/forums/profile.php?mode=viewprofile&u=226 duke'ku].'''

==Scripting Examples by [http://bani.anime.net/banimod/forums/profile.php?mode=viewprofile&u=800 Rain]==
Additionally, players may modify keys on existing entities with the set command.
===Example 1: Oasis Axis Garrison spawn marker fix===
Here are a couple of examples from the oasis map script (etpro/maps/oasis.script):
<pre>axis_garrison_wobj
{
spawn
{
set
{
origin "7089 4852 -415"
}
}
}</pre>
This changes the position of the spawn marker for the Axis garrison to (7089, 4852, -415). (This was done to correct player spawn location after setautospawn usage was fixed.)
===Example 2: Oasis caves water fix===
Here's another example:
<pre>water_tunnel
{
spawn
{
// rain - these are put into the world as CONTENTS_SOLID,
// which is a Bad Thing if WolfReviveBBox gets called
// while we're in the water
wait 100
set
{
contents 32 // CONTENTS_WATER
clipmask 32 // CONTENTS_WATER
}
}
[...]
</pre>
As described by the comments, this fixes the problem that sometimes caused players to be pushed around uncontrollably while underwater in the tunnel.

Both create and set recognize some keys that can't normally be used while mapping. Normally, most of these are computed automatically (often at map compile time); however, there are some cases when the compiled value is unusable, and there are some cases where you might want to set these values when spawning a new entity.

===Additional supported keys===
The additional keys supported are:
<table align="center"><tr><th>Key</th><th>Description</th></tr>
<tr><td>mins</td><td>A point describing the location of the lower corner of the bounding box. (''ent->r.mins'')</td></tr>
<tr><td>maxs</td><td>A point describing the location of the upper corner of the bounding box. (''ent->r.maxs'')</td></tr>
<tr><td>contents</td><td>Contents flags - description above (''ent->r.contents'')</td></tr>
<tr><td>svflags</td><td>Server flags (''ent->r.svFlags'')</td></tr>
<tr><td>clipmask</td><td>Brush content types to collide with. (''ent->clipmask'')</td></tr>
<tr><td>count2</td><td>entity-specific (''ent->count2'')</td></tr>
<tr><td>eflags</td><td>Entity flags (''ent->s.eFlags'')</td></tr>
<tr><td>pos_trType</td><td>Position trajectory type (''ent->s.pos.trType'')</td></tr>
<tr><td>pos_trDelta</td><td>Position trajectory delta Δ (''ent->s.pos.trType'')</td></tr>
<tr><td>apos_trType</td><td>Angle trajectory type (''ent->s.apos.trType'')</td></tr>
<tr><td>pos_trDelta</td><td>Angle trajectory delta Δ (''ent->s.apos.trType'')</td></tr>
<tr><td>classname_nospawn</td><td>Changes the class name, but doesn't re-spawn the entity. (''ent->classname'')</td></tr>
<tr><td>customaxisimage</td><td>Custom command map image for the Axis team</td></tr>
<tr><td>customalliesimage customalliedimage</td><td valign="top">Custom command map image for the Allied team</td></tr>
<tr><td>allowteams</td><td>Teams allowed to use an entity (''ent->allowteams'')</td></tr></table>

(You may wish to refer to the ET SDK for additional information.)
===The func_fakebrush entity===
Finally, ET Pro offers the func_fakebrush entity (also available by ORing EF_FAKEBMODEL (65536 or 0x10000) to eFlags), which allows the limited ability to spawn brush entities. The fake model must be a hexahedron, defined by mins and maxs, and will not work for all brush entity types.

'''Originally posted in the [http://bani.anime.net/banimod/forums/ ETPro forums] by [http://bani.anime.net/banimod/forums/profile.php?mode=viewprofile&u=800 Rain].'''

==Scripting Examples by [http://bani.anime.net/banimod/forums/profile.php?mode=viewprofile&u=1448 SiliconSlick]==
===Example 1: Additional Axis spawn in the trainyard tower on Railgun===
[http://bani.anime.net/banimod/forums/profile.php?mode=viewprofile&u=1448 SiliconSlick] made a [http://en.wikipedia.org/wiki/Diff diff] for the Railgun map script to provide the axis with an additional spawn point in the trainyard tower.
<pre>--- railgun.script.etpro.orig Wed Mar 31 20:01:18 2004
+++ railgun.script Mon Aug 23 10:11:08 2004
@@ -6,6 +6,83 @@
{
spawn
{
+ // SS - new spawns for Axis
+ create
+ {
+ targetname "axistowermarker"
+ scriptname "axistowermarker"
+ spawnflags 3
+ description "Axis Tower"
+ origin "2050 5100 625"
+ classname "team_WOLF_objective"
+ }
+
+ create
+ {
+ classname "team_CTF_redspawn"
+ scriptname "redspawn_00"
+ spawnflags 3
+ origin "2000 5175 625"
+ angle "-45"
+ mins "-30 -30 -30"
+ maxs "30 30 30"
+ }
+
+ create
+ {
+ classname "team_CTF_redspawn"
+ scriptname "redspawn_00"
+ spawnflags 3
+ origin "2000 5175 360"
+ angle "-45"
+ mins "-30 -30 -30"
+ maxs "30 30 30"
+ }
+
+ create
+ {
+ classname "team_CTF_redspawn"
+ scriptname "redspawn_00"
+ spawnflags 3
+ origin "2100 5175 625"
+ angle "-135"
+ mins "-30 -30 -30"
+ maxs "30 30 30"
+ }
+
+ create
+ {
+ classname "team_CTF_redspawn"
+ scriptname "redspawn_00"
+ spawnflags 3
+ origin "2100 5050 625"
+ angle "135"
+ mins "-30 -30 -30"
+ maxs "30 30 30"
+ }
+
+ create
+ {
+ classname "team_CTF_redspawn"
+ scriptname "redspawn_00"
+ spawnflags 3
+ origin "2100 5050 360"
+ angle "135"
+ mins "-30 -30 -30"
+ maxs "30 30 30"
+ }
+
+ create
+ {
+ classname "team_CTF_redspawn"
+ scriptname "redspawn_00"
+ spawnflags 3
+ origin "2000 5050 625"
+ angle "45"
+ mins "-30 -30 -30"
+ maxs "30 30 30"
+ }
+
//bani - bug fixes
create
{ </pre>
===Example 2: Depot Yard capture for Axis when Tug loaded on Railgun===
This is another diff that makes it so that when the first tug gets loaded with ammo, the Depot Yard spawn point gets captured permanently for the axis.
<pre>--- railgun.script.etpro.orig Wed Mar 31 20:01:18 2004
+++ railgun.script Mon Aug 23 10:11:08 2004
@@ -3088,6 +3165,8 @@

wm_set_main_objective 2 0
wm_set_main_objective 2 1
+
+ trigger depotflag axis_capture_forgood // SS - depot now permanently axis
}
}

@@ -6022,18 +6101,35 @@
wait 200
setstate capturespawn invisible
accum 0 set 0
+ accum 1 set 0 // SS - nobody had flag last
}

trigger axis_capture
{
trigger game_manager depotflagred
trigger depotflag setaxis
+ accum 1 set 2 // SS - axis had flag last
+ }
+
+
+ // SS - give depot yard to axis permanently
+ trigger axis_capture_forgood
+ {
+ trigger game_manager depotflagred
+ trigger depotflag setaxis
+
+ alertentity depotspawn // wake it up
+ setstate depotflag invisible // remove flag
+ accum 1 abort_if_less_than 2 // should be done if allies or nobody had it
+ alertentity depotspawn // switch to axis
+ wm_announce "Axis have permanently captured the Depot Yard!"
}

trigger allied_capture
{
trigger game_manager depotflagblue
trigger depotflag setallies
+ accum 1 set 1 // SS - allied had flag last
}

trigger setaxis </pre>
'''Originally posted in the [http://bani.anime.net/banimod/forums/ ETPro forums] and the [http://www.nd80usa.net/modules.php?name=Forums&file=viewtopic&t=11941&start=49 ND80 forums] by [http://bani.anime.net/banimod/forums/profile.php?mode=viewprofile&u=1448 SiliconSlick].'''
==Unresolved issues==
===[http://bani.anime.net/banimod/forums/profile.php?mode=viewprofile&u=1859 Ragnar_40k]'s destroyable team door on Radar===
I played around with the ETPro scripts and tried to make the axis team door next to the main gate satchable.
As first step I simply copied over the code for the battery backdoor and only changed the origin-key.
When I start the map I can throw a satchel next to the team door and get 7.5XP when I blast it. But I get no message and the teamdoor doesnt disapper.
It seems that the trigger "death" for "backdoor_obj" isn't called.
Can you say what is wrong?
<pre>
game_manager
{
spawn
{
create
{
scriptName "backdoor"
classname "func_explosive"
targetname "backdoor"
origin "-1518 16 1406"
mins "-63 -10 0"
maxs "63 10 128"
spawnflags 1 // AXIS_OBJECTIVE(1)
eflags 65536 // EF_FAKEBMODEL
svflags 1 // SVF_NOCLIENT
}

create
{
scriptName "backdoor_obj"
classname "trigger_objective_info"
targetname "backdoor_obj"
target "backdoor"
origin "-1518 16 1406"
mins "-95 -85 0"
maxs "95 85 128"
spawnflags 17 // AXIS_OBJECTIVE(1) | CUSTOMIMAGE
track "the Back Door"
shortname "Back Door"
customaxisimage "gfx/limbo/cm_radar_maindoor"
}
.
.
.
}</pre>
<pre>
backdoor
{
spawn
{
wait 50
constructible_class 2
}
}

backdoor_obj
{
death
{
wm_announce "Allied team has destroyed the Axis Team Door!"
trigger teamonlydoor1 hide

}
}

teamonlydoor1
{
trigger hide
{
remove
// setstate teamonlydoor1 invisible
}
}</pre>
The trigger backdoor_obj->death isn't called (I don't see the text from the wm_announce) . But the func_explosive "backdoor" I created is deystroyed (I get the XP for it).

'''Originally posted in the [http://bani.anime.net/banimod/forums/ ETPro forums] by [http://bani.anime.net/banimod/forums/profile.php?mode=viewprofile&u=1859 Ragnar_40k].'''
===[http://bani.anime.net/banimod/forums/profile.php?mode=viewprofile&u=2786 MoB Seany]'s Health and Ammo Cabinets===
Ok, now I want to get it to show up on the command map
I already have
<pre>game_manager
{
spawn
{
create
{
targetname "ammo"
scriptname "ammo"
origin "-1373 -1100 192"
classname "misc_cabinet_supply"
angle "270"
mins "-45 -45 -25"
maxs "45 45 25"
ammototal "100"
modelscale "1"
contents "1"
clipmask "1"
model "models/mapobjects/supplystands/stand_ammo.md3"
}
create
{
target "ammo"
ammototal "40"
ammorate "1"
origin "-1373 -1100 192"
classname "trigger_ammo"
targetname "ammoarea"
scriptname "ammoarea"
modelscale "1"
contents "1"
mins "-45 -45 -25"
maxs "45 45 25"
clipmask "1"
}
create
{
targetname "health"
scriptname "health"
origin "-1488 -1175 192"
classname "misc_cabinet_health"
angle "360"
mins "-45 -45 -25"
maxs "45 45 25"
modelscale "1"
contents "1"
clipmask "1"
model "models/mapobjects/supplystands/stand_ammo.md3"
}
create
{
target "health"
scriptname "healtharea"
targetname "healtharea"
classname "trigger_heal"
origin "-1488 -1175 192"
healtotal "400"
healrate "10"
modelscale "1"
contents "1"
mins "-45 -45-25"
maxs "45 45 25"
clipmask "1"
}
create
{
classname "trigger_objective_info"
target "help_marker_toi"
scriptname "ammo_info_toi"
track "Health and Ammo Cabinets"
targetname "ammo_info_toi"
shortname "Health and Ammo Cabinets"
spawnflags "is_healthammocabinet"
customimage "gfx/limbo/cm_healthammo"
origin "-1352 -1179 256"
modelscale "1"
contents "1"
mins "-45 -45-25"
maxs "45 45 25"
clipmask "1"

}
create
{
classname "misc_commandmap_marker"
scriptname "help_marker_toi"
targetname "help_marker_toi"
contents "1"
clipmask "1"
origin "-1488 -1175 192"
}
}
}</pre>
Its works and has a "You are near Health and Ammo" message, but what do I need to do to get it to show up ont he command map?
I did have script_mover parts as well before I removed them:
<pre>create
{
targetname "ammo_clip"
scriptname "ammo_clip"
classname "script_mover"
spawnflags "2"
}
create
{
targetname "health_clip"
scriptname "health_clip"
classname "script_mover"
spawnflags "2"
}</pre>
But, no matter what properties i removed, it still said a model was required for script_mover. Is a script_mover class really that important? And if so, what do I need to do to fix it? If not, then what must be done for it to show up on the command map? Thanks.

'''Originally posted in the [http://bani.anime.net/banimod/forums/ ETPro forums] by [http://bani.anime.net/banimod/forums/profile.php?mode=viewprofile&u=2786 MoB Seany].'''
[[Category:ETPro]][[Category:ETPro:Mapping]]

Talk:Fieldname

2006-05-16T01:53:53Z

ReyalP: /* Question */