EntityClient

attachEntityToEntityPhysically

ATTACH_ENTITY_TO_ENTITY_PHYSICALLY0xC3675780C92F90F9

The GTA V native ATTACH_ENTITY_TO_ENTITY_PHYSICALLY of the ENTITY namespace, as LS:MP client scripts call it: the global function attachEntityToEntityPhysically, in JavaScript and in Lua.

SignatureJavaScript
attachEntityToEntityPhysically(
  entity1: Entity,
  entity2: Entity,
  boneIndex1: number,
  boneIndex2: number,
  xPos1: number,
  yPos1: number,
  zPos1: number,
  xPos2: number,
  yPos2: number,
  zPos2: number,
  xRot: number,
  yRot: number,
  zRot: number,
  breakForce: number,
  fixedRot: boolean,
  p15: boolean,
  collision: boolean,
  p17: boolean,
  p18: number
): void
SignatureLua
attachEntityToEntityPhysically(
  entity1: Entity,
  entity2: Entity,
  boneIndex1: integer,
  boneIndex2: integer,
  xPos1: number,
  yPos1: number,
  zPos1: number,
  xPos2: number,
  yPos2: number,
  zPos2: number,
  xRot: number,
  yRot: number,
  zRot: number,
  breakForce: number,
  fixedRot: boolean,
  p15: boolean,
  collision: boolean,
  p17: boolean,
  p18: integer
)

Usage

JavaScript
attachEntityToEntityPhysically(
  entity1, entity2, boneIndex1, boneIndex2, xPos1, yPos1, zPos1, xPos2, yPos2, zPos2, xRot,
  yRot, zRot, breakForce, fixedRot, p15, collision, p17, p18
);
Lua
attachEntityToEntityPhysically(
    entity1, entity2, boneIndex1, boneIndex2, xPos1, yPos1, zPos1, xPos2, yPos2, zPos2, xRot,
    yRot, zRot, breakForce, fixedRot, p15, collision, p17, p18
)

Three consecutive numbers can be given as one vector: { x, y, z } (or [x, y, z]) in JavaScript, a Vector3 in Lua.

JavaScript · with vectors
attachEntityToEntityPhysically(
  entity1, entity2, boneIndex1, boneIndex2, pos1, pos2, rot, breakForce, fixedRot, p15,
  collision, p17, p18
);
Lua · with vectors
attachEntityToEntityPhysically(
    entity1, entity2, boneIndex1, boneIndex2, pos1, pos2, rot, breakForce, fixedRot, p15,
    collision, p17, p18
)

Parameters

ParameterTypeJavaScriptLua
entity1Entitynumberinteger
entity2Entitynumberinteger
boneIndex1intnumberinteger
boneIndex2intnumberinteger
xPos1floatnumbernumber
yPos1floatnumbernumber
zPos1floatnumbernumber
xPos2floatnumbernumber
yPos2floatnumbernumber
zPos2floatnumbernumber
xRotfloatnumbernumber
yRotfloatnumbernumber
zRotfloatnumbernumber
breakForcefloatnumbernumber
fixedRotBOOLbooleanboolean
p15BOOLbooleanboolean
collisionBOOLbooleanboolean
p17BOOLbooleanboolean
p18intnumberinteger

Returns

Nothing. In JavaScript the call evaluates to undefined.

Notes

From the community native database. Names are LS:MP’s; samples may be written for C++ or another framework.

breakForce is the amount of force required to break the bond.
p14 - is always 1 in scripts
p15 - is 1 or 0 in scripts - unknoun what it does
p16 - controls collision between the two entities (FALSE disables collision).
p17 - do not teleport entity to be attached to the position of the bone Index of the target entity (if 1, entity will not be teleported to target bone)
p18 - is always 2 in scripts.

Reference

Namespace
Entity ENTITY
In the game
void ATTACH_ENTITY_TO_ENTITY_PHYSICALLY(Entity entity1, Entity entity2, int boneIndex1, int boneIndex2, float xPos1, float yPos1, float zPos1, float xPos2, float yPos2, float zPos2, float xRot, float yRot, float zRot, float breakForce, BOOL fixedRot, BOOL p15, BOOL collision, BOOL p17, int p18)
Hash
0xC3675780C92F90F9

Open in the interactive natives reference