Player::putIntoVehicle - Revision history

Shr0x at 11:59, 28 April 2024

2024-04-28T11:59:57Z

← Older revision		Revision as of 11:59, 28 April 2024
Line 4:		Line 4:

	'''The vehicle must be streamed-in for this method to work as intended.'''		'''The vehicle must be streamed-in for this method to work as intended.'''

			For client side head to [[https://wiki.rage.mp/index.php?title=Player::setIntoVehicle Player::setIntoVehicle]]
	== Syntax ==		== Syntax ==
	<pre>		<pre>

Shr0x at 11:56, 28 April 2024

2024-04-28T11:56:23Z

← Older revision		Revision as of 11:56, 28 April 2024
Line 54:		Line 54:

	if (!vehicle \|\| !mp.vehicles.exists(vehicle)) return;		if (!vehicle \|\| !mp.vehicles.exists(vehicle)) return;
	if (!vehicle.~~onVehicleStreamIn~~ \|\| typeof vehicle.~~onVehicleStreamIn~~ === 'undefined') return;		if (!vehicle.onStreamIn \|\| typeof vehicle.onStreamIn === 'undefined') return;
	vehicle.~~onVehicleStreamIn~~.constructor.name === 'AsyncFunction' ? await vehicle.onStreamIn(vehicle) : vehicle.onStreamIn(vehicle);		vehicle.onStreamIn.constructor.name === 'AsyncFunction' ? await vehicle.onStreamIn(vehicle) : vehicle.onStreamIn(vehicle);
	});		});

Shr0x at 11:55, 28 April 2024

2024-04-28T11:55:58Z

