Pool::exists
Available Entity Pools
The following are the main entity pools available on the RAGEMP, used for managing various game entities:
| Entity Pool | Description |
|---|---|
| mp.players | Manages all connected players |
| mp.vehicles | Manages all spawned vehicles |
| mp.objects | Manages all created objects |
| mp.peds | Manages all non-player characters (peds) |
| mp.markers | Manages all markers in the game |
| mp.labels | Manages all 3D text labels |
| mp.checkpoints | Manages checkpoints |
| mp.blips | Manages map blips |
| mp.colshapes | Manages collision shapes |
Summary
The mp.pool.exists function checks if an entity with a specific ID exists within a pool. It returns true if the entity exists and false if it does not. This is helpful for ensuring an entity is valid before performing further operations.
Syntax
mp.pool.exists(id)
Return value
Returns true if the entity exists, false if it does not.
Required Arguments
- id/entity: Number — The entity ID or the entity itself to check in the pool.
Example
This example checks if a specific player with ID 1500 exists in the players pool, and if so, sends them a welcome message. If not, it logs that the player is not found.
const playerID = 1500;
if (mp.players.exists(playerID)) {
const player = mp.players.at(playerID);
player.outputChatBox(`Welcome back, ${player.name}!`);
} else {
console.log(`Player with ID ${playerID} does not exist.`);
}