Latest revision as of 12:07, 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 `pool.at` function returns an entity from a specified pool by its ID. It is useful for accessing specific entities such as players, vehicles, or objects by their unique server-side ID.

Syntax

pool.at(id)

Return value

An entity with the selected ID from a pool, or `undefined` if no entity exists with that ID.

Required Arguments

id: Number — The ID of the element to retrieve from the pool.

Example

This example retrieves a player by ID and outputs their name to the console if they exist.

let player = mp.players.at(1488);
if (player) {
    console.log(`Player with ID 1488 has nickname ${player.name}`);
} else {
    console.log(`Player with ID 1488 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 returns entity at specified id.
+{{ServersideJsFunction}}
+{{JSContainer|
-==Syntax==
+{{Pool_list}}
+==Summary==
+The `pool.at` function returns an entity from a specified pool by its ID. It is useful for accessing specific entities such as players, vehicles, or objects by their unique server-side ID.
+===Syntax===
 <syntaxhighlight lang="javascript">
-pool.at( id );
+pool.at(id)
 </syntaxhighlight>
+===Return value===
+An entity with the selected ID from a pool, or `undefined` if no entity exists with that ID.
+===Required Arguments===
+*'''id:''' {{RageType|Number}} — The ID of the element to retrieve from the pool.
 ==Example==
+This example retrieves a player by ID and outputs their name to the console if they exist.
 <syntaxhighlight lang="javascript">
-console.log(mp.players.at(0).name);
+let player = mp.players.at(1488);
+if (player) {
+    console.log(`Player with ID 1488 has nickname ${player.name}`);
+} else {
+    console.log(`Player with ID 1488 does not exist...`);
+}
 </syntaxhighlight>
+}}
+==See Also==
+{{EntityPool_function}}
+[[Category:Serverside API]]