Difference between revisions of "Lua Commands"

From Fortress Forever Wiki
Jump to navigationJump to search
(Redirecting to Category:Lua Commands)
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
LUA commands that require further explanation.
+
#REDIRECT [[Category:Lua_Commands]]
 
 
= Global Events =
 
These are functions that are called by the engine that do not belong inside any class. Simply declare them as globals in the lua namespace.
 
 
 
{| border="1" cellspacing="0"
 
! LUA Command !! Discription
 
|-
 
| [[Lua:tick|tick]]() || This function is called every second by the engine.
 
|-
 
| [[Lua:precache|precache]]() || This function is called when the map starts, before entities have been initialized.
 
|-
 
| [[Lua:startup|startup]]() || This function is called when the map starts, after all the entities have been initialized, also used to set map properties.
 
|-
 
| [[Lua:flaginfo|flaginfo]]() ||
 
|}
 
 
 
== Player Triggered Commands ==
 
 
 
These commands are triggered when a event with a player happens in-game.
 
 
 
{| border="1" cellspacing="0"
 
! LUA Command !! Discription
 
|-
 
| [[Lua:player_spawn|player_spawn]]( player ) || triggers when a player spawns.
 
|-
 
| [[Lua:player_killed|player_killed]]( player, killer ) ||  triggers when a player is killed.
 
|-
 
| [[Lua:player_onconc|player_onconc]]( player, inflictor ) || triggers when a player is conced.
 
conc_duration -- duration of conc
 
 
 
conc_iconduration -- duration of conced icon on HUD
 
|-
 
| [[Lua:player_ondamage|player_ondamage]]( player ) || triggers is called whenever a player takes damage.
 
|-
 
| [[Lua:player_ontranq|player_ontranq]]( player, inflictor ) || triggers when a player is tranq'd.
 
tranq_duration -- duration of tranq.
 
 
 
tranq_speed -- speed of tranq'd player.
 
|-
 
| [[Lua:player_ongas|player_ongas]]( player, inflictor ) || triggers when a player is gassed.
 
gas_duration
 
 
 
gas_iconduration
 
|-
 
| [[Lua:player_oninfect|player_oninfect]]( player, inflictor ) ||
 
infection_duration
 
 
 
infect_iconduration
 
|-
 
| [[Lua:player_onradiotag|player_onradiotag]]( player, inflictor ) ||
 
radiotag_duration
 
radiotag_iconduration
 
|-
 
| [[Lua:player_onheadshot|player_onheadshot]]( player, inflictor ) ||
 
|-
 
| [[Lua:player_onlegshot|player_onlegshot]]( player, inflictor ) ||
 
legshot_duration
 
 
 
legshot_iconduration
 
 
 
legshot_speed
 
|-
 
| [[Lua:player_oncaltrop|player_oncaltrop]]( player, inflictor ) ||
 
caltrop_duration
 
 
 
caltrop_iconduration
 
 
 
caltrop_speed
 
|-
 
| [[Lua:player_onacspinup|player_onacspinup]]( player, inflictor ) ||
 
acspinup_duration
 
 
 
acspinup_speed
 
|-
 
| [[Lua:player_onsniperrifle|player_onsniperrifle]]( player, inflictor ) ||
 
sniperrifle_speed
 
|-
 
| [[Lua:player_onspeedluaX|player_onspeedluaX]]( player, inflictor ) || these are for various speed settings, like CZ2's flags. You can have up to ten, they're defined here.
 
speedlua_speed
 
|-
 
|}
 
 
 
= Casting Commands =
 
 
 
in lua entity's and other objects may be passed to other commands's as a different object then needed these are used to cast or transform a lua object to a different type of object such as a player.
 
 
 
{| border="1" cellspacing="0"
 
! LUA Command !! Discription
 
|-
 
| [[Lua:CastToBeam|CastToBeam]]( ent_id ) || tries to cast the entity to a beam (to see if whatever triggered the event was a laser beam, a la SD2). If it fails, it returns null.
 
|-
 
| [[Lua:CastToPlayer|CastToPlayer]]( ent_id ) || used to cast the passed in entity to a player, often used for touch commands.
 
|-
 
| [[Lua:CastToInfoScript|CastToInfoScript]]( ent_id ) ||
 
|-
 
| [[Lua:CastToTriggerScript|CastToTriggerScript]]( ent_id ) ||
 
|-
 
| [[Lua:CastToTriggerClip|CastToTriggerClip]]( ent_id ) ||
 
|-
 
| [[Lua:CastToGrenade|CastToGrenade]]( ent_id ) ||
 
|-
 
| [[Lua:CastToDispenser|CastToDispenser]]( ent_id ) ||
 
|-
 
| [[Lua:CastToSentrygun|CastToSentrygun]]( ent_id ) ||
 
|-
 
| [[Lua:CastToDetpack|CastToDetpack]]( ent_id ) ||
 
|}
 
 
 
 
 
