Formatierungsvariablen
Formatierungsvariablen ermöglichen April, Discord-Werte in Nachrichten, Embeds, Bild-URLs und unterstützte Editor-Felder einzufügen.
Legacy-Nachrichtenvariablen
Abschnitt betitelt „Legacy-Nachrichtenvariablen“Welcome, leaver, logs, protection messages, custom commands, managed embeds, stream monitors und levels verwenden Variablen mit einfachen geschweiften Klammern, wenn der Nachrichteneditor Variablenbuttons anzeigt.
Beispiel:
Welcome {user.mention} to {guild}. You are member {memberCount.ordinal}.Verschiedene Seiten stellen verschiedene Daten bereit. Wenn eine Variable für diese Funktion nicht verfügbar ist, lässt April sie unverändert oder ersetzt sie durch einen Fallback-Wert.
Häufige User-Variablen
Abschnitt betitelt „Häufige User-Variablen“| Variable | Bedeutung |
|---|---|
{user} | Benutzername |
{user.mention} | Discord-User-Mention |
{user.status.color} | Hex-Farbe des aktuellen User-Status |
{user.discriminator} | Discord-Discriminator, wenn verfügbar |
{user.avatar} | User-Avatar-URL |
{user.avatar.rounded} | User-Avatar-URL für Bildvorlagen |
{user.fullname} | Vollständiger Anzeigename, der dem Formatter zur Verfügung steht |
{user.id} | Discord-User-ID |
{user.created} | Vollständiges Erstellungsdatum des Users |
{user.created.date} | Erstellungsdatum des Users |
{user.created.ago} | Relative Zeit seit Erstellung des Users |
{user.created.time} | Erstellungszeit des Users |
{user.joined} | Vollständiges Beitrittsdatum zum Server |
{user.joined.date} | Beitrittsdatum zum Server |
{user.joined.ago} | Relative Zeit seit Serverbeitritt |
{user.joined.time} | Beitrittszeit zum Server |
Guild- und channel-Variablen
Abschnitt betitelt „Guild- und channel-Variablen“| Variable | Bedeutung |
|---|---|
{guild} | Servername |
{memberCount} | Ungefähre Mitgliederzahl |
{memberCount.ordinal} | Mitgliederzahl als Ordinalwert |
{guild.id} | Discord-Server-ID |
{guild.created.ago} | Relative Zeit seit Servererstellung |
{guild.created.date} | Server-Erstellungsdatum |
{guild.created.time} | Server-Erstellungszeit |
{guild.icon} | Server-Icon-URL |
{channel} | channel-Name |
{channel.id} | Discord-channel-ID |
{channel.mention} | Discord-channel-Mention |
{channel.created} | Vollständiges Erstellungsdatum des channels |
{channel.created.date} | Erstellungsdatum des channels |
{channel.created.time} | Erstellungszeit des channels |
{channel.created.ago} | Relative Zeit seit channel-Erstellung |
{channel.nsfw} | Ob der channel als NSFW markiert ist |
{channel.topic} | channel-Thema |
Level-Variablen
Abschnitt betitelt „Level-Variablen“Verwende diese in Level-up-Nachrichten, Rank-card-Designs und levelbezogenen Vorlagen, wo die Seite sie anbietet.
| Variable | Bedeutung |
|---|---|
{user.level} | Level des Users auf dem Server |
{user.xp} | XP im aktuellen Level |
{user.xpRatio} | Fortschritt im aktuellen Level von 0 bis 1 |
{user.nextLevel} | Für das nächste Level benötigte XP |
{user.totalXp} | Insgesamt angesammelte XP |
Log-Variablen
Abschnitt betitelt „Log-Variablen“Log-Events können before/after-Werte bereitstellen, wenn Discord beide Zustände sendet.
| Variable | Bedeutung |
|---|---|
{before.user} | Vorheriger Benutzername |
{before.user.nickname} | Vorheriger Server-Nickname |
{before.user.avatar} | Vorherige Avatar-URL |
{before.user.fullname} | Vorheriger vollständiger User-Wert |
{after.user} | Aktualisierter Benutzername |
{after.user.nickname} | Aktualisierter Server-Nickname |
{after.user.avatar} | Aktualisierte Avatar-URL |
{after.user.fullname} | Aktualisierter vollständiger User-Wert |
{before.channel} | Vorheriger channel-Name |
{before.channel.id} | Vorherige channel-ID |
{before.channel.nsfw} | Vorheriger NSFW-Status |
{before.channel.topic} | Vorheriges channel-Thema |
{after.channel} | Aktualisierter channel-Name |
{after.channel.id} | Aktualisierte channel-ID |
{after.channel.nsfw} | Aktualisierter NSFW-Status |
{after.channel.topic} | Aktualisiertes channel-Thema |
Einige Log-Events fügen außerdem eventspezifische Werte hinzu, etwa Nachrichteninhalt oder geänderte Rollen. Verwende die Variablenbuttons auf der Konfigurationsseite des jeweiligen Events.
Stream-monitor-Variablen
Abschnitt betitelt „Stream-monitor-Variablen“Twitch-Benachrichtigungen können verwenden:
| Variable | Bedeutung |
|---|---|
{stream.channel} | Anzeigename des Streamers |
{stream.avatarUrl} | Avatar-URL des Streamers |
{stream.url} | Twitch-channel-URL |
{stream.viewerCount} | Zuschauerzahl |
{stream.started.ago} | Relative Startzeit des Streams |
{stream.type} | Stream-Typ |
{stream.length} | Stream-Dauer |
{stream.title} | Stream-Titel |
{stream.preview} | Stream-Thumbnail-URL |
{stream.game} | Spiel oder Kategorie |
YouTube-Benachrichtigungen können {stream.channel.name}, {stream.channel}, {stream.url}, {stream.started.ago} und {stream.title} verwenden.
Zufallswerte
Abschnitt betitelt „Zufallswerte“Custom commands und andere legacy Nachrichtenvorlagen können Zufallszahl-Variablen verwenden:
{random}{random.1-100}{random} gibt einen Wert von 0 bis 10 zurück. {random.1-100} gibt einen Wert im konfigurierten Bereich zurück.
Editor-workspace-Variablen
Abschnitt betitelt „Editor-workspace-Variablen“Editor V2 bindings verwenden stattdessen Liquid-ähnliche Ausgabesyntax:
| Variable | Beispielverwendung |
|---|---|
{{ user }} | Den ausgewählten User in Text rendern |
{{ guild }} | Den Servernamen in Text rendern |
{{ channel }} | Einen channel-Wert in Text rendern |
Editor V2 bindings werden im Workspace-Inspector konfiguriert. Werte mit einfachen Klammern wie {user} sind in Editor V2 bindings nicht gültig.
URL-Werte
Abschnitt betitelt „URL-Werte“Bild- und Icon-Variablen müssen zu gültigen URLs aufgelöst werden. Zum Beispiel eignen sich {user.avatar}, {guild.icon} und {stream.preview} für Bild-URL-Felder, wenn die Funktion sie unterstützt.