Variabili di formattazione
Le variabili di formattazione permettono ad April di inserire valori Discord in messaggi, embed, URL immagine e campi editor supportati.
Variabili messaggio legacy
Sezione intitolata “Variabili messaggio legacy”Welcome, leaver, logs, protection messages, custom commands, managed embeds, stream monitors e levels usano variabili con parentesi graffe singole quando l’editor messaggi espone pulsanti variabile.
Esempio:
Welcome {user.mention} to {guild}. You are member {memberCount.ordinal}.Pagine diverse espongono dati diversi. Se una variabile non è disponibile per quella funzionalità, April la lascia invariata o la sostituisce con un valore fallback.
Variabili utente comuni
Sezione intitolata “Variabili utente comuni”| Variable | Significato |
|---|---|
{user} | Nome utente |
{user.mention} | Menzione utente Discord |
{user.status.color} | Colore hex dello stato corrente dell’utente |
{user.discriminator} | Discriminatore Discord quando disponibile |
{user.avatar} | URL avatar utente |
{user.avatar.rounded} | URL avatar utente per template immagine |
{user.fullname} | Valore nome visualizzato completo disponibile al formatter |
{user.id} | ID utente Discord |
{user.created} | Data completa di creazione utente |
{user.created.date} | Data di creazione utente |
{user.created.ago} | Tempo relativo dalla creazione utente |
{user.created.time} | Ora di creazione utente |
{user.joined} | Data completa di ingresso nel server |
{user.joined.date} | Data di ingresso nel server |
{user.joined.ago} | Tempo relativo dall’ingresso nel server |
{user.joined.time} | Ora di ingresso nel server |
Variabili guild e channel
Sezione intitolata “Variabili guild e channel”| Variable | Significato |
|---|---|
{guild} | Nome server |
{memberCount} | Conteggio membri approssimativo |
{memberCount.ordinal} | Conteggio membri come valore ordinale |
{guild.id} | ID server Discord |
{guild.created.ago} | Tempo relativo dalla creazione del server |
{guild.created.date} | Data di creazione server |
{guild.created.time} | Ora di creazione server |
{guild.icon} | URL icona server |
{channel} | Nome channel |
{channel.id} | ID channel Discord |
{channel.mention} | Menzione channel Discord |
{channel.created} | Data completa di creazione channel |
{channel.created.date} | Data di creazione channel |
{channel.created.time} | Ora di creazione channel |
{channel.created.ago} | Tempo relativo dalla creazione channel |
{channel.nsfw} | Se il channel è marcato NSFW |
{channel.topic} | Topic del channel |
Variabili livello
Sezione intitolata “Variabili livello”Usale in messaggi level-up, design rank-card e template relativi ai livelli quando la pagina le offre.
| Variable | Significato |
|---|---|
{user.level} | Livello dell’utente nel server |
{user.xp} | XP nel livello corrente |
{user.xpRatio} | Progresso del livello corrente da 0 a 1 |
{user.nextLevel} | XP richiesti per il livello successivo |
{user.totalXp} | XP totali accumulati |
Variabili log
Sezione intitolata “Variabili log”Gli eventi log possono esporre valori before/after quando Discord invia entrambi gli stati.
| Variable | Significato |
|---|---|
{before.user} | Nome utente precedente |
{before.user.nickname} | Nickname server precedente |
{before.user.avatar} | URL avatar precedente |
{before.user.fullname} | Valore utente completo precedente |
{after.user} | Nome utente aggiornato |
{after.user.nickname} | Nickname server aggiornato |
{after.user.avatar} | URL avatar aggiornato |
{after.user.fullname} | Valore utente completo aggiornato |
{before.channel} | Nome channel precedente |
{before.channel.id} | ID channel precedente |
{before.channel.nsfw} | Stato NSFW precedente |
{before.channel.topic} | Topic channel precedente |
{after.channel} | Nome channel aggiornato |
{after.channel.id} | ID channel aggiornato |
{after.channel.nsfw} | Stato NSFW aggiornato |
{after.channel.topic} | Topic channel aggiornato |
Alcuni eventi log aggiungono anche valori specifici dell’evento, come contenuto del messaggio o ruoli cambiati. Usa i pulsanti variabile mostrati nella pagina di configurazione di quell’evento.
Variabili stream monitor
Sezione intitolata “Variabili stream monitor”Le notifiche Twitch possono usare:
| Variable | Significato |
|---|---|
{stream.channel} | Nome visualizzato dello streamer |
{stream.avatarUrl} | URL avatar dello streamer |
{stream.url} | URL canale Twitch |
{stream.viewerCount} | Numero spettatori |
{stream.started.ago} | Tempo relativo di inizio stream |
{stream.type} | Tipo stream |
{stream.length} | Durata stream |
{stream.title} | Titolo stream |
{stream.preview} | URL thumbnail stream |
{stream.game} | Gioco o categoria |
Le notifiche YouTube possono usare {stream.channel.name}, {stream.channel}, {stream.url}, {stream.started.ago} e {stream.title}.
Valori casuali
Sezione intitolata “Valori casuali”Custom commands e altri template messaggio legacy possono usare variabili di numero casuale:
{random}{random.1-100}{random} restituisce un valore da 0 a 10. {random.1-100} restituisce un valore nell’intervallo configurato.
Variabili workspace editor
Sezione intitolata “Variabili workspace editor”I bindings Editor V2 usano invece sintassi di output stile Liquid:
| Variable | Esempio d’uso |
|---|---|
{{ user }} | Renderizzare l’utente selezionato nel testo |
{{ guild }} | Renderizzare il nome server nel testo |
{{ channel }} | Renderizzare un valore channel nel testo |
I bindings Editor V2 si configurano dall’inspector del workspace. Valori con parentesi singole come {user} non sono validi nei bindings Editor V2.
Valori URL
Sezione intitolata “Valori URL”Le variabili immagine e icona devono risolversi in URL validi. Per esempio, {user.avatar}, {guild.icon} e {stream.preview} sono adatti ai campi URL immagine quando la funzionalità li supporta.