LuaDocs/Activity

From Data Realms Wiki

Revision as of 08:57, 15 May 2014 (view source) LuaBot (Talk | contribs) (Activity - Automatically generated by LuaBot) ← Older edit		Latest revision as of 20:18, 2 April 2015 (view source) LuaBot (Talk | contribs) (Activity - Automatically generated by LuaBot)
Line 368:		Line 368:
	A float with the funds tally for the requested team.		A float with the funds tally for the requested team.
		+
		+
		+	===SetTeamAISkill===
		+	Sets AI skill level for specified team
		+
		+	'''Return value:'''
		+
		+	None
		+
		+
		+	===GetTeamAISkill===
		+	'''Arguments:'''
		+
		+	* Team to get skill level for
		+
		+	'''Return value:'''
		+
		+	Team skill level

---

Latest revision as of 20:18, 2 April 2015

Contents 1 Parent: Entity 2 Enumerations 2.1 ActivityState 2.2 Player 2.3 Team 2.4 ViewState 2.5 DifficultySetting 3 Properties 3.1 ClassName 3.2 Description 3.3 InCampaignStage 3.4 ActivityState 3.5 SceneName 3.6 PlayerCount 3.7 HumanCount 3.8 TeamCount 3.9 Difficulty 4 Functions 4.1 DeactivatePlayer 4.2 PlayerActive 4.3 PlayerHuman 4.4 TeamActive 4.5 GetTeamOfPlayer 4.6 SetTeamOfPlayer 4.7 PlayersInTeamCount 4.8 ScreenOfPlayer 4.9 GetViewState 4.10 SetViewState 4.11 GetPlayerBrain 4.12 SetPlayerBrain 4.13 PlayerHadBrain 4.14 SetBrainEvacuated 4.15 BrainWasEvacuated 4.16 IsAssignedBrain 4.17 IsBrainOfWhichPlayer 4.18 IsOtherPlayerBrain 4.19 HumanBrainCount 4.20 AIBrainCount 4.21 GetControlledActor 4.22 SetTeamFunds 4.23 GetTeamFunds 4.24 SetTeamAISkill 4.25 GetTeamAISkill 4.26 ChangeTeamFunds 4.27 TeamFundsChanged 4.28 ReportDeath 4.29 GetTeamDeathCount 4.30 GetDemoTimeLeft 4.31 Running 4.32 Paused 4.33 ActivityOver 4.34 EnteredOrbit 4.35 SwitchToActor 4.36 SwitchToNextActor 4.37 SwitchToPrevActor 4.38 IsPlayerTeam 4.39 ResetMessageTimer 4.40 Pause 4.41 End

Parent: Entity

Generic Class. Base class for all Activity:s, including game modes and editors.

Go back to Class Index

Enumerations

ActivityState

• 0 = NOTSTARTED
• 1 = STARTING
• 2 = EDITING
• 3 = PREGAME
• 4 = RUNNING
• 5 = DEMOEND
• 6 = INERROR
• 7 = OVER

Player

• 0 = PLAYER_1
• 1 = PLAYER_2
• 2 = PLAYER_3
• 3 = PLAYER_4
• 4 = MAXPLAYERCOUNT

Team

• 0 = TEAM_1
• 1 = TEAM_2
• 2 = TEAM_3
• 3 = TEAM_4
• 4 = MAXTEAMCOUNT

ViewState

• 0 = NORMAL
• 1 = OBSERVE
• 2 = DEATHWATCH
• 3 = ACTORSELECT
• 4 = AISENTRYPOINT
• 5 = AIPATROLPOINTS
• 6 = AIGOLDDIGPOINT
• 7 = AIGOTOPOINT
• 8 = LZSELECT

DifficultySetting

• 0 = MINDIFFICULTY
• 15 = CAKEDIFFICULTY
• 40 = EASYDIFFICULTY
• 60 = MEDIUMDIFFICULTY
• 85 = HARDDIFFICULTY
• 98 = NUTSDIFFICULTY
• 100 = MAXDIFFICULTY

Properties

ClassName

