Skip to main content

Players::call

Server-side function

Summary​

The mp.players.call function triggers a specified event on the client-side for either all players or a defined array of players. It is useful for synchronizing client events across multiple players on the server.

Required Params​

  • eventName: string — The name of the client event to trigger.
  • args: Array — Arguments to send with the event. Supports strings, numbers, booleans, entities; objects and arrays should be in JSON format.

Syntax​

mp.players.call(eventName[, args]);
mp.players.call(playersArray, eventName[, args]);

Examples​

  1. Trigger an event for nearby players: This example triggers the "disablePlayerRegeneration" event for all players within 20 units of a position (150, 100, 50).
const playersArray = mp.players.toArray().filter((player) =>
    player.dist(new mp.Vector3(150, 100, 50)) < 20
);
mp.players.call(playersArray, "disablePlayerRegeneration");
  1. Trigger an event for all players: This example triggers the "disablePlayerRegeneration" event for everyone on the server.
mp.players.call("disablePlayerRegeneration");