Latest revision as of 12:08, 10 November 2024

Server-Side
Function

JavaScript

JavaScript Syntax

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.`);
}

Functions
- Pool::at
- Pool::exists
- Pool::forEach
- Pool::forEachFast
- Pool::forEachInRange
- Pool::forEachInDimension
- Pool::forEachInStreamRange // Clientside only
- Pool::toArray
- Pool::toArrayFast
- Pool::toArrayInRange
- Pool::toArrayInDimension
- Pool::apply
- Pool::getClosest
- Pool::getClosestInDimension
Properties
- Pool::length
- Pool::size
Arrays
- Pool::streamed

@@ Line 1: / Line 1: @@
-This function is used for check, exists entity with ID in pool or not.
+{{ServersideJsFunction}}
+{{JSContainer|
-==Syntax==
+{{Pool_list}}
+==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===
 <syntaxhighlight lang="javascript">
-Boolean pool.exists(Number ID)
+mp.pool.exists(id)
 </syntaxhighlight>
-===Returns===
-Return true if entity exists, false if not exists.
+===Return value===
+Returns `true` if the entity exists, `false` if it does not.
 ===Required Arguments===
-*'''ID:''' Entity ID, what you wanna check in pool.
+*'''id/entity:''' {{RageType|Number}} — The entity ID or the entity itself to check in the pool.
-==Example==
-This example will check player with ID in pool, and write player name into chat if he exists.
+==Example==
-<div class="header" style="background-color: #408DAE; color: #FFFFFF; border: 2px solid #408DAE;">
+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.
-<div style="margin: 10px 10px 10px 10px;"><b>Server-Side</b></div>
-<syntaxhighlight lang="javascript" highlight="1">
+<syntaxhighlight lang="javascript">
-let isPlayerExists = mp.players.exists(1488);
+const playerID = 1500;
-if (isPlayerExists) {
-	let player = mp.players.at(1488);
+if (mp.players.exists(playerID)) {
-	console.log(`Player with id 1488 exists and have nickname ${player.name}`);
+    const player = mp.players.at(playerID);
+    player.outputChatBox(`Welcome back, ${player.name}!`);
 } else {
-	console.log(`Player by id 1488 does not exists...`);
+    console.log(`Player with ID ${playerID} does not exist.`);
-};
+}
 </syntaxhighlight>
-</div>
+}}
 ==See Also==
 {{EntityPool_function}}
+[[Category:Serverside API]]