# createSpotLight (Cliente)

> Crea una luz que ilumina dentro de un cono, como un foco. La luz solo existe en este cliente.

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

## Sintaxis

```lua
light|false createSpotLight(float x, y, z, float dirX, dirY, dirZ [, float radius = 15, color color = tocolor(255, 255, 255), float cone = 30, float hardness = 0.5])
```

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `x, y, z` | `float` | Posición de la luz en el mundo, tres números o un vec3. |
| `dirX, dirY, dirZ` | `float` | Hacia dónde apunta la luz. Tres números o un vec3, finito y no nulo; se normaliza. |
| `radius` | `float` | Alcance en metros, mayor que 0 y hasta 1000. *(por defecto: `15`)* |
| `color` | `color` | Tres números `r, g, b` (enteros de 0 a 255) o un valor de `tocolor`. El alfa se ignora. *(por defecto: `tocolor(255, 255, 255)`)* |
| `cone` | `float` | Mitad de la apertura del cono, en grados desde su eje, mayor que 0 y hasta 90. *(por defecto: `30`)* |
| `hardness` | `float` | Fracción del cono iluminada por completo, de 0 a 1. Por encima de 0.99 cuenta como 0.99. *(por defecto: `0.5`)* |

## Retorno

El elemento `light` creado, o `false` si no se pudo crear.

Su radio de fuente empieza en 0.1 metros (o en el alcance, si es menor); cámbialo con `setLightSourceRadius`. Una luz fuera de la dimensión o del área en foco no se dibuja.

## Ejemplo

```lua
local pos = getElementPosition(localPlayer)
local light = createSpotLight(pos.x, pos.y, pos.z + 6, 0, 0, -1, 20, 255, 240, 200, 25, 0.7)
setLightCastShadow(light, true)
```

### Si vienes de MTA

MTA no tiene luces dinámicas. Para iluminar un solo fotograma sin crear un elemento, usa `dxDrawSpotLight`.

## Ver también

- [createPointLight (Cliente)](https://wiki.mymp.gg/es/createPointLight.md): Crea una luz que ilumina en todas las direcciones desde un punto. La luz solo existe en este cliente.
- [setLightCone (Cliente)](https://wiki.mymp.gg/es/setLightCone.md): Cambia la apertura y la dureza del borde del cono de una luz spot.
- [setLightDirection (Cliente)](https://wiki.mymp.gg/es/setLightDirection.md): Cambia hacia dónde apunta una luz spot o rect.
- [dxDrawSpotLight (Cliente)](https://wiki.mymp.gg/es/dxDrawSpotLight.md): Ilumina un cono durante un solo fotograma, sin crear un elemento.