= Entity Check's =
 
these commands are used to Check if a passed in entity is a game entity of a specific type
 
 
 
{| border="1" cellspacing="0"
 
! LUA Command !! Discription
 
|-
 
| [[Lua:IsPlayer|IsPlayer]]( ent_id ) || used to see if a passed in entity is a player to before actions are performed on said player.
 
|-
 
| [[Lua:IsDispenser|IsDispenser]]( ent_id ) ||
 
|-
 
| [[Lua:IsSentrygun|IsSentrygun]]( ent_id ) ||
 
|-
 
| [[Lua:IsDetpack|IsDetpack]]( ent_id ) ||
 
|-
 
| [[Lua:IsGrenade|IsGrenade]]( ent_id ) ||
 
|-
 
| [[Lua:IsTurret|IsTurret]]( ent_id ) ||
 
|}
 
 
 
= Player messaging and sounds =
 
these are used to send text messages and sounds to players.
 
 
 
{| border="1" cellspacing="0"
 
! LUA Command !! Discription
 
|-
 
| [[Lua:BroadCastMessage|BroadCastMessage]]( message ) || broadcasts a given message to all players.
 
|-
 
| [[Lua:BroadCastMessageToPlayer|BroadCastMessageToPlayer]]( player, message ) || broadcasts message to one player.
 
|-
 
| [[Lua:BroadCastSound|BroadCastSound]]( sound ) ||
 
|-
 
| [[Lua:BroadCastSoundToPlayer|BroadCastSoundToPlayer]]( player, sound ) ||
 
|-
 
| [[Lua:ConsoleToAll|ConsoleToAll]]( message ) || sends a message to server console. Inaccurately named.
 
|}
 
 
 
= Other Commands =
 
other misc commands not lumped into any group as of yet.
 
 
 
