Die Twasi-Variable
Diese Dokumentation bezieht sich nicht auf das Twasi-Variablen-Plugin, mit dem Benutzer ihre eigenen Variablen erstellen können. Hier kannst du mehr über die Variablen herausfinden, die durch Twasi-Plugins registriert werden können.
Was ist eine Twasi-Variable?
Twasi-Variablen können die Ausgabe von Befehlen, die der Benutzer hinzugefügt hat, dynamisch machen. Sie können von Plugins hinzugefügt werden und werden durch Controller-Klassen gelöst.
Aus was besteht eine Twasi-Variable?
Twasi-Variablen setzen sich aus drei Hauptbestandteilen zusammen:
- Das Präfix ('$' standardmäßig - kann derzeit nicht geändert werden)
- Dem Variablennamen
- Mit Komma getrennte, benutzerdefinierte Argumente
Beispiel
$urlfetch(https://any-web-address.com, 120)
- '$' ist das Variablen-Präfix.
- 'urlfetch' ist der Variablenname
- '()' ist der Indikator für Variablen-Argumente (optional)
- 'https://any-web-address.com' ist das erste Argument
- '120' ist das zweite Argument.
Wenn eine Variable keine Parameter benötigt, sind die Klammern optional. $song statt $song() verwenden
Namensbeschränkungen
Twasi-Variablen müssen einen alphanumerischen Namen, egal welcher Länge, haben. Groß- und Kleinschreibung spielt keine Rolle.
Beispiele für gültige Namen
- a
- fetchurl
- this1is2a3test4
- 45
- a1B2
- A1b2
Verschachtelung
Twasi's Variablen Parser ist intelligent genug, um verschachtelte Variablen zu erkennen. Innere Variablen werden immer vor äußeren Variablen analysiert.
Beispiel
Angenommen, du hast einen Befehl namens !checkkbalance, um den Kontostand eines anderen Benutzers zu überprüfen. Die Returnausgabe des Befehls könnte wie folgt aussehen:
$balance($args(1))
Während $balance den Saldo des sendenden Benutzers (wenn kein Argument übergeben wird) oder des im ersten Argument angegebenen Benutzers zurückgibt, gibt $args alle Befehlsargumente als eine Zeichenkette zurück. Wenn eine Zahl angegeben wird, teilt sie die Argumente auf und gibt nur das angeforderte zurück (in diesem Fall 1).
Jetzt führst du deinen Befehl aus: !checkbalance larcce
Der Parser wird zuerst die innere Variable ('$args(1)') analysieren:
$balance(larcce)
Dann die äußere Variable:
50
Tiefes Parsen
Sollte eine Twasi-Variable eine andere Twasi-Variable zurückgeben, wird die zurückgegebene Variable ebenfalls analysiert (nicht unbegrenzt, der Parser wird abgebrochen, wenn das Parsen zu tief geht).