PT-BR/CreateVehicle - Revision history

LordHenry: Undo revision 71358 by EOFIK (talk) Reason: No real change.

2021-06-20T20:46:50Z

Undo revision 71358 by EOFIK (talk) Reason: No real change.

← Older revision		Revision as of 20:46, 20 June 2021
Line 28:		Line 28:
	* '''variant1''': Um [[int]] para o primeiro variante do veículo. Veja [[vehicle variants]].		* '''variant1''': Um [[int]] para o primeiro variante do veículo. Veja [[vehicle variants]].
	* '''variant2''': Um [[int]] para o segundo variante do veículo. Veja [[vehicle variants]].		* '''variant2''': Um [[int]] para o segundo variante do veículo. Veja [[vehicle variants]].
	~~\|PT-BR~~}}		}}

	===Retorna===		===Retorna===

EOFIK: Изменение категории

2021-06-17T20:50:03Z

Изменение категории

← Older revision		Revision as of 20:50, 17 June 2021
Line 28:		Line 28:
	* '''variant1''': Um [[int]] para o primeiro variante do veículo. Veja [[vehicle variants]].		* '''variant1''': Um [[int]] para o primeiro variante do veículo. Veja [[vehicle variants]].
	* '''variant2''': Um [[int]] para o segundo variante do veículo. Veja [[vehicle variants]].		* '''variant2''': Um [[int]] para o segundo variante do veículo. Veja [[vehicle variants]].
	}}		\|PT-BR}}

	===Retorna===		===Retorna===

LordHenry: linked other languages

2020-08-06T18:39:45Z

linked other languages

← Older revision		Revision as of 18:39, 6 August 2020
Line 186:		Line 186:

	==Veja também==		==Veja também==
			[[de:createVehicle]]
			[[pl:createVehicle]]
			[[ru:CreateVehicle]]
	[[en:CreateVehicle]]		[[en:CreateVehicle]]
	{{Vehicle functions}}		{{Vehicle functions}}

LordHenry at 18:32, 6 August 2020

2020-08-06T18:32:46Z

← Older revision		Revision as of 18:32, 6 August 2020
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{BR/Funcao compartilhada}}{{BR/Nota\|Os veículos (e outros elementos) criados em client-side são vistos somente pelo cliente que os criaram, não são sincronizados e os jogadores não podem entrar neles. Eles são essencialmente apenas para exibição.}}		{{BR/Funcao compartilhada}}
			{{BR/Nota\|Os veículos (e outros elementos) criados em client-side são vistos somente pelo cliente que os criaram, não são sincronizados e os jogadores não podem entrar neles. Eles são essencialmente apenas para exibição.}}
	Esta função cria um veículo em uma localização especificada.		Esta função cria um veículo em uma localização especificada.

LordHenry at 18:28, 6 August 2020

2020-08-06T18:28:38Z

← Older revision		Revision as of 18:28, 6 August 2020
Line 7:		Line 7:
	==Sintaxe==		==Sintaxe==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	vehicle createVehicle ( int ~~modelo~~, float x, float y, float z [, float rx, float ry, float rz, string numberplate, bool bDirection, int variant1, int variant2 ] )		vehicle createVehicle ( int model, float x, float y, float z [, float rx, float ry, float rz, string numberplate, bool bDirection, int variant1, int variant2 ] )
	</syntaxhighlight>		</syntaxhighlight>
	{{PT-BR/POO\|\|[[Vehicle]]\|\|}}		{{PT-BR/POO\|\|[[Vehicle]]\|\|}}

	===Argumentos necessários===		===Argumentos necessários===
	* '''~~modelo~~''': O [[IDs_de_veiculos\|ID]] do veículo que está sendo criado		* '''model''': O [[IDs_de_veiculos\|ID]] do veículo que está sendo criado
	* '''x''': Um número [[float]] representando a coordenada X do mapa		* '''x''': Um número [[float]] representando a coordenada X do mapa
	* '''y''': Um número [[float]] representando a coordenada Y do mapa		* '''y''': Um número [[float]] representando a coordenada Y do mapa

