> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jaksam-scripts.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Permitir o rechazar un paso

> Decide desde tu propio script quién puede usar un paso de un robo, por ejemplo solo los miembros de una party.

Se llama en el servidor cada vez que un jugador intenta usar un paso de un robo (abrir una caja fuerte, hackear un panel, saquear un carrito, disparar a una vitrina...), después de las comprobaciones del robo (policía, cooldowns) y antes de que pase nada. Devuelve `false` y el paso se rechaza: no se usa nada, no se quita ningún item y el robo no empieza.

Es el lugar para conectar un script de party, banda o grupo: permitir un robo solo a una party registrada, o exigir un número mínimo de miembros para empezarlo.

```lua Function theme={null}
function canPlayerDoHeistStep(playerId, heistId, stageId, stepType, isStarting)
    return true
end
```

La función está al final de `integrations/sv_integrations.lua`, edítala ahí. Si actualizaste desde una versión anterior y conservaste tu propio `sv_integrations.lua`, pégala al final del archivo: sin ella todos los pasos están permitidos, como antes.

### Parámetros

| Nombre | Tipo de dato | Descripción |
| - | - | - |
| `playerId` | integer | Server ID del jugador que intenta usar el paso |
| `heistId` | integer | ID del robo |
| `stageId` | integer | ID de la etapa |
| `stepType` | string | El tipo de paso, ver la [lista de tipos de paso](https://docs.jaksam-scripts.com/es/robberies-creator/server/step-completed.md#tipos-de-paso) |
| `isStarting` | boolean | `true` hasta que se completa el primer paso del robo, `false` cuando el robo está en curso |

### Valor devuelto

`true` para permitir el paso, `false` para rechazarlo. Cuando lo rechaces, dile al jugador por qué: el script no muestra nada por sí solo.

## Ejemplo

```lua theme={null}
-- Script de party hipotético: solo los miembros de una party pueden usar los pasos de un robo,
-- y una party necesita al menos 3 miembros para empezar un robo
function canPlayerDoHeistStep(playerId, heistId, stageId, stepType, isStarting)
    local partyId = exports["my_party"]:getPlayerParty(playerId)

    if(not partyId) then
        notify(playerId, "Tienes que estar en una party")
        return false
    end

    if(isStarting and exports["my_party"]:getMembersCount(partyId) < 3) then
        notify(playerId, "Tu party necesita al menos 3 miembros")
        return false
    end

    return true
end
```

`notify(playerId, text)` es la notificación del script, puedes usarla en este archivo.

> [!NOTE]
>
> El número de policías y los cooldowns se comprueban antes de tu función. El item requerido del paso se comprueba justo después: un jugador sin él sigue siendo rechazado, después de que lo hayas permitido. Un minijuego perdido no empieza el robo, así que `isStarting` sigue siendo `true` en el siguiente intento.

## Partys y grupos

* **El progreso ya es compartido.** El progreso pertenece al robo, no a un jugador: cualquier jugador puede hacer cualquier paso, y un paso hecho (un panel hackeado, una puerta abierta, una caja fuerte vaciada) está hecho para todos. Los miembros de una party pueden repartirse el trabajo sin código extra
* **Las recompensas** van al jugador que completa el paso. Para dar algo al resto de la party, escucha el event [Paso completado](https://docs.jaksam-scripts.com/es/robberies-creator/server/step-completed.md): te dice lo que recibió el jugador
* **Las puertas de Doors Creator** usadas en un robo las abre el propio Robberies Creator cuando se completa el paso, así que rechazar un paso aquí también mantiene cerradas sus puertas


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.