diff --git a/doc/en/scripting/builtins/libplayer.md b/doc/en/scripting/builtins/libplayer.md index b406f694..4bc81424 100644 --- a/doc/en/scripting/builtins/libplayer.md +++ b/doc/en/scripting/builtins/libplayer.md @@ -142,3 +142,21 @@ player.get_entity(playerid: int) -> int ``` Returns unique identifier of the player entity + +```lua +player.get_all_in_radius(center: vec3, radius: number) -> table +``` + +Returns an array of player IDs within a sphere with center `center` and radius `radius`. + +```lua +player.get_all() -> table +``` + +Returns an array of all active player IDs. + +```lua +player.get_nearest(position: vec3) -> int +``` + +Returns the ID of the player closest to the specified position, or nil if there are no players. diff --git a/doc/ru/scripting/builtins/libplayer.md b/doc/ru/scripting/builtins/libplayer.md index c40cd86d..c038ecae 100644 --- a/doc/ru/scripting/builtins/libplayer.md +++ b/doc/ru/scripting/builtins/libplayer.md @@ -142,3 +142,21 @@ player.get_entity(playerid: int) -> int ``` Возвращает уникальный идентификатор сущности игрока + +```lua +player.get_all_in_radius(center: vec3, radius: number) -> table +``` + +Возвращает массив id игроков в пределах сферы с центром `center` и радиусом `radius`. + +```lua +player.get_all() -> table +``` + +Возвращает массив id всех активных игроков. + +```lua +player.get_nearest(position: vec3) -> int +``` + +Возвращает id ближайшего к указанной позиции игрока, либо nil если игроков нет.