← Older revision		Revision as of 11:55, 28 April 2024
Line 50:		Line 50:

	//Adding a event which will be called from client when the vehicle streams in		//Adding a event which will be called from client when the vehicle streams in
	mp.events.add('server::vehicleStreamIn', async (player~~: PlayerMp~~, remoteid~~: number~~) => {		mp.events.add('server::vehicleStreamIn', async (player, remoteid) => {
	const vehicle = mp.vehicles.at(remoteid);		const vehicle = mp.vehicles.at(remoteid);

Shr0x: Added a quick snippet & notes

2024-04-28T11:54:58Z

Added a quick snippet & notes

← Older revision		Revision as of 11:54, 28 April 2024
Line 1:		Line 1:
	This ~~function~~ puts player into vehicle.		{{ServersideJsFunction}}
			{{JSContainer\|
			This method puts player into vehicle.

			'''The vehicle must be streamed-in for this method to work as intended.'''
	== Syntax ==		== Syntax ==
	<pre>		<pre>
	player.putIntoVehicle(~~Vehicle~~ vehicle, ~~Number~~ seat)		player.putIntoVehicle(vehicle, seat)
	</pre>		</pre>

	Seats:		Seats:
	* -1 - driver seat
	* 0 - passenger seat 1
	* 1 - passenger seat 2
	* 2 - passenger seat 3

	~~In version >1.0 Seats:~~
	* 0 - driver seat		* 0 - driver seat
	* 1 - passenger seat 1		* 1 - passenger seat 1
Line 16:		Line 15:
	* 3 - passenger seat 3		* 3 - passenger seat 3

	~~'''NOTE''': You can't~~ put player in vehicle ~~immediately after creating~~ vehicle, ~~use timeout~~ (~~200 ms~~ will be ~~fine~~)		==Example==
			<syntaxhighlight lang="javascript">
			//Server side

			mp.events.addCommand("spawncar", (player, _, model = "sultanrs") => {
			const position = player.position;
			const vehicle = mp.vehicles.new(mp.joaat(model), position); //Creating the vehicle
			player.putIntoVehicle(vehicle, 0); //we put the player into the vehicle as soon as the vehicle is streamed in.

			})

			</syntaxhighlight>
			==Quick Snippet==
			Making a custom vehicle stream in handler for server side.
			<syntaxhighlight lang="typescript">
			//Server side

			mp.events.addCommand("spawncar", (player, _) => {
			const position = new mp.Vector3(573.07, -352.55, 43.21); //A random position to spawn the vehicle at

			const vehicle = mp.vehicles.new(mp.joaat("sultanrs"), position); //Creating the vehicle

			//Adding a custom method to the vehicle which will handle the stream in (will be called from the client).
			vehicle.onStreamIn = (veh) => { //supports async as well

			if (!player \|\| !mp.players.exists(player)) return; //if the player is no longer available when this method is called we return here.

			player.putIntoVehicle(veh, 0); //we put the player into the vehicle as soon as the vehicle is streamed in.
			}

	=~~=Examples==~~		player.position = vehicle.position; //setting player position to the vehicle position
	~~{{ServersideCode\|~~
	~~<pre>~~		})
	// ~~0.3.7~~
	mp.events.~~addCommand~~('~~veh~~', (player, ~~vehicle = "T20"~~) => {		//Adding a event which will be called from client when the vehicle streams in
	const ~~veh~~ = mp.vehicles.~~new~~(mp.~~joaat~~(vehicle)~~, player~~.~~position, {~~		mp.events.add('server::vehicleStreamIn', async (player: PlayerMp, remoteid: number) => {
	~~dimension: player~~.~~dimension~~		const vehicle = mp.vehicles.at(remoteid);
	});
	~~player~~.~~putIntoVehicle~~(~~veh, -1~~);		if (!vehicle \|\| !mp.vehicles.exists(vehicle)) return;
			if (!vehicle.onVehicleStreamIn \|\| typeof vehicle.onVehicleStreamIn === 'undefined') return;
			vehicle.onVehicleStreamIn.constructor.name === 'AsyncFunction' ? await vehicle.onStreamIn(vehicle) : vehicle.onStreamIn(vehicle);
	});		});

	// ~~1.0 +~~		</syntaxhighlight>
	mp.events.~~addCommand~~('~~veh~~', (~~player, vehicle = "T20"~~) => {
	~~const veh = mp.vehicles.new~~(mp.~~joaat(~~vehicle)~~, player.position,~~ {
	~~dimension: player~~.~~dimension~~		<syntaxhighlight lang="javascript">
	~~});~~		//Client side
	~~player~~.~~putIntoVehicle~~(~~veh~~, 0);		mp.events.add('entityStreamIn', (entity) => {
			if (entity.type === 'vehicle') {
			mp.events.callRemote('server::vehicleStreamIn', entity.remoteId);
			}
	});		});
	</~~pre~~>		</syntaxhighlight>

	}}		}}

	==See Also==		==See Also==
	{{Player_block}}		{{Player_block}}

Rerorero: Information about timeout

2021-01-03T22:04:39Z

Information about timeout

← Older revision		Revision as of 22:04, 3 January 2021
Line 15:		Line 15:
	* 2 - passenger seat 2		* 2 - passenger seat 2
	* 3 - passenger seat 3		* 3 - passenger seat 3

			'''NOTE''': You can't put player in vehicle immediately after creating vehicle, use timeout (200 ms will be fine)

	==Examples==		==Examples==

Impnumb at 18:19, 3 July 2020

2020-07-03T18:19:00Z

← Older revision		Revision as of 18:19, 3 July 2020
Line 10:		Line 10:
	* 2 - passenger seat 3		* 2 - passenger seat 3

	In >1.0 Seats:		In version >1.0 Seats:
	* 0 - driver seat		* 0 - driver seat
	* 1 - passenger seat 1		* 1 - passenger seat 1

Nenoxc: /* Examples */

2020-06-12T00:46:55Z

Examples

← Older revision		Revision as of 00:46, 12 June 2020
Line 19:		Line 19:
	{{ServersideCode\|		{{ServersideCode\|
	<pre>		<pre>
	mp.events.addCommand('veh', (player~~: MpPlayer~~, ~~text: string~~) => {		// 0.3.7
	~~if (text == undefined) {~~		mp.events.addCommand('veh', (player, vehicle = "T20") => {
	~~let~~ veh = mp.vehicles.new(mp.joaat(~~'T20'~~), player.position);		const veh = mp.vehicles.new(mp.joaat(vehicle), player.position, {
	player.putIntoVehicle(veh, -1);		dimension: player.dimension
	} ~~else~~ {		});
	~~let~~ veh = mp.vehicles.new(mp.joaat(~~text~~), player.position);		player.putIntoVehicle(veh, -1);
	player.putIntoVehicle(veh, -1);		});
	}
			// 1.0 +
			mp.events.addCommand('veh', (player, vehicle = "T20") => {
			const veh = mp.vehicles.new(mp.joaat(vehicle), player.position, {
			dimension: player.dimension
			});
			player.putIntoVehicle(veh, 0);
	});		});
	</pre>		</pre>

YnnhoJ at 19:29, 20 February 2020

2020-02-20T19:29:22Z

← Older revision		Revision as of 19:29, 20 February 2020
Line 9:		Line 9:
	* 1 - passenger seat 2		* 1 - passenger seat 2
	* 2 - passenger seat 3		* 2 - passenger seat 3

			In >1.0 Seats:
			* 0 - driver seat
			* 1 - passenger seat 1
			* 2 - passenger seat 2
			* 3 - passenger seat 3

	==Examples==		==Examples==

Rootcause: Replaced HTML with template

2018-10-26T11:36:36Z

Replaced HTML with template

← Older revision		Revision as of 11:36, 26 October 2018
Line 1:		Line 1:
	This function puts player into vehicle.		This function puts player into vehicle.
	== Syntax ==		== Syntax ==
	<~~syntaxhighlight lang="javascript"~~>		<pre>
	player.putIntoVehicle(Vehicle vehicle, Number seat)		player.putIntoVehicle(Vehicle vehicle, Number seat)
	</~~syntaxhighlight~~>		</pre>
	Seats:		Seats:
	* -1 - driver seat		* -1 - driver seat
Line 11:		Line 11:

	==Examples==		==Examples==
	~~<div class="header" style="background-color: #408DAE; color: #FFFFFF; border: 2px solid #408DAE;">~~		{{ServersideCode\|
	~~<div style="margin: 10px 10px 10px 10px;"><b>Server-Side</b></div>~~		<pre>
	<~~syntaxhighlight lang="javascript"~~>
	mp.events.addCommand('veh', (player: MpPlayer, text: string) => {		mp.events.addCommand('veh', (player: MpPlayer, text: string) => {
	if (text == undefined) {		if (text == undefined) {
Line 23:		Line 22:
	}		}
	});		});
	</~~syntaxhighlight~~>		</pre>
	~~</div>~~		}}

	==See Also==		==See Also==
	{{Player_block}}		{{Player_block}}

Shyim at 14:55, 14 January 2018

2018-01-14T14:55:12Z

@@ Line 9: / Line 9: @@
 * 1 - passenger seat 2
 * 2 - passenger seat 3
 ==See Also==
 {{Player_block}}