# Reminder

Mit der Zeit sammeln sich viele Module und Commands an, und nicht jeder Spieler kennt alles. Das Reminder-Modul schickt deshalb alle 30 Minuten einen kurzen Tipp in den Chat: ein Command, ein Werkzeug oder eine Funktion, die sich lohnt. Die Tipps passen sich dem Server an, wichtige Dinge kommen häufiger, und derselbe Tipp kommt nie zweimal hintereinander.

## So funktioniert es

- Jeder mitgelieferte Tipp gehört zu einem Modul und erscheint nur, solange dieses Modul aktiv ist. Schaltest du zum Beispiel Jobs ab, verschwinden die Job-Tipps von selbst.
- Jeder Tipp hat ein Gewicht: 3 für Dinge, die jeder Spieler kennen sollte (Claims setzen, Home speichern, `/guide`), 2 für Alltagsfunktionen, 1 für Nischen wie den Team-Chat. Je höher, desto öfter kommt der Tipp dran.
- Es wird nie der Tipp wiederholt, der zuletzt zu sehen war, solange es einen anderen gibt.
- Tipps gehen nur an Spieler, die gerade online sind und die Permission `reminder.receive` haben.
- Alle Texte stehen in `messages.yml` unter `reminder.tips` und lassen sich dort anpassen oder übersetzen. Das Präfix ist `TIP »` und wird wie alle Präfixe unter `prefixes` gesetzt.

## Permissions

| Permission | Default | Beschreibung |
|---|---|---|
| `reminder.receive` | true | Bekommt die Tipps. Entziehen, um eine Gruppe (zum Beispiel Teammitglieder) auszunehmen |

## Konfiguration (modules/reminder.yml)

```yaml
# Schaltet das Reminder-Modul ein oder aus.
enabled: true

reminder:
  # Minuten zwischen zwei Tipps.
  interval-minutes: 30
  # Die mitgelieferten Tipps (Texte in messages.yml unter reminder.tips).
  # Jeder gehört zu einem Modul und erscheint nur, solange es aktiv ist.
  builtin-tips: true
  # Mitgelieferte Tipps, die nie erscheinen sollen, nach ihrer Id (den
  # Schlüsseln unter reminder.tips), zum Beispiel [claim-subdivide, baltop].
  disabled-tips: []
  # Eigene Tipps. text ist MiniMessage, weight sagt, wie oft ein Tipp im
  # Vergleich zu den anderen drankommt (mitgelieferte nutzen 3, 2 und 1),
  # module beschränkt den Tipp auf die Zeit, in der ein Modul aktiv ist
  # (leer = immer).
  custom: []
```

## Eigene Tipps

Eigene Tipps hängst du unter `custom` an. Jeder Eintrag braucht einen `text`, `weight` und `module` sind optional:

```yaml
reminder:
  custom:
    - text: "<gray>Fragen? Unser Discord hilft: <yellow>discord.gg/example</yellow>"
      weight: 3
    - text: "<gray>Team-Plots gibt es am Marktplatz, schau bei <yellow>/warp markt</yellow> vorbei."
      weight: 1
      module: team
```

Der erste Tipp kommt immer und etwa so oft wie ein wichtiger mitgelieferter Tipp, der zweite nur, solange das Team-Modul aktiv ist, und selten.

> **Tipp:** Ein Intervall von 20 bis 45 Minuten hat sich bewährt. Kürzer wirkt schnell wie Spam, länger sehen viele Spieler in einer Session gar keinen Tipp.

## Mitgelieferte Tipps

| Id | Modul | Gewicht |
|---|---|---|
| `guide`, `wiki` | immer | 3, 2 |
| `cweb` | Web-Interface | 2 |
| `claim-shovel`, `claim-trust` | Claims | 3 |
| `claim-stick`, `claim-blocks` | Claims | 2 |
| `claim-trapped`, `claim-subdivide` | Claims | 1 |
| `sethome` | Homes | 3 |
| `homes-list` | Homes | 1 |
| `warps`, `tpa`, `spawn`, `back`, `rtp` | Teleportation | 2 |
| `pay` | Economy | 2 |
| `baltop` | Economy | 1 |
| `shop` | Chest-Shops | 2 |
| `jobs` | Jobs | 3 |
| `jobs-quests` | Jobs | 1 |
| `team-create` | Teams | 2 |
| `team-chat`, `team-home` | Teams | 1 |
| `msg` | Private Nachrichten | 2 |
| `stations`, `upgrade` | Stations, Verzauberungs-Upgrades | 2 |
| `nick`, `cosmetic`, `afk`, `sleep`, `trash` | Nicknames, Cosmetics, AFK, Sleep, Utility | 1 |