LordHenry: Link to original language

2020-08-06T17:50:03Z

Link to original language

← Older revision		Revision as of 17:50, 6 August 2020
Line 186:		Line 186:
	==Veja também==		==Veja também==

			[[en:CreateVehicle]]
	{{Vehicle functions}}		{{Vehicle functions}}

Sbx320: Sbx320 moved page CreateVehicle/PT-BR to PT-BR/CreateVehicle

2020-08-06T17:07:44Z

Sbx320 moved page CreateVehicle/PT-BR to PT-BR/CreateVehicle

← Older revision

Revision as of 17:07, 6 August 2020

Lettify: Correção do que a função pode retornar

2020-04-03T20:44:26Z

Correção do que a função pode retornar

← Older revision		Revision as of 20:44, 3 April 2020
Line 30:		Line 30:

	===Retorna===		===Retorna===
	Retorna o elemento [[Elemento/Vehicle]] que foi criado. Retorna ''false'' se os argumentos estão incorretos, ou se o limite de 65535 ~~do veículo~~ for excedido.		Retorna o elemento [[Elemento/Vehicle]] que foi criado. Retorna ''false'' se os argumentos estão incorretos, ou se o limite de 65535 veículos spawnados no mundo for excedido

	==Usando trens==		==Usando trens==

Lettify: Created page with "NOTOC {{BR/Funcao compartilhada}}{{BR/Nota|Os veículos (e outros elementos) criados em client-side são vistos somente pelo cliente que os criaram, não são sincronizado..."

2020-04-03T19:06:24Z

Created page with "__NOTOC__ {{BR/Funcao compartilhada}}{{BR/Nota|Os veículos (e outros elementos) criados em client-side são vistos somente pelo cliente que os criaram, não são sincronizado..."

New page

__NOTOC__
{{BR/Funcao compartilhada}}{{BR/Nota|Os veículos (e outros elementos) criados em client-side são vistos somente pelo cliente que os criaram, não são sincronizados e os jogadores não podem entrar neles. Eles são essencialmente apenas para exibição.}}
Esta função cria um veículo em uma localização especificada.

Vale notar que a posição do veículo é relativa ao ponto central do veículo, não sua base. Sendo assim, você precisa garantir que o valor z (eixo vertical) esteja a alguma altura acima do solo. Você pode achar a altura exata com a seguinte função client-side [[getElementDistanceFromCentreOfMassToBaseOfModel]], ou você mesmo pode fazer uma estimativa e gerar o veículo para que ele caia no chão.

==Sintaxe==
<syntaxhighlight lang="lua">
vehicle createVehicle ( int modelo, float x, float y, float z [, float rx, float ry, float rz, string numberplate, bool bDirection, int variant1, int variant2 ] )
</syntaxhighlight>
{{PT-BR/POO||[[Vehicle]]||}}

===Argumentos necessários===
* '''modelo''': O [[IDs_de_veiculos|ID]] do veículo que está sendo criado
* '''x''': Um número [[float]] representando a coordenada X do mapa
* '''y''': Um número [[float]] representando a coordenada Y do mapa
* '''z''': Um número [[float]] representando a coordenada Z do mapa

===Argumentos Opcionais===
{{BR/ArgOpcional}}
* '''rx''': Um número [[float]] representando a rotação em torno do eixo X em graus.
* '''ry''': Um número [[float]] representando a rotação em torno do eixo Y em graus.
* '''rz''': Um número [[float]] representando a rotação em torno do eixo Z em graus.
* '''numberplate''': Uma string que aparecerá na placa do veículo (máximo de 8 caracteres).
* '''bDirection''' ''(serverside only)'': Placeholder [[boolean]] que fornece compatibilidade com alguns scripts. Isso nunca teve nenhum efeito, mas é lido pelo código. Recomenda-se ignorar esse argumento, passando o argumento '' false '' ou '' variant1 '' em seu lugar.
{{New feature/item|3.0120|1.2||
* '''variant1''': Um [[int]] para o primeiro variante do veículo. Veja [[vehicle variants]].
* '''variant2''': Um [[int]] para o segundo variante do veículo. Veja [[vehicle variants]].
}}

