> For the complete documentation index, see [llms.txt](https://docs.timecord.dev/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.timecord.dev/docs/de/guide/commands.md).

# Commands

## Befehle

Jeder Befehl ist ein Discord-Slash-Befehl. Tippe `/` in einem beliebigen Kanal, um sie zu sehen, mit direkten Beschreibungen in deiner Serversprache (Englisch oder Deutsch).

{% hint style="info" %}
Befehle, die mit **⭐ Premium** markiert sind, benötigen ein aktives TimeCord-Abo für diesen Server. Manche Befehle sind nur teilweise Premium; das wird beim jeweiligen Befehl vermerkt.
{% endhint %}

**Wer was nutzen darf**

* **Jeder** kann die unten aufgeführten Mitglieder-Befehle nutzen.
* **Admin-Befehle** benötigen entweder die Discord-Berechtigung `Administrator` oder eine der Verwaltungsrollen, die du als *Zugriffsrollen* im Dashboard festlegst.
* Jeder Befehl kann einzeln aktiviert, deaktiviert oder auf Admins beschränkt werden unter **Dashboard → Einstellungen → Befehle**.

***

### Mitglieder-Befehle

#### `/help`

Zeigt Links zu dieser Dokumentation und zu unserem Support-Server.

#### `/info` `[user]`

Zeigt ein Mitgliederprofil:

* Eingestellt seit, und aktueller Dienststatus (eingestempelt seit, oder letzter Zeitpunkt des Ausstempelns)
* Job und Rang, falls konfiguriert (siehe [Ränge](broken://pages/4SdD2jtqo9WeGxvyS6db))
* Anzahl der **aktiven** Verwarnungen
* Tägliche, wöchentliche, monatliche und Gesamtstunden

Führe ihn für dich selbst aus, oder übergib einen `user`, um jemand anderen anzusehen.

#### `/leaderboard` `<timeframe>`

Reiht Mitglieder nach erfassten Stunden. `timeframe` ist eines von `alltime`, `monthly`, `weekly`, `daily`. Die Liste ist **paginiert** (10 pro Seite) mit ◀ / ▶ Buttons und berücksichtigt die Serverzeitzone und den Wochenstart (siehe [Statistiken & Zeit](/docs/de/guide/statistiken-and-zeit.md)).

#### `/overview`

Listet jeden auf, der aktuell eingestempelt ist, und wie lange er schon im Dienst ist.

#### `/timerequest` `<action> <minutes> <reason> [proof-link] [proof-attachment]` ⭐ Premium

Ermöglicht es einem Mitglied, eine Zeitänderung anzufragen, anstatt dass ein Admin sie manuell vornimmt.

* `action` - `give` (Zeit hinzufügen anfragen) oder `remove` (Zeit entfernen anfragen)
* `minutes` - wie viele Minuten
* `reason` - warum
* `proof-link` / `proof-attachment` - optionaler Nachweis (ein Link und/oder ein Bild/Video)

Die Anfrage wird an dein Personal mit Zugriffsrolle gepostet, mit **Approve**- und **Reject**-Buttons. Bei Genehmigung wird die Zeit automatisch angewendet und das Mitglied benachrichtigt.

***

### Admin-Befehle

#### `/employee` `<user> <action>`

Verwalte einen einzelnen Mitarbeiter.

| Aktion    | Was sie bewirkt                                                                        |
| --------- | -------------------------------------------------------------------------------------- |
| `hire`    | Erlaubt dem Nutzer, Zeit zu erfassen. Das ist die Voraussetzung für die Zeiterfassung. |
| `dismiss` | Entzieht die Zeiterfassung. Ihre Daten bleiben erhalten.                               |
| `stop`    | Beendet ihre aktive Sitzung; der Nutzer **behält** die erfasste Zeit.                  |
| `cancel`  | Beendet ihre aktive Sitzung; der Nutzer erhält **keine** Zeit.                         |
| `delete`  | Löscht dauerhaft alle Daten des Nutzers (fragt zuerst nach Bestätigung).               |

{% hint style="info" %}
Einstellen und Kündigen kann auch automatisch geschehen: Aktiviere Auto-Einstellung beim Beitritt, oder lege **Autorollen** im Dashboard fest, sodass das Erhalten/Verlieren einer Rolle das Mitglied einstellt/kündigt.
{% endhint %}

#### `/tracking` `<action>`

Verwalte die serverweite Zeiterfassung.

| Aktion     | Was sie bewirkt                                                                                      |
| ---------- | ---------------------------------------------------------------------------------------------------- |
| `generate` | Postet die Stechuhr-Nachricht mit **Clock in** / **Clock out** Buttons.                              |
| `list`     | Zeigt eine **paginierte** Liste jedes eingestellten Mitarbeiters (im Dienst zuerst, 🟢 = im Dienst). |
| `stop` ⭐   | Stempelt **alle** aus und gibt ihnen ihre Zeit.                                                      |
| `cancel` ⭐ | Stempelt **alle** aus, mit **keiner** Zeit.                                                          |

`generate` und `list` sind kostenlos; `stop` und `cancel` sind Premium.

#### `/time` `<action> <user> <amount>`

Passe die Zeit eines Nutzers manuell an. `action` ist `add` oder `remove`, `amount` ist in Minuten.

#### `/timezone` `<timezone>`

Setzt die IANA-Zeitzone, die zum Gruppieren der täglichen / wöchentlichen / monatlichen Statistiken verwendet wird, zum Beispiel `Europe/Berlin`, `America/New_York` oder `UTC` (der Standard). Siehe [Statistiken & Zeit](/docs/de/guide/statistiken-and-zeit.md).

#### `/language` `<language>`

Setzt die Sprache des Bots für diesen Server: `de` (Deutsch) oder `en` (Englisch).

#### `/weekstart` `<day>` ⭐ Premium

Legt fest, mit welchem Wochentag eine Woche beginnt (Montag bis Sonntag). Das ändert, wie wöchentliche Statistiken gruppiert werden. Siehe [Statistiken & Zeit](/docs/de/guide/statistiken-and-zeit.md).

#### `/cleanup` ⭐ Premium

Entfernt Nutzer aus der Datenbank, die nicht mehr auf dem Server sind.

#### `/role` `<action> <role>` ⭐ Premium

Massen-Operationen für jeden, der eine bestimmte Rolle hat.

| Aktion   | Was sie bewirkt                                         |
| -------- | ------------------------------------------------------- |
| `add`    | Stellt jeden mit der Rolle ein.                         |
| `remove` | Kündigt jedem mit der Rolle.                            |
| `reset`  | Setzt die erfasste Zeit für jeden mit der Rolle zurück. |

#### `/warn` `<action> <user>` ⭐ Premium

Das Verwarnungssystem.

| Aktion   | Was sie bewirkt                                                                 |
| -------- | ------------------------------------------------------------------------------- |
| `warn`   | Öffnet ein Modal, um Grund und Dauer festzulegen, und verwarnt dann den Nutzer. |
| `delete` | Entfernt eine der aktiven Verwarnungen des Nutzers.                             |
| `show`   | Listet die aktiven Verwarnungen des Nutzers auf.                                |

Verwarnungen **verfallen automatisch**: Sobald die Dauer einer Verwarnung abläuft, zählt sie nicht mehr und wird später aufgeräumt. Siehe [Statistiken & Zeit](/docs/de/guide/statistiken-and-zeit.md#verwarnungen).

#### `/export` ⭐ Premium

Exportiert eine **CSV** mit den täglichen, wöchentlichen, monatlichen und Gesamtstunden jedes Mitarbeiters, bereit für die Lohnabrechnung. Der Export berücksichtigt deine Zeitzone und deinen Wochenstart. Die Datei wird dir privat gesendet.
