Charakterwerte und -bögen
Ein großes neues Feature stellt auch die Speicherung von Werten für Charaktere dar. Hierzu wurde ein neues Kommando implementiert: /character. Ergänzt wird dieses Kommando um die gewünschte Funktion: import, export, set oder get.
Import
Der einfachste Weg einen Charakterbogen zu hinterlegen ist der Import einer CSV Datei. Die CSV Datei besteht aus (mindestens) vier Spalten: Shortcut, Name, Wert und Formel. Sofern eine Kopfzeile verwendet wird, sollte die erste Spalte mit “Shortcut” betitelt werden, damit der @RollButler diese Zeile auch erkennt und ignoriert.
Die Spalte Shortcut beinhaltet die Bezeichner für die einzelnen Werte, wie sie später im @RollButler referenziert werden. Anstelle von “Geschicklichkeit” kann man dann “GES” eingeben. Shortcuts dürfen nur Buchstaben, Zahlen und den Unterstrich beinhalten, sollten aber nicht nur aus Zahlen bestehen. Wird kein Shortcut gesetzt, übernimmt der @RollButler beim Import den Wert der zweiten Spalte und ersetzt alle ungültigen Zeichen durch den Unterstrich “_”.
Die zweite Spalte (Name) beinhaltet dann die vollständige Bezeichnung des Werts. Spalte 3 (Wert) fasst dann den nummerischen oder textuellen Wert für die Fertigkeit in der Zeile, während die vierte Spalte eine Würfelinstruktion beinhaltet, die für eine Probe auf diesen Wert genutzt wird.
Die Werte werden im @RollButler wie Variablen behandelt, können also mit $<Shortcut> abgefragt werden. In der CSV Datei gibt es eine Vereinfachung für die Generierung der Formeln: $$ in einer Formel wird beim Import durch den Shortcut der aktuellen Zeile ersetzt.
Eine CSV Datei kann dann wie folgt aussehen:
Shortcut,Name,Value,Formula STA,Stärke,45,_pre()<=$$ GES,Geschicklichkeit,47,_pre()<=$$ KON,Konstitution,40,_pre()<=$$ INT,Intelligenz,50,_pre()<=$$ AUS,Ausdauer,60,_pre()<=$$ BIL,Bildung,40,_pre()<=$$ ,Droschke lenken,10,_pre()<=$$ ,Fälschen,10,_pre()<=$$ ,Faustkampf,15,_pre()<=$$ ,Fremdsprache,5,_pre()<=$$ ,Gesetz,5,_pre()<=$$
Der Import der CSV Datei erfolgt dann mit dem Kommando
/char import(“<Bezeichnung>”) <Inhalt der CSV Datei>
Optional kann in den Klammernder Funktion import() ein Name für den Charakterbogen angegeben werden. Auf diese Weise können auch mehrere Charaktere in einem Profil gespeichert werden.
Hinter der Funktion wird dann der Inhalt der CSV Datei eingefügt, also nicht der Dateiname, sondern per copy&paste der Text der Datei.
Alternativ zur CSV Datei kann auch ein JSON formatierter Text dort eingefügt werden, wie er bei der export() Funktion bereitgestellt wird.
Hinweis: Ein Import überschreibt einen bereits existierenden Charakterbogen mit gleicher Bezeichnung vollständig und irreversibel. Ferner sollte beachtet werden, dass Variablen, die in Würfelinstruktionen gesetzt werden, insbesondere $1, $2, etc. die Werte des Charakterbogens überlagern, also vorrangig bedient werden.
Export
Der Export erfolgt mit dem Kommando
/char export(“<Bezeichnung>”)
und liefert dann etwa die folgende Ausgabe.
{
"stats": {
"STA": {
"name": "Stu00e4rke",
"value": "45",
"macro": "_pre()<=$STA"
},
"GES": {
"name": "Geschicklichkeit",
"value": "47",
"macro": "_pre()<=$GES"
},
"KON": {
"name": "Konstitution",
"value": "40",
"macro": "_pre()<=$KON"
},
"INT": {
"name": "Intelligenz",
"value": "50",
"macro": "_pre()<=$INT"
},
"AUS": {
"name": "Ausdauer",
"value": "60",
"macro": "_pre()<=$AUS"
}
}
} Die export() Funktion dient dazu sich die Charakterwerte für einen späteren Gebrauch lokal sichern zu können. Der @RollButler löscht die Charakterbögen spätestens nach drei Monaten der Nichtbenutzung.
Werte ändern und nutzen
Einzelne Werte können mit der set() Funktion im Charakterbogen verändert oder hinzugefügt werden. Das Kommando sieht dabei wie folgt aus:
/char set(“<Bezeichnung>”) <Skill>=<Wert>
<Skill> ist dabei der Shortcut zu dem jeweiligen Attributs- oder Fertigkeitswert, (z. B. STA) und <Wert> der neue Fertigkeitswert selber. Beispiel: /char set() STA=55.
In den Würfelanweisungen kann dann unkompliziert mittels $<Shortcut>, also z. B. $STA auf den Fertigkeitswert zugegriffen werden, z. B. bei /roll W100<$STA.
Die hinterlegte Formel für eine Probe kann mit /roll cr(“<Shortcut>”), also z. B. /roll cr(“STA”) durchgeführt werden. Und da dies immer noch zu komplex ist, wurde ein neues Kommando für diesen speziellen Fall eingeführt: /cr <Shortcut>, also z. B. /cr STA. (“cr” steht für “character roll”.) Mit /pcr (“private character roll) kann der Wurf auch geheim durchgeführt werden.
Zusammenfassung zum Charakterbogen im @RollButler
- Charakterbogen im CSV oder JSON Format importieren mit /char import() <CSV oder JSON Code>
- Zugriff auf Werte des Bogens in Würfelanweisungen mit $<Shortcut>
- Würfeln einer vordefinierten Probe im Charakterbogen mit /cr <Shortcut> oder in einer Würfelinstruktion (/roll) mit c(“<Shortcut>”)
- Ändern eines Wertes im Charakterbogen mit /char set() <Shortcut>=<Neuer Wert>
- Exportieren des Charakterbogens im JSON Format mit /char export()
Vorlagen für Charakterbögen
Ein paar Vorlagen für Charakterbögen stehen in einer Google Docs Tabelle zur Verfügung. Über die Export Funktion kann der Charakterbogen in das erforderliche CSV Format konvertiert werden. Die Liste wird voraussichtlich in Zukunft um weitere Systeme erweitert.