===Retorna===
Retorna o elemento [[Elemento/Vehicle]] que foi criado. Retorna ''false'' se os argumentos estão incorretos, ou se o limite de 65535 do veículo for excedido.

==Usando trens==
Trens são criados usando a função desta página. Eles são colocados no ponto mais próximo do percurso do trem do GTA:SA (geralmente são trilhos de trem) a partir do ponto em que ele foi spawnado.

==Exemplo==

<section name="Example 1: Server" class="server" show="true">
Este exemplo cria um marker 'vehicle spawner' que dá ao jogador um veículo assim que ele atinge o marker.
<syntaxhighlight lang="lua">
local vehMark = createMarker(-2426.34106, -639.12714, 132.93631,"cylinder")

function vehicleSpawner(hitElement,matchingDimension)
if getElementType(hitElement) == "player" then
if getPedOccupiedVehicle(hitElement) == false then
local x,y,z = getElementPosition(hitElement)
local veh = createVehicle(551, x,y,z)
warpPedIntoVehicle(hitElement,veh)
end
end
end
addEventHandler("onMarkerHit",vehMark,vehicleSpawner)
</syntaxhighlight>
</section>

<section name="Example 2: Server" class="server" show="true">
Este exemplo cria um veículo a 5 unidades de distância do jogador quando ele digita ''createvehicle'' e seu nome no console:
<syntaxhighlight lang="lua">
local distance = 5 --units

