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

# Schritt erlauben oder verweigern

> Entscheide aus deinem eigenen Script, wer einen Heist-Schritt nutzen darf, zum Beispiel nur die Mitglieder einer Party.

Wird auf dem Server jedes Mal aufgerufen, wenn ein Spieler versucht, einen Heist-Schritt zu nutzen (einen Tresor öffnen, ein Panel hacken, einen Trolley plündern, auf eine Vitrine schießen...), nach den Prüfungen des Heists (Polizei, Cooldowns) und bevor irgendetwas passiert. Gib `false` zurück und der Schritt wird verweigert: nichts wird benutzt, kein Item wird genommen und der Heist startet nicht.

Hier bindest du ein Party-, Gang- oder Gruppen-Script ein: erlaube einen Heist nur einer registrierten Party oder verlange eine Mindestanzahl an Mitgliedern, um ihn zu starten.

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

Die Funktion steht am Ende von `integrations/sv_integrations.lua`, bearbeite sie dort. Wenn du von einer älteren Version aktualisiert und deine eigene `sv_integrations.lua` behalten hast, füge sie am Ende der Datei ein: ohne sie ist jeder Schritt erlaubt, wie vorher.

### Parameter

| Name | Datentyp | Beschreibung |
| - | - | - |
| `playerId` | integer | Server-ID des Spielers, der den Schritt nutzen will |
| `heistId` | integer | Heist-ID |
| `stageId` | integer | Stufen-ID |
| `stepType` | string | Der Schritttyp, siehe die [Liste der Schritttypen](https://docs.jaksam-scripts.com/de/robberies-creator/server/step-completed.md#schritttypen) |
| `isStarting` | boolean | `true` bis der erste Schritt des Heists abgeschlossen ist, `false` wenn der Heist läuft |

### Rückgabewert

`true`, um den Schritt zu erlauben, `false`, um ihn zu verweigern. Wenn du ihn verweigerst, sag dem Spieler warum: das Script zeigt selbst nichts an.

## Beispiel

```lua theme={null}
-- Hypothetisches Party-Script: nur Party-Mitglieder können Heist-Schritte nutzen,
-- und eine Party braucht mindestens 3 Mitglieder, um einen Heist zu starten
function canPlayerDoHeistStep(playerId, heistId, stageId, stepType, isStarting)
    local partyId = exports["my_party"]:getPlayerParty(playerId)

    if(not partyId) then
        notify(playerId, "Du musst in einer Party sein")
        return false
    end

    if(isStarting and exports["my_party"]:getMembersCount(partyId) < 3) then
        notify(playerId, "Deine Party braucht mindestens 3 Mitglieder")
        return false
    end

    return true
end
```

`notify(playerId, text)` ist die Benachrichtigung des Scripts, du kannst sie in dieser Datei nutzen.

> [!NOTE]
>
> Die Polizeianzahl und die Cooldowns werden vor deiner Funktion geprüft. Das benötigte Item des Schritts wird direkt danach geprüft: ein Spieler ohne das Item wird trotzdem verweigert, nachdem du ihn erlaubt hast. Ein verlorenes Minigame startet den Heist nicht, also bleibt `isStarting` beim nächsten Versuch `true`.

## Partys und Gruppen

* **Der Fortschritt wird bereits geteilt.** Der Fortschritt gehört dem Heist, nicht einem Spieler: jeder Spieler kann jeden Schritt machen, und ein erledigter Schritt (ein gehacktes Panel, eine geöffnete Tür, ein geleerter Tresor) ist für alle erledigt. Party-Mitglieder können die Arbeit ohne zusätzlichen Code aufteilen
* **Belohnungen** gehen an den Spieler, der den Schritt abschließt. Um dem Rest der Party etwas zu geben, höre auf das Event [Schritt abgeschlossen](https://docs.jaksam-scripts.com/de/robberies-creator/server/step-completed.md): es sagt dir, was der Spieler erhalten hat
* **Doors Creator** Türen in einem Heist werden von Robberies Creator selbst geöffnet, wenn der Schritt abgeschlossen ist, also hält das Verweigern eines Schritts hier auch seine Türen geschlossen


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