From 7c24bcfb18fc25f651494dddef10235d98bb9caa Mon Sep 17 00:00:00 2001 From: Fridolin012 <143649557+Fridolin012@users.noreply.github.com> Date: Sat, 18 Nov 2023 21:34:59 +0100 Subject: [PATCH 01/14] Update welcomer.md --- docs/custom-bot/modules/administration/welcomer.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/custom-bot/modules/administration/welcomer.md b/docs/custom-bot/modules/administration/welcomer.md index 43115905..ad95b8d4 100644 --- a/docs/custom-bot/modules/administration/welcomer.md +++ b/docs/custom-bot/modules/administration/welcomer.md @@ -20,7 +20,7 @@ Simple module to say "Hi" to new mebers, give them roles automatically and say " ### Set up Welcome Messages {#setup-welcome-messages} -Welcome messages get sent every time a new member joins the server. You add a welcome-button to these messages which +Welcome messages get sent every time a new member joins the server. You can add a welcome-button to these messages which allows your existing members to welcome the new user. Additionally, if [enabled](#configuration-config), the message will get deleted if the user leaves your server within seven days. From 645d0bdad68912438687143f3f82a95afe13032d Mon Sep 17 00:00:00 2001 From: Fridolin012 <143649557+Fridolin012@users.noreply.github.com> Date: Sat, 18 Nov 2023 21:39:28 +0100 Subject: [PATCH 02/14] Update welcomer.md --- docs/custom-bot/modules/administration/welcomer.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/custom-bot/modules/administration/welcomer.md b/docs/custom-bot/modules/administration/welcomer.md index ad95b8d4..1eb4747b 100644 --- a/docs/custom-bot/modules/administration/welcomer.md +++ b/docs/custom-bot/modules/administration/welcomer.md @@ -1,6 +1,6 @@ # Welcome and Boosts -Simple module to say "Hi" to new mebers, give them roles automatically and say "thanks" to users who boosted. +Simple module to say "Hi" to new members, give them roles automatically and say "thanks" to users who boosted. From f69028860e595e5b100829dc32c6baddec3d18c7 Mon Sep 17 00:00:00 2001 From: Fridolin012 <143649557+Fridolin012@users.noreply.github.com> Date: Sat, 18 Nov 2023 21:58:32 +0100 Subject: [PATCH 03/14] Create welcomer.md --- .../modules/administration/welcomer.md | 204 ++++++++++++++++++ 1 file changed, 204 insertions(+) create mode 100644 i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md new file mode 100644 index 00000000..3a997e60 --- /dev/null +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md @@ -0,0 +1,204 @@ +# Willkommen und Boosts + +Einfaches Modul, um neuen Nutzern "Hi" zu sagen, ihnen Rollen zu geben und um sich bei Nutzern, die deinen Server geboostet haben, zu bedanken. + + + +## Funktionen {#features} + +* Heiße neue Nutzer mit eigenen Nachrichten (und dynamischen Bildern) willkommen. +* Sage Tschüss zu Nutzern, die deinen Server verlassen haben. +* Bedanke dich bei Nutzern, die deinen Server geboostet haben mit eigenen Nachrichten Thank users who boosted your server with custom messages und erpresse sie emotional, indem du ihnen eine Nachricht sendest, wenn sie deinen Server entboostet haben. +* Füge unbegrenzt viele an Nachrichten zum Beitritt, Boost oder Verlassen in verschiedenen Kanälen hinzu. +* Füge neuen Nutzern und Boostern automatisch Rollen hinzu. +* Lasse den Bot zufällige Nachrichten nutzen, um ein wenig Verschiedenheit in deine Willkommens, Verlassen, Boost und Entboost-Nachrichten zu bekommen. +* Lösche Willkommens-Nachrichten von Nutzern, die deinen Server innerhalb von 7 Tagen wieder verlassen haben, automatisch. +* Füge einen Button unter Willkommens-Nachrichten hinzu, der es deinen bestehenden Nutzern erlaubt, Mitglieder willkommen zu heißen. + +## Einrichtung {#setup} + +### Willkommens-Nachricht einrichten {#setup-welcome-messages} + +Willkommens-Nachrichten werdenWelcome messages get sent every time a new member joins the server. You can add a welcome-button to these messages which +allows your existing members to welcome the new user. Additionally, if [enabled](#configuration-config), the message +will get deleted if the user leaves your server within seven days. + +1. Create or select one of your channels in which the bot should send your message when a new member join. The bot has + to have the "View channel", "Send messages" and "View message history" permissions on it. +2. Add the channel to + the [channel configuration](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) using + the "join" Message-Type + and [configure it](#configuration-channels). +3. Configure the message: + * If you want to use random messages, enable the "Random messages?" option, open + the [random messages](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Frandom-messages) + configuration file and [configure](#configuration-random-messages) the random messages with the Message-Type " + join". + * If you want to send the same message every time, use + the [channel configuration](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) + to [configure the message](#configuration-channels). + +### Set up Boost / Unboost Messages {#setup-boost-messages} + +Boost-Messages gets send when a user boosts the server *for the first time* and the Unboost-Message will get send when a +user removes *all of their* boosts from your server. This messages will not get resend if a user increases or decreases +the amount of boosts on your server due to +a [Discord API limitation](https://github.com/discord/discord-api-docs/discussions/3228#discussioncomment-1717560). + +1. Create or select one of your channels in which the bot should send when a member boosts your server. The bot has + to have the "View channel", "Send messages" and "View message history" permissions on it. +2. Add the channel to + the [channel configuration](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) using + the "Boost" or "Unboost" Message-Type + and [configure it](#configuration-channels). +3. Configure the message: + * If you want to use random messages, enable the "Random messages?" option, open + the [random messages](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Frandom-messages) + configuration file and [configure](#configuration-random-messages) the random messages with the Message-Type " + boost" or "unboost". + * If you want to send the same message every time, use + the [channel configuration](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) + to [configure the message](#configuration-channels). + +### Set up Leave Messages {#setup-leave-messages} + +Leave messages will get send every time a user leaves your server. + +1. Create or select one of your channels in which the bot should send when a member leaves your server. The bot has + to have the "View channel", "Send messages" and "View message history" permissions on it. +2. Add the channel to + the [channel configuration](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) using + the "leave" Message-Type + and [configure it](#configuration-channels). +3. Configure the message: + * If you want to use random messages, enable the "Random messages?" option, open + the [random messages](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Frandom-messages) + configuration file and [configure](#configuration-random-messages) the random messages with the Message-Type " + leave". + * If you want to send the same message every time, use + the [channel configuration](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) + to [configure the message](#configuration-channels). + +### Setup Join or Boost Roles {#setup-join-roles} + +:::caution +Currently, Join-Roles might overwrite or remove roles from users that have assigned themselves roles using Discord's +onboarding. +This issue is known and is being worked on. +::: + +1. Open the [module configuration](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fconfig). +2. Select the desired roles in the [respective configuration fields](#configuration-config). + +## Usage {#usage} + +After [setting up](#setup) the module, messages will get automatically sent every time the event gets triggered. + +To allow your members to use a Welcome button, simply [enable this feature](#configuration-config) in your +configuration. Once done, new messages will have a (configurable) button. When this button is pressed by one of your +members, it will get inactive (= it can't be pressed by anyone another time) and a [configurable](#configuration-config) +message will get sent in the configured channel. + +## Configuration {#configuration} + +This module is split in multiple configuration files. You can find them below. + +### Channels {#configuration-channels} + +In this configuration file, you can set up the channels in which this module is supposed to operate in and allows +configuration of these channels. Open it in +your [dashboard](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels). + +:::info +This configuration file uses "Config-Elements". One Config-Element represents each channel that should receive messages +when a supported event is triggered. You can add a channel multiple times, this is especially required if you want to +send different event types in the same channel. +::: + +Each Channel has the following configuration options: + +| Field | Description | +|-----------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Channel | This is the channel the message will get sent in. | +| Channel-Type | Depending on this value, this particular Config-Element will represent the configuration for a specific event type (see [setup](#setup). The following options are available: | +| Random messages | If this option is enabled, the "Message" value will *NOT* be applied. Instead, a [random message](#configuration-random-messages) with the same Channel-Type will get sent randomly. | +| Message | This will be the message sent in this channel, if "Random messages" is not enabled. This option [supports dynamic image generation](https://sc-net.work/imgen) to make your messages even more pretty ✨. | +| Welcome Button | *This option is only available, when "Channel Type" is set to "join"*
If enabled, a button will get added below each message. One other member can then click on this button, which will trigger the configured message to be sent. | +| Welcome Button Content | *Only visible if "Welcome Button" is enabled.*
This will be the content of the button added below messages. The value needs to be less than 100 characters. | +| Channel in which the welcome-button should send a message | *Only visible if "Welcome Button" is enabled.*
This is the channel the welcome message will get sent in once another member presses the welcome button. | +| Welcome Button Message | *Only visible if "Welcome Button" is enabled.*
This is the message that gets sent in the configured channel when another member presses the welcome button. | + +### Module configuration {#configuration-config} + +In this configuration file allows you to [set up welcome- and boost roles](#setup-join-roles) and configure other basic +features of this module. Open it in +your [dashboard](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fconfig). + +| Field | Description | +|--------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Give roles on join | These roles will be given to members who joined your server. This won't get applied retroactively, use the [massrole module](./../tools/massrole) to do this. | +| Ignore bots? | If enabled (this is highly recommended), welcome and leave messages won't get sent if the user joining or leaving is a bot. | +| Give additional roles on boost | These roles will be given to members who boosted your server in addition to their boost-role assigned by Discord. The roles will get removed if the member removes all their boosts. | +| Delete welcome message | If enabled, sent welcome messages will get deleted automatically if the user leaves your server within seven days after join. | + +### Random messages {#configuration-random-messages} + +This configuration file will get used if a [configured channel](#configuration-channels) uses the "Random messages" +option. In this case, the bot will randomly select one of the messages configured in this file with the same type as +configured in the channel. + +:::info +This configuration file uses "Config-Elements". One Config-Element represents a message which a specified type. +When [a channel](#configuration-channels) uses the "Random messages" option, a random message with the same type will +get selected. +::: + +| Field | Description | +|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Message-Type | *see the "Channel-Type" option in the [channel configuration](#configuration-channels).* | +| Message | This is the message that gets send if this message object will get selected randomly. This option [supports dynamic image generation](https://sc-net.work/imgen) to make your messages even more pretty ✨. | + +## Troubleshooting {#troubleshooting} + +This module is notoriously trick to troubleshoot, as its highly flexible and customizable design introduces a +complicated configuration structure. If none of the steps below help (please try them first!), you can always reach out +to our friendly staff at [scnx.app/help](https://scnx.app/help). + +
+ A message is not being sent or the message is "Message not found". +
    +
  • Make sure your bot has the "View channel", "Send messages" and "View message history" permissions on the configured channel.
    • +
  • Make sure a correct channel entry is set up of the correct channel and correct event type.
    • +
  • If you are using Random Messages: Make sure at least one random message is configured for this event-type. The message in the channel entry will be ignored.
    • +
  • If you are not using Random Messages: Make sure you have configured a valid message in your channel entry.
    • +
