Player::call

This function call added client-side event for selected player.

Syntax

player.call(String eventName [, ...args]);

Required Arguments

• eventName: Event name, what will be called.
• args: Any arguments, what should be sended to client. Supports entities, strings, numbers and booleans. (Objects and Arrays should be packed to JSON format.)

Example

That's example will call event added on client side for player with ID 1337, disable regeneration health and send number current player health.

Client-Side

let disableRegeneration = (currentHealth) => { //currentHealth - value, what we send from server.
	mp.game.player.setHealthRechargeMultiplier(0); //Disable regeneration
	let text = `Regeneration disabled. Current health: ${currentHealth}`;
	mp.gui.chat.push(text); //Output text to default chatbox
};

mp.events.add('disablePlayerRegeneration', disableRegeneration);

Server-Side

let player = mp.player.at(1337); //Get player by ID
if (player) {
	let playerHealth = player.health;
	player.call(`disablePlayerRegeneration`, playerHealth);
};

You cannot pass Vector3 types (send them through x,y,z and put them in a Vector3 type variable in the client function)

See Also

• Functions
  • Player::ban
  • Player::call
  • Player::callProc
  • Player::callToStreamed
  • Player::callUnreliable
  • Player::cancelPendingRpc
  • Player::clearDecorations
  • Player::getClothes
  • Player::getDecoration
  • Player::getFaceFeature
  • Player::getHeadBlend
  • Player::getHeadOverlay
  • Player::getProp
  • Player::getWeaponAmmo
  • Player::giveWeapon
  • Player::hasPendingRpc
  • Player::invoke
  • Player::isStreamed
  • Player::isStreamedFor
  • Player::kick
  • Player::kickSilent
  • Player::notify
  • Player::outputChatBox
  • Player::playAnimation
  • Player::playScenario
  • Player::putIntoVehicle
  • Player::removeFromVehicle
  • Player::removeObject
  • Player::removeWeapon
  • Player::removeAllWeapons
  • Player::resetWeapon
  • Player::setClothes
  • Player::setCustomization
  • Player::setDecoration
  • Player::setFaceFeature
  • Player::setHairColor
  • Player::setHeadBlend
  • Player::setHeadOverlay
  • Player::setProp
  • Player::setWeaponAmmo
  • Player::spawn
  • Player::stopAnimation
  • Player::updateHeadBlend
  • Player::enableVoiceTo
  • Player::disableVoiceTo
  • Weapons::clear
  • Entity::destroy
  • Entity::dist
  • Entity::distSquared
  • Entity::getVariable
  • Entity::setVariable
  • Entity::setVariables
• Properties
  • Player::action
  • Player::aimTarget
  • Player::allWeapons
  • Player::armour
  • Player::eyeColor
  • Player::faceFeatures
  • Player::hairColor
  • Player::hairHighlightColor
  • Player::heading
  • Player::health
  • Player::rgscId
  • Player::ip
  • Player::serial
  • Player::isAiming
  • Player::isClimbing
  • Player::isEnteringVehicle
  • Player::isInCover
  • Player::isInMelee
  • Player::isJumping
  • Player::isLeavingVehicle
  • Player::isOnLadder
  • Player::isReloading
  • Player::name
  • Player::packetLoss
  • Player::ping
  • Player::seat
  • Player::socialClub
  • Player::streamedPlayers
  • Player::vehicle
  • Player::voiceListeners
  • Player::disableOutgoingSync
  • Player::weapon
  • Player::weaponAmmo
  • Player::weapons
    • Weapons::all
    • Weapons::current
    • Weapons::hash
    • Weapons::name
  • Entity::alpha
  • Entity::data
  • Entity::dimension
  • Entity::id
  • Entity::model
  • Entity::position
  • Entity::type