Respawn – Arma 3

From Bohemia Interactive Community
Jump to navigation Jump to search
(Created page with "Category:Arma 3: Editing == Mission Configuration == === Description.ext === A wide range of Description.ext entries lets you to configure respawn settings for your miss...")
 
mNo edit summary
Line 21: Line 21:


=== Files ===
=== Files ===
Create a file called ''initRespawn.sqf'' in your [[Mission_Editor:_External|mission directory]]. It will be automatically executed on player's computer when he dies and once again when he respawns.  
Create a file called ''initRespawn.sqf'' in your [[Mission_Editor:_External|mission directory]]. It will be automatically executed on player's computer either when he dies, when he respawns or in both cases.


Following parameters are passed into it in both cases:
Following parameters are passed into it in both cases:
Line 39: Line 39:
:*isDeath: [[Boolean]]- true when script is executed after death, false when after respawn.
:*isDeath: [[Boolean]]- true when script is executed after death, false when after respawn.
:*respawnDelay: [[Number]] - respawn delay defined either in respawn type or in Description.ext.
:*respawnDelay: [[Number]] - respawn delay defined either in respawn type or in Description.ext.
{{Important|File name and arguments may change during Alpha / Beta development}}





Revision as of 11:52, 14 May 2013


Mission Configuration

Description.ext

A wide range of Description.ext entries lets you to configure respawn settings for your mission.

// Respawn type, see the table below
respawn = 2;
// Delay in seconds before playable unit respawns
respawnDelay = 10;
// Delay in seconds before vehicle respawns
respawnVehicleDelay = 60;
// 0 to disable the score table (it can still be opened manually by pressing 'P' key)
respawnDialog = 0;
// Respawn templates from CfgRespawnTemplates
respawnTemplates[] = {"Counter","Wave"};
// 1 to execute respawn templates when a player joins the game
respawnOnStart = 1;
// When 1, the score table contains score of all playable units as opposed to players only
aikills = 1;


Files

Create a file called initRespawn.sqf in your mission directory. It will be automatically executed on player's computer either when he dies, when he respawns or in both cases.

Following parameters are passed into it in both cases:

Death

(first 2 params are the same as are passed into Killed event handler)
[<unit>,<killer>,<isRespawn>,<respawn>,<respawnDelay>]

Respawn

(first 2 params are the same as are passed into Respawn event handler)
[<newUnit>,<oldUnit>,<isRespawn>,<respawn>,<respawnDelay>]

Parameters:

  • oldUnit: Object - killed player. objNull when executed on start.
  • newUnit: Object - newly respawned player.
  • killer: Object - a unit who killed player. objNull when executed on start.
  • isDeath: Boolean- true when script is executed after death, false when after respawn.
  • respawnDelay: Number - respawn delay defined either in respawn type or in Description.ext.
File name and arguments may change during Alpha / Beta development


Respawn Types

ID Name Description initRespawn.sqf
on death
initRespawn.sqf
on respawn
0 "NONE" Show singleplayer death screen Template:task/ Template:task
1 "BIRD" Respawn to a seagull Template:task Template:task/
2 "INSTANT" Respawn on spot where player died Template:task/ Template:task/
3 "BASE" Respawn on a marker
  • Unit respawn
    • respawn_west
    • respawn_east
    • respawn_guerrila
    • respawn_civilian
  • Vehicle respawn
    • respawn_vehicle_west
    • respawn_vehicle_east
    • respawn_vehicle_guerrila
    • respawn_vehicle_civilian
Template:task/ Template:task/
4 "GROUP" Respawn to the next available playable unit in a group. When none is left, BIRD respawn is used instead. Template:task Template:task/
5 "SIDE" Respawn to the next available playable unit of the same side (selected using team switch window). When none is left, BIRD respawn is used instead. Template:task Template:task/


Scripting Commands

System Configuration

Respawn Templates

New templates can be defined in global Config.cpp or in mission and campaign Description.ext files.

class CfgRespawnTemplates
{
	// Class used in respawnTemplates entry
	class myTag_beacon
	{
		// Template name
		displayName = "Beacon";
		// Function or script execute upon death and respawn. Parameters passed into it are the same as are passed into initRespawn.sqf file
		init = "\myAddon\scripts\respawnBeacon.sqf";
		// Default respawn delay (can be overwitten by description.ext entry of the same name)
		respawnDelay = 20;
	};
	class Spectator
	{
		displayName = "Spectator";
		init = "BIS_fnc_respawnSpectator";
	};
};