{| border="1" cellspacing="0"
 
! LUA Command !! Discription
 
|-
 
| [[Lua:AddSchedule|AddSchedule]]("name", time, function[, param1 ... param4]) || Schedules function to go off with time second delay. Optional parameters are applied to the function.
 
|-
 
| [[Lua:AddScheduleRepeating|AddScheduleRepeating]]("name", time, function[, param1 ... param4]) || Adds a schedule that repeats function constantly every time seconds.
 
|-
 
| [[Lua:AddScheduleRepeatingNotInfinitely|AddScheduleRepeatingNotInfinitely]]("name", time, function, counts[, param1 ... param4]) || Adds a schedule that repeats function counts times every time seconds.
 
|-
 
| [[Lua:AddHudIcon|AddHudIcon]]( player, HudIconType, NameOfHudIcon, X, Y, Width, Height, Align ) || adds HUD icon to given player of given type. Name is generally taken from the flag entity to apply the right kind. X, Y, W, H, and A are all standard.
 
|-
 
| [[Lua:AddHudIconToAll|AddHudIconToAll]]( HudIconType, NameOfHudUcon, X, Y, W, H, A ) || adds HUD icon to all players like those used for flag info.
 
|-
 
| [[Lua:DeleteSchedule|DeleteSchedule]]( schedulename ) || deletes an existing schedule.
 
|-
 
| [[Lua:RemoveSchedule|RemoveSchedule]]( schedulename ) || same as delete.
 
|-
 
| [[Lua:GetConvar|GetConvar]]( cvar ) || checks the value of a console variable (cvar)
 
|-
 
| [[Lua:GetEntity|GetEntity]]( index ) || gets an entity by its index.
 
|-
 
| [[Lua:GetEntityByName|GetEntityByName]]( name ) || obvious?
 
|-
 
| [[Lua:GetInfoScriptById|GetInfoScriptById]]( id ) || gets an info_ff_script's information by its id.
 
|-
 
| [[Lua:GetInfoScriptByName|GetInfoScriptByName]]( name ) || obvious?
 
|-
 
| [[Lua:GetGrenade|GetGrenade]]() || ??
 
|-
 
| [[Lua:GetPacketloss|GetPacketloss]]( playerentity ) || gets a player's packet loss. Woo?
 
|-
 
| [[Lua:GetPing|GetPing]]( playerentity ) ||
 
|-
 
| [[Lua:GetPlayer|GetPlayer]]( playerentity ) ||
 
|-
 
| [[Lua:GetPlayerByID|GetPlayerByID]]( id ) ||
 
|-
 
| [[Lua:GetServerTime|GetServerTime]]()  ||
 
|-
 
| [[Lua:GetSteamID|GetSteamID]]( playerentity ) ||
 
|-
 
| [[Lua:GetTeam|GetTeam]]( playerentity ) ||
 
|-
 
| [[Lua:GetTriggerScriptByName|GetTriggerScriptByName]]( name ) ||
 
|-
 
| [[Lua:GoToIntermission|GoToIntermission]]( ) || ???
 
|-
 
| [[Lua:IncludeScript|IncludeScript]]( luafile ) || used to include Lua files found in /includes/ such as base_teamplay or base_ctf.
 
|-
 
| [[Lua:ApplyToAll|ApplyToAll]]( effect ) ||
 
|-
 
| [[Lua:ApplyToTeam|ApplyToTeam]]( effect, team ) ||
 
|-
 
| [[Lua:ApplyToPlayer|ApplyToPlayer]]( effect, player ) ||
 
|-
 
| [[Lua:AreTeamsAllied|AreTeamsAllied]]( team1, team2 ) || obvious?
 
|-
 
| [[Lua:KillAndRespawnAllPlayers|KillAndRespawnAllPlayers]]() || obvious!
 
|-
 
| [[Lua:NumPlayers|NumPlayers]]() || gets the number of players.
 
|-
 
| [[Lua:OutputEvent|OutputEvent]]( event, ent_id[, param1, param2, etc.] ) || tells an entity to fire the given output.
 
|-
 
| OutputEvent , void * const char* , const char* , const char* , float , unsigned int &FFLib::FireOutput  ||
 
|-
 
| [[Lua:PrecacheModel|PrecacheModel]]( modelfile ) || loads a given model into memory for use later.
 
|-
 
| [[Lua:PrecacheSound|PrecacheSound]]( soundfile ) || as above.
 
|-
 
| PrintBool , &FFLib::PrintBool  ||
 
|-
 
| [[Lua:RandomFloat|RandomFloat]]( min, max ) || generates a random float.
 
|-
 
| [[Lua:RandomInt|RandomInt]]( min, max ) || generates a random integer
 
|-
 
| [[Lua:RemoveEntity|RemoveEntity]]( ent_id ) || removes entity.
 
|-
 
| [[Lua:RemoveHudItem|RemoveHudItem]]( player, hudiconid ) || removes hud icon.
 
|-
 
| [[Lua:RemoveHudItemFromAll|RemoveHudItemFromAll]]( hudiconid ) ||
 
|-
 
| [[Lua:RespawnAllPlayers|RespawnAllPlayers]]( ) || respawns everyone.
 
|-
 
| [[Lua:ResetMap|ResetMap]]() || resets map.
 
|-
 
| [[Lua:SetGlobalRespawnDelay|SetGlobalRespawnDelay]]( time ) || enforces a respawn delay.
 
|-
 
| [[Lua:SetPlayerLimit|SetPlayerLimit]]( team , # ) || used to set player limit per team.
 
|-
 
| [[Lua:SetPlayerLimits|SetPlayerLimits]]( #, # ) ||
 
|-
 
| [[Lua:SmartClassLimits|SmartClassLimits]]( team, #scout, #sniper, #soldier, #demoman, #medic, #hwguy, #pyro, #spy, #engineer, #civilian ) || sets smart class limits instead of using individual commands.
 
|-
 
| [[Lua:SetConvar|SetConvar]]( player, var, value ) || sets a players cvar to set value
 
|-
 
| [[Lua:SetTeamAllies|SetTeamAllies]]( team , bits ) || used to ally one team to another.
 
|-
 
| [[Lua:SetTeamClassLimit|SetTeamClassLimit]]( team, class, limit ) ||
 
|-
 
| [[Lua:SetTeamName|SetTeamName]]( team, name ) ||
 
|-
 
| [[Lua:SetTeamPlayerLimit|SetTeamPlayerLimit]]( team, limit ) ||
 
|-
 
| [[Lua:SetTeamPlayerLimit|SetTeamPlayerLimit]]( team, limit ) ||
 
|-
 
| SmartMessage , &FFLib::SmartMessage ||
 
|-
 
| SmartSound , &FFLib::SmartSound ||
 
|-
 
| SmartTeamMessage , &FFLib::SmartTeamMessage ||
 
|-
 
| SmartTeamSound , &FFLib::SmartTeamSound ||
 
|-
 
| SpeakAll , &FFLib::SpeakAll ||
 
|-
 
| SpeakPlayer , &FFLib::SpeakPlayer ||
 
|-
 
| SpeakTeam , &FFLib::SpeakTeam ||
 
|}
 
 
 
[[Category:Lua]]
 

Latest revision as of 20:05, 25 February 2008