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

# Counter

> Lass deinen Chatbot ein Wort im Chat mitzählen und automatisch darauf antworten.

## Was ist ein Counter?

Ein Counter zählt mit, wie oft ein bestimmtes Wort im Chat geschrieben wird, und lässt den Bot darauf antworten. Du legst z.B. den Counter `gg` an: Schreibt jemand `gg` in den Chat, erhöht sich der Zähler um 1 und der Bot antwortet — z.B. `WhyScarface hat 512x gut gespielt!`.

Anders als ein [Command](/chatbot/commands) braucht ein Counter **kein `!` davor**. Er reagiert direkt auf das Wort im Chat.

***

## Counter anlegen

<Steps>
  <Step title="Counter hinzufügen öffnen">
    Klicke auf **Counter hinzufügen +**, um das Formular zu öffnen.
  </Step>

  <Step title="Counter ausfüllen">
    Fülle die folgenden Felder aus:

    <ParamField body="Name" type="string" required>
      Das Wort, auf das der Counter reagiert. **2–20 Zeichen, nur Buchstaben und Zahlen.** Der Name wird intern kleingeschrieben (`GG` wird zu `gg`). Jeder Name kann pro Channel nur **einmal** vergeben werden.
    </ParamField>

    <ParamField body="Antwort-Text" type="string" required>
      Die Nachricht, die der Bot postet, wenn das Wort geschrieben wird. Hier kannst du [Platzhalter](#platzhalter) wie `{counter}` und `{user}` nutzen.
    </ParamField>

    <ParamField body="Startwert" type="number" required default="0">
      Der Wert, mit dem der Zähler beginnt (z.B. `0`).

      <Warning>
        Der Startwert ist nach dem Anlegen **nicht mehr änderbar**. Willst du ihn ändern, lösche den Counter und lege ihn neu an.
      </Warning>
    </ParamField>

    <ParamField body="Cooldown (Sekunden)" type="number" default="0">
      Optional. Wie viele Sekunden nach einem gezählten Treffer **kein weiterer Treffer** gezählt wird. **Bereich 0–300**, Standard `0`.

      * `0` (Standard): Jede passende Chat-Nachricht zählt sofort mit.
      * Höher (z.B. `30`): Nach einem Treffer pausiert das Mitzählen für 30 Sekunden.

      Mehr dazu im Abschnitt [Cooldown](#cooldown).
    </ParamField>
  </Step>

  <Step title="Hinzufügen">
    Klicke auf **Hinzufügen**, um den Counter zu speichern.
  </Step>
</Steps>

***

## Platzhalter

Im Antwort-Text kannst du Platzhalter in **geschweiften Klammern** verwenden. Der Bot ersetzt sie automatisch, wenn er antwortet.

| Platzhalter | Bedeutung                                         |
| ----------- | ------------------------------------------------- |
| `{counter}` | Der aktuelle Zählerstand                          |
| `{user}`    | Der Name der Person, die das Wort geschrieben hat |

Zusätzlich funktionieren die meisten [Command-Variablen](/chatbot/variables) wie `$(user)`, `$(random)`, `$(pick)` und `$(repeat)`. **Nicht unterstützt** werden in Countern `$(touser)` und `$(clip)`.

***

## Beispiele

| Name | Antwort-Text                               | Output im Chat                       |
| ---- | ------------------------------------------ | ------------------------------------ |
| `gg` | `{user} hat {counter}x gut gespielt!`      | `WhyScarface hat 512x gut gespielt!` |
| `nt` | `Nice Try! Das war Versuch Nr. {counter}.` | `Nice Try! Das war Versuch Nr. 27.`  |

***

## Wann reagiert ein Counter?

Ein Counter reagiert, wenn eine Chat-Nachricht **mit dem Counter-Wort beginnt** und das Wort danach zu Ende ist — es darf also nicht direkt weitergehen.

Beispiel für den Counter `gg`:

| Nachricht        | Reaktion                                       |
| ---------------- | ---------------------------------------------- |
| `gg`             | ✅ Reagiert                                     |
| `GG`             | ✅ Reagiert                                     |
| `gg!`            | ✅ Reagiert                                     |
| `gg mega runde!` | ✅ Reagiert                                     |
| `ggwp`           | ❌ Reagiert nicht — das Wort geht direkt weiter |
| `lol gg`         | ❌ Reagiert nicht — steht nicht am Anfang       |

***

## Cooldown

Mit dem **Cooldown** legst du fest, wie viele Sekunden nach einem gezählten Treffer **kein weiterer Treffer** gezählt wird. Das hält deinen Zähler wahrheitsgemäß, wenn viele Leute gleichzeitig dasselbe Wort schreiben.

**Beispiel:** Dir gelingt ein guter Play und direkt schreiben 10 Leute `gg`. Ohne Cooldown springt dein Counter um 10 hoch — das verzerrt den echten Stand. Mit einem Cooldown von `30` zählt in diesem Zeitfenster nur der **erste** `gg`, die restlichen werden ignoriert.

<Accordion title="Gut zu wissen zum Cooldown">
  * **Standard ist `0`** — dann zählt jede passende Nachricht sofort mit.
  * **Nur derselbe Counter.** Der Cooldown gilt pro Counter. Andere Counter haben ihren eigenen und laufen unabhängig.
  * **Jederzeit änderbar.** Anders als der Startwert lässt sich der Cooldown im Bearbeiten-Fenster jederzeit anpassen.
</Accordion>

<Note>
  Mitzählen und Bot-Antwort sind zwei getrennte Dinge. Der Cooldown steuert das **Mitzählen** — nicht, wann der Bot antwortet. Nicht mit einer Antwort-Verzögerung verwechseln.
</Note>

***

## Counter bearbeiten

Klicke auf einen Counter, um ihn zu bearbeiten. Du kannst jederzeit den **Antwort-Text** und den **[Cooldown](#cooldown)** ändern — **Name** und **Startwert** bleiben fest. Im Bearbeiten-Fenster siehst du außerdem den aktuellen Zählerstand.

### Aktivieren & deaktivieren

Über den **Schalter** kannst du einen Counter aktivieren oder deaktivieren. Ein deaktivierter Counter reagiert nicht mehr, **behält aber seinen Stand**. Beim erneuten Aktivieren läuft er beim letzten Wert weiter — nicht beim Startwert.

### Löschen

Mit dem **Papierkorb-Icon** entfernst du den Counter komplett. Der aktuelle Stand geht dabei verloren.

***

## Gut zu wissen

* **Bis zu 10 Counter pro Channel** (aktive und deaktivierte zusammen). Ist das Limit erreicht, lösche einen bestehenden Counter, um Platz zu schaffen.
* **Der Bot muss aktiv sein.** Counter reagieren nur, wenn dein [Chatbot aktiv](/chatbot/settings) ist.
* **Antwort-Verzögerung gegen Spam.** Schreiben mehrere Leute das Wort kurz hintereinander, antwortet der Bot nur alle paar Sekunden einmal. Das betrifft nur die Chat-Antworten — wie oft **mitgezählt** wird, steuerst du über den [Cooldown](#cooldown).