diff --git a/docs/assets/discord-ids/en/activatedevelopermode.png b/docs/assets/discord-ids/en/activatedevelopermode.png new file mode 100644 index 00000000..7fee04b2 Binary files /dev/null and b/docs/assets/discord-ids/en/activatedevelopermode.png differ diff --git a/docs/assets/discord-ids/en/copy-channel-id.png b/docs/assets/discord-ids/en/copy-channel-id.png new file mode 100644 index 00000000..1fbbb53a Binary files /dev/null and b/docs/assets/discord-ids/en/copy-channel-id.png differ diff --git a/docs/assets/discord-ids/en/copy-message-id.png b/docs/assets/discord-ids/en/copy-message-id.png new file mode 100644 index 00000000..ce02ce01 Binary files /dev/null and b/docs/assets/discord-ids/en/copy-message-id.png differ diff --git a/docs/assets/discord-ids/en/copy-role-id.png b/docs/assets/discord-ids/en/copy-role-id.png new file mode 100644 index 00000000..e9c6c7c5 Binary files /dev/null and b/docs/assets/discord-ids/en/copy-role-id.png differ diff --git a/docs/assets/discord-ids/en/copy-server-id.png b/docs/assets/discord-ids/en/copy-server-id.png new file mode 100644 index 00000000..1eec60e8 Binary files /dev/null and b/docs/assets/discord-ids/en/copy-server-id.png differ diff --git a/docs/assets/discord-ids/en/copy-user-id.png b/docs/assets/discord-ids/en/copy-user-id.png new file mode 100644 index 00000000..11e0c5c0 Binary files /dev/null and b/docs/assets/discord-ids/en/copy-user-id.png differ diff --git a/docs/assets/discord-ids/en/opendiscordsettings.png b/docs/assets/discord-ids/en/opendiscordsettings.png new file mode 100644 index 00000000..f12ec531 Binary files /dev/null and b/docs/assets/discord-ids/en/opendiscordsettings.png differ diff --git a/docs/assets/discord-ids/en/scnx-mention-helper.png b/docs/assets/discord-ids/en/scnx-mention-helper.png new file mode 100644 index 00000000..08f700c7 Binary files /dev/null and b/docs/assets/discord-ids/en/scnx-mention-helper.png differ diff --git a/docs/discord-ids.md b/docs/discord-ids.md new file mode 100644 index 00000000..2c530bc2 --- /dev/null +++ b/docs/discord-ids.md @@ -0,0 +1,111 @@ +# Discord IDs & Mentions + +To configure advanced features on SCNX, you sometimes need specific Discord IDs. These unique identifiers allow our system to precisely target the correct users, channels, or roles. This guide will show you how to find them and how to mention entities using their ID to customize your bot's behavior. + +## 1. Enable Discord Developer Mode +Before you can copy IDs, you need to enable the Developer Mode in your Discord client. This is a built-in feature that unlocks advanced context menu options for power users and developers. + +1. Open your **User Settings** (the gear icon next to your name). +2. Go to **Advanced** (located under the "App Settings" category). +3. Toggle **Developer Mode** to **On**. + +![A screenshot of a Discord server marking the gear icon](@site/docs/assets/discord-ids/en/opendiscordsettings.png) +![A screenshot of the Discord user settings page "Advanced"](@site/docs/assets/discord-ids/en/activatedevelopermode.png) + +## 2. Copying IDs +Every entity on Discord — whether it's a user, a server, or a single message — has a unique ID. Once Developer Mode is active, you can right-click almost anything to retrieve it. IDs are used by bots to identify entities as they don't change - even if the name of the entity has changed. + +### Copy User and Bot IDs +1. Right-click on the user's name or avatar. +2. Select **Copy User ID** at the bottom of the menu. +3. The ID is now in your clipboard - you can now paste it into SCNX or elsewhere 🚀 +* **On Mobile:** Long-press the user's profile, tap the three dots (`...`) in the top right, and select "Copy User ID". + +![Screenshot showing how to right-click a user and select Copy User ID](@site/docs/assets/discord-ids/en/copy-user-id.png) + +### Copy Channel IDs +1. Right-click a channel name in your sidebar. +2. Select **Copy Channel ID**. +3. The ID is now in your clipboard - you can now paste it into SCNX or elsewhere 🚀 +* **On Mobile:** Long-press the channel name, scroll down, and tap "Copy Channel ID". + +![Screenshot showing the context menu on a channel with Copy Channel ID highlighted](@site/docs/assets/discord-ids/en/copy-channel-id.png) + +### Copy Role IDs +1. Go to **Server Settings** > **Roles**. +2. Right-click the specific role name. +3. Select **Copy Role ID**. +4. The ID is now in your clipboard - you can now paste it into SCNX or elsewhere 🚀 +* **On Mobile:** Go to Server Settings > Roles, tap the role, and tap the "Copy ID" icon in the top right. + +![Screenshot of the role settings page with the right-click menu active](@site/docs/assets/discord-ids/en/copy-role-id.png) + +### Copy Message IDs +1. Hover over the message and click the **three dots** (More) on the right side. +2. Select **Copy Message ID** at the very bottom of the menu. +3. The ID is now in your clipboard - you can now paste it into SCNX or elsewhere 🚀 +* **On Mobile:** Long-press the message, scroll to the bottom of the menu, and tap "Copy Message ID". + +![Screenshot showing the context menu on a message with Copy Message ID highlighted](@site/docs/assets/discord-ids/en/copy-message-id.png) + +### Copy Server IDs (Guild IDs) +1. Right-click the **Server Name** at the top of your channel list or right-click the **Server Icon**. +2. Select **Copy Server ID** at the bottom of the list. +3. The ID is now in your clipboard - you can now paste it into SCNX or elsewhere 🚀 +* **On Mobile:** Tap the three dots next to the Server Name at the top of the channel list, scroll down, and tap "Copy Server ID". + +![Screenshot showing how to right-click a server icon to copy the Server ID](@site/docs/assets/discord-ids/en/copy-server-id.png) + +--- + +## 3. Mentioning Elements via ID +Sometimes you need to mention a user, role, or channel within a bot response (like a custom embed or a welcome message) where a standard "@" mention might not work. Using the raw ID syntax ensures the mention resolves correctly once the bot sends the message. + +:::info Mention-Helper in SCNX +In the SCNX Message-Editor, you often don't have to type the syntax manually. You can simply click the **"@" button** above the text field to easily select and insert channel or role mentions. + +![SCNX Message Editor Mention Button](@site/docs/assets/discord-ids/en/scnx-mention-helper.png) +::: + +### Mention Syntax Table +If you are writing raw text or configuring advanced fields, use the following syntax: + +| Entity | Syntax | Example | Preview | +| :--- | :--- | :--- | :--- | +| **Users and Bots** | `<@USERID>` | `<@787026352191701033>` | @SCNX | +| **Channels** | `<#CHANNELID>` | `<#1113165263295230002>` | #news | +| **Roles** | `<@&ROLEID>` | `<@&1113115210048360489>` | @Moderator | + +### Mentioning Timestamps +If you want to include dynamic time displays, Discord uses a special Unix-Timestamp format. + +To create a timestamp, you wrap a Unix-Time (seconds since 1970) in a specific code. For example: ``. + +* **Dynamic:** It automatically adjusts to the local time of every user. +* **Versatile:** Can show relative time ("5 minutes ago"), full dates, or just the time. + +![A screenshot showing examples of different timestamp formats](@site/docs/assets/discord-formatting/en/types3.png) + +You can find a detailed guide and a generator for these [here](@site/docs/discord-formatting.md#timestamps). + +--- + +## Troubleshooting {#troubleshooting} + +
+ The "Copy ID" option is missing + +
+ +
+ The mention appears as raw text instead of a name + +
diff --git a/docs/scnx/guilds/files.md b/docs/scnx/guilds/files.md index 93379264..a9608fcc 100644 --- a/docs/scnx/guilds/files.md +++ b/docs/scnx/guilds/files.md @@ -40,14 +40,14 @@ Additionally, please note that you can no longer purchase new storage upgrades f ::: If you have been using SCNX for a while, you are likely familiar with the personal image upload space located -at [scnx.app/user/file](https://scnx.app/user/file). +at [scnx.app/user/file](https://scnx.app/user/files). Guild Image Storage is a completely separate, shared space. To move your existing images from your personal space to the shared server library, **you will need to manually re-upload them**. -1. Download the images you want to share from your [personal space](https://scnx.app/user/file). +1. Download the images you want to share from your [personal space](https://scnx.app/user/files). 2. Navigate to your server's **Images** page. -3. Upload the files into the [new shared library](https://live.local/glink?page=images). +3. Upload the files into the [new shared library](https://scnx.app/glink?page=images). ## Adding Images to Your Library {#adding-images-to-your-library} @@ -217,4 +217,4 @@ From within the picker you can: picker. The image will upload directly to whichever tab you currently have open (Server or Personal) and will be selected immediately. -![Screenshot of the image picker modal showing the Server Images and Personal Images tabs](@site/docs/assets/scnx/guilds/files/image-upload.png) \ No newline at end of file +![Screenshot of the image picker modal showing the Server Images and Personal Images tabs](@site/docs/assets/scnx/guilds/files/image-upload.png) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/discord-ids.md b/i18n/de/docusaurus-plugin-content-docs/current/discord-ids.md new file mode 100644 index 00000000..25b425be --- /dev/null +++ b/i18n/de/docusaurus-plugin-content-docs/current/discord-ids.md @@ -0,0 +1,125 @@ +# Discord-IDs & Erwähnungen + +Um fortgeschrittene Funktionen auf SCNX zu konfigurieren, benötigst du manchmal spezifische Discord-IDs. Diese eindeutigen Kennungen ermöglichen es unserem System, die richtigen Nutzer, Kanäle oder Rollen präzise anzusprechen. Diese Anleitung zeigt dir, wie du sie findest und wie du Objekte mithilfe ihrer ID erwähnst, um das Verhalten deines Bots anzupassen. + +## 1. Discord-Entwicklermodus aktivieren + +Bevor du IDs kopieren kannst, musst du den Entwicklermodus in deinem Discord-Client aktivieren. Dies ist eine integrierte Funktion, die erweiterte Kontextmenü-Optionen für Power-User und Entwickler freischaltet. + +1. Öffne deine **Nutzereinstellungen** (das Zahnrad-Symbol neben deinem Namen). +2. Gehe zu **Erweitert** (unter der Kategorie "App-Einstellungen"). +3. Schalte den **Entwicklermodus** auf **An**. + +![Ein Screenshot eines Discord-Servers, der das Zahnrad-Symbol markiert](@site/docs/assets/discord-ids/en/opendiscordsettings.png) +![Ein Screenshot der Discord-Nutzereinstellungen Seite "Erweitert"](@site/docs/assets/discord-ids/en/activatedevelopermode.png) + +## 2. IDs kopieren + +Jedes Objekt auf Discord — egal ob es sich um einen Nutzer, einen Server oder eine einzelne Nachricht handelt — hat eine eindeutige ID. Sobald der Entwicklermodus aktiv ist, kannst du fast alles rechtsklicken, um sie abzurufen. IDs werden von Bots verwendet, um Objekte zu identifizieren, da sie sich nicht ändern - selbst wenn der Name des Objekts geändert wurde. + +### Nutzer- und Bot-IDs kopieren + +1. Rechtsklicke den Namen oder den Avatar des Nutzers. +2. Wähle **Nutzer-ID kopieren** ganz unten im Menü. +3. Die ID befindet sich nun in deiner Zwischenablage - du kannst sie jetzt in SCNX oder an anderer Stelle einfügen 🚀 + +* **Auf dem Handy:** Drücke lange auf das Profil des Nutzers, tippe auf die drei Punkte (`...`) oben rechts und wähle "Nutzer-ID kopieren". + +![Screenshot, der zeigt, wie man einen Nutzer rechtsklickt und Nutzer-ID kopieren auswählt](@site/docs/assets/discord-ids/en/copy-user-id.png) + +### Kanal-IDs kopieren + +1. Rechtsklicke auf einen Kanalnamen in deiner Seitenleiste. +2. Wähle **Kanal-ID kopieren**. +3. Die ID befindet sich nun in deiner Zwischenablage - du kannst sie jetzt in SCNX oder an anderer Stelle einfügen 🚀 + +* **Auf dem Handy:** Drücke lange auf den Kanalnamen, scrolle nach unten und tippe auf "Kanal-ID kopieren". + +![Screenshot, der das Kontextmenü eines Kanals mit hervorgehobenem Kanal-ID kopieren zeigt](@site/docs/assets/discord-ids/en/copy-channel-id.png) + +### Rollen-IDs kopieren + +1. Gehe zu **Servereinstellungen** > **Rollen**. +2. Rechtsklicke den spezifischen Rollennamen. +3. Wähle **Rollen-ID kopieren**. +4. Die ID befindet sich nun in deiner Zwischenablage - du kannst sie jetzt in SCNX oder an anderer Stelle einfügen 🚀 + +* **Auf dem Handy:** Gehe zu Servereinstellungen > Rollen, tippe auf die Rolle und tippe auf das "ID kopieren"-Symbol oben rechts. + +![Screenshot der Rolleneinstellungen mit aktivem Rechtsklick-Menü](@site/docs/assets/discord-ids/en/copy-role-id.png) + +### Nachrichten-IDs kopieren + +1. Fahre mit der Maus über die Nachricht und klicke auf die **drei Punkte** (Mehr) auf der rechten Seite. +2. Wähle **Nachrichten-ID kopieren** ganz unten im Menü. +3. Die ID befindet sich nun in deiner Zwischenablage - du kannst sie jetzt in SCNX oder an anderer Stelle einfügen 🚀 + +* **Auf dem Handy:** Drücke lange auf die Nachricht, scrolle zum Ende des Menüs und tippe auf "Nachrichten-ID kopieren". + +![Screenshot, der das Kontextmenü einer Nachricht mit hervorgehobenem Nachrichten-ID kopieren zeigt](@site/docs/assets/discord-ids/en/copy-message-id.png) + +### Server-IDs kopieren (Guild IDs) + +1. Rechtsklicke den **Servernamen** oben in deiner Kanalliste oder rechtsklicke auf das **Server-Icon**. +2. Wähle **Server-ID kopieren** am Ende des Menüs. +3. Die ID befindet sich nun in deiner Zwischenablage - du kannst sie jetzt in SCNX oder an anderer Stelle einfügen 🚀 + +* **Auf dem Handy:** Tippe auf die drei Punkte neben dem Servernamen oben in der Kanalliste, scrolle nach unten und tippe auf "Server-ID kopieren". + +![Screenshot, der zeigt, wie man auf ein Server-Icon rechtsklickt, um die Server-ID zu kopieren](@site/docs/assets/discord-ids/en/copy-server-id.png) + +--- + +## 3. Elemente via ID erwähnen + +Manchmal musst du einen Nutzer, eine Rolle oder einen Kanal innerhalb einer Bot-Antwort erwähnen (wie in einem benutzerdefinierten Embed oder einer Willkommensnachricht), wo eine Standard-"@"-Erwähnung vielleicht nicht funktioniert. Die Verwendung der rohen ID-Syntax stellt sicher, dass die Erwähnung korrekt angezeigt wird, sobald der Bot die Nachricht sendet. + +:::info Erwähnungs-Helfer in SCNX +Im SCNX Nachrichten-Editor musst du die ID oft nicht manuell eingeben. Du kannst einfach auf den **"@"-Button** über dem Textfeld klicken, um Kanal- oder Rollenerwähnungen einfach auszuwählen und einzufügen. + +![SCNX Message Editor Erwähnungs-Button](@site/docs/assets/discord-ids/en/scnx-mention-helper.png) +::: + +### Erwähnungssyntax-Tabelle + +Wenn du Rohtext schreibst oder fortgeschrittene Felder konfigurierst, verwende die folgende Syntax: + +| Objekt | Syntax | Beispiel | Vorschau | +| :--- | :--- | :--- | :--- | +| **Nutzer und Bots** | `<@NUTZERID>` | `<@787026352191701033>` | @SCNX | +| **Kanäle** | `<#KANALID>` | `<#1113165263295230002>` | #news | +| **Rollen** | `<@&ROLLENID>` | `<@&1113115210048360489>` | @Moderator | + +### Zeitstempel erwähnen + +Wenn du dynamische Zeitanzeigen einfügen möchtest, verwendet Discord ein spezielles Unix-Timestamp-Format. +Um einen Zeitstempel zu erstellen, umschließt du eine Unix-Zeit (Sekunden seit 1970) mit einem spezifischen Code. Zum Beispiel: ``. + +* **Dynamisch:** Er passt sich automatisch an die lokale Zeit jedes Nutzers an. +* **Vielseitig:** Kann relative Zeit ("vor 5 Minuten"), vollständige Daten oder nur die Uhrzeit anzeigen. + +![Ein Screenshot, der Beispiele für verschiedene Zeitstempelformate zeigt](@site/docs/assets/discord-formatting/en/types3.png) + +Eine detaillierte Anleitung und einen Generator dafür findest du [hier](@site/docs/discord-formatting.md#timestamps). + +--- + +## Fehlerbehebung {#troubleshooting} + +
+ Die Option "ID kopieren" fehlt +
    +
  • Stelle sicher, dass der Entwicklermodus in deinen Discord-Einstellungen auf "An" geschaltet ist (Nutzereinstellungen > Erweitert).
    • +
  • Wenn du ihn gerade erst aktiviert hast, versuche deinen Discord-Client neu zu starten (drücke Strg + R am Desktop).
    • +
  • Stelle auf dem Handy sicher, dass du die neueste Version der Discord-App verwendest.
    • +
+
+ +
+ Die Erwähnung erscheint als Rohtext anstatt als Name +
    +
  • Überprüfe doppelt, ob die kopierte ID korrekt ist und zum richtigen Objekttyp gehört.
    • +
  • Stelle sicher, dass du die erforderlichen Symbole wie <, @, #, & und > inkludiert hast.
    • +
  • Wenn die ID zu einem Nutzer oder einer Rolle gehört, die nicht auf dem Server ist, auf dem die Nachricht gesendet wird, zeigt Discord möglicherweise die rohe ID an.
    • +
+
diff --git a/i18n/de/docusaurus-plugin-content-docs/current/scnx/guilds/files.md b/i18n/de/docusaurus-plugin-content-docs/current/scnx/guilds/files.md index ae1236fc..178786f2 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/scnx/guilds/files.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/scnx/guilds/files.md @@ -44,14 +44,14 @@ Bitte beachte außerdem, dass du keine neuen Speicher-Upgrades mehr für deinen ::: Wenn du SCNX schon eine Weile nutzt, bist du wahrscheinlich mit dem persönlichen Bilder-Upload-Bereich -unter [scnx.app/user/file](https://scnx.app/user/file) vertraut. +unter [scnx.app/user/file](https://scnx.app/de/user/files) vertraut. Server-Bilderspeicher ist ein völlig separater, gemeinsamer Bereich. Um deine bestehenden Bilder aus deinem persönlichen Bereich in die gemeinsame Serverbibliothek zu verschieben, **musst du sie manuell neu hochladen**. -1. Lade die Bilder, die du teilen möchtest, aus deinem [persönlichen Bereich](https://scnx.app/user/file) herunter. +1. Lade die Bilder, die du teilen möchtest, aus deinem [persönlichen Bereich](https://scnx.app/de/user/files) herunter. 2. Navigiere zur **Bilder**-Seite deines Servers. -3. Lade die Dateien in die [neue gemeinsame Bibliothek](https://live.local/glink?page=images) hoch. +3. Lade die Dateien in die [neue gemeinsame Bibliothek](https://scnx.app/de/glink?page=images) hoch. ## Bilder zu deiner Bibliothek hinzufügen {#adding-images-to-your-library} @@ -229,4 +229,4 @@ Innerhalb der Auswahl kannst du: Drag & Drop direkt in die Auswahl. Das Bild wird direkt in den Tab hochgeladen, den du gerade geöffnet hast (Server oder Persönlich), und sofort ausgewählt. -![Screenshot des modalen Bildauswahlfensters, das die Tabs Serverbilder und Persönliche Bilder zeigt](@site/docs/assets/scnx/guilds/files/image-upload.png) \ No newline at end of file +![Screenshot des modalen Bildauswahlfensters, das die Tabs Serverbilder und Persönliche Bilder zeigt](@site/docs/assets/scnx/guilds/files/image-upload.png) diff --git a/sidebars.js b/sidebars.js index 905f8dfc..92c38347 100644 --- a/sidebars.js +++ b/sidebars.js @@ -43,6 +43,21 @@ const sidebars = { } ] }, + { + type: 'category', + label: 'Discord', + collapsed: false, + items: [ + { + type: 'doc', + id: 'discord-formatting' + }, + { + type: 'doc', + id: 'discord-ids' + } + ] + }, { type: 'category', label: 'Detailed documentation', @@ -69,16 +84,6 @@ const sidebars = { } ] }, - { - type: 'category', - label: 'Discord', - items: [ - { - type: 'doc', - id: 'discord-formatting' - } - ] - } ], linkedRolesSidebar: [ {