Entity::setHealth

Sets entity health to a specified value.

• Player: For some reason health is calculated relying on 100 + actual player health. Setting value to 100 will result in player having 0 health but not dead, values <100 will kill the player.
• Vehicle: Setting health of a vehicle doesn't seem to have any technical results, vehicle will not be destroyed at 0 mark even after any damage.

Syntax

entity.setHealth(health);

Required Arguments

• health: int

Return value

• Undefined

Example

mp.players.local.setHealth(150); // Setting player health to 50
mp.players.local.setHealth(200); // Setting player health to 100

See also

• Properties
  • Entity::id
  • Entity::type
  • Entity::remoteId
  • Entity::handle
  • Entity::alpha
  • Entity::data
  • Entity::dimension
  • Entity::model
  • Entity::position
  • Entity::rotation

• Functions
  • Entity::applyForceTo
  • Entity::applyForceToCenterOfMass
  • Entity::attachTo
  • Entity::attachToPhysically
  • Entity::clearLastDamage
  • Entity::destroy
  • Entity::detach
  • Entity::dist
  • Entity::distSquared
  • Entity::doesBelongToThisScript
  • Entity::doesExist
  • Entity::doesHaveDrawable
  • Entity::doesHavePhysics
  • Entity::forceAiAndAnimationUpdate
  • Entity::forceStreamingUpdate
  • Entity::freezePosition
  • Entity::getAlpha
  • Entity::getAnimCurrentTime
  • Entity::getAnimTotalTime
  • Entity::getAttachedTo
  • Entity::getBoneIndexByName
  • Entity::getCollisionNormalOfLastHitFor
  • Entity::getCoords
  • Entity::getForwardVector
  • Entity::getForwardX
  • Entity::getForwardY
  • Entity::getHeading
  • Entity::getHealth
  • Entity::getHeight
  • Entity::getHeightAboveGround
  • Entity::getLastMaterialHitBy
  • Entity::getLodDist
  • Entity::getMatrix
  • Entity::getMaxHealth
  • Entity::getModel
  • Entity::getNearestPlayerTo
  • Entity::getNearestPlayerToOnTeam
  • Entity::getObjectIndexFromIndex
  • Entity::getOffsetFromGivenWorldCoords
  • Entity::getOffsetFromInWorldCoords
  • Entity::getPedIndexFromIndex
  • Entity::getPhysicsHeading
  • Entity::getPitch
  • Entity::getPopulationType
  • Entity::getQuaternion
  • Entity::getRoll
  • Entity::getRotation
  • Entity::getRotationVelocity
  • Entity::getScript
  • Entity::getSpeed
  • Entity::getSpeedVector
  • Entity::getSubmergedLevel
  • Entity::getType
  • Entity::getUprightValue
  • Entity::hasVariable
  • Entity::getVariable
  • Entity::getVehicleIndexFromIndex
  • Entity::getVelocity
  • Entity::getWorldPositionOfBone
  • Entity::hasAnimEventFired
  • Entity::hasAnimFinished
  • Entity::hasBeenDamagedBy
  • Entity::hasBeenDamagedByEntity
  • Entity::hasBeenDamagedByAnyObject
  • Entity::hasBeenDamagedByAnyPed
  • Entity::hasBeenDamagedByAnyVehicle
  • Entity::hasClearLosTo
  • Entity::hasClearLosToInFront
  • Entity::hasCollidedWithAnything
  • Entity::hasCollisionLoadedAround
  • Entity::isAMission
  • Entity::isAnObject
  • Entity::isAPed
  • Entity::isAt
  • Entity::isAtCoord
  • Entity::isAttached
  • Entity::isAttachedTo
  • Entity::isAttachedToAnyObject
  • Entity::isAttachedToAnyPed
  • Entity::isAttachedToAnyVehicle
  • Entity::isAVehicle
  • Entity::isCollisonDisabled
  • Entity::isDead
  • Entity::isInAir
  • Entity::isInAngledArea
  • Entity::isInArea
  • Entity::isInWater
  • Entity::isInZone
  • Entity::isOccluded
  • Entity::isOnScreen
  • Entity::isPlayingAnim
  • Entity::isStatic
  • Entity::isTouching
  • Entity::isTouchingModel
  • Entity::isUpright
  • Entity::isUpsidedown
  • Entity::isVisible
  • Entity::isVisibleToScript
  • Entity::isWaitingForWorldCollision
  • Entity::playAnim
  • Entity::playSynchronizedAnim
  • Entity::processAttachments
  • Entity::resetAlpha
  • Entity::setAlpha
  • Entity::setAlwaysPrerender
  • Entity::setAnimCurrentTime
  • Entity::setAnimSpeed
  • Entity::setAsMission
  • Entity::setCanBeDamaged
  • Entity::setCanBeDamagedByRelationshipGroup
  • Entity::setCanBeTargetedWithoutLos
  • Entity::setCollision
  • Entity::setCoords
  • Entity::setCoords2
  • Entity::setCoordsNoOffset
  • Entity::setDynamic
  • Entity::setHasGravity
  • Entity::setHeading
  • Entity::setHealth
  • Entity::setInvincible
  • Entity::setIsTargetPriority
  • Entity::setLights
  • Entity::setLoadCollisionFlag
  • Entity::setLodDist
  • Entity::setMaxHealth
  • Entity::setMaxSpeed
  • Entity::setMotionBlur
  • Entity::setNoCollision
  • Entity::setOnlyDamagedByPlayer
  • Entity::setOnlyDamagedByRelationshipGroup
  • Entity::setProofs
  • Entity::setQuaternion
  • Entity::setRecordsCollisions
  • Entity::setRenderScorched
  • Entity::setRotation
  • Entity::setTrafficlightOverride
  • Entity::setVelocity
  • Entity::setVisible
  • Entity::stopAnim
  • Entity::stopSynchronizedAnim