Skip to content
9 changes: 2 additions & 7 deletions docs/scnx/intro.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,8 +37,6 @@ detailed [frequently asked questions](/docs/scnx/guilds/faq) section about serve
the [toolbox documentation](/docs/scnx/account-and-billing/toolbox).
* SCNX Ads: Advertise your server or product on SCNX. You can open
the [Ads on SCNX documentation](/docs/scnx/account-and-billing/ads).
* SCNX Referrals: Earn a commission for purchased plans on SCNX. You can open
the [Referrals documentation](/docs/scnx/account-and-billing/referrals).
* SCNX File Storage: Host images and more for your Discord servers and embed them directly on SCNX.
* SC Network Memberships (outdated): *More information will be made available shortly*.

Expand All @@ -51,8 +49,7 @@ questions you might have.
[ScootKit](https://scootkit.net) is a German-based company running SCNX and other service-as-a-service products.
:::

* [ScootKit Merch Store](https://scnx.app/user/merch): Purchase physical SCNX Merch.
* [Feature Board](https://features.sc-network.net): Suggest new features for SCNX Products.
* [Feature Board](https://featureboard.net/): Suggest new features for SCNX Products.
* SCNX Marketplace: A system for third-parties to integrate new and existing products into SCNX.
* [SCNX Documentation](/): This documentation aimed to explain as many features of SCNX in detail as possible.
* [SCNX FAQ](https://faq.scnx.app): Legacy articles about a few topics on SCNX (mostly used for legal stuff). Previously
Expand All @@ -67,7 +64,5 @@ questions you might have.
* [SCNX Helper Program](https://scnx.app/user/helper-application): A program to allow involved community members with
technical knowledge about SCNX to
receive recognition and perks based as an "SCNX Helper" on our [Discord server](https://scootk.it/dc).
* [ScootKit Moderator](https://scnx.app/user/moderator-application): Program designed to allow community members to
moderate, organize events and more on our [Discord server](https://scootk.it/dc).
* ScootKit RSS Hub: System designed to handle traffic and notifications for CustomBot Notification-Modules.
* and more… :wink:
* and more… :wink:
Original file line number Diff line number Diff line change
@@ -0,0 +1,119 @@
# Versende Nachrichten / Embeds, Self-Rollen und mehr

Sende Nachrichten, Embeds und Forenposts über deinen Bot – direkt aus dem SCNX-Dashboard. Du kannst diese Funktion auch nutzen, um Selbst-Rollen-Nachrichten mit Knöpfen zu erstellen.

<IncludedInPlan data={{PROFESSIONAL: true, UNLIMITED: true, STARTER: true}} />

## Übersicht {#overview}

Als Bot anmelden ermöglicht es dir, die Nachrichten deines Bots direkt über das Dashboard zu steuern, ohne Discord auf deinem Gerät geöffnet haben zu müssen. Folgende Optionen stehen dir zur Verfügung:

* Verschicke Nachrichten und formatierte Embeds in sämtliche Kanäle, auf die dein Bot Zugriff hat.
* Bearbeite bereits gesendete Bot-Nachrichten.
* Hänge Dateien an Nachrichten an.
* Füge interaktive Komponenten wie Knöpfe und Auswahlmenüs hinzu (einschließlich Selbst-Rollen-Knöpfe).
* Erstelle Forenposts in Foren-Kanälen.
* Sieh dir den Audit-Log aller über das Dashboard gesendeten Nachrichten an.

## Einrichtung {#setup}

1. Öffne die Seite [Als Bot anmelden](https://scnx.app/de/glink?page=bot/login) auf deinem SCNX-Dashboard.
2. Stelle sicher, dass dein Bot **online** ist — Als Bot anmelden setzt voraus, dass dein Bot ohne kritische Fehler läuft.
3. Dein Bot benötigt die Berechtigungen **Kanal anzeigen** und **Nachrichten senden** in jedem Kanal, in den du Nachrichten verschicken möchtest.

:::caution
Falls dein Bot offline ist oder kritische Probleme aufweist, kannst du Als Bot anmelden nicht nutzen. Sieh dir die [Fehlerbehebungs Dokumentation](/de/docs/custom-bot/troubleshooting/) an, falls dein Bot nicht startet.
:::

## Versenden einer Nachricht {#send-message}

1. Öffne die Seite [Als Bot anmelden](https://scnx.app/de/glink?page=bot/login) auf deinem SCNX-Dashboard.
2. Wähle den Kanal, in den du die Nachricht senden möchtest, aus der Kanalliste auf der linken Seite aus.
3. Verfasse deine Nachricht mit dem Nachrichten-Editor. Folgende Optionen stehen dir zur Verfügung:
* Schreibe reinen Text in das Nachrichtenfeld.
* Füge ein oder mehrere Embeds mit benutzerdefiniertem Titel, Beschreibung, Farbe, Feldern, Bildern, Fußzeile und mehr hinzu.
* Füge Dateien hinzu.
* Füge Komponenten hinzu (siehe [Komponenten hinzufügen](#components)).
4. Klicke zum Absenden auf „Nachricht senden“.

:::tip
Nutze die Vorschau im Nachrichten-Editor, um zu sehen, wie deine Nachricht vor dem Absenden aussehen wird.
:::

## Editing a message {#edit-message}

You can edit messages that were previously sent by your bot (including messages sent via Bot Log-In).
Comment on lines +43 to +45

1. Öffne die Seite [Als Bot anmelden](https://scnx.app/de/glink?page=bot/login) auf deinem SCNX-Dashboard.
2. Wähle den Kanal, in den du die Nachricht senden möchtest, aus der Kanalliste auf der linken Seite aus.
3. Suche die Nachricht in der Kanalansicht und klicke auf „Nachricht bearbeiten“.
4. Passe den Nachrichteninhalt, die Embeds oder die Komponenten mit dem Nachrichten-Editor an.
5. Klicke auf „Nachricht bearbeiten“, um deine Änderungen zu übernehmen.

## Komponenten hinzufügen {#components}

Du kannst Nachrichten, die über Als Bot anmelden gesendet werden, interaktive Komponenten hinzufügen:

* **Eigene Befehl Knöpfe hinzufügen** — Knöpfe, die deine [Eigenen Befehle](/de/docs/custom-bot/custom-commands/) auslösen, wenn sie angeklickt werden. Konfiguriere diese im Bereich „Komponenten“ des Nachrichten-Editors und verknüpfe sie mit einem Eigenen Befehl, der einen Knopf-Trigger nutzt.
* **Selbst-Rollen-Knopf hinzufügen** — Knöpfe, die beim Anklicken eine Rolle hinzufügen oder entfernen und es Mitgliedern so ermöglichen, sich selbst Rollen zuzuweisen. Dies ist eine moderne, übersichtlichere Alternative zu den herkömmlichen „Reaction Roles“.
* **Select-Menüs** — Auswahlmenüs, mit denen Nutzer aus einer Liste von Optionen wählen können. Diese können ebenfalls mit Eigenen Befehlen verknüpft werden.

:::info
Um einen Eigene Befehl Knopf zu verwenden, musst du zuerst einen [Eigenen Befehl erstellen](/de/docs/custom-bot/custom-commands/), der einen Knopf-Trigger nutzt. Diesen kannst du dann beim Hinzufügen eines Eigenen Befehl Knopfes im Nachrichten-Editor auswählen.
:::

## Einen Forenpost erstellen {#forum-post}

Wenn der ausgewählte Kanal ein Foren-Kanal ist, kannst du einen neuen Post erstellen:

1. Öffne die Seite [Als Bot anmelden](https://scnx.app/de/glink?page=bot/login) auf deinem SCNX-Dashboard.
2. Wähle einen Foren-Kanal aus.
3. Klicke auf **„Post erstellen“**.
4. Gib den Namen des Posts ein und verfasse die erste Nachricht.
5. Wähle optional Tags aus, die dem Beitrag zugewiesen werden sollen.
6. Klicke auf **„Post erstellen“**, um ihn zu veröffentlichen.

## Audit-Log für gesendete Nachrichten {#audit-log}

Als Bot anmelden führt ein Protokoll über alle Nachrichten, die über das Dashboard gesendet wurden. Klicke auf „Gesendete Nachrichten“, um den Audit-Log aufzurufen, der folgende Informationen anzeigt:

* Den Kanal, in den jede Nachricht gesendet wurde.
* Wer die Nachricht über das Dashboard gesendet hat.
* Ob die Nachricht **zugestellt** oder **nicht zugestellt** wurde.
* Das Nachrichtenformat.

Diese Funktion ist hilfreich, um den Überblick über gesendete Inhalte zu behalten und Fehler bei fehlgeschlagenen Zustellungen zu beheben.

## Fehlerbehebung {#troubleshooting}

<details>
<summary>Als Bot anmelden zeigt „Bot ist offline“ an</summary>

Dein Bot muss online sein und darf keine kritischen Probleme aufweisen. Überprüfe das
<a href="https://scnx.app/de/glink?page=bot/manage">Bot-Dashboard</a> nach Fehlermeldungen und schaue dir die
<a href="/de/docs/custom-bot/troubleshooting/">Fehlerbehebungs-Dokumentation</a> an.
</details>

<details>
<summary>Ich kann keine Kanäle sehen / Fehler: „No text channels“</summary>

Dein Bot benötigt die Berechtigungen <b>Kanal anzeigen</b> und <b>Nachrichten senden</b>. Bitte einen Server-Administrator, die Kanalberechtigungen des Bots zu überprüfen.
</details>

<details>
<summary>Nachricht konnte nicht gesendet werden / „Nicht zugestellt“</summary>
<ul>
<li>Stelle sicher, dass dein Bot im Zielkanal über die Berechtigungen <b>Kanal anzeigen</b>, <b>Nachrichten senden</b> und <b>Links einbetten</b> verfügt.</li>
<li>Falls du Embeds eingefügt hast, stelle sicher, dass der Bot über die Berechtigung <b>Links einbetten</b> verfügt.</li>
<li>Falls du Dateien angehängt hast, stelle sicher, dass der Bot über die Berechtigung <b>Dateien anhängen</b> verfügt und die Datei nicht zu groß ist.</li>
<li>Überprüfe, ob der Kanal noch existiert und nicht gelöscht wurde.</li>
</ul>
</details>

<details>
<summary>Ich kann eine Nachricht nicht bearbeiten</summary>
<ul>
<li>Du kannst nur Nachrichten bearbeiten, die von deinem Bot gesendet wurden.</li>
<li>Stelle sicher, dass dein Bot weiterhin Zugriff auf den Kanal hat, in dem die Nachricht gesendet wurde.</li>
</ul>
</details>
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
# Status-Roles

Ein einfaches Modul, um Nutzer mit Rollen zu belohnen, die bestimmte Wörter in ihrem benutzerdefinierten Discord-Status haben.

<ModuleOverview moduleName="status-roles" />

## Funktionen {#features}

* Weise Nutzern automatisch Rollen zu, die bestimmte Wörter oder Phrasen in ihrem benutzerdefinierten Discord-Status haben.
* Entferne automatisch die zugewiesenen Rollen, wenn ein Nutzer seinen Status ändert und die erforderlichen Wörter nicht mehr enthalten sind.
* Entferne optional alle anderen (nicht verwalteten) Rollen von Nutzern, wenn sie die Status-Kriterien erfüllen.
* Option, Offline-Nutzer zu ignorieren, um das Entfernen von Rollen beim Ausloggen zu verhindern (empfohlen für größere Server).

## Einrichtung {#setup}

1. [Aktiviere das Modul](https://scnx.app/de/glink?page=bot/modules?query=status-roles) auf deinem Server.
2. Öffne die [Modul-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=status-roles%7Cconfig) und füge die Wörter, die Nutzer in ihrem Status haben sollten, in das Feld „Wörter“ ein.
3. Füge die Rollen, die entsprechenden Nutzern zugewiesen werden sollen, im Feld „Rollen“ hinzu.
4. Stelle sicher, dass der Bot über die Berechtigung **Rollen verwalten** verfügt und dass die höchste Rolle des Bots über den Rollen steht, die du zuweisen möchtest.
5. Der Bot benötigt außerdem den **Presence Intent**, um Statusänderungen zu erkennen. Dieser ist bei SCNX standardmäßig aktiviert.
6. Wenn dein Server mehr als 500 Mitglieder hat, wird empfohlen, die Option „Rollen von offline Nutzern nicht entfernen“ zu aktivieren, um einen fehlerhaften Rollenentzug zu verhindern.

## Nutzung {#usage}

* Einmal konfiguriert, arbeitet das Modul automatisch. Wenn ein Nutzer seinen benutzerdefinierten Discord-Status aktualisiert, prüft der Bot, ob eines der konfigurierten Wörter darin vorkommt.
* Wenn eine Übereinstimmung gefunden wird, werden dem Nutzer die konfigurierten Rollen zugewiesen.
* Wenn der Nutzer seinen Status ändert und die Wörter nicht mehr vorhanden sind, werden die Rollen entfernt (es sei denn, der Nutzer ist offline und die Option „Rollen von offline Nutzern nicht entfernen“ ist aktiviert).
* Bei der Wortübereinstimmung wird nicht zwischen Groß- und Kleinschreibung unterschieden.

## Konfiguration {#configuration}

Dies ist die Konfigurationsdatei für das Modul. Öffne sie in deinem [Dashboard](https://scnx.app/de/glink?page=bot/configuration?file=status-roles%7Cconfig).

| Feld | Beschreibung |
|-------|-------------|
| Statusinhalt | Wörter, die Nutzer in ihrem benutzerdefinierten Status haben sollten. Der Bot prüft, ob eines dieser Wörter im Status des Nutzers vorkommt (Groß-/Kleinschreibung wird nicht berücksichtigt). |
| Rollen | Rollen, die Nutzern zugewiesen werden, wenn eines der konfigurierten Wörter in ihrem Status vorkommt. |
| Entferne alle anderen Rollen | Falls aktiviert, werden alle anderen (nicht vom Modul verwalteten) Rollen vom Nutzer entfernt, sobald dieser die Status-Kriterien erfüllt. |
| Rollen von offline Nutzern nicht entfernen | Falls aktiviert, werden die Status-Rollen nicht von Nutzern entfernt, die offline sind. Empfohlen für Server mit mehr als 500 Mitgliedern. |

## Fehlerbehebung {#troubleshooting}

* **Rollen werden nicht zugewiesen**:Stelle sicher, dass der Bot über die Berechtigung „Rollen verwalten“ verfügt und dass die höchste Rolle des Bots über den Rollen steht, die du zuweisen möchtest. Überprüfe außerdem, ob die Wörter in der Konfiguration mit denen übereinstimmen, die Nutzer in ihrem benutzerdefinierten Status haben.
* **Rollen werden entfernt, wenn Nutzer offline gehen**: Aktiviere die Option „Rollen von Offline-Nutzern nicht entfernen“ in der Konfiguration. Wenn Nutzer offline gehen, entfernt Discord deren Statusinformationen, was den Bot zu der Annahme führt, dass die Bedingungen nicht mehr erfüllt sind.
* **Das Modul scheint keine Statusänderungen zu erkennen**: Stelle sicher, dass der „Presence Intent“ für deinen Bot aktiviert ist. Auf SCNX ist dieser standardmäßig aktiviert.
Loading
Loading