# Friend System

## config.yml

### Prefix

Der Präfix wird standardmäßig bei jeder Nachricht genutzt. Dieser kann in den Nachrichten-Datein am Anfang jeder Nachricht gesetzt werden. Um diesen zu setzten schreibe einfach `%prefix%` (Placeholder). Dieser wird dann vom System mit dem Präfix, der in der `config.yml` eingetragen ist, ausgetauscht.

### jump To Message

Wenn dieser Wert auf `true` gesetzt ist, wird die Nachricht die du unter dem Punkt `options.friend.jumpToMessage` findest gesendet. Wenn der Wert auf `false` steht, wird er nicht gesendet.

### Default Requests

Hier kannst du festlegen, wie viele Freundesanfragen jeder Spieler Standardmäßig hat. Standard: `defaultRequests: 100`

### Max Requests

Hier kannst du anhand von Permissions, die Anzahl an maximalen Freundschaftsanfragen eines Spielers einstellen. Standard:

<pre class="language-yaml"><code class="lang-yaml"># permission ; max Requests
# -1 = unlimited
<strong>maxRequests:
</strong>    - "bungeesystem.friends.requests.150;150"
    - "bungeesystem.friends.requests.256;256"
    - "bungeesystem.friends.requests.unlimited;-1"
</code></pre>

### Max Friends

Hier kannst du anhand von Permissions, die Anzahl an maximalen Freunden eines Spielers einstellen. Standard:

```yaml
# permission ; max Friends
# -1 = unlimited
maxFriends:
    - "bungeesystem.friends.friends.150;150"
    - "bungeesystem.friends.friends.256;256"
    - "bungeesystem.friends.friends.unlimited;-1"
```

### Whitelist

Wenn du CloudNet v3 verwendest, musst du als 1. Schritt das Modul CloudNet v3 unter modules in der `config.yml` aktivieren.

Als nächstes trägst du unter dem Punkt whitelist alle tasks von CloudNet ein, wo ein Spieler von seinen Freunden die Nachricht bekommen dürfen, die in den Nachrichten Datein unter `command.friend.switch.message` steht.

```yaml
whitelist:
    - "BedWars4x1"
    - "BedWars4x2"
    - "BedWars4x4"
    - "MLGRush"
    - "GunGame"
```

### Aliases

Du kannst auch sogenannte Aliases definieren die du anstatt /friend eingeben kannst. Hierfür fügst du einfach weitere Punkte unter dem Punkt `aliases` hinzu.

```yaml
aliases:
    - "freunde"
    - "freund"
    - "friends"
```

### Standard Konfiguration

{% code title="config.yml" lineNumbers="true" %}

```yaml
friend:
  prefix: "&7[&9Friends&7]&r"
  jumpToMessage: true
  # permission ; max Requests
  # -1 = unlimited
  defaultRequests: 100
  maxRequests:
    - "bungeesystem.friends.requests.150;150"
    - "bungeesystem.friends.requests.256;256"
    - "bungeesystem.friends.requests.unlimited;-1"
  # permission ; max Friends
  # -1 = unlimited
  defaultFriends: 100
  maxFriends:
    - "bungeesystem.friends.friends.150;150"
    - "bungeesystem.friends.friends.256;256"
    - "bungeesystem.friends.friends.unlimited;-1"
  # if cloudnet v3 is enabled, please insert the cloudnet task, if not insert server names
  # if player connect to this server/task, all friends will get the switch message. if the message is enabled with the friend toggleswitch command
  whitelist:
    - "BedWars4x1"
    - "BedWars4x2"
    - "BedWars4x4"
    - "MLGRush"
    - "GunGame"
  aliases:
    - "freunde"
    - "freund"
    - "friends"
```

{% endcode %}

## Kommandos

### Syntax

| Kommando                  | Erklärung                             |
| ------------------------- | ------------------------------------- |
| /friend help \<Seite>     | Zeigt die Hilfeseiten 1-2             |
| /friend add \<Spieler>    | Füge einen Freund hinzu               |
| /friend remove \<Spieler> | Entferne einen Freund                 |
| /friend accept \<Spieler> | Akzeptiere eine Freundschaftsanfrage  |
| /friend deny \<Spieler>   | Lehne eine Freundschaftsanfrage ab    |
| /friend acceptall         | Akzeptiere alle Freundschaftsanfragen |
| /friend denyall           | Lehne alle Freundschaftsanfragen ab   |
| /friend list              | Listet alle Freunde auf               |
| /friend requests          | Listet alle Freundschaftsanfragen auf |
| /friend clear             | Entferne alle Freunde                 |
| /friend jump              | Springe zu einem Freund               |
| /friend togglerequest     | Aktivieren/Deaktivieren               |
| /friend togglejump        | Aktivieren/Deaktivieren               |
| /friend togglenotify      | Aktivieren/Deaktivieren               |
| /friend toggleswitch      | Aktivieren/Deaktivieren               |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki-de.herrtechniker.eu/bungeesystem/module/friend-system.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
