# getElementsInRange (Compartido)

> Lista los elementos cuya posición está dentro de una esfera.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Función Lua
- **Lado**: Compartido
- **Categoría**: Elementos
- **URL**: https://wiki.mymp.gg/es/getElementsInRange

## Sintaxis

```lua
table getElementsInRange(float x, y, z, float radius [, string type = "", int interior = -1, int dimension = -1])
```

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `x, y, z` | `float` | Centro de la esfera. |
| `radius` | `float` | Radio en metros. Un número negativo da error. |
| `type` | `string` | Solo elementos de este tipo. Vacío acepta cualquier tipo. *(por defecto: `""`)* |
| `interior` | `int` | Solo elementos en este interior. `-1` acepta cualquier interior. *(por defecto: `-1`)* |
| `dimension` | `int` | Solo elementos en esta dimensión. `-1` acepta cualquier dimensión. *(por defecto: `-1`)* |

## Retorno

Una tabla con los elementos encontrados, vacía si no hay ninguno.

Los elementos sin posición nunca entran. Al filtrar por interior, los que no tienen interior quedan fuera.

## Ejemplo

```lua
local pos = getElementPosition(localPlayer)
local nearby = getElementsInRange(pos, 30, "vehicle", 0, getElementDimension(localPlayer))
outputDebugString(#nearby .. " vehículos cerca")
```

### Si vienes de MTA

En MTA esta función se llama `getElementsWithinRange`.

## Ver también

- [getElementsByType (Servidor)](https://wiki.mymp.gg/es/getElementsByType-server.md): Lista todos los elementos de un tipo debajo de un elemento del árbol en el servidor.
- [getElementPosition (Compartido)](https://wiki.mymp.gg/es/getElementPosition.md): Lee la posición de un elemento en el mundo.