AutoAttach - Revision history

IManGaaX at 10:45, 29 October 2023

2023-10-29T10:45:08Z

← Older revision		Revision as of 10:45, 29 October 2023
Line 60:		Line 60:
	'''Author:''' [[User:LordHenry\|LordHenry]]		'''Author:''' [[User:LordHenry\|LordHenry]]

	==~~Examples~~==		==Example==
	This example attach a vehicle into another at the same position it is when the player uses the command /attach.<br>		This example attach a vehicle into another at the same position it is when the player uses the command /attach.<br>
	It also detach the vehicle if the command is used again.<br>		It also detach the vehicle if the command is used again.<br>
	This example creates a Packer (443) and a FCR-900 (521) at the center of the map. You need to be there to interact with them.		This example creates a Packer (443) and a FCR-900 (521) at the center of the map. You need to be there to interact with them.
	<section name="~~Example1~~" class="server" show="true">		<section name="Server" class="server" show="true">
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	theTruck = createVehicle (443, 0, 0, 4)		theTruck = createVehicle (443, 0, 0, 4)

IManGaaX at 10:44, 29 October 2023

2023-10-29T10:44:36Z

← Older revision		Revision as of 10:44, 29 October 2023
Line 61:		Line 61:

	==Examples==		==Examples==
	~~<section name="Example1" class="server" show="true">~~
	This example attach a vehicle into another at the same position it is when the player uses the command /attach.<br>		This example attach a vehicle into another at the same position it is when the player uses the command /attach.<br>
	It also detach the vehicle if the command is used again.<br>		It also detach the vehicle if the command is used again.<br>
	This example creates a Packer (443) and a FCR-900 (521) at the center of the map. You need to be there to interact with them.		This example creates a Packer (443) and a FCR-900 (521) at the center of the map. You need to be there to interact with them.
			<section name="Example1" class="server" show="true">
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	theTruck = createVehicle (443, 0, 0, 4)		theTruck = createVehicle (443, 0, 0, 4)

LordHenry: /* Examples */

2023-03-03T05:32:48Z

Examples

← Older revision		Revision as of 05:32, 3 March 2023
Line 81:		Line 81:
	</syntaxhighlight>		</syntaxhighlight>
	</section>		</section>
	Author: LordHenry		Author: [[User:LordHenry\|LordHenry]]

	==See Also==		==See Also==
	{{Useful_Functions}}		{{Useful_Functions}}

LordHenry: /* Code */

2023-03-03T05:32:32Z

Code

← Older revision		Revision as of 05:32, 3 March 2023
Line 58:		Line 58:
	</syntaxhighlight>		</syntaxhighlight>
	</section>		</section>
	'''Author:''' LordHenry		'''Author:''' [[User:LordHenry\|LordHenry]]

	==Examples==		==Examples==

LordHenry: /* Syntax */

2022-01-21T22:50:53Z

Syntax

← Older revision		Revision as of 22:50, 21 January 2022
Line 5:		Line 5:

	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">bool autoAttach ( element theElement, element theAttachToElement)</syntaxhighlight>		<syntaxhighlight lang="lua">bool autoAttach (element theElement, element theAttachToElement)</syntaxhighlight>

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

LordHenry: /* Examples */

2022-01-21T22:18:59Z

Examples

← Older revision		Revision as of 22:18, 21 January 2022
Line 70:		Line 70:

	addCommandHandler ("attach", function (thePlayer, cmd)		addCommandHandler ("attach", function (thePlayer, cmd)
	state = not state		state = not state
	if (state) then		if (state) then
	autoAttach (theVehicle, theTruck)		autoAttach (theVehicle, theTruck)

LordHenry: Created page with "{{Useful Function}} NOTOC This function attach an element into another by calculating the rotation and position offset automatically. It works exactly like attachElements but you don't need to provide offset parameters. ==Syntax== bool autoAttach ( element theElement, element theAttachToElement) ===Required Arguments=== '''theElement:''' The element to be attached. '''theAttachToElement:''' The..."

2022-01-21T22:16:00Z

Created page with "{{Useful Function}} <lowercasetitle/> __NOTOC__ This function attach an element into another by calculating the rotation and position offset automatically. It works exactly like attachElements but you don't need to provide offset parameters. ==Syntax== <syntaxhighlight lang="lua">bool autoAttach ( element theElement, element theAttachToElement)</syntaxhighlight> ===Required Arguments=== *'''theElement:''' The element to be attached. *'''theAttachToElement:''' The..."

New page

{{Useful Function}}
<lowercasetitle/>
__NOTOC__
This function attach an element into another by calculating the rotation and position offset automatically. It works exactly like [[attachElements]] but you don't need to provide offset parameters.

==Syntax==
<syntaxhighlight lang="lua">bool autoAttach ( element theElement, element theAttachToElement)</syntaxhighlight>

===Required Arguments===
*'''theElement:''' The element to be attached.
*'''theAttachToElement:''' The element to attach the first to.

===Returns===
Returns ''true'' if the attaching process was successful, ''false'' otherwise.

==Code==
<section name="Shared" class="both" show="true">
<syntaxhighlight lang="lua">
function autoAttach (theElement, theAttachToElement)
if (theElement and theAttachToElement) then
local mat = getElementMatrix (theAttachToElement)
local vec = Vector3 (getElementPosition(theElement))
local tx, ty, tz = getElementRotation (theAttachToElement)
local vx, vy, vz = getElementRotation (theElement)
local rotX, rotY, rotZ = 0, 0, 0
if (tx < vx) then
rotX = math.abs(tx - vx)
elseif (tx > vx) then
rotX = vx - tx
end
if (ty < vy) then
rotY = math.abs(ty - vy)
elseif (ty > vy) then
rotY = vy - ty
end
if (tz < vz) then
rotZ = math.abs(tz - vz)
elseif (tz > vz) then
rotZ = vz - tz
end

mat[1][4] = 0
mat[2][4] = 0
mat[3][4] = 0
mat[4][4] = 1
mat = matrix.invert (mat)

local offX = vec.x * mat[1][1] + vec.y * mat[2][1] + vec.z * mat[3][1] + mat[4][1]
local offY = vec.x * mat[1][2] + vec.y * mat[2][2] + vec.z * mat[3][2] + mat[4][2]
local offZ = vec.x * mat[1][3] + vec.y * mat[2][3] + vec.z * mat[3][3] + mat[4][3]

if (attachElements (theElement, theAttachToElement, offX, offY, offZ, rotX, rotY, rotZ)) then
return true
end
end
return false
end
</syntaxhighlight>
</section>
'''Author:''' LordHenry

==Examples==
<section name="Example1" class="server" show="true">
This example attach a vehicle into another at the same position it is when the player uses the command /attach.<br>
It also detach the vehicle if the command is used again.<br>
This example creates a Packer (443) and a FCR-900 (521) at the center of the map. You need to be there to interact with them.
<syntaxhighlight lang="lua">
theTruck = createVehicle (443, 0, 0, 4)
theVehicle = createVehicle (521, 0, 0, 7)

addCommandHandler ("attach", function (thePlayer, cmd)
state = not state
if (state) then
autoAttach (theVehicle, theTruck)
outputChatBox ("Bike attached to the truck", thePlayer, 0, 255, 0)
else
detachElements (theVehicle, theTruck)
outputChatBox ("Bike detached from the truck", thePlayer, 255, 0, 0)
end
end)
</syntaxhighlight>
</section>
Author: LordHenry

==See Also==
{{Useful_Functions}}