-- define our handler (we'll take a variable number of parameters where the name goes, because there are vehicle names with more than one word)
function consoleCreateVehicle ( sourcePlayer, commandName, ... )
-- if a player triggered it, not the admin,
if ( sourcePlayer ) then
-- calculate the position of the vehicle based on the player's position and rotation:
local x, y, z = getElementPosition ( sourcePlayer ) -- get the player's position
local rotZ = getElementRotation ( sourcePlayer ) -- get the player's rotation around the Z axis in degrees
x = x + ( ( math.cos ( math.rad ( rotZ ) ) ) * distance ) -- calculate the X position of the vehicle
y = y + ( ( math.sin ( math.rad ( rotZ ) ) ) * distance ) -- calculate the Y position of the vehicle

-- get the complete vehicle name by joining all passed parameters using Lua function table.concat
local vehicleName = table.concat({...}, " ")
-- get the vehicle's model ID from the name
local vehicleID = getVehicleModelFromName ( vehicleName )
-- if vehicle ID is valid,
if vehicleID then
-- create the vehicle using the information gathered above:
local newVehicle = createVehicle ( vehicleID, x, y, z, 0, 0, rotZ )
-- if vehicle creation failed, give the player a message
if not newVehicle then
outputConsole ( "Failed to create vehicle.", sourcePlayer )
end
end
end
end

-- Attach the 'consoleCreateVehicle' function to the "createvehicle" command
addCommandHandler ( "createvehicle", consoleCreateVehicle )
</syntaxhighlight>
</section>

<section name="Example 3: Server" class="server" show="false">
Esse script gera um Rhino em cima de um indivíduo sortudo.
<syntaxhighlight lang="lua">
function scriptCreateTank ( player, command )
local luckyBugger = getRandomPlayer() -- get a random player
local x, y, z = getElementPosition ( luckyBugger ) -- retrive the player's position
createVehicle ( 432, x, y, z + 10 ) -- create the tank 10 units above them
outputChatBox ( "You got Tank'd!", luckyBugger )
end
--Attach the 'scriptCreateTank' function to the "tank" command
addCommandHandler ( "tank", scriptCreateTank )
</syntaxhighlight>
</section>

<section name="Example 4: Server" class="server" show="false">
Este exemplo adiciona o comando ''/spveh'' para spawnar um modelo de um carro nas coordenadas fornceidas. Se qualquer um dos carros criados por este comando explodir, ele será respawnado no lugar onde foi criado.
<syntaxhighlight lang="lua">
-- Do not allow the following IDs to be spawned
local forbiddenCars = { [435] = true, [441] = true, [449] = true, [450] = true, [464] = true, [465] = true, [501] = true,
[537] = true, [538] = true, [564] = true, [569] = true, [570] = true, [584] = true, [590] = true,
[591] = true, [594] = true, [606] = true, [607] = true, [608] = true, [610] = true, [611] = true }

local cmdVehRoot = createElement("commandVehicles") -- Dummy element containing the cars that this command has created
addCommandHandler("spveh",
function(player, cmd, modelID, x, y, z, platetext)
-- Check whether arguments are correct
local modelID, x, y, z = tonumber(modelID), tonumber(x), tonumber(y), tonumber(z)
if modelID and x and y and z then
-- Do not continue if we shouldn't
if forbiddenCars[modelID] then
outputChatBox("The car model you provided is not allowed.", player, 255, 0, 0)
return
end
local platetext = type(platetext) == "string" and platetext or "PRIVATE"
-- Create the actual vehicle and set it as a children of our dummy element
setElementParent(createVehicle(modelID, x, y, z, 0, 0, 0, platetext), cmdVehRoot)
-- Inform the player about what we did
outputChatBox("You have created a " .. getVehicleNameFromModel(modelID) .. " (model ID: " .. modelID .. ") at " .. table.concat({ x, y, z }, ", ") .. " with numberplate " .. platetext .. " successfully.", player, 0, 255, 0)
else
outputChatBox("Syntax: /" .. cmd .. " (modelID) (x) (y) (z) [numberplate]", player, 255, 255, 255)
end
end
)

-- If a vehicle that has been created using the command blows up, respawn it where it was created
addEventHandler("onVehicleExplode", cmdVehRoot,
function()
respawnVehicle(source)
end
)
</syntaxhighlight>
</section>

<section name="Example 5: Client" class="client" show="true">
Este script spawna um tanque em cima do jogador local.
<syntaxhighlight lang="lua">
function scriptCreateTank ( commandName )
local luckyBugger = getLocalPlayer() -- get the local player
local x, y, z = getElementPosition ( luckyBugger ) -- retrive the player's position
createVehicle ( 432, x, y, z + 10 ) -- create the tank 10 units above them
outputChatBox ( "You got Tank'd!", 255, 0, 0)
end
--Attach the 'scriptCreateTank' function to the "tank" command
addCommandHandler ( "tank", scriptCreateTank )
</syntaxhighlight>
</section>

{{New items|4.0132|1.4|
Este é um exemplo de como essa função é usada em OOP(POO - Programação Orientada a Objeto)
<section name="OOP server" class="server" show="true">
This script will create an Infernus at the center (0, 0, 3) of San Andreas upon execution.
<syntaxhighlight lang="lua">
addEventHandler( "onResourceStart", resourceRoot,
function()
infernus = Vehicle(411, Vector3(0, 0, 3)); -- Create an Infernus and spawn it at the middle of SA.
infernus:setColor(0, 0, 0); -- Set its color to black.
infernus.damageProof = true; -- Make it damage proof
end
)

addCommandHandler( "blowinfernus",
function(p)
if not infernus.blown then -- Check if the Infernus is blown up or not.
infernus:blow();
else -- Ouch, it's blown up, let's output an error to the player.
outputChatBox( "The Infernus has already been blown up by you.", p, 255, 0, 0, false );
end
end)
</syntaxhighlight>
</section>
}}

==Veja também==

{{Vehicle functions}}