SetElementModel - Revision history

EOFIK: Edited language change

2022-06-06T17:36:23Z

Edited language change

← Older revision		Revision as of 17:36, 6 June 2022
Line 98:		Line 98:
	==See Also==		==See Also==
	{{Element functions}}		{{Element functions}}

			[[ru:setElementModel]]

Dutchman101: t

2020-03-14T22:43:50Z

← Older revision		Revision as of 22:43, 14 March 2020
Line 22:		Line 22:
	==Example==		==Example==
	<section class="server" name="Example 1 (Server)" show="true">		<section class="server" name="Example 1 (Server)" show="true">
	This example ~~lets~~ players change their own skin with a command (/skin [ID])		This example allows players to change their own skin with a command (/skin [ID])
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	local spam = {}		local spam = {}

Dutchman101: Improve example 2

2020-03-14T22:41:46Z

Improve example 2

← Older revision		Revision as of 22:41, 14 March 2020
Line 60:		Line 60:

	function changeMyVehicle(player, command, newModel)		function changeMyVehicle(player, command, newModel)
	if spam[player] then		if spam[player] and getTickCount() - spam[player] < 2500 then
	return outputChatBox("Don't spam vehicle changes!", player, 255, 0, 0)		return outputChatBox("Don't spam vehicle changes!", player, 255, 0, 0)
	end		end

	local theVehicle = getPedOccupiedVehicle(player)		local theVehicle = getPedOccupiedVehicle(player)

			if not (theVehicle and getVehicleController(theVehicle) == player) then
			return outputChatBox("You must be driving a vehicle in order to change it!", player, 255, 0, 0)
			end

	if isValidModel(newModel) and isElement(theVehicle) then		if isValidModel(newModel) and isElement(theVehicle) then
	setElementModel(theVehicle, newModel)		setElementModel(theVehicle, newModel)
	spam[player] = ~~setTimer~~(~~function() spam[player] = nil end, 2500, 1~~)		spam[player] = getTickCount()
	else		else
	outputChatBox("Invalid vehicle ID!", player, 255, 0, 0)		outputChatBox("Invalid vehicle ID!", player, 255, 0, 0)
Line 82:		Line 86:
	return false		return false
	end		end

			function cleanUp()
			if spam[source] then
			spam[source] = nil
			end
			end
			addEventHandler("onPlayerQuit", root, cleanUp)
	</syntaxhighlight>		</syntaxhighlight>
	</section>		</section>

Dutchman101: Improved example 1

2020-03-14T22:24:28Z

Improved example 1

← Older revision		Revision as of 22:24, 14 March 2020
Line 27:		Line 27:

	function setSkin(player, cmd, skin)		function setSkin(player, cmd, skin)
	if spam[player] then		if spam[player] and getTickCount() - spam[player] < 4000 then
	return outputChatBox("You cannot change skin that often!", player, 255, 0, 0~~, false~~)		return outputChatBox("You cannot change skin that often!", player, 255, 0, 0)
	end		end

	~~if getElementModel(player) =~~= skin ~~or isPedDead~~(~~player~~) ~~then return end~~		skin = skin and tonumber(skin)

	~~skin~~ = skin ~~and tonumber~~(~~skin~~)		if getElementModel(player) == skin or isPedDead(player) then
	if skin and ~~string.len(~~skin) <= 4 then		return
	setElementModel(player, skin)		end
	spam[player] = ~~setTimer~~(~~function() spam[player] = nil end, 4000, 1~~)
	else		if skin and skin <= 99999 then -- what do we know about dynamic ped ID range?
	outputChatBox("Invalid skin ID!", player, 255, 0, 0)		setElementModel(player, skin)
	end		spam[player] = getTickCount()
			else
			outputChatBox("Invalid skin ID!", player, 255, 0, 0)
			end
	end		end
	addCommandHandler("skin", setSkin)		addCommandHandler("skin", setSkin)

			function cleanUp()
			if spam[source] then
			spam[source] = nil
			end
			end
			addEventHandler("onPlayerQuit", root, cleanUp)
	</syntaxhighlight>		</syntaxhighlight>
	</section>		</section>

Dutchman101: improved script examples

2020-03-14T19:19:29Z

improved script examples