Read-only property. The class name of this Entity.A string with the friendly-formatted type name of this object.

Description

Read-only property. The user-friendly description of this.A string with the user-friendly description of this.

InCampaignStage

Shows in which stage of the Campaign this appears.An int with the stage number. < 0 means it's not in the campaign

ActivityState

The current activity state code. See the ActivityState enumeration for the legend.An int with the game state code.

SceneName

The name of the current scene.A string with the instance name of the scene.

PlayerCount

The total number of active players in the current game, AI or HumanThe total number of players in the current game.

HumanCount

Read-only property. The total number of human players in the current gameThe total number of players in the current game.

TeamCount

The total number of teams in the current gameThe total number of teams in the current game.

Difficulty

The current difficulty settingThe current setting.

Functions

DeactivatePlayer

Turns off a player if they were active. Should only be done if brain etc are already taken care of and disposed of properly. Will also deactivate the team this player is on, if there's no other active players still on it.

Arguments:

• Which player index to deactivate.

Return value:

Whether the player was active before trying to deactivate.

PlayerActive

Indicates whether a specific player is active in the current game.

Arguments:

• Which player index to check.

Return value:

Whether the player is active in the current activity.

PlayerHuman

Indicates whether a specific player is human in the current game, ie not an AI player and has a screen etc.

Arguments:

• Which player index to check.

Return value:

Whether the player is active as a Human in the current activity.

TeamActive

Indicates whether a specific team is active in the current game.

Arguments:

• Which team index to check.

Return value:

Whether the team is active in the current activity.

GetTeamOfPlayer

Gets the current team a specific player belongs to.

Arguments:

• The player to get the team info on.

Return value:

An int with the team number.

SetTeamOfPlayer

Sets the current team a specific player belongs to.

Arguments:

• The player to set the team info on, and the team.

Return value:

None.

PlayersInTeamCount

Gets the current number of players in a specific team.

Arguments:

• Which team to get the player count for.

Return value:

An int with the player count.

ScreenOfPlayer

Converts a player index into a screen index, and only if that player is human.

Arguments:

• Which player index to convert.

Return value:

An int with the screen index, or -1 if nonhuman player or no players.

GetViewState

Gets the current viewing state for a specific player. See the ViewState enumeration for the legend.

Arguments:

• Which player to get the view state for.

Return value:

None.

SetViewState

Sets the current viewing state for a specific player. See the ViewState enumeration for the legend.

Arguments:

• The state you want to set to.
• Which player to get the view state for.

Return value:

None.

GetPlayerBrain

Gets the current Brain actor for a specific player.

Arguments:

• Which player to get the brain actor for.

Return value:

A pointer to the Brain Actor. Ownership is NOT transferred!

SetPlayerBrain

Sets the current Brain actor for a specific player.

Arguments:

• A pointer to the new brain Actor. Ownership is NOT transferred!
• Which team to set the brain actor for.

Return value:

None.

PlayerHadBrain

Shows whether a specific player ever had a brain yet.

Arguments:

• Which player to check whether they ever had a brain.

Return value:

Whether this player ever had a brain.

SetBrainEvacuated

Sets whether a player's brain was evacuated during the Activity.

Arguments:

• Which player to check whether their brain was evac'd.
• Whether it was evacuated yet.

Return value:

None.

BrainWasEvacuated

Shows whether a specific player's brain was evacuated into orbit so far.

Arguments:

• Which player to check whether their brain was evac'd.

Return value:

Whether this player had a brain that was evacuated.

IsAssignedBrain

Shows whether the passed in actor is the brain of any player.

Arguments:

• Which Actor to check for player brainedness.

Return value:

Whetehr any player's brain or not.

IsBrainOfWhichPlayer

Shows which player has a specific actor as a brain, if any.

Arguments:

• Which Actor to check for player brainedness.

Return value:

Which player has this assigned as a brain, if any.

IsOtherPlayerBrain

Shows whether the passed in actor is the brain of any other player.

Arguments:

• Which Actor to check for other player brainedness.
• From which player's perspective to make the query.

Return value:

Whetehr other player's brain or not.

HumanBrainCount

