> ## 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.

# Autoriser ou refuser une étape

> Décide depuis ton propre script qui peut utiliser une étape d'un braquage, par exemple seulement les membres d'une party.

Appelée sur le serveur chaque fois qu'un joueur essaie d'utiliser une étape d'un braquage (ouvrir un coffre, hacker un panneau, piller un chariot, tirer sur une vitrine...), après les vérifications du braquage (police, cooldowns) et avant que quoi que ce soit ne se passe. Renvoie `false` et l'étape est refusée : rien n'est utilisé, aucun item n'est retiré et le braquage ne démarre pas.

C'est l'endroit où brancher un script de party, de gang ou de groupe : autoriser un braquage seulement à une party enregistrée, ou exiger un nombre minimum de membres pour le démarrer.

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

La fonction se trouve en bas de `integrations/sv_integrations.lua`, modifie-la là. Si tu as mis à jour depuis une ancienne version en gardant ton propre `sv_integrations.lua`, colle-la en bas du fichier : sans elle toutes les étapes sont autorisées, comme avant.

### Paramètres

| Nom | Type de donnée | Description |
| - | - | - |
| `playerId` | integer | Server ID du joueur qui essaie d'utiliser l'étape |
| `heistId` | integer | ID du braquage |
| `stageId` | integer | ID de la phase |
| `stepType` | string | Le type d'étape, voir la [liste des types d'étapes](https://docs.jaksam-scripts.com/fr/robberies-creator/server/step-completed.md#types-detape) |
| `isStarting` | boolean | `true` jusqu'à ce que la première étape du braquage soit terminée, `false` quand le braquage est en cours |

### Valeur renvoyée

`true` pour autoriser l'étape, `false` pour la refuser. Quand tu la refuses, dis au joueur pourquoi : le script n'affiche rien de lui-même.

## Exemple

```lua theme={null}
-- Script de party hypothétique : seuls les membres d'une party peuvent utiliser les étapes d'un braquage,
-- et une party a besoin d'au moins 3 membres pour démarrer un braquage
function canPlayerDoHeistStep(playerId, heistId, stageId, stepType, isStarting)
    local partyId = exports["my_party"]:getPlayerParty(playerId)

    if(not partyId) then
        notify(playerId, "Tu dois être dans une party")
        return false
    end

    if(isStarting and exports["my_party"]:getMembersCount(partyId) < 3) then
        notify(playerId, "Ta party a besoin d'au moins 3 membres")
        return false
    end

    return true
end
```

`notify(playerId, text)` est la notification du script, tu peux l'utiliser dans ce fichier.

> [!NOTE]
>
> Le nombre de policiers et les cooldowns sont vérifiés avant ta fonction. L'item requis de l'étape est vérifié juste après : un joueur qui ne l'a pas est quand même refusé, après que tu l'as autorisé. Un mini-jeu perdu ne démarre pas le braquage, donc `isStarting` reste `true` pour la tentative suivante.

## Partys et groupes

* **La progression est déjà partagée.** La progression appartient au braquage, pas à un joueur : n'importe quel joueur peut faire n'importe quelle étape, et une étape faite (un panneau hacké, une porte ouverte, un coffre vidé) est faite pour tout le monde. Les membres d'une party peuvent se répartir le travail sans code en plus
* **Les récompenses** vont au joueur qui termine l'étape. Pour donner quelque chose au reste de la party, écoute l'event [Étape terminée](https://docs.jaksam-scripts.com/fr/robberies-creator/server/step-completed.md) : il te dit ce que le joueur a reçu
* **Les portes de Doors Creator** utilisées dans un braquage sont ouvertes par Robberies Creator lui-même quand l'étape est terminée, donc refuser une étape ici garde aussi ses portes fermées


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