imported>Shr0x: Pool list

2024-11-10T12:10:24Z

Pool list

Новая страница

{{ServersideJsFunction}}
{{JSContainer|

{{Pool_list}}

==Summary==
The `pool.forEach` function iterates over each element in a pool, applying a specified function to each entity. It’s useful for actions that involve every entity within a pool, such as broadcasting messages, modifying player states, or destroying all vehicles.

==Syntax==
<syntaxhighlight lang="javascript">
pool.forEach(Function callingFunction)
</syntaxhighlight>

===Required Arguments===
*'''callingFunction:''' {{RageType|Function}} — A function to apply to each entity in the pool.

==Examples==
===Example #1===
This example collects and returns a string of all player nicknames on the server.

{{ServersideCode|
<syntaxhighlight lang="javascript">
let getNicknamesText = () => {
let text = ``;
mp.players.forEach((player) => {
text = text === `` ? player.name : `${text}, ${player.name}`;
});
return text;
};

const nicknameText = getNicknamesText();
console.log(nicknameText !== `` ? nicknameText : `No players online.`);
</syntaxhighlight>
}}

===Example #2===
This example adds a command to remove all vehicles on the server using `forEach`.

{{ServersideCode|
<syntaxhighlight lang="javascript">
mp.events.addCommand("removeAll", (player) => {
mp.vehicles.forEach((vehicle) => {
vehicle.destroy();
});
mp.players.broadcast(`${player.name} has destroyed all vehicles!`);
});
</syntaxhighlight>
}}

===Example #3===
This example teleports a player who types `/port <name>` to the location of the specified player.

{{ServersideCode|
<syntaxhighlight lang="javascript">
mp.events.addCommand("port", (player, name) => {
mp.players.forEach((_player) => {
if (_player.name === name) player.position = _player.position;
});
});
</syntaxhighlight>
}}

}}
==See Also==
{{EntityPool_function}}
[[Category:Serverside API]]

Pool::forEach - История изменений

imported>Shr0x: Pool list