+
+ +
+ I am experiencing issues with a dynamically generated image. + + Please visit sc-net.work/imgen, as shown in the error image. +
+ +
+ No message is being sent when a user adds another boost to their existing server boost. + + This happens due to a Discord API limitation. We cannot change this behavior. +
+ +## Stored data {#data-usage} + +The following data will get stored for every configured welcome messsage every time when a new member joins: + +* An unique integer identifying the database entry +* The unique Discord User-ID of the member who just joined and triggered the welcome message +* The unique Discord Message-ID of the welcome message that got sent by the bot +* The unique Discord Channel-ID of the channel the welcome message got sent in by the bot +* The exact time the member joined the server +* Metadata about the entry (date when created and last updated) + +This data will get used to delete the sent welcome messages if the user leaves the server within seven days after +joins (if [enabled](#configuration-config)). There is no way to stop the bot from storing data (as toggling this feature +should be retroactive), but the data won't get used unless the feature is enabled. + +To remove all data, [purge the module database](./../../additional-features#reset-module-database). From a8218c5ad2ff37a7e6d693dcbf030d7737699fff Mon Sep 17 00:00:00 2001 From: Fridolin012 <143649557+Fridolin012@users.noreply.github.com> Date: Sat, 25 Nov 2023 21:54:21 +0100 Subject: [PATCH 04/14] Update welcomer.md --- .../modules/administration/welcomer.md | 62 +++++++++---------- 1 file changed, 28 insertions(+), 34 deletions(-) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md index 3a997e60..9647b92b 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md @@ -19,33 +19,27 @@ Einfaches Modul, um neuen Nutzern "Hi" zu sagen, ihnen Rollen zu geben und um si ### Willkommens-Nachricht einrichten {#setup-welcome-messages} -Willkommens-Nachrichten werdenWelcome messages get sent every time a new member joins the server. You can add a welcome-button to these messages which -allows your existing members to welcome the new user. Additionally, if [enabled](#configuration-config), the message -will get deleted if the user leaves your server within seven days. - -1. Create or select one of your channels in which the bot should send your message when a new member join. The bot has - to have the "View channel", "Send messages" and "View message history" permissions on it. -2. Add the channel to - the [channel configuration](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) using - the "join" Message-Type - and [configure it](#configuration-channels). -3. Configure the message: - * If you want to use random messages, enable the "Random messages?" option, open - the [random messages](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Frandom-messages) - configuration file and [configure](#configuration-random-messages) the random messages with the Message-Type " - join". - * If you want to send the same message every time, use - the [channel configuration](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) - to [configure the message](#configuration-channels). - -### Set up Boost / Unboost Messages {#setup-boost-messages} - -Boost-Messages gets send when a user boosts the server *for the first time* and the Unboost-Message will get send when a -user removes *all of their* boosts from your server. This messages will not get resend if a user increases or decreases -the amount of boosts on your server due to -a [Discord API limitation](https://github.com/discord/discord-api-docs/discussions/3228#discussioncomment-1717560). - -1. Create or select one of your channels in which the bot should send when a member boosts your server. The bot has +Willkommens-Nachrichten werden jedes mal gesendet, wenn ein neuer Nutzer deinen Server betritt. Du kannst einen Willkommen-Button hinzufügen, welcher es bestehenden Nutzern erlaubt, den neuen Nutzer willkommen zu heißen. Zusätzlich wird, falls [aktiviert](#configuration-config), die Nachricht gelöscht, wenn der Nutzer den Server innerhalb 7 Tage wieder verlässt. + +1. Erstelle oder wähle einen deiner Kanäle, in welchen der Bot deine Nachricht schicken soll, wenn ein Nutzer beitritt. Der Bot muss die Berechtigungen "Kanal + ansehen" ("View channel"), "Nachrichten senden" ("Send messages") und "Nachrichtenverlauf einsehen" ("View message history") auf diesem haben. +3. Füge den Kanal zur + [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) hinzu. Nutze dafür als Kanal-Typ "join" und + [konfiguriere es](#configuration-channels). +4. Konfiguriere die Nachrichten: + * Wenn du zufällige Nachrichten verwenden willst, aktiviere die Option "Zufällige Nachrichten?", öffne die + [Zufällige Nachrichten](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Frandom-messages)- + Konfigurationsdatei und [konfiguriere](#configuration-random-messages) die zufälligen Nachrichten mit dem Nachrichten-Typ + "join". + * Wenn du immer die gleiche Nachricht gesendet haben willst, nutze die + [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels), um die + [Nachricht zu konfigurieren](#configuration-channels). + +### Boost / Unboost Nachrichten einreichten {#setup-boost-messages} + +Boost-Nachrichten werden gesendet, wenn ein Nutzer deinen Server *das erste mal* boostet und die Unboost-Nachricht wird gesendet, wenn ein Nutzer *alle seine Boosts* von deinem Server entfernt hat. Aufgrund [Einschränkungen in Discords API]((https://github.com/discord/discord-api-docs/discussions/3228#discussioncomment-1717560)) werden diese Nachrichten nicht gesendet, wenn ein Nutzer die Anzahl seiner Boosts auf deinem Server erhöht oder verringert. + +1. Erstelle oder wähle einen deiner Kanäle, in welchen der Bot eine Nachricht schreiben sollcCreate or select one of your channels in which the bot should send when a member boosts your server. The bot has to have the "View channel", "Send messages" and "View message history" permissions on it. 2. Add the channel to the [channel configuration](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) using @@ -79,10 +73,10 @@ Leave messages will get send every time a user leaves your server. the [channel configuration](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) to [configure the message](#configuration-channels). -### Setup Join or Boost Roles {#setup-join-roles} +### Beitritts- und Boost-Rollen einrichten {#setup-join-roles} :::caution -Currently, Join-Roles might overwrite or remove roles from users that have assigned themselves roles using Discord's +Momentan werden Currently, Join-Roles might overwrite or remove roles from users that have assigned themselves roles using Discord's onboarding. This issue is known and is being worked on. ::: @@ -186,15 +180,15 @@ to our friendly staff at [scnx.app/help](https://scnx.app/help). This happens due to a Discord API limitation. We cannot change this behavior. -## Stored data {#data-usage} +## Gespeicherte Daten {#data-usage} The following data will get stored for every configured welcome messsage every time when a new member joins: * An unique integer identifying the database entry -* The unique Discord User-ID of the member who just joined and triggered the welcome message -* The unique Discord Message-ID of the welcome message that got sent by the bot -* The unique Discord Channel-ID of the channel the welcome message got sent in by the bot -* The exact time the member joined the server +* Die einzigartige Discord Nutzer-ID des Nutzers, der deinem Server beigetreten ist und die Willkommens-Nachricht ausgelöst hat +* Die einzigartige Discord Nachrichten-ID der Willkommens-Nachricht, die vom Bot gesendet wurde +* Die einzigartige Discord Kanal-ID des Kanals, in welchen der Bot die Willkommens-Nachricht geschrieben hat +* Der genaue Zeitpunkt, wann der Nutzer deinem Server beigetreten ist * Metadata about the entry (date when created and last updated) This data will get used to delete the sent welcome messages if the user leaves the server within seven days after From ca0ce31c17a5d4d6b4825d7fccb2c9c848a16c85 Mon Sep 17 00:00:00 2001 From: Fridolin012 <143649557+Fridolin012@users.noreply.github.com> Date: Wed, 3 Jan 2024 21:15:38 +0100 Subject: [PATCH 05/14] Update welcomer.md --- .../modules/administration/welcomer.md | 22 +++++++++---------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md index 9647b92b..b44465d9 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md @@ -35,20 +35,20 @@ Willkommens-Nachrichten werden jedes mal gesendet, wenn ein neuer Nutzer deinen [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels), um die [Nachricht zu konfigurieren](#configuration-channels). -### Boost / Unboost Nachrichten einreichten {#setup-boost-messages} +### Boost / Unboost Nachrichten einrichten {#setup-boost-messages} Boost-Nachrichten werden gesendet, wenn ein Nutzer deinen Server *das erste mal* boostet und die Unboost-Nachricht wird gesendet, wenn ein Nutzer *alle seine Boosts* von deinem Server entfernt hat. Aufgrund [Einschränkungen in Discords API]((https://github.com/discord/discord-api-docs/discussions/3228#discussioncomment-1717560)) werden diese Nachrichten nicht gesendet, wenn ein Nutzer die Anzahl seiner Boosts auf deinem Server erhöht oder verringert. -1. Erstelle oder wähle einen deiner Kanäle, in welchen der Bot eine Nachricht schreiben sollcCreate or select one of your channels in which the bot should send when a member boosts your server. The bot has - to have the "View channel", "Send messages" and "View message history" permissions on it. -2. Add the channel to - the [channel configuration](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) using - the "Boost" or "Unboost" Message-Type - and [configure it](#configuration-channels). -3. Configure the message: - * If you want to use random messages, enable the "Random messages?" option, open - the [random messages](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Frandom-messages) - configuration file and [configure](#configuration-random-messages) the random messages with the Message-Type " +1. Erstelle oder wähle einen deiner Kanäle, in welchen der Bot eine Nachricht schreiben soll, wenn ein Mitglied deinen Server geboostet hat. Der Bot benötigt + die Rechte "Kanal anzeigen" ("View channel"), "Nachrichten senden" ("Send messages") und "Nachrichtenverlauf anzeigen" ("View message history") auf diesen Kanal. +2. Füge den Kanal zur + [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) hinzu, indem du + den Kanal-Typ "Boost" or "Unboost" benutzt + und das Element [konfigurierst](#configuration-channels). +3. Konfiguriere die Nachricht: + * Wenn du zufällige Nachrichten verwendest willst, aktivierst du die "Zufällige Nachrichten?"-Option, öffnest + die [Zufällige Nachrichten](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Frandom-messages)-Konfigurationsdatei + und [configure](#configuration-random-messages) the random messages with the Message-Type " boost" or "unboost". * If you want to send the same message every time, use the [channel configuration](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) From 7c2ab3785f0083e53a742a530fb605f7e0de9fe3 Mon Sep 17 00:00:00 2001 From: Fridolin012 <143649557+Fridolin012@users.noreply.github.com> Date: Fri, 9 Feb 2024 22:52:30 +0100 Subject: [PATCH 06/14] Update welcomer.md --- .../modules/administration/welcomer.md | 42 +++++++++---------- 1 file changed, 21 insertions(+), 21 deletions(-) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md index b44465d9..ccc2fffd 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md @@ -43,13 +43,13 @@ Boost-Nachrichten werden gesendet, wenn ein Nutzer deinen Server *das erste mal* die Rechte "Kanal anzeigen" ("View channel"), "Nachrichten senden" ("Send messages") und "Nachrichtenverlauf anzeigen" ("View message history") auf diesen Kanal. 2. Füge den Kanal zur [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) hinzu, indem du - den Kanal-Typ "Boost" or "Unboost" benutzt + den Kanal-Typ "Boost" oder "Unboost" benutzt und das Element [konfigurierst](#configuration-channels). 3. Konfiguriere die Nachricht: - * Wenn du zufällige Nachrichten verwendest willst, aktivierst du die "Zufällige Nachrichten?"-Option, öffnest + * Wenn du zufällige Nachrichten verwendest willst, aktiviere die "Zufällige Nachrichten?"-Option, öffne die [Zufällige Nachrichten](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Frandom-messages)-Konfigurationsdatei - und [configure](#configuration-random-messages) the random messages with the Message-Type " - boost" or "unboost". + und [konfigure](#configuration-random-messages) die zufälligen Nachrichten mit dem Nachrichten-Typ " + boost" oder "unboost". * If you want to send the same message every time, use the [channel configuration](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) to [configure the message](#configuration-channels). @@ -69,35 +69,35 @@ Leave messages will get send every time a user leaves your server. the [random messages](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Frandom-messages) configuration file and [configure](#configuration-random-messages) the random messages with the Message-Type " leave". - * If you want to send the same message every time, use - the [channel configuration](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) - to [configure the message](#configuration-channels). + * Wenn du jedes mal die gleiche Nachricht senden willst, nutze + die [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels), + um die [Nachricht zu konfigurieren](#configuration-channels). ### Beitritts- und Boost-Rollen einrichten {#setup-join-roles} :::caution -Momentan werden Currently, Join-Roles might overwrite or remove roles from users that have assigned themselves roles using Discord's -onboarding. -This issue is known and is being worked on. +Momentan werden Beitritts-Rollen Rollen, die sich Nutzer selbst über +Discords Einführung gegeben haben, überschreiben oder entfernen. +Dieser Fehler ist bekannt und wird bearbeitet. ::: -1. Open the [module configuration](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fconfig). -2. Select the desired roles in the [respective configuration fields](#configuration-config). +1. Öffne die [Modul-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fconfig). +2. Wähle die gewünschten Rollen in dem [jeweiligen Konfigurationsfeld](#configuration-config). -## Usage {#usage} +## Nutzung {#usage} -After [setting up](#setup) the module, messages will get automatically sent every time the event gets triggered. +Nach dem [Einrichten](#setup) des Moduls werden die Nachrichten automatisch jedes mal gesendet, wenn die Aktion ausgelöst wird. -To allow your members to use a Welcome button, simply [enable this feature](#configuration-config) in your -configuration. Once done, new messages will have a (configurable) button. When this button is pressed by one of your -members, it will get inactive (= it can't be pressed by anyone another time) and a [configurable](#configuration-config) -message will get sent in the configured channel. +Um Nutzern zu erlauben, einen Willkommen-Button zu benutzen, [aktiviere diese Funktion](#configuration-config) einfach in deiner Konfiguration. +Nach dem Einstellen werden neue Nachrichten einen (konfigurierbaren) Knopf haben. Wenn dieser Knopf von einem deiner Mitglieder gedrückt wird, +wird er inaktiv (= kann nicht mehr gedrückt werden) und eine [konfigurierbare](#configuration-config) +Nachricht wird in den konfigurierten Kanal gesendet. -## Configuration {#configuration} +## Konfiguration {#configuration} -This module is split in multiple configuration files. You can find them below. +Dieses Modul ist in mehrere Konfigurationsdateien unteteilt. Du kannst diese weiter unten finden. -### Channels {#configuration-channels} +### Kanäle {#configuration-channels} In this configuration file, you can set up the channels in which this module is supposed to operate in and allows configuration of these channels. Open it in From 5662ac11f6326d28f95ed19077f7b48b6e964162 Mon Sep 17 00:00:00 2001 From: Fridolin012 <143649557+Fridolin012@users.noreply.github.com> Date: Tue, 6 Aug 2024 12:53:46 +0200 Subject: [PATCH 07/14] Update welcomer.md --- .../modules/administration/welcomer.md | 73 +++++++++---------- 1 file changed, 36 insertions(+), 37 deletions(-) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md index ccc2fffd..7f21d383 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md @@ -7,31 +7,31 @@ Einfaches Modul, um neuen Nutzern "Hi" zu sagen, ihnen Rollen zu geben und um si ## Funktionen {#features} * Heiße neue Nutzer mit eigenen Nachrichten (und dynamischen Bildern) willkommen. -* Sage Tschüss zu Nutzern, die deinen Server verlassen haben. -* Bedanke dich bei Nutzern, die deinen Server geboostet haben mit eigenen Nachrichten Thank users who boosted your server with custom messages und erpresse sie emotional, indem du ihnen eine Nachricht sendest, wenn sie deinen Server entboostet haben. -* Füge unbegrenzt viele an Nachrichten zum Beitritt, Boost oder Verlassen in verschiedenen Kanälen hinzu. -* Füge neuen Nutzern und Boostern automatisch Rollen hinzu. -* Lasse den Bot zufällige Nachrichten nutzen, um ein wenig Verschiedenheit in deine Willkommens, Verlassen, Boost und Entboost-Nachrichten zu bekommen. -* Lösche Willkommens-Nachrichten von Nutzern, die deinen Server innerhalb von 7 Tagen wieder verlassen haben, automatisch. +* Verabschiede Nutzer, die deinen Server verlassen. +* Bedanke dich bei Nutzern mit eigenen Nachrichten, die deinen Server geboostet haben und erpresse sie emotional, indem du ihnen eine Nachricht sendest, wenn sie deinen Server entboosten. +* Füge unbegrenzt viele Nachrichten zum Beitritt, Boost oder Verlassen in verschiedenen Kanälen hinzu. +* Gebe neuen Nutzern und Boostern automatisch Rollen. +* Lasse den Bot zufällige Nachrichten nutzen, um ein wenig Verschiedenheit in deine Willkommens-, Verlassens-, Boost- und Entboost-Nachrichten zu bekommen. +* Lösche automatisch Willkommens-Nachrichten von Nutzern, die deinen Server innerhalb von 7 Tagen wieder verlassen haben. * Füge einen Button unter Willkommens-Nachrichten hinzu, der es deinen bestehenden Nutzern erlaubt, Mitglieder willkommen zu heißen. ## Einrichtung {#setup} ### Willkommens-Nachricht einrichten {#setup-welcome-messages} -Willkommens-Nachrichten werden jedes mal gesendet, wenn ein neuer Nutzer deinen Server betritt. Du kannst einen Willkommen-Button hinzufügen, welcher es bestehenden Nutzern erlaubt, den neuen Nutzer willkommen zu heißen. Zusätzlich wird, falls [aktiviert](#configuration-config), die Nachricht gelöscht, wenn der Nutzer den Server innerhalb 7 Tage wieder verlässt. +Willkommens-Nachrichten werden jedes mal gesendet, wenn ein neuer Nutzer deinem Server betritt. Du kannst einen Willkommen-Button hinzufügen, welcher es bestehenden Nutzern erlaubt, den neuen Nutzer willkommen zu heißen. Zusätzlich wird, falls [aktiviert](#configuration-config), die Nachricht gelöscht, wenn der Nutzer den Server innerhalb von 7 Tagen wieder verlässt. -1. Erstelle oder wähle einen deiner Kanäle, in welchen der Bot deine Nachricht schicken soll, wenn ein Nutzer beitritt. Der Bot muss die Berechtigungen "Kanal - ansehen" ("View channel"), "Nachrichten senden" ("Send messages") und "Nachrichtenverlauf einsehen" ("View message history") auf diesem haben. -3. Füge den Kanal zur - [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) hinzu. Nutze dafür als Kanal-Typ "join" und - [konfiguriere es](#configuration-channels). -4. Konfiguriere die Nachrichten: +1. Erstelle oder wähle einen deiner Kanäle, in welchen der Bot deine Nachricht schicken soll, wenn ein Nutzer beitritt. Der Bot benötigt + die Rechte "Kanal anzeigen" ("View channel"), "Nachrichten senden" ("Send messages") und "Nachrichtenverlauf anzeigen" ("View message history") auf diesen Kanal. +2. Füge den Kanal zur + [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) hinzu, indem du als Kanal-Typ "join" nutzt und + das Element [konfigurierst](#configuration-channels). +3. Konfiguriere die Nachricht: * Wenn du zufällige Nachrichten verwenden willst, aktiviere die Option "Zufällige Nachrichten?", öffne die [Zufällige Nachrichten](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Frandom-messages)- Konfigurationsdatei und [konfiguriere](#configuration-random-messages) die zufälligen Nachrichten mit dem Nachrichten-Typ "join". - * Wenn du immer die gleiche Nachricht gesendet haben willst, nutze die + * Wenn du jedes mal die gleiche Nachricht senden willst, nutze die [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels), um die [Nachricht zu konfigurieren](#configuration-channels). @@ -39,36 +39,35 @@ Willkommens-Nachrichten werden jedes mal gesendet, wenn ein neuer Nutzer deinen Boost-Nachrichten werden gesendet, wenn ein Nutzer deinen Server *das erste mal* boostet und die Unboost-Nachricht wird gesendet, wenn ein Nutzer *alle seine Boosts* von deinem Server entfernt hat. Aufgrund [Einschränkungen in Discords API]((https://github.com/discord/discord-api-docs/discussions/3228#discussioncomment-1717560)) werden diese Nachrichten nicht gesendet, wenn ein Nutzer die Anzahl seiner Boosts auf deinem Server erhöht oder verringert. -1. Erstelle oder wähle einen deiner Kanäle, in welchen der Bot eine Nachricht schreiben soll, wenn ein Mitglied deinen Server geboostet hat. Der Bot benötigt +1. Erstelle oder wähle einen deiner Kanäle, in welchen der Bot eine Nachricht schreiben soll, wenn ein Nutzer deinen Server boostet. Der Bot benötigt die Rechte "Kanal anzeigen" ("View channel"), "Nachrichten senden" ("Send messages") und "Nachrichtenverlauf anzeigen" ("View message history") auf diesen Kanal. 2. Füge den Kanal zur [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) hinzu, indem du - den Kanal-Typ "Boost" oder "Unboost" benutzt + den Kanal-Typ "boost" oder "unboost" benutzt und das Element [konfigurierst](#configuration-channels). 3. Konfiguriere die Nachricht: * Wenn du zufällige Nachrichten verwendest willst, aktiviere die "Zufällige Nachrichten?"-Option, öffne - die [Zufällige Nachrichten](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Frandom-messages)-Konfigurationsdatei + die [Zufällige Nachrichten](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Frandom-messages)-Konfigurationsdatei und [konfigure](#configuration-random-messages) die zufälligen Nachrichten mit dem Nachrichten-Typ " boost" oder "unboost". - * If you want to send the same message every time, use - the [channel configuration](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) - to [configure the message](#configuration-channels). - -### Set up Leave Messages {#setup-leave-messages} - -Leave messages will get send every time a user leaves your server. - -1. Create or select one of your channels in which the bot should send when a member leaves your server. The bot has - to have the "View channel", "Send messages" and "View message history" permissions on it. -2. Add the channel to - the [channel configuration](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) using - the "leave" Message-Type - and [configure it](#configuration-channels). -3. Configure the message: - * If you want to use random messages, enable the "Random messages?" option, open - the [random messages](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Frandom-messages) - configuration file and [configure](#configuration-random-messages) the random messages with the Message-Type " - leave". + * Wenn du jedes mal die gleiche Nachricht senden willst, nutze + die [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels), um die + [Nachricht zu konfigurieren](#configuration-channels). + +### Verlassens-Nachrichten einrichten {#setup-leave-messages} + +Verlassens-Nachrichten werden jedes mal gesendet, wenn ein Nutzer deinen Server verlässt. + +1. Erstelle oder wähle einen deiner Kanäle, in welchen der Bot deine Nachricht schicken soll, wenn ein Nutzer deinen Server verlässt. Der Bot benötigt + die Rechte "Kanal anzeigen" ("View channel"), "Nachrichten senden" ("Send messages") und "Nachrichtenverlauf anzeigen" ("View message history") auf diesen Kanal. +2. Füge den Kanal zur + [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) hinzu, indem du als Kanal-Typ "leave" nutzt und + das Element [konfigurierst](#configuration-channels). +3. Konfiguriere die Nachricht: + * Wenn du zufällige Nachrichten verwenden willst, aktiviere die Option "Zufällige Nachrichten?", öffne die + [Zufällige Nachrichten](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Frandom-messages)- + Konfigurationsdatei und [konfiguriere](#configuration-random-messages) die zufälligen Nachrichten mit dem Nachrichten-Typ + "leave". * Wenn du jedes mal die gleiche Nachricht senden willst, nutze die [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels), um die [Nachricht zu konfigurieren](#configuration-channels). @@ -86,7 +85,7 @@ Dieser Fehler ist bekannt und wird bearbeitet. ## Nutzung {#usage} -Nach dem [Einrichten](#setup) des Moduls werden die Nachrichten automatisch jedes mal gesendet, wenn die Aktion ausgelöst wird. +Nach dem [Einrichten](#setup) des Moduls werden Nachrichten automatisch jedes mal gesendet, wenn die jeweilige Aktion ausgelöst wird. Um Nutzern zu erlauben, einen Willkommen-Button zu benutzen, [aktiviere diese Funktion](#configuration-config) einfach in deiner Konfiguration. Nach dem Einstellen werden neue Nachrichten einen (konfigurierbaren) Knopf haben. Wenn dieser Knopf von einem deiner Mitglieder gedrückt wird, From efc057ba454c813199c5869d474481d909c5603d Mon Sep 17 00:00:00 2001 From: Fridolin Date: Thu, 31 Oct 2024 13:16:21 +0100 Subject: [PATCH 08/14] Update welcomer.md --- .../modules/administration/welcomer.md | 123 +++++++++--------- 1 file changed, 59 insertions(+), 64 deletions(-) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md index 7f21d383..adcdd5e1 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md @@ -8,7 +8,7 @@ Einfaches Modul, um neuen Nutzern "Hi" zu sagen, ihnen Rollen zu geben und um si * Heiße neue Nutzer mit eigenen Nachrichten (und dynamischen Bildern) willkommen. * Verabschiede Nutzer, die deinen Server verlassen. -* Bedanke dich bei Nutzern mit eigenen Nachrichten, die deinen Server geboostet haben und erpresse sie emotional, indem du ihnen eine Nachricht sendest, wenn sie deinen Server entboosten. +* Bedanke dich bei Nutzern mit eigenen Nachrichten, die deinen Server geboostet haben und erpresse sie emotional, indem du ihnen eine Nachricht sendest, wenn sie deinen Server entboosten. * Füge unbegrenzt viele Nachrichten zum Beitritt, Boost oder Verlassen in verschiedenen Kanälen hinzu. * Gebe neuen Nutzern und Boostern automatisch Rollen. * Lasse den Bot zufällige Nachrichten nutzen, um ein wenig Verschiedenheit in deine Willkommens-, Verlassens-, Boost- und Entboost-Nachrichten zu bekommen. @@ -21,28 +21,28 @@ Einfaches Modul, um neuen Nutzern "Hi" zu sagen, ihnen Rollen zu geben und um si Willkommens-Nachrichten werden jedes mal gesendet, wenn ein neuer Nutzer deinem Server betritt. Du kannst einen Willkommen-Button hinzufügen, welcher es bestehenden Nutzern erlaubt, den neuen Nutzer willkommen zu heißen. Zusätzlich wird, falls [aktiviert](#configuration-config), die Nachricht gelöscht, wenn der Nutzer den Server innerhalb von 7 Tagen wieder verlässt. -1. Erstelle oder wähle einen deiner Kanäle, in welchen der Bot deine Nachricht schicken soll, wenn ein Nutzer beitritt. Der Bot benötigt - die Rechte "Kanal anzeigen" ("View channel"), "Nachrichten senden" ("Send messages") und "Nachrichtenverlauf anzeigen" ("View message history") auf diesen Kanal. +1. Erstelle oder wähle einen deiner Kanäle, in welchen der Bot deine Nachricht schicken soll, wenn ein Nutzer beitritt. Der Bot benötigt + die Rechte "Kanal anzeigen" ("View channel"), "Nachrichten senden" ("Send messages") und "Nachrichtenverlauf anzeigen" ("View message history") in diesem Kanal. 2. Füge den Kanal zur - [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) hinzu, indem du als Kanal-Typ "join" nutzt und + [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) hinzu, indem du als Kanal-Typ "join" nutzt und das Element [konfigurierst](#configuration-channels). 3. Konfiguriere die Nachricht: * Wenn du zufällige Nachrichten verwenden willst, aktiviere die Option "Zufällige Nachrichten?", öffne die [Zufällige Nachrichten](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Frandom-messages)- - Konfigurationsdatei und [konfiguriere](#configuration-random-messages) die zufälligen Nachrichten mit dem Nachrichten-Typ + Konfigurationsdatei und [konfiguriere](#configuration-random-messages) die zufälligen Nachrichten mit dem Nachrichten-Typ "join". * Wenn du jedes mal die gleiche Nachricht senden willst, nutze die - [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels), um die + [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels), um die [Nachricht zu konfigurieren](#configuration-channels). ### Boost / Unboost Nachrichten einrichten {#setup-boost-messages} Boost-Nachrichten werden gesendet, wenn ein Nutzer deinen Server *das erste mal* boostet und die Unboost-Nachricht wird gesendet, wenn ein Nutzer *alle seine Boosts* von deinem Server entfernt hat. Aufgrund [Einschränkungen in Discords API]((https://github.com/discord/discord-api-docs/discussions/3228#discussioncomment-1717560)) werden diese Nachrichten nicht gesendet, wenn ein Nutzer die Anzahl seiner Boosts auf deinem Server erhöht oder verringert. -1. Erstelle oder wähle einen deiner Kanäle, in welchen der Bot eine Nachricht schreiben soll, wenn ein Nutzer deinen Server boostet. Der Bot benötigt - die Rechte "Kanal anzeigen" ("View channel"), "Nachrichten senden" ("Send messages") und "Nachrichtenverlauf anzeigen" ("View message history") auf diesen Kanal. +1. Erstelle oder wähle einen deiner Kanäle, in welchen der Bot eine Nachricht schreiben soll, wenn ein Nutzer deinen Server boostet. Der Bot benötigt + die Rechte "Kanal anzeigen" ("View channel"), "Nachrichten senden" ("Send messages") und "Nachrichtenverlauf anzeigen" ("View message history") in diesem Kanal. 2. Füge den Kanal zur - [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) hinzu, indem du + [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) hinzu, indem du den Kanal-Typ "boost" oder "unboost" benutzt und das Element [konfigurierst](#configuration-channels). 3. Konfiguriere die Nachricht: @@ -51,17 +51,17 @@ Boost-Nachrichten werden gesendet, wenn ein Nutzer deinen Server *das erste mal* und [konfigure](#configuration-random-messages) die zufälligen Nachrichten mit dem Nachrichten-Typ " boost" oder "unboost". * Wenn du jedes mal die gleiche Nachricht senden willst, nutze - die [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels), um die + die [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels), um die [Nachricht zu konfigurieren](#configuration-channels). ### Verlassens-Nachrichten einrichten {#setup-leave-messages} Verlassens-Nachrichten werden jedes mal gesendet, wenn ein Nutzer deinen Server verlässt. -1. Erstelle oder wähle einen deiner Kanäle, in welchen der Bot deine Nachricht schicken soll, wenn ein Nutzer deinen Server verlässt. Der Bot benötigt - die Rechte "Kanal anzeigen" ("View channel"), "Nachrichten senden" ("Send messages") und "Nachrichtenverlauf anzeigen" ("View message history") auf diesen Kanal. +1. Erstelle oder wähle einen deiner Kanäle, in welchen der Bot deine Nachricht schicken soll, wenn ein Nutzer deinen Server verlässt. Der Bot benötigt + die Rechte "Kanal anzeigen" ("View channel"), "Nachrichten senden" ("Send messages") und "Nachrichtenverlauf anzeigen" ("View message history") auf diesen Kanal. 2. Füge den Kanal zur - [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) hinzu, indem du als Kanal-Typ "leave" nutzt und + [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) hinzu, indem du als Kanal-Typ "leave" nutzt und das Element [konfigurierst](#configuration-channels). 3. Konfiguriere die Nachricht: * Wenn du zufällige Nachrichten verwenden willst, aktiviere die Option "Zufällige Nachrichten?", öffne die @@ -76,7 +76,7 @@ Verlassens-Nachrichten werden jedes mal gesendet, wenn ein Nutzer deinen Server :::caution Momentan werden Beitritts-Rollen Rollen, die sich Nutzer selbst über -Discords Einführung gegeben haben, überschreiben oder entfernen. +Discords Einführung gegeben haben, überschrieben oder entfernt. Dieser Fehler ist bekannt und wird bearbeitet. ::: @@ -98,9 +98,7 @@ Dieses Modul ist in mehrere Konfigurationsdateien unteteilt. Du kannst diese wei ### Kanäle {#configuration-channels} -In this configuration file, you can set up the channels in which this module is supposed to operate in and allows -configuration of these channels. Open it in -your [dashboard](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels). +In dieser Konfigurationsdatei kannst du die Kanäle einrichten und konfigurieren, in denen das Modul funktionieren soll. Öffne sie in deinem [Dashboard](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels). :::info This configuration file uses "Config-Elements". One Config-Element represents each channel that should receive messages @@ -110,35 +108,33 @@ send different event types in the same channel. Each Channel has the following configuration options: -| Field | Description | -|-----------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| Channel | This is the channel the message will get sent in. | -| Channel-Type | Depending on this value, this particular Config-Element will represent the configuration for a specific event type (see [setup](#setup). The following options are available:
  • join: This Config-Element will be applied when a new member joins your server.
  • leave: This Config-Element will be applied when a member leaves your server.
  • boost: This Config-Element will be applied when a member boosts your server for the first time.
  • unboost: This Config-Element will be applied when a member removes their last boost from your server.
