RU/spawnPlayer: Difference between revisions

Latest revision as of 18:50, 20 December 2018

Данная функция спавнит игрока в указанной точке карты.

[[{{{image}}}\|link=\|]]	Примечание: Используйте setCameraTarget, чтобы сфокусировать камеру на игроке. Также при первоначальным подключении игрока, камера затемнена. Чтобы выключить затемнение, используйте fadeCamera.

Синтаксис

bool spawnPlayer ( player thePlayer, vector3 position, [ int rotation = 0, int skinID = 0, int interior = 0, int dimension = 0, team theTeam = nil ] )

bool spawnPlayer ( player thePlayer, float x, float y, float z, [ int rotation = 0, int skinID = 0, int interior = 0, int dimension = 0, team theTeam = nil ] )

Обязательные аргументы

thePlayer: игрок, которого вы хотите заспавнить.
position: координаты в виде вектора.

или

x: координата x, на которой заспавнится игрок.
y: координата y, на которой заспавнится игрок.
z: координата z, на которой заспавнится игрок.

Дополнительные аргументы

rotation: угол поворота игрока в градусах.
skinID: скин игрока при спавне. Скины
interior: интерьер, в котором будет заспавнен игрок. ID'ы интерьеров
dimension: ID измерения, в котором будет находиться игрок.
theTeam: команда, к которой присоединится игрок.

Вывод

Возвращает true если игрок был успешно заспавнен, false в противном случае.

Пример

Данный пример спавнит всех игроков в центре карты.

-- Получаем таблицу со всеми игроками
players = getElementsByType ( "player" )
-- Пробегаемся по игрокам
for playerKey, playerValue in ipairs(players) do
	-- Спавним каждого из них в нужных нам координатах
	spawnPlayer ( playerValue, 0.0, 0.0, 5.0, 90.0, 0 )
end

Спавнит игрока после его авторизации.

spawnTeam = createTeam ("Teamname", 255, 0, 0) -- Создаем команду для спавна.
function spawnOnLogin (prevA, curA)
	outputChatBox ("Welcome to ...", source, 255, 0, 0, false)
	spawnPlayer (source, 0, 0, 5, 0, math.random (0,288), 0, 0, spawnTeam) -- спавним игрока со случайным скином
	fadeCamera (source, true)
	setCameraTarget (source, source)
end
addEventHandler("onPlayerLogin", getRootElement(), spawnOnLogin)

Смотрите также

@@ Line 1: / Line 1: @@
 __NOTOC__
 {{RU/Server function}}
-Эта функция спавнит игрока в указанной точке карты.<br>
+Данная функция спавнит игрока в указанной точке карты.<br>
+{{Примечание|Используйте [[setCameraTarget]], чтобы сфокусировать камеру на игроке. Также при первоначальным подключении игрока, камера затемнена. Чтобы выключить затемнение, используйте [[fadeCamera]].}}
-'''''Примечание:''' Используйте [[RU/setCameraTarget|setCameraTarget]], чтобы камера была сфокусирована на игроке. Также при первоначальном подключении игрока, камера "затемнена", поэтому ее необходимо "растемнить" с помощью [[RU/fadeCamera|fadeCamera]].''
 ==Синтаксис==
+<syntaxhighlight lang="lua">
+bool spawnPlayer ( player thePlayer, vector3 position, [ int rotation = 0, int skinID = 0, int interior = 0, int dimension = 0, team theTeam = nil ] )
+</syntaxhighlight>
 <syntaxhighlight lang="lua">
 bool spawnPlayer ( player thePlayer, float x, float y, float z, [ int rotation = 0, int skinID = 0, int interior = 0, int dimension = 0, team theTeam = nil ] )
@@ Line 11: / Line 13: @@
 ===Обязательные аргументы===
-*'''thePlayer:''' [[player|игрок]], которого вы спавните.
+*'''thePlayer:''' игрок, которого вы хотите заспавнить.
-*'''x:''' Координата по x
+*'''position:''' координаты в виде [[vector3|вектора]].
-*'''y:''' Координата по y
+или
-*'''z:''' Координата по z
+*'''x:''' координата x, на которой заспавнится игрок.
+*'''y:''' координата y, на которой заспавнится игрок.
+*'''z:''' координата z, на которой заспавнится игрок.
 ===Дополнительные аргументы===
-*'''rotation:''' угол поворота игрока в градусах
+*'''rotation:''' угол поворота игрока в градусах.
-*'''skinID:''' скин игрока при спавне (по умолчанию CJ)
+*'''skinID:''' скин игрока при спавне. [[Character Skins|Скины]]
-*'''interior:''' ID интерьера, в который спавнить
+*'''interior:''' интерьер, в котором будет заспавнен игрок. [[Interior IDs|ID'ы интерьеров]]
 *'''dimension:''' ID [[dimension|измерения]], в котором будет находиться игрок.
-*'''theTeam:''' команда, в которой будет находиться игрок.
+*'''theTeam:''' команда, к которой присоединится игрок.
 ===Вывод===
-Возвращает ''true'' если успешно, ''false'' в противном случае.
+Возвращает ''true'' если игрок был успешно заспавнен, ''false'' в противном случае.
 ==Пример==
-Спавним всех игроков в центре карты.
+Данный пример спавнит всех игроков в центре карты.
 <syntaxhighlight lang="lua">
--- получаем таблицу всех игроков
+-- Получаем таблицу со всеми игроками
 players = getElementsByType ( "player" )
--- пробегаем все ячейки этой таблицы
+-- Пробегаемся по игрокам
 for playerKey, playerValue in ipairs(players) do
-	-- спавним каждого из игроков в указанной точке
+	-- Спавним каждого из них в нужных нам координатах
 	spawnPlayer ( playerValue, 0.0, 0.0, 5.0, 90.0, 0 )
 end
 </syntaxhighlight>
-Этот код спавнит игрока, когда он логинится.
+Спавнит игрока после его авторизации.
 <syntaxhighlight lang="lua">
-spawnTeam = createTeam ("Teamname", 255, 0, 0) -- Создаем команду для игрока
+spawnTeam = createTeam ("Teamname", 255, 0, 0) -- Создаем команду для спавна.
-function spawnOnLogin (prevA, curA, autoLogin)
+function spawnOnLogin (prevA, curA)
 	outputChatBox ("Welcome to ...", source, 255, 0, 0, false)
 	spawnPlayer (source, 0, 0, 5, 0, math.random (0,288), 0, 0, spawnTeam) -- спавним игрока со случайным скином
-	fadeCamera (source, true) --"растемняем" камеру
+	fadeCamera (source, true)
-	setCameraTarget (source, source) --направляем ее на игрока
+	setCameraTarget (source, source)
 end
 addEventHandler("onPlayerLogin", getRootElement(), spawnOnLogin)
@@ Line 51: / Line 55: @@
 ==Смотрите также==
-{{RU/Player functions}}
+{{RU/Player_functions}}
 [[en:spawnPlayer]]