|
|
(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]] | |