| -| Random messages | If this option is enabled, the "Message" value will *NOT* be applied. Instead, a [random message](#configuration-random-messages) with the same Channel-Type will get sent randomly. | -| Message | This will be the message sent in this channel, if "Random messages" is not enabled. This option [supports dynamic image generation](https://sc-net.work/imgen) to make your messages even more pretty ✨. | -| Welcome Button | *This option is only available, when "Channel Type" is set to "join"*
If enabled, a button will get added below each message. One other member can then click on this button, which will trigger the configured message to be sent. | -| Welcome Button Content | *Only visible if "Welcome Button" is enabled.*
This will be the content of the button added below messages. The value needs to be less than 100 characters. | -| Channel in which the welcome-button should send a message | *Only visible if "Welcome Button" is enabled.*
This is the channel the welcome message will get sent in once another member presses the welcome button. | -| Welcome Button Message | *Only visible if "Welcome Button" is enabled.*
This is the message that gets sent in the configured channel when another member presses the welcome button. | +| Feld | Beschreibung | +|------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Kanal | Das ist der Kanal, in welchen die Nachricht gesendet wird. | +| Kanal-Typ | Abhängig von diesem Wert wird das Config-Element die Konfiguration für ein bestimmten Event-Typ wiederspiegeln (siehe [Einrichtung](#setup). Die folgenden Optionen sind verfügbar:
  • join: Dieses Config-Element wird angewandt, wenn ein neues Mitglied deinem Server beitritt.
  • leave: Dieses Config-Element wird angewandt, wenn ein Mitglied deinen Server verlässt.
  • boost: Dieses Config-Element wird angewandt, wenn ein Mitglied deinen Server zum ersten Mal boostet.
  • unboost: Dieses Config-Element wird angewandt, wenn ein Mitglied seinen letzten Boost von deinem Server entfernt.
| +| Zufällige Nachrichten? | Wenn diese Option aktivert ist, wird der Wert "Nachricht" *NICHT* genutzt. Stattdessen wird eine der [zufälligen Nachrichten](#configuration-random-messages) mit dem selben Kanal-Typ gesendet. | +| Nachricht | Das ist die in den Kanal gesendete Nachricht, wenn "Zufällige Nachrichten?" nicht aktiviert ist. Diese Option [unterstützt dynamische Bildgeneration](https://sc-net.work/imgen), um deine Nachrichten noch schöner zu machen✨. | +| Willkommens-Knopf | *Diese Option ist nur verfügbar, wenn "Kanal-Typ" auf "join" gesetzt ist*
Wenn aktviert wird unter jede Nachricht ein Knopf angehangen. Ein anderes Mitglied kann diesen Knopf drücken, worauf die konfigurierte Nachricht gesendet wird. | +| Willkommens-Knopf-Inhalt | *Nur sichtbar, wenn "Willkommens-Knopf" aktiviert ist.*
Das ist der Inhalt des unter die Nachricht angehangenen Knopfs. Dieser Wert muss kürzer als 100 Zeichen sein. | +| Kanal, in welchen der Willkommensknopf die Nachricht senden soll | *Nur sichtbar, wenn "Willkommens-Knopf" aktiviert ist.*
Das ist der Kanal, in den die Willkommens-Knopf-Nachricht gesendet wird, wenn ein anderes Mitglied den Willkommens-Knopf drückt. | +| Willkommens-Knopf-Nachricht | *Nur sichtbar, wenn "Willkommens-Knopf" aktiviert ist.*
Das ist die in den konfigurierten Kanal gesendete Nachricht, wenn ein anderes Mitglied den Willkommens-Knopf drückt. | -### Module configuration {#configuration-config} +### Modul-Konfiguration {#configuration-config} -In this configuration file allows you to [set up welcome- and boost roles](#setup-join-roles) and configure other basic -features of this module. Open it in -your [dashboard](https://scnx.app/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fconfig). +Diese Konfigurationsdatei erlaubt es dir, [Willkommen- und Boost-Rollen einzurichten](#setup-join-roles) und andere grundlegende Funktionen dieses Moduls zu konfigurieren. Öffne sie +in deinem [Dashboard](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fconfig). -| Field | Description | -|--------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| Give roles on join | These roles will be given to members who joined your server. This won't get applied retroactively, use the [massrole module](./../tools/massrole) to do this. | -| Ignore bots? | If enabled (this is highly recommended), welcome and leave messages won't get sent if the user joining or leaving is a bot. | -| Give additional roles on boost | These roles will be given to members who boosted your server in addition to their boost-role assigned by Discord. The roles will get removed if the member removes all their boosts. | -| Delete welcome message | If enabled, sent welcome messages will get deleted automatically if the user leaves your server within seven days after join. | +| Feld | Beschreibung | +|-------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Nutzern Rollen beim Beitreten geben | Diese Rollen werden Mitgliedern gegeben, die deinem Server beitreten. Das wird nicht rückwirkend angewandt, nutze dafür das [Massrole-Modul](./../tools/massrole). | +| Bots ignorieren? | Wenn aktiviert (und das ist sehr empfehlenswert), werden keine Willkommens- und Verlassensnachrichten verschickt, wenn das Mitglied ein Bot ist. | +| Zusätzliche Rollen beim Boost geben | Diese Rollen werden einem Mitglied zusätzlich zu der von Discord vergebenen Boost-Rolle gegeben, wenn es deinen Server boostet. Die Rollen werden entfernt, wenn das Mitglied all seine Boosts entfernt. | +| Willkommensnachricht löschen | Wenn aktiviert werden Willkommensnachrichten automatisch gelöscht, wenn das Mitglied deinen Server innerhalb von sieben Tagen wieder verlässt. | -### Random messages {#configuration-random-messages} +### Zufällige Nachrichten {#configuration-random-messages} -This configuration file will get used if a [configured channel](#configuration-channels) uses the "Random messages" -option. In this case, the bot will randomly select one of the messages configured in this file with the same type as -configured in the channel. +Diese Konfigurationsdatei wird genutzt, wenn ein [konfigurierter Kanal](#configuration-channels) die "Zufällige Nachrichten?"- +Option nutzt. In diesem Fall wird der Bot zufällig eine der in dieser Datei konfigurierten Nachrichten mit dem selben Kanal-Typ auswählen. :::info This configuration file uses "Config-Elements". One Config-Element represents a message which a specified type. @@ -146,52 +142,51 @@ When [a channel](#configuration-channels) uses the "Random messages" option, a r get selected. ::: -| Field | Description | -|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| Message-Type | *see the "Channel-Type" option in the [channel configuration](#configuration-channels).* | -| Message | This is the message that gets send if this message object will get selected randomly. This option [supports dynamic image generation](https://sc-net.work/imgen) to make your messages even more pretty ✨. | +| Feld | Beschreibung | +|----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Nachricht-Typ | *Schau dir dazu "Kanal-Typ" in der [Kanal-Konfiguration](#configuration-channels) an.* | +| Nachricht | Das ist die Nachricht, die versendet wird, wenn dieses Nachrichtenobjekt zufällig ausgewählt wird. Diese Option [unterstützt dynamische Bildgeneration](https://sc-net.work/imgen), um deine Nachrichten noch schöner zu machen✨. | -## Troubleshooting {#troubleshooting} +## Fehlerbehebung {#troubleshooting} -This module is notoriously trick to troubleshoot, as its highly flexible and customizable design introduces a -complicated configuration structure. If none of the steps below help (please try them first!), you can always reach out -to our friendly staff at [scnx.app/help](https://scnx.app/help). +Dieses Modul ist bekanntermaßen schwierig zu beheben, da sein hochflexibles und anpassbares Design eine komplizierte Konfigurationsstruktur mit sich bringt. +Wenn keinder der Schritte hierunter hilft (bitte probiere das zuerst!), kannst du jederzeit unsere +freundlichen Teammitglieder über [scnx.app/help](https://scnx.app/help) kontaktieren.
- A message is not being sent or the message is "Message not found". + Eine Nachricht wird nicht gesendet oder der Inhalt der Nachricht ist "Message not found".
    -
  • Make sure your bot has the "View channel", "Send messages" and "View message history" permissions on the configured channel.
    • +
  • Stelle sicher, dass der Bot die Berechtigungen "Kanal anzeigen" ("View channel"), "Nachrichten senden" ("Send messages") und "Nachrichtenverlauf anzeigen" ("View message history") im konfigurierten Kanal besitzt.
  • Make sure a correct channel entry is set up of the correct channel and correct event type.
    • -
  • If you are using Random Messages: Make sure at least one random message is configured for this event-type. The message in the channel entry will be ignored.
    • -
  • If you are not using Random Messages: Make sure you have configured a valid message in your channel entry.
    • +
  • Wenn du zufällige Nachrichten nutzt: Stelle sicher, dass mindenstens eine zufällige Nachricht für diesen Event-Typ konfiguriert ist. Die Nachricht in der Kanal-Konfiguration wird ignoriert.
    • +
  • Wenn du zufällige Nachrichten nicht nutzt: Stelle sicher, dass du eine gültige Nachricht in der Kanal-Konfiguration konfiguriert hast.
- I am experiencing issues with a dynamically generated image. + Ich habe Probleme mit einem dynamischen Bild. - Please visit sc-net.work/imgen, as shown in the error image. + Bitte schaue dir, wie im Fehlerbild angzeigt, sc-net.work/imgen an.
- No message is being sent when a user adds another boost to their existing server boost. + Es wird keine Nachricht gesendet, wenn ein Mitglied meinen Server ein weiteres Mal boostet. - This happens due to a Discord API limitation. We cannot change this behavior. + Das liegt an einer Discord API Limitation. Wir können daran nichts ändern.
## Gespeicherte Daten {#data-usage} -The following data will get stored for every configured welcome messsage every time when a new member joins: +Die folgenden Daten werden über jede konfigurierte Willkommensnachricht jedes mal gespeichert, wenn ein Mitglied deinem Server beitritt: -* An unique integer identifying the database entry +* Eine eindeutige ID, die den Datenbankeintrag identifiziert * Die einzigartige Discord Nutzer-ID des Nutzers, der deinem Server beigetreten ist und die Willkommens-Nachricht ausgelöst hat * Die einzigartige Discord Nachrichten-ID der Willkommens-Nachricht, die vom Bot gesendet wurde * Die einzigartige Discord Kanal-ID des Kanals, in welchen der Bot die Willkommens-Nachricht geschrieben hat * Der genaue Zeitpunkt, wann der Nutzer deinem Server beigetreten ist -* Metadata about the entry (date when created and last updated) +* Metadaten zum Eintrag (Datum der Erstellung und letzten Aktualisierung) -This data will get used to delete the sent welcome messages if the user leaves the server within seven days after -joins (if [enabled](#configuration-config)). There is no way to stop the bot from storing data (as toggling this feature -should be retroactive), but the data won't get used unless the feature is enabled. +Diese Daten werden genutzt, um gesendete Willkommensnachrichten wieder zu löschen, wenn ein Nutzer den Server innerhalb von sieben Tagen nach dem Beitreten wieder verlässt (falls [aktviert](#configuration-config)). Es gibt keinen Weg, den Bot davon abzuhalten, diese Daten zu speichern (falls die Funktion im Nachhinein aktiviert wird), +aber die Daten werden nicht genutzt, bis die Funktion aktiviert ist. -To remove all data, [purge the module database](./../../additional-features#reset-module-database). +Um alle Daten zu löschen, [lösche die Moduldatenbank](./../../additional-features#reset-module-database). From 518049bc9c486df2ca6f4253f6546d89f0824cfa Mon Sep 17 00:00:00 2001 From: Fridolin Date: Thu, 31 Oct 2024 14:05:26 +0100 Subject: [PATCH 09/14] Update welcomer.md --- .../custom-bot/modules/administration/welcomer.md | 13 +++++-------- 1 file changed, 5 insertions(+), 8 deletions(-) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md index adcdd5e1..c524fcf0 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md @@ -1,6 +1,6 @@ # Willkommen und Boosts -Einfaches Modul, um neuen Nutzern "Hi" zu sagen, ihnen Rollen zu geben und um sich bei Nutzern, die deinen Server geboostet haben, zu bedanken. +Einfaches Modul, um neuen Nutzern "Hi" zu sagen, ihnen Rollen zu geben und um sich bei Nutzern, die deinen Server boosten, zu bedanken. @@ -101,12 +101,10 @@ Dieses Modul ist in mehrere Konfigurationsdateien unteteilt. Du kannst diese wei In dieser Konfigurationsdatei kannst du die Kanäle einrichten und konfigurieren, in denen das Modul funktionieren soll. Öffne sie in deinem [Dashboard](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels). :::info -This configuration file uses "Config-Elements". One Config-Element represents each channel that should receive messages -when a supported event is triggered. You can add a channel multiple times, this is especially required if you want to -send different event types in the same channel. +Diese Konfigurationsdatei nutzt "Config-Elemente". Ein Config-Element repräsentiert einen Kanal, in den Nachrichten geschickt werden sollen, wenn eine Aktion ausgelöst wird. Du kannst einen Kanal mehrmals hinzufügen, das ist vor allem notwendig wenn du verschiedene Event-Typen in den selben Kanal senden willst.l. ::: -Each Channel has the following configuration options: +Jeder Kanal hat die folgenden Konfigurationsoptionen: | Feld | Beschreibung | |------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -137,9 +135,8 @@ Diese Konfigurationsdatei wird genutzt, wenn ein [konfigurierter Kanal](#configu Option nutzt. In diesem Fall wird der Bot zufällig eine der in dieser Datei konfigurierten Nachrichten mit dem selben Kanal-Typ auswählen. :::info -This configuration file uses "Config-Elements". One Config-Element represents a message which a specified type. -When [a channel](#configuration-channels) uses the "Random messages" option, a random message with the same type will -get selected. +Diese Konfigurationsdatei nutzt "Config-Elemente". Ein Config-Element repräsentiert eine Nachricht mit einem bestimmten Typ. Wenn [ein Kanal](#configuration-channels) die "Zufällige Nachrichten?" Option nutzt, wird eine zufällige Nachricht mit dem selben Typ ausgewählt. + ::: | Feld | Beschreibung | From a4f761fc34ced7989c9975eef9e06161730b839d Mon Sep 17 00:00:00 2001 From: Fridolin Date: Thu, 31 Oct 2024 14:06:06 +0100 Subject: [PATCH 10/14] Update partner-list.md --- .../current/custom-bot/modules/administration/partner-list.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/partner-list.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/partner-list.md index c20a197e..3b4d5d02 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/partner-list.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/partner-list.md @@ -94,4 +94,4 @@ deinem [Dashboard](https://scnx.app/de/glink?page=bot/configuration?file=partner * Metadaten zum Eintrag (Datum der Erstellung und letzten Aktualisierung) Um gespeicherte Daten zu löschen, verwende [`/partner delete`](#commands) -oder [Moduldatenbank löschen](./../../additional-features#reset-module-database). \ No newline at end of file +oder [lösche die Moduldatenbank](./../../additional-features#reset-module-database). From 24d93c5907c606596b37178d979709ddaf809a6a Mon Sep 17 00:00:00 2001 From: Fridolin Date: Sun, 17 Nov 2024 20:22:59 +0100 Subject: [PATCH 11/14] Apply suggestions from code review MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit sorry for the empty spaces😥 Co-authored-by: Simon --- .../modules/administration/welcomer.md | 56 +++++++++---------- 1 file changed, 28 insertions(+), 28 deletions(-) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md index c524fcf0..349d0337 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md @@ -11,57 +11,57 @@ Einfaches Modul, um neuen Nutzern "Hi" zu sagen, ihnen Rollen zu geben und um si * Bedanke dich bei Nutzern mit eigenen Nachrichten, die deinen Server geboostet haben und erpresse sie emotional, indem du ihnen eine Nachricht sendest, wenn sie deinen Server entboosten. * Füge unbegrenzt viele Nachrichten zum Beitritt, Boost oder Verlassen in verschiedenen Kanälen hinzu. * Gebe neuen Nutzern und Boostern automatisch Rollen. -* Lasse den Bot zufällige Nachrichten nutzen, um ein wenig Verschiedenheit in deine Willkommens-, Verlassens-, Boost- und Entboost-Nachrichten zu bekommen. -* Lösche automatisch Willkommens-Nachrichten von Nutzern, die deinen Server innerhalb von 7 Tagen wieder verlassen haben. +* Lasse den Bot zufällige Nachrichten nutzen, um ein wenig Abwechslung in deine Willkommens-, Verlassens-, Boost- und Entboost-Nachrichten zu bekommen. +* Lösche automatisch Willkommens-Nachrichten von Nutzern, die deinen Server innerhalb von 7 Tagen wieder verlassen. * Füge einen Button unter Willkommens-Nachrichten hinzu, der es deinen bestehenden Nutzern erlaubt, Mitglieder willkommen zu heißen. ## Einrichtung {#setup} ### Willkommens-Nachricht einrichten {#setup-welcome-messages} -Willkommens-Nachrichten werden jedes mal gesendet, wenn ein neuer Nutzer deinem Server betritt. Du kannst einen Willkommen-Button hinzufügen, welcher es bestehenden Nutzern erlaubt, den neuen Nutzer willkommen zu heißen. Zusätzlich wird, falls [aktiviert](#configuration-config), die Nachricht gelöscht, wenn der Nutzer den Server innerhalb von 7 Tagen wieder verlässt. +Willkommens-Nachrichten werden jedes mal gesendet, wenn ein neuer Nutzer deinem Server betritt. Du kannst einen Willkommens-Knopf hinzufügen, welcher es bestehenden Nutzern erlaubt, den neuen Nutzer willkommen zu heißen. Zusätzlich wird, falls [aktiviert](#configuration-config), die Nachricht gelöscht, wenn der Nutzer den Server innerhalb von 7 Tagen wieder verlässt. -1. Erstelle oder wähle einen deiner Kanäle, in welchen der Bot deine Nachricht schicken soll, wenn ein Nutzer beitritt. Der Bot benötigt - die Rechte "Kanal anzeigen" ("View channel"), "Nachrichten senden" ("Send messages") und "Nachrichtenverlauf anzeigen" ("View message history") in diesem Kanal. +1. Erstelle oder wähle einen deiner Kanäle, in welchen der Bot deine Nachricht schicken soll, wenn ein Nutzer beitritt. Der Bot benötigt + die Rechte "Kanal anzeigen" ("View channel"), "Nachrichten senden" ("Send messages") und "Nachrichtenverlauf anzeigen" ("View message history") in diesem Kanal. 2. Füge den Kanal zur - [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) hinzu, indem du als Kanal-Typ "join" nutzt und + [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) hinzu, indem du als Kanal-Typ "join" nutzt und das Element [konfigurierst](#configuration-channels). 3. Konfiguriere die Nachricht: * Wenn du zufällige Nachrichten verwenden willst, aktiviere die Option "Zufällige Nachrichten?", öffne die [Zufällige Nachrichten](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Frandom-messages)- - Konfigurationsdatei und [konfiguriere](#configuration-random-messages) die zufälligen Nachrichten mit dem Nachrichten-Typ + Konfigurationsdatei und [konfiguriere](#configuration-random-messages) die zufälligen Nachrichten mit dem Nachrichten-Typ "join". * Wenn du jedes mal die gleiche Nachricht senden willst, nutze die - [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels), um die + [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels), um die [Nachricht zu konfigurieren](#configuration-channels). ### Boost / Unboost Nachrichten einrichten {#setup-boost-messages} Boost-Nachrichten werden gesendet, wenn ein Nutzer deinen Server *das erste mal* boostet und die Unboost-Nachricht wird gesendet, wenn ein Nutzer *alle seine Boosts* von deinem Server entfernt hat. Aufgrund [Einschränkungen in Discords API]((https://github.com/discord/discord-api-docs/discussions/3228#discussioncomment-1717560)) werden diese Nachrichten nicht gesendet, wenn ein Nutzer die Anzahl seiner Boosts auf deinem Server erhöht oder verringert. -1. Erstelle oder wähle einen deiner Kanäle, in welchen der Bot eine Nachricht schreiben soll, wenn ein Nutzer deinen Server boostet. Der Bot benötigt - die Rechte "Kanal anzeigen" ("View channel"), "Nachrichten senden" ("Send messages") und "Nachrichtenverlauf anzeigen" ("View message history") in diesem Kanal. +1. Erstelle oder wähle einen deiner Kanäle, in welchen der Bot eine Nachricht schreiben soll, wenn ein Nutzer deinen Server boostet. Der Bot benötigt + die Rechte "Kanal anzeigen" ("View channel"), "Nachrichten senden" ("Send messages") und "Nachrichtenverlauf anzeigen" ("View message history") in diesem Kanal. 2. Füge den Kanal zur - [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) hinzu, indem du + [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) hinzu, indem du den Kanal-Typ "boost" oder "unboost" benutzt und das Element [konfigurierst](#configuration-channels). 3. Konfiguriere die Nachricht: * Wenn du zufällige Nachrichten verwendest willst, aktiviere die "Zufällige Nachrichten?"-Option, öffne die [Zufällige Nachrichten](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Frandom-messages)-Konfigurationsdatei - und [konfigure](#configuration-random-messages) die zufälligen Nachrichten mit dem Nachrichten-Typ " - boost" oder "unboost". + und [konfiguriere](#configuration-random-messages) die zufälligen Nachrichten mit dem Nachrichten-Typ + "boost" oder "unboost". * Wenn du jedes mal die gleiche Nachricht senden willst, nutze - die [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels), um die + die [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels), um die [Nachricht zu konfigurieren](#configuration-channels). ### Verlassens-Nachrichten einrichten {#setup-leave-messages} Verlassens-Nachrichten werden jedes mal gesendet, wenn ein Nutzer deinen Server verlässt. -1. Erstelle oder wähle einen deiner Kanäle, in welchen der Bot deine Nachricht schicken soll, wenn ein Nutzer deinen Server verlässt. Der Bot benötigt - die Rechte "Kanal anzeigen" ("View channel"), "Nachrichten senden" ("Send messages") und "Nachrichtenverlauf anzeigen" ("View message history") auf diesen Kanal. +1. Erstelle oder wähle einen deiner Kanäle, in welchen der Bot deine Nachricht schicken soll, wenn ein Nutzer deinen Server verlässt. Der Bot benötigt + die Rechte "Kanal anzeigen" ("View channel"), "Nachrichten senden" ("Send messages") und "Nachrichtenverlauf anzeigen" ("View message history") auf diesen Kanal. 2. Füge den Kanal zur - [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) hinzu, indem du als Kanal-Typ "leave" nutzt und + [Kanal-Konfiguration](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels) hinzu, indem du als Kanal-Typ "leave" nutzt und das Element [konfigurierst](#configuration-channels). 3. Konfiguriere die Nachricht: * Wenn du zufällige Nachrichten verwenden willst, aktiviere die Option "Zufällige Nachrichten?", öffne die @@ -87,8 +87,8 @@ Dieser Fehler ist bekannt und wird bearbeitet. Nach dem [Einrichten](#setup) des Moduls werden Nachrichten automatisch jedes mal gesendet, wenn die jeweilige Aktion ausgelöst wird. -Um Nutzern zu erlauben, einen Willkommen-Button zu benutzen, [aktiviere diese Funktion](#configuration-config) einfach in deiner Konfiguration. -Nach dem Einstellen werden neue Nachrichten einen (konfigurierbaren) Knopf haben. Wenn dieser Knopf von einem deiner Mitglieder gedrückt wird, +Um Nutzern zu erlauben, einen Willkommens-Knopf zu benutzen, [aktiviere diese Funktion](#configuration-config) einfach in deiner Konfiguration. +Nach dem Einstellen wird unter neuen Nachrichten ein (konfigurierbarer) Knopf angezeigt. Wenn dieser Knopf von einem deiner Mitglieder gedrückt wird, wird er inaktiv (= kann nicht mehr gedrückt werden) und eine [konfigurierbare](#configuration-config) Nachricht wird in den konfigurierten Kanal gesendet. @@ -101,7 +101,7 @@ Dieses Modul ist in mehrere Konfigurationsdateien unteteilt. Du kannst diese wei In dieser Konfigurationsdatei kannst du die Kanäle einrichten und konfigurieren, in denen das Modul funktionieren soll. Öffne sie in deinem [Dashboard](https://scnx.app/de/glink?page=bot/configuration?file=welcomer%7Cconfigs%2Fchannels). :::info -Diese Konfigurationsdatei nutzt "Config-Elemente". Ein Config-Element repräsentiert einen Kanal, in den Nachrichten geschickt werden sollen, wenn eine Aktion ausgelöst wird. Du kannst einen Kanal mehrmals hinzufügen, das ist vor allem notwendig wenn du verschiedene Event-Typen in den selben Kanal senden willst.l. +Diese Konfigurationsdatei nutzt "Config-Elemente". Ein Config-Element repräsentiert einen Kanal, in den Nachrichten geschickt werden sollen, wenn eine Aktion ausgelöst wird. Du kannst einen Kanal mehrmals hinzufügen, das ist vor allem notwendig wenn du verschiedene Event-Typen in den selben Kanal senden willst. ::: Jeder Kanal hat die folgenden Konfigurationsoptionen: @@ -110,10 +110,10 @@ Jeder Kanal hat die folgenden Konfigurationsoptionen: |------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Kanal | Das ist der Kanal, in welchen die Nachricht gesendet wird. | | Kanal-Typ | Abhängig von diesem Wert wird das Config-Element die Konfiguration für ein bestimmten Event-Typ wiederspiegeln (siehe [Einrichtung](#setup). Die folgenden Optionen sind verfügbar:
  • join: Dieses Config-Element wird angewandt, wenn ein neues Mitglied deinem Server beitritt.
  • leave: Dieses Config-Element wird angewandt, wenn ein Mitglied deinen Server verlässt.
  • boost: Dieses Config-Element wird angewandt, wenn ein Mitglied deinen Server zum ersten Mal boostet.
  • unboost: Dieses Config-Element wird angewandt, wenn ein Mitglied seinen letzten Boost von deinem Server entfernt.
| -| Zufällige Nachrichten? | Wenn diese Option aktivert ist, wird der Wert "Nachricht" *NICHT* genutzt. Stattdessen wird eine der [zufälligen Nachrichten](#configuration-random-messages) mit dem selben Kanal-Typ gesendet. | +| Zufällige Nachrichten? | Wenn diese Option aktiviert ist, wird der Wert "Nachricht" *NICHT* genutzt. Stattdessen wird eine der [zufälligen Nachrichten](#configuration-random-messages) mit dem selben Kanal-Typ gesendet. | | Nachricht | Das ist die in den Kanal gesendete Nachricht, wenn "Zufällige Nachrichten?" nicht aktiviert ist. Diese Option [unterstützt dynamische Bildgeneration](https://sc-net.work/imgen), um deine Nachrichten noch schöner zu machen✨. | -| Willkommens-Knopf | *Diese Option ist nur verfügbar, wenn "Kanal-Typ" auf "join" gesetzt ist*
Wenn aktviert wird unter jede Nachricht ein Knopf angehangen. Ein anderes Mitglied kann diesen Knopf drücken, worauf die konfigurierte Nachricht gesendet wird. | -| Willkommens-Knopf-Inhalt | *Nur sichtbar, wenn "Willkommens-Knopf" aktiviert ist.*
Das ist der Inhalt des unter die Nachricht angehangenen Knopfs. Dieser Wert muss kürzer als 100 Zeichen sein. | +| Willkommens-Knopf | *Diese Option ist nur verfügbar, wenn "Kanal-Typ" auf "join" gesetzt ist*
Wenn aktiviert wird unter jede Nachricht ein Knopf angehangen. Ein anderes Mitglied kann diesen Knopf drücken, worauf die konfigurierte Nachricht gesendet wird. | +| Willkommens-Knopf-Inhalt | *Nur sichtbar, wenn "Willkommens-Knopf" aktiviert ist.*
Das ist der Inhalt des unter die Nachricht angehängten Knopfs. Dieser Wert muss kürzer als 100 Zeichen sein. | | Kanal, in welchen der Willkommensknopf die Nachricht senden soll | *Nur sichtbar, wenn "Willkommens-Knopf" aktiviert ist.*
Das ist der Kanal, in den die Willkommens-Knopf-Nachricht gesendet wird, wenn ein anderes Mitglied den Willkommens-Knopf drückt. | | Willkommens-Knopf-Nachricht | *Nur sichtbar, wenn "Willkommens-Knopf" aktiviert ist.*
Das ist die in den konfigurierten Kanal gesendete Nachricht, wenn ein anderes Mitglied den Willkommens-Knopf drückt. | @@ -132,10 +132,10 @@ in deinem [Dashboard](https://scnx.app/de/glink?page=bot/configuration?file=welc ### Zufällige Nachrichten {#configuration-random-messages} Diese Konfigurationsdatei wird genutzt, wenn ein [konfigurierter Kanal](#configuration-channels) die "Zufällige Nachrichten?"- -Option nutzt. In diesem Fall wird der Bot zufällig eine der in dieser Datei konfigurierten Nachrichten mit dem selben Kanal-Typ auswählen. +Option nutzt. In diesem Fall wird der Bot zufällig eine der in dieser Datei konfigurierten Nachrichten des selben Kanal-Typs auswählen. :::info -Diese Konfigurationsdatei nutzt "Config-Elemente". Ein Config-Element repräsentiert eine Nachricht mit einem bestimmten Typ. Wenn [ein Kanal](#configuration-channels) die "Zufällige Nachrichten?" Option nutzt, wird eine zufällige Nachricht mit dem selben Typ ausgewählt. +Diese Konfigurationsdatei nutzt "Config-Elemente". Ein Config-Element repräsentiert eine Nachricht mit einem bestimmten Typ. Wenn [ein Kanal](#configuration-channels) die "Zufällige Nachrichten?" Option nutzt, wird eine zufällige Nachricht des selben Typs ausgewählt. ::: @@ -148,7 +148,7 @@ Diese Konfigurationsdatei nutzt "Config-Elemente". Ein Config-Element repräsent Dieses Modul ist bekanntermaßen schwierig zu beheben, da sein hochflexibles und anpassbares Design eine komplizierte Konfigurationsstruktur mit sich bringt. Wenn keinder der Schritte hierunter hilft (bitte probiere das zuerst!), kannst du jederzeit unsere -freundlichen Teammitglieder über [scnx.app/help](https://scnx.app/help) kontaktieren. +freundlichen Teammitglieder über [scnx.app/de/help](https://scnx.app/help) kontaktieren.
Eine Nachricht wird nicht gesendet oder der Inhalt der Nachricht ist "Message not found". @@ -163,7 +163,7 @@ freundlichen Teammitglieder über [scnx.app/help](https://scnx.app/help) kontakt
Ich habe Probleme mit einem dynamischen Bild. - Bitte schaue dir, wie im Fehlerbild angzeigt, sc-net.work/imgen an. + Bitte schaue dir, wie im Fehlerbild angezeigt, scootk.it/imgen an.
@@ -183,7 +183,7 @@ Die folgenden Daten werden über jede konfigurierte Willkommensnachricht jedes m * Der genaue Zeitpunkt, wann der Nutzer deinem Server beigetreten ist * Metadaten zum Eintrag (Datum der Erstellung und letzten Aktualisierung) -Diese Daten werden genutzt, um gesendete Willkommensnachrichten wieder zu löschen, wenn ein Nutzer den Server innerhalb von sieben Tagen nach dem Beitreten wieder verlässt (falls [aktviert](#configuration-config)). Es gibt keinen Weg, den Bot davon abzuhalten, diese Daten zu speichern (falls die Funktion im Nachhinein aktiviert wird), +Diese Daten werden genutzt, um gesendete Willkommensnachrichten wieder zu löschen, wenn ein Nutzer den Server innerhalb von sieben Tagen nach dem Beitreten wieder verlässt (falls [aktiviert](#configuration-config)). Es gibt keinen Weg, den Bot davon abzuhalten, diese Daten zu speichern (falls die Funktion im Nachhinein aktiviert wird), aber die Daten werden nicht genutzt, bis die Funktion aktiviert ist. Um alle Daten zu löschen, [lösche die Moduldatenbank](./../../additional-features#reset-module-database). From 81c723c0ae202e17bc4ece48b810d6befe752c06 Mon Sep 17 00:00:00 2001 From: Fridolin Date: Sun, 17 Nov 2024 20:27:02 +0100 Subject: [PATCH 12/14] Update i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md Co-authored-by: Simon --- .../current/custom-bot/modules/administration/welcomer.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md index 349d0337..e64794b3 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md @@ -147,7 +147,7 @@ Diese Konfigurationsdatei nutzt "Config-Elemente". Ein Config-Element repräsent ## Fehlerbehebung {#troubleshooting} Dieses Modul ist bekanntermaßen schwierig zu beheben, da sein hochflexibles und anpassbares Design eine komplizierte Konfigurationsstruktur mit sich bringt. -Wenn keinder der Schritte hierunter hilft (bitte probiere das zuerst!), kannst du jederzeit unsere +Wenn keiner der der Schritte hierunter hilft (bitte probiere das zuerst!), kannst du jederzeit unsere freundlichen Teammitglieder über [scnx.app/de/help](https://scnx.app/help) kontaktieren.
From 0b15d403aad36fc2b8c0f7a02834243827220379 Mon Sep 17 00:00:00 2001 From: Fridolin Date: Mon, 18 Nov 2024 19:55:28 +0100 Subject: [PATCH 13/14] Update welcomer.md --- .../current/custom-bot/modules/administration/welcomer.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md index e64794b3..18a7cec6 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md @@ -148,13 +148,13 @@ Diese Konfigurationsdatei nutzt "Config-Elemente". Ein Config-Element repräsent Dieses Modul ist bekanntermaßen schwierig zu beheben, da sein hochflexibles und anpassbares Design eine komplizierte Konfigurationsstruktur mit sich bringt. Wenn keiner der der Schritte hierunter hilft (bitte probiere das zuerst!), kannst du jederzeit unsere -freundlichen Teammitglieder über [scnx.app/de/help](https://scnx.app/help) kontaktieren. +freundlichen Teammitglieder über [scnx.app/de/help](https://scnx.app/de/help) kontaktieren.
Eine Nachricht wird nicht gesendet oder der Inhalt der Nachricht ist "Message not found".
  • Stelle sicher, dass der Bot die Berechtigungen "Kanal anzeigen" ("View channel"), "Nachrichten senden" ("Send messages") und "Nachrichtenverlauf anzeigen" ("View message history") im konfigurierten Kanal besitzt.
    • -
  • Make sure a correct channel entry is set up of the correct channel and correct event type.
    • +
  • Stelle sicher, dass ein Kanal-Element mit dem richtigen Kanal und Event-Typ eingerichtet ist.
  • Wenn du zufällige Nachrichten nutzt: Stelle sicher, dass mindenstens eine zufällige Nachricht für diesen Event-Typ konfiguriert ist. Die Nachricht in der Kanal-Konfiguration wird ignoriert.
  • Wenn du zufällige Nachrichten nicht nutzt: Stelle sicher, dass du eine gültige Nachricht in der Kanal-Konfiguration konfiguriert hast.
From 3da7110b4f16c220196a37a94bc6bf8da8b4db0e Mon Sep 17 00:00:00 2001 From: Fridolin Date: Mon, 18 Nov 2024 20:01:20 +0100 Subject: [PATCH 14/14] Update i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md Thx Co-authored-by: Simon --- .../current/custom-bot/modules/administration/welcomer.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md index 18a7cec6..06a160b4 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/custom-bot/modules/administration/welcomer.md @@ -146,7 +146,7 @@ Diese Konfigurationsdatei nutzt "Config-Elemente". Ein Config-Element repräsent ## Fehlerbehebung {#troubleshooting} -Dieses Modul ist bekanntermaßen schwierig zu beheben, da sein hochflexibles und anpassbares Design eine komplizierte Konfigurationsstruktur mit sich bringt. +Fehler in diesem Modul sind bekanntermaßen schwierig zu beheben, da es hochflexible und anpassbar ist und dies eine komplizierte Konfigurationsstruktur mit sich bringt. Wenn keiner der der Schritte hierunter hilft (bitte probiere das zuerst!), kannst du jederzeit unsere freundlichen Teammitglieder über [scnx.app/de/help](https://scnx.app/de/help) kontaktieren.