Shows how many human-controlled brains are left in this Activity.

Arguments:

• None.

Return value:

How many brains are left as human-controlled in this Activity.

AIBrainCount

Shows how many A.I.-controlled brains are left in this Activity.

Arguments:

• None.

Return value:

How many brains are left on as A.I.-controlled in this Activity.

GetControlledActor

Gets the currently controlled actor of a specific player.

Arguments:

• Which player to get the controlled actor of.

Return value:

A pointer to the controlled Actor. Ownership is NOT transferred! 0 If no actor is currently controlled by this player.

SetTeamFunds

Sets the amount of funds a specific team currently has in the game.

Arguments:

• Which team to set the fund count for. 0 = first team.

Return value:

A float with the funds tally for the requested team.

GetTeamFunds

Gets the amount of funds a specific team currently has in the game.

Arguments:

• Which team to get the fund count from. 0 = first team.

Return value:

A float with the funds tally for the requested team.

SetTeamAISkill

Sets AI skill level for specified team

Return value:

None

GetTeamAISkill

Arguments:

• Team to get skill level for

Return value:

Team skill level

ChangeTeamFunds

Changes a team's funds level by a certain amount.

Arguments:

• The amount with which to change the funds balance.
• Which team to alter the funds of. 0 = first team.

Return value:

None.

TeamFundsChanged

Checks whetehr the team funds changed since last time this was called. This also resets the state, so calling this again on the same team will ield false unless it's been changed again.

Arguments:

• Which team's funds to check.

Return value:

Whether funds amount changed for this team since last time this was called.

ReportDeath

Increments the tally of a death of an actor on a specific team.

Arguments:

• Which team to increase the death count of. 0 = first team.

Return value:

The new death count.

GetTeamDeathCount

Gets the number of deaths on a specific team so far on the current game.

Arguments:

• Which team to get the death tally of. 0 = first team.

Return value:

The current death count.

GetDemoTimeLeft

Shows how many seconds of demo time is left, if indeed in demo mode.

Arguments:

• None.

Return value:

An int wwith how many demo seconds are left, or < 0 if not applicable.

Running

Indicates whether the game is currently running or not (not editing, over or paused)

Arguments:

• None.

Return value:

Whether the game is running or not.

Paused

Indicates whether the game is currently paused or not.

Arguments:

• None.

Return value:

Whether the game is paused or not.

ActivityOver

Indicates whether the game is over or not.

Arguments:

• None.

Return value:

Whether the game is over or not.

EnteredOrbit

Indicates an Actor as having left the game scene and entered orbit. OWNERSHIP IS NOT transferred, as the Actor's inventory is just 'unloaded'.

Arguments:

• The actor instance. Ownership IS NOT TRANSFERRED!

Return value:

None.

SwitchToActor

Forces the ActivityMan to focus player control to a specific Actor for a specific team. OWNERSHIP IS NOT TRANSFERRED!

Arguments:

• Which Actor to switch focus to. The team of this Actor will be set once it is passed in. Ownership IS NOT TRANSFERRED! The Actor should be added to MovableMan already.

Return value:

Whether the focus switch was successful or not.

SwitchToNextActor

Forces the ActivityMan to focus player control to the next Actor of a specific team, other than the current one focused on.

Arguments:

• Which team to switch to next actor on.
• An actor pointer to skip in the sequence.

Return value:

None.

SwitchToPrevActor

Forces the ActivityMan to focus player control to the previous Actor of a specific team, other than the current one focused on.

Arguments:

• Which team to switch to next actor on.
• An actor pointer to skip in the sequence.

Return value:

None.

IsPlayerTeam

Indicates whether a team is player controlled or not.

Arguments:

• The team nuber to check.

Return value:

Whether team is player controlled or not.

ResetMessageTimer

Resets the message timer for one player

Arguments:

• The player to rese tthe message timer for.

Return value:

None.

Pause

Pauses and unpauses the game.

Arguments:

• Whether to pause the game or not.

Return value:

None.

End

Forces this activity's game end.

Arguments:

• None.

Return value:

None.

Go back to Class Index