← Older revision		Revision as of 19:19, 14 March 2020
Line 22:		Line 22:
	==Example==		==Example==
	<section class="server" name="Example 1 (Server)" show="true">		<section class="server" name="Example 1 (Server)" show="true">
			This example lets players change their own skin with a command (/skin [ID])
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	~~addCommandHandler~~ ( "~~changeveh~~",		local spam = {}
	~~function ( thePlayer~~, ~~command~~, ~~newModel~~ )
	~~local theVehicle~~ = ~~getPedOccupiedVehicle~~ ( ~~thePlayer~~ ) ~~-- get the vehicle the player is in~~		function setSkin(player, cmd, skin)
	~~newModel~~ = tonumber ( ~~newModel~~ ) ~~-- try to convert the string argument to a number~~		if spam[player] then
	if ~~theVehicle~~ and ~~newModel~~ then ~~-- make sure the~~ player ~~is in a vehicle and specified a number~~		return outputChatBox("You cannot change skin that often!", player, 255, 0, 0, false)
	~~setElementModel~~ ( ~~theVehicle~~, ~~newModel~~ )		end
	end
	end		if getElementModel(player) == skin or isPedDead(player) then return end
	)
			skin = skin and tonumber(skin)
			if skin and string.len(skin) <= 4 then
			setElementModel(player, skin)
			spam[player] = setTimer(function() spam[player] = nil end, 4000, 1)
			else
			outputChatBox("Invalid skin ID!", player, 255, 0, 0)
			end
			end
			addCommandHandler("skin", setSkin)
	</syntaxhighlight>		</syntaxhighlight>
	~~After the above code is executed, a player can get in any vehicle and execute e.g. the command "/changeveh 520" to change it into a hydra.~~
	</section>		</section>
	<section class="server" name="Example 2 (Server)" show="true">		<section class="server" name="Example 2 (Server)" show="true">
	This ~~will continually change an object~~ model ~~every 2.5 seconds at the location -1084.52, -1634.81, 76.36 (Truth's farm)~~.		This example allows players to transform their current vehicle into another vehicle model.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	~~myobject~~ = ~~createObject ( 5822, -1084.52, -1634.81, 76.36 )~~		local spam = {}
	~~-- We create an initial object element. I choose object model 5822 to begin with.~~

	function ~~objectRandomization~~ ()		function changeMyVehicle(player, command, newModel)
	local ~~randomobjectnumber~~ = ~~math.random~~(1, ~~18000~~)		if spam[player] then
	~~-- Choose a random number between~~ 1 ~~and 18000 as a whole integer and assign it to~~		return outputChatBox("Don't spam vehicle changes!", player, 255, 0, 0)
	~~-- the variable 'randomobjectnumber'~~		end
	~~setElementModel~~ ( ~~myobject~~, ~~randomobjectnumber~~ )
	~~-- Change our object appearance by applying a new model ID~~		local theVehicle = getPedOccupiedVehicle(player)

			if isValidModel(newModel) and isElement(theVehicle) then
			setElementModel(theVehicle, newModel)
			spam[player] = setTimer(function() spam[player] = nil end, 2500, 1)
			else
			outputChatBox("Invalid vehicle ID!", player, 255, 0, 0)
			end
	end		end
			addCommandHandler("changeveh", changeMyVehicle)

	~~setTimer~~ ( ~~objectRandomization, 2500, 0~~ )		function isValidModel(modelID)
	~~-- Every 2.5 seconds, the function 'objectRandomization' is called by this timer.~~		modelID = tonumber(modelID)
	~~-- Each time the function runs, it changes the object model by applying a new whole-~~		if modelID and modelID >= 400 and modelID <= 611 then
	~~-- integer random object ID. This timer is called an infinite amount of times since~~		return true
	~~-- its repeat value is set to 0.~~		end
			return false
			end
	</syntaxhighlight>		</syntaxhighlight>
	</section>		</section>

Emiliano Castro at 00:26, 23 September 2015

2015-09-23T00:26:29Z

← Older revision		Revision as of 00:26, 23 September 2015
Line 8:		Line 8:
	bool setElementModel ( element theElement, int model )		bool setElementModel ( element theElement, int model )
	</syntaxhighlight>		</syntaxhighlight>
	{{OOP\|\|[[element]]:setModel\|model\|}}		{{OOP\|\|[[element]]:setModel\|model\|getElementModel}}

	===Required Arguments===		===Required Arguments===

Qaisjp: fix oop syntax

2015-01-01T18:36:29Z

fix oop syntax

← Older revision		Revision as of 18:36, 1 January 2015
Line 8:		Line 8:
	bool setElementModel ( element theElement, int model )		bool setElementModel ( element theElement, int model )
	</syntaxhighlight>		</syntaxhighlight>
	{{OOP\|~~This function is also a static function underneath the Element class.~~\|[[element]]:setModel\|model\|}}		{{OOP\|\|[[element]]:setModel\|model\|}}

	===Required Arguments===		===Required Arguments===

Jaysds: /* Syntax */ OOP

2014-08-16T16:42:22Z

Syntax: OOP

← Older revision		Revision as of 16:42, 16 August 2014
Line 8:		Line 8:
	bool setElementModel ( element theElement, int model )		bool setElementModel ( element theElement, int model )
	</syntaxhighlight>		</syntaxhighlight>
			{{OOP\|This function is also a static function underneath the Element class.\|[[element]]:setModel\|model\|}}

	===Required Arguments===		===Required Arguments===

Lopez at 11:49, 26 July 2014

2014-07-26T11:49:44Z

← Older revision		Revision as of 11:49, 26 July 2014
Line 14:		Line 14:
	** For players/peds: A GTASA player model (skin) ID. See [[Character Skins]].		** For players/peds: A GTASA player model (skin) ID. See [[Character Skins]].
	** For vehicles: The [[Vehicle IDs\|vehicle ID]] of the vehicle being changed.		** For vehicles: The [[Vehicle IDs\|vehicle ID]] of the vehicle being changed.
	** For objects: An [[int]] specifying the model id.		** For objects/projectiles/weapons: An [[int]] specifying the model id.

	===Returns===		===Returns===

LordAzamath: Added specification to model variable

2009-06-29T11:52:00Z

Added specification to model variable

← Older revision		Revision as of 11:52, 29 June 2009
Line 12:		Line 12:
	*'''theElement:''' the element you want to change.		*'''theElement:''' the element you want to change.
	*'''model:''' the model ID to set.		*'''model:''' the model ID to set.
			** For players/peds: A GTASA player model (skin) ID. See [[Character Skins]].
			** For vehicles: The [[Vehicle IDs\|vehicle ID]] of the vehicle being changed.
			** For objects: An [[int]] specifying the model id.

	===Returns===		===Returns===