Einführung in die Blattentwicklung

19. September 2023 14:24

Erstellen eines Charakterbogens

Um ein Blatt zu erstellen, müssen Sie Zugriff auf ein Pro-Konto haben.

So bearbeiten Sie ein benutzerdefiniertes Charakterblatt für ein Spiel:

Wählen Sie das Menü „Spiele“ und dann „Meine Spiele“.
Wählen Sie das Spiel aus, um zur Seite mit den Kampagnendetails zu gelangen.
Wählen Sie im Menü „Einstellungen“ die Option „Spieleinstellungen“.
Wählen Sie im Menü „Charakterblattvorlage“ die Option „Benutzerdefiniert“ aus.

Der Editor verfügt über vier Registerkarten: HTML-Layout, CSS-Styling, Übersetzung und Vorschau.

Einschränkungen & Sicherheitsfilterung

Im Allgemeinen werden Zeichenblätter mit HTML, CSS und JavaScript (fürSheet Workers) erstellt, es gibt jedoch einige Einschränkungen, die für fortgeschrittene und fortgeschrittene Benutzer gut zu wissen sind. Im Hinblick auf die Sicherheitsfilterung, die Roll20 auch auf Ihr HTML anwendet, sind einige Einschränkungen zu beachten:

HTML:

Im Browser ist das Zeichenblatt grundsätzlich in ein riesiges<form>-Tag eingebunden.

ID-Attributekönnen nicht verwendet werden. (Alle ID-Attribute auf dem Blatt eines Charakters würden sich beim Öffnen auf das Blatt eines anderen Charakters in derselben Kampagne auswirken.
AlleDOMFunktionen können nicht verwendet werden.
Verwenden Sie in Ihrem Zeichenblatt-HTML keine reservierten HTML-Tags wie<head>oder<body>. Dadurch wird verhindert, dass Ihr Charakterblatt auf die virtuelle Tischplatte geladen wird.
Einige Tags wie<section>,<header>,<footer>,<footer>funktionieren ebenfalls nicht.
Bei der Prüfung auf Eindeutigkeit wird bei Attributnamen die Groß-/Kleinschreibung nicht beachtet. Alle Eingaben (und Auswahlmöglichkeiten, Textbereiche usw.) sollten einen eindeutigen Attributnamen haben.
Allen Klassen, die nicht mit „attr_“, „repeating_“ oder „roll_“ beginnen, wird „sheet-“ vorangestellt.
Alle Bilder werden über den Roll20-Image-Proxy weitergeleitet, um Sicherheitsangriffe zu verhindern. Dies sollte für Sie weitgehend transparent sein und keine Auswirkungen haben, aber Sie sollten sich darüber im Klaren sein.
<svg>wird nicht unterstützt.
Alle Attribute inRoll Templatesmüssen in doppelte Anführungszeichen geschrieben werden, da einfache Anführungszeichen dazu führen, dass sie vollständig ignoriert werden.

CSS:

In der CSS-Datei sollten alle allgemeinen Klassen mit dem Präfixsheet-beginnen, damit Roll20 sie lesen kann.
Medienabfragenkönnen derzeit nicht verwendet werden.
Standardschriftarten:Auf die folgenden Schriftarten kann standardmäßig zugegriffen werden:Arial,Patrick .Hand,Contrail One,Shadows Into LightundCandal.
Google Fonts:Google Fonts sind jetzt mit der@import-Funktion verfügbar.

JavaScript

DOM kann nicht verwendet werden.
Einige Javascript-Funktionen oder Funktionalitäten können nicht verwendet werden. Weitere Einzelheiten finden Sie unterBlatt Arbeiterdokumentation.

Verwenden Sie nur Klassen, keine IDs

Sie sollten keine IDs für Ihre Tags verwenden (tun Sie zum Beispiel NICHT<input type='text' id='name' />). Da von jedem Blatt im DOM gleichzeitig mehrere Kopien vorhanden sind, ist die Verwendung einer ID falsch, da IDs nur für eindeutige Elemente verwendet werden sollten.

Dies bedeutet jedoch, dass Sie keine ID-verknüpften<label>Elemente verwenden können (z. B.<label for="my_id">My Label Text</label>). Sie können Elemente innerhalb des Etiketts platzieren, um sie miteinander zu verknüpfen (z. B.<label>Etikettentext <input ... /></label>), obwohl dies auf Kosten der Flexibilität Ihres CSS gehen kann.

Häufige Fehler

1.Vergessen, Attribute mit demattr_zu benennen (z. B.<input type="number" name="attr_dexterity">vs.<input type="number" name="dexterity">). Dies führt dazu, dass nach dem Schließen des Blatts keine Daten im Feld gespeichert werden.

2.Vergessen,Blattzu den Klassennamen in Ihrer.cssDatei hinzuzufügen. Dies ist in der Datei.htmlnicht erforderlich, Roll20 geht automatisch davon aus, dass alle Klassen dort dieses Präfix haben.

3.Verwendung eines Unterstrichs im Namen/in der Klasse sich wiederholender Abschnitte. Jede<fieldset>muss einen eindeutigen Klassennamen haben, der mit „repeating_“ beginnt, und der Rest des Namens darf keine Unterstriche enthalten, sonst speichert der Abschnitt keine Informationen.

4.Beim Vornehmen von Änderungen nur auf das Vorschaufenster schauen.Das Vorschaufenster zeigt keine 100 % genaue Ansicht davon, wie das Blatt aussehen/funktionieren wird, und Blattarbeiter werden völlig ignoriert. Sie müssen sich also bei der Kampagne anmelden und dort ein Charakterblatt öffnen, um sicherzugehen, dass das Blatt optisch/funktionell aussieht.

5.Vorhandene Blätter nicht ansehen. Wenn Sie sehen, wie vorhandene Blätter erstellt und strukturiert wurden, können Sie vermeiden, das Rad neu zu erfinden oder Fehler zu machen, weil Sie zwar HTML/CSS/JavaScript kennen, aber wenig mit der Erstellung von Zeichenblättern vertraut sind. Alle Blätter im Charakterblatt-Repository stehen unter MIT-Lizenz und können daher kostenlos (und empfohlen) als Vorlagen für die Erstellung eigener Blätter verwendet werden, anstatt alles von Grund auf neu zu erstellen.

6.Bitten Sie nicht um Hilfe, wenn Sie nicht weiterkommen. Roll20 verfügt über eine kleine, aber aktive Community, die an der Erstellung und Verbesserung von Charakterbögen arbeitet und oft gerne weiterhilft, wenn Sie bei einer Funktion, die Sie herausfinden wollten, nicht weiterkommen. Roll20-Charakterblatt & Kompendium-Foren.

Der Blatteditor

Vorschaufenster

Das „Vorschaufenster/Blatteditor“ zeigt eine Vorschau eines Charakterblatts. Diese Vorschau ist nicht identisch mit dem Aussehen des Blattes in Roll20 und stellt nur eine Annäherung dar.

Das Vorschaufenster wendet dieselben Sicherheitsvorkehrungen und Filter an wie die Hauptanwendung von Roll20. Klicken Sie unbedingt mit der rechten Maustaste und prüfen Sie das Element, wenn Sie ein seltsames Verhalten bemerken (z. B. werden Ihre Stile nicht richtig angewendet). Möglicherweise gibt es einen Sicherheitsfilter, der den Namen einer Klasse ändert, oder etwas Ähnliches.

Das Vorschaufenster wird in Echtzeit aktualisiert, wenn Sie HTML, CSS oder die Übersetzung auf Ihrem Blatt ändern. Dies zeigt Ihnen eineAnnäherungdavon, wie das Blatt im Spiel aussehen würde. Dies ist nützlich, um während der Bearbeitung schnell oberflächliche Änderungen zu überprüfen. Um jedoch sicher zu sein, dass das tatsächliche Endergebnis vorliegt, müssen Sie das Spiel aufrufen und das Blatt selbst öffnen.

Wenn Sie während des Spiels Änderungen im Charakterblatt-Editor vornehmen, müssen Sie Ihre Änderungen speichern und das aktive Roll20-Spiel aktualisieren. Wenn das Zeichenblatt außerdem <rolltemplate>enthält, wird der Code dafür im Vorschaufenster als unverarbeitet angezeigt. Es wird empfohlen, Rollenvorlagen am Ende des Blattcodes zu platzieren, damit sie die visuelle Darstellung des Blatts bei Verwendung des Vorschaufensters nicht verdecken.

Charakterbogen-Sandbox

Als Alternative zum Blatteditor können Sie jetzt versuchen, dieCustom Sheet Sandboxzum Entwickeln Ihres Blattes zu verwenden. Mit der benutzerdefinierten Sheet-Sandbox können Sie HTML- und CSS & Übersetzungsdateien aus der Sandbox auswählen und hochladen und die Blattaktualisierung sofort sehen. Die Sandbox ermöglicht auch das Testen Ihrer Standardblatteinstellungen über Ihre sheet.json-Datei.

HTML-Layout

HTML wird verwendet, um die Felder und das Layout innerhalb der Charakterblattvorlage zu definieren. Sie können die meisten grundlegenden HTML-Tags wiep, div, textarea, input, select, imgin Ihrem Blatt verwenden. Beachten Sie jedoch, dass Roll20 HTML anders verwendet, als Sie es normalerweise erwarten würden. Einige Tags, wie z. B.<button>, verfügen in der Roll20-Umgebung über unterschiedliche Standardfunktionen. Wir werden später in diesem Artikel weiter darauf eingehen.

Beachten Sie, dass Sie in Ihrer Blattvorlage kein Javascript verwenden können, außer im Fall vonSheet Worker-Skripten.

Speicherung von Benutzerdaten

Die meisten HTML-Tags, die zum Speichern von Benutzereingaben verwendet werden, können mit einem bemerkenswerten Unterschied in einem Roll20-Blatt verwendet werden. Für jedes Tag müssen Sieeinname-Attribut einschließen, das mitattr_beginnt. Dies definiert den eindeutigen Attributnamen für das Tag und teilt mit, dass es sich um ein Attribut handelt, das für den Charakter gespeichert werden soll. Dies muss auch für Attribute mit Werten & erfolgen, die der Benutzer nicht bearbeiten kann, damit diese Daten für Berechnungen oder ähnliches verwendet werden können. Alle diese Attribute (außer in sich wiederholenden Abschnitten) werden auf der Registerkarte „Attribute & Fähigkeiten“ auf dem Charakterblatt angezeigt, nachdem sie zum ersten Mal bearbeitet wurden.

Text & Zahlen

Um ein Feld zum Speichern von Text oder vom Benutzer eingegebenen Zahlen zu erstellen, verwenden Sie die Tags<input type="text">,<input type="number">oder<textarea>. (Hinweis: Für<input>Tags muss ein Typ angegeben werden (Text, Zahl, ausgeblendet, Kontrollkästchen oder Radio)).

Beispiel:

<Eingabetyp=„Nummer“ Name=„attr_Strength“ />
<Eingabetyp=„Text“ Name=„attr_class“ />
<=„attr_notes“></textarea>

Wenn Sie möchten, dass das Feld den „max“ eines Attributs anstelle des normalen Werts verwendet, können Sie_maxan den Namen des Felds anhängen, z. B.<input type="number" name="attr_Strength_max" />.

Sie können auch ein< span>Tag verwenden, um einen schreibgeschützten Wert auf Ihrem Blatt anzuzeigen, z. B.< span name="attr_Strength"></ span>. Es ist möglich, ein Span-Tag einzufügen, das denselben Attributnamen wie ein Eingabe-Tag hat, und das Span-Tag wird jedes Mal aktualisiert, wenn die Eingabe geändert wird.

Standardwerte

Sie können dem Tag optional auch ein Attribut mit dem Werthinzufügen, das den Standardwert für das Feld definiert.

Im Folgenden würde beispielsweise ein „AC“-Feld mit dem Standardwert „0“ definiert. Wenn kein Standardwert angegeben ist, handelt es sich um eine leere Zeichenfolge („“).

<Eingabetyp=„Nummer“ Name=„attr_AC“ Wert=„0“ />

Werte automatisch berechnen

Sie können eine Formel in den Standardwert für das Feld einfügen und das Attributinvalid="true"für das Feld angeben. Wenn Sie dies tun, wird auf dem Blatt das Ergebnis der Formel anstelle der Formel selbst angezeigt. Beispielsweise würde<input type="number" name="attr_StrMod" value="@{Strength}/2" disabled="true" />ein „StrMod“-Feld erstellen, das den halben Stärkewert anzeigt. Diese automatisch berechnenden Attribute können wie gewohnt in Sheet Rolls, Makros und Fähigkeiten verwendet werden.

Beachten Sie, dass Sie nur Attribute des aktuellen Charakters einschließen können. Sie können auch keine Makros, Fähigkeiten oder Würfe einbeziehen, sondern nur grundlegende Mathematik wie@{Intelligence}/2+@{Level}. Sie haben auch Zugriff auf die Boden-, Rund- und Deckenfunktionen, z. B.Boden(@{Intelligence}/2).

Wenn Ihr automatisch berechnetes Feld von anderen automatisch berechneten Feldern abhängt, müssen Sie Zwischenformeln in Klammern setzen. Andernfalls könnte es zu Fehleinschätzungen kommen.

Beispiel:

<Eingabetyp=„Nummer“ Name=„attr_StrMod“ Wert=„(@{Strength}/2)“ deaktiviert=„wahr“ />
<Eingabetyp=„Nummer“ Name=„attr_StrModLeveled“ Wert=„@{StrMod}+@{Level}„ deaktiviert=„wahr“ />

Hinweis:Berechnungen werden nicht in der Vorschau angezeigt, sondern nur auf einem Charakterblatt im Spiel.

Die automatische Berechnung von Werten erhöht die Belastung eines Blatts beim Öffnen und sollte daher sparsam verwendet werden. Erwägen Sie die Verwendung vonSheet Worker Scripts, um bedingte Berechnungen durchzuführen.

Charakternamen

Wenn Sie ein Textfeld für den Namen des Charakters hinzufügen, können Sie es automatisch mit dem Charakternamen des Tagebuchs verknüpfen, indem Sie ihm das Attributnamevonattr_character_namezuweisen.

<Eingabetyp=„Text“ Name=„attr_character_name“ />

Verborgen

Es kann nützlich sein, versteckte Variablen auf dem Charakterblatt zu speichern, die der Benutzer nicht sehen muss. In diesem Fall kann der Eingabetyp „versteckt“ verwendet werden. Der Wert der Eingabe wird gespeichert, aber in keiner Weise auf dem Zeichenblatt angezeigt, was es für den Benutzer einfacher macht, als ihn mit CSS ausblenden zu müssen.

Beispiel:

<Eingabetyp=„versteckt“ Wert=„10“ Name=„attr_str_mod“ Wert=„0“ />

Anwendungsfälle: Speichern von Statistiken, die vonSheet Worker Scriptsverwendet werden, Optionen für AdvancedCharacter Sheet Translationund einigeCSS WizardryBeispiele.

Dropdown-Menü

Das Tag<select>kann zum Speichern von Informationen in einer vordefinierten Liste von Optionen verwendet werden, auf die der Benutzer über ein Dropdown-Menü zugreifen kann.

Beispiel:

<Name auswählen=„attr_WoundLevel“>
  <Optionswert=„0“ ausgewählt=„ausgewählt“>Gesund</Option>
  <Optionswert=„1“>Betäubt</Option>
  <Optionswert=„1“>Verwundet</Option>
  <Optionswert=„2“>Zweimal verwundet</Option>
  <Optionswert=„5“>Arbeitsunfähig</Option>
  <Optionswert=„10“107>Tödlich</Option>
</Auswahl>

Um auszuwählen, welche Option standardmäßig ausgewählt ist, geben Sieselected="selected"wie im Beispiel ein.

Kontrollkästchen und Optionsfelder

Für Kontrollkästchen und Optionsfelder müssen Sie immer einWert-Attribut angeben.

Bei Kontrollkästchen gilt: Wenn das Kontrollkästchen aktiviert ist, wird das Attribut auf den Wert des Kontrollkästchens gesetzt. Wenn es nicht aktiviert ist, wird es auf „0“ gesetzt. Wenn Sie möchten, dass ein Kontrollkästchen standardmäßig aktiviert ist, fügen Sie das Attributreviewed="true"hinzu.

Beispiel:

<Eingabetyp=„Kontrollkästchen“ Name=„attr_HasShield“ Wert=„1“ geprüft=„wahr“ />

Wenn bei Optionsfeldern eines der Optionsfelder ausgewählt ist, wird das Attribut auf den Wert dieses Optionsfelds gesetzt. Wenn keine Optionsfelder ausgewählt sind, ist der Wert eine leere Zeichenfolge. Mindestens eines der Optionsfelder sollte das Attributreviewed="true"haben, um einen Standardwert festzulegen. Optionsfelder sind der einzige Feldtyp, bei dem mehr als ein Feld mit demselbenNamen-Attribut vorhanden sein soll.

Beispiel:

<Eingabetyp=„Radio“ Wert=„10“ Name=„attr_Multiplier“ />
<Eingabetyp=„Radio“ Wert=„25“ Name=„attr_Multiplier“ geprüft=„true“ />

Statische Informationen

Allgemeiner Text, wie Namen, & Beschriftungen für verschiedene Felder, & andere Informationen, kann mit den meisten gängigen HTML-Tags angezeigt werden. Das Standard-Erscheinungsbild der meisten Tags variiert ein wenig, kann aber bei Bedarf mit CSS geändert werden.

Beispiel:

<h2>Statistiken</h2>
<span>Charaktername:</span>
<Eingabetyp=„Text“ Name=„attr_character_name“ />

<h1>-<h5>: Gut für Abschnittstitel
<span>,<p>: Gut für einen Textblock, hat nicht viel Formatierung
<label>: Gut zum Beschriften von Eingabefeldern. Ist standardmäßig fett gedruckt und lässt zusätzlichen Platz unter sich
<div>: Im Allgemeinen bestes Tag zur Strukturierung des Blatts. Enthält keinen Stil, kann für Text verwendet werden.

Blattrollen und Rollenknöpfe

Sie können vordefinierte Rollen in Ihr Blatt einfügen. Dies ist eine großartige Möglichkeit, die Würfe hinzuzufügen, die der Spieler benötigt, wenn er die Standardwürfe im Spielsystem verwendet.

Beispielsweise möchten Sie möglicherweise neben jeder Fertigkeit auf dem Blatt eine Schaltfläche „Wurfsprüfung“ hinzufügen. Um eine Roll-Schaltfläche zu definieren, verwenden Sie das Tag<button>. Das-Typ--Attribut ist auf „rollen“ gesetzt. Die Rolle selbst wird im-Wert--Attribut definiert. Sie können auch einName--Attribut hinzufügen, das es ermöglicht, auf den Wurf in externen Makros, Fähigkeiten oder im Chat zu verweisen. Damit der Name funktioniert, muss er das Präfixroll_haben.

Beispiel für einen „Bluff-Check“-Wurf-Button:

<Knopftyp=„Rolle“ Wert=/Rolle 1W20 + @{Bluff}“ Name=„roll_BluffCheck“></Taste>

Die Referenzierung von Attributen/Feldern auf dem Blatt erfolgt mit der Syntax@{AttributeName}. Sie könnten dieses Beispiel dann auch in anderen Makros oder Fähigkeiten mit%{BoB|BluffCheck}würfeln.

Lesen Sie mehr über den Community-Button- -Artikel.

Hinweis:Die Namen, die Sie Ihren Roll-Buttons geben, müssen für alle Fähigkeiten oder anderen Roll-Buttons Ihrer Charaktere eindeutig sein, wenn Sie sie in Fähigkeiten oder Makros referenzieren möchten. Wenn ein Charakterblatt über mehrere Rollschaltflächen mit identischen Namen, aber unterschiedlichen Werten verfügt, führt der Aufruf des Rollschaltflächennamens zum letzten Eintrag im HTML-Code des Blattes.

Siehe auch:

Initiativewurf
Roll-Abfragen– So verwenden Sie Roll-Abfragen in Ihren Schaltflächen
Würfelreferenz– Die Roll20-Würfel-/Mathe-Syntax

Sich wiederholende Abschnitte

Manchmal gibt es einen Objekttyp, bei dem es ein oder mehrere davon gibt, und es ist nicht im Voraus bekannt, wie viele es sind. Ein gutes Beispiel hierfür ist die Liste der Fähigkeiten eines Charakters in Savage Worlds. Mit den Blättern von Roll20 können Sie für jedes Element im Abschnitt eine Vorlage definieren, und der Spieler kann dann so viele davon zur Liste hinzufügen, wie er benötigt. Um einen sich wiederholenden Abschnitt zu definieren, verwenden Sie das Tag<fieldset>. Fügen Sie dem Tag eine Klasse mit dem Namen „repeating_sectionname“ hinzu und fügen Sie innerhalb des Tags die Felder ein, die jedes Element haben wird.

Warnung:Jeder Abschnittsname sollte eindeutig sein und Sie können in Ihrem Abschnittsnamen keine Unterstriche verwenden. Verwenden Sie nicht „repeating_melee_weapon“. Verwenden Sie „repeating_melee“ oder „repeating_meleeweapon“.

Hier ist ein Beispiel für eine Kompetenzliste:


<h3>Skills</h3>
<fieldset class="repeating_skills"> 
  <select name="attr_dtype" class="dtype"> 
    <option value="d4">d4</option>
    <option value="d6">d6</option>
    <option value="d8">d8</option>
    <option value="d10">d10</option>
    <option value="d12">d12</option>
  </select>
  <input type="text" name="attr_skillname" /> 
</fieldset>

Wenn das Blatt angezeigt wird, enthält Roll20 automatisch die Schaltflächen,hinzufügen“ und „ändern“, damit der Spieler von jedem Gegenstand so viele hinzufügen kann, wie er benötigt. Jedes Element hat seinen eigenen Satz von Feldern (im Beispiel oben hat jedes seinen eigenenattr_dtypeundattr_skillname).

Intern wird jedes sich wiederholende Element in einem Attribut wie folgt gespeichert:Repeating_skills_-ABC123_dtypeoderRepeating_skills_$0_Skillname. Die ID (der-ABC123Teil des vorherigen Beispiels) ändert sich nie für eine sich wiederholende Abschnittszeile, sodass Sie in Makros, Fähigkeiten und bei der Verwendung der API darauf verweisen können. Neuen Zeilen, die Sie hinzufügen, wird nach dem Zufallsprinzip eine neue eindeutige ID zugewiesen. Zeilen werden derzeit in der Reihenfolge sortiert, in der sie erstellt wurden.

Hinweis:Alle Attribute im Wiederholungsabschnitt sollten global einen eindeutigen Namen haben. Wenn Sie also attr_Qty in Ihrem Wiederholungsabschnitt haben, sollten Sie kein weiteres Feld mit dem Namen attr_Qty außerhalb eines Wiederholungsabschnitts oder in einem anderen Wiederholungsabschnitt haben. Es ist schwierig oder gar nicht möglich, sich wiederholende Abschnitte um eine HTML-Tabelle herum zu erstellen. Es wird empfohlen, sie in einer einzelnen Zelle zu platzieren.

Layout

Viele Blattautoren empfehlen die Verwendung Ihres eigenen CSS für die Gestaltung und das Layout des Blattes mitCSS Flexboxund/oderCSS Gridanstelle der integrierten Spalten-/Zeilenoption oder HTML-Tabellen.

Roll20 bietet einige grundlegende Klassen, mit denen Sie Dinge in einem einfachen spaltenbasierten Layout organisieren können. Um sie zu nutzen, erstellen Sie einfach ein Div mit der Klasse „3colrow“, „2colrow“ oder „row“. Erstellen Sie dann innerhalb dieses Divs ein Div für jede Spalte mit der Klasse „col“. Um beispielsweise ein 3-Spalten-Layout zu erstellen, können Sie Folgendes tun:

<div class='3colrow'>
  <div class='col'>
    <!-- Put the content for the first column here -->
  </div>
  <div class='col'>
    <!-- Second column -->
  </div>
  <div class='col'>
    <!-- Third column -->
  </div>
</div>

Lesen Sie mehr über die CommunityArtikel „Charakterblatt-Layout entwerfen“.

CSS-Styling

Sie können & CSS verwenden, um den Stil so zu gestalten, wie Ihr Blatt für Spieler aussieht. Sie können nahezu jeden gewünschten CSS-Stil verwenden, einschließlich Hintergrundbilder, Farben, Schriftgrößen usw. Es sind nur ein paar Vorbehalte zu beachten:

Alle Ihre CSS-Stile sind auf die übergeordnete Klasse .charsheet beschränkt. Wenn Sie also einen Stil mit dem Namen „Eingabe“ eingeben, stellt das System diesem automatisch .charsheet „Eingabe“ voran. Dies sollte Sie im Allgemeinen nicht beeinträchtigen, verhindert jedoch, dass Sie das CSS der Roll20-Anwendung außerhalb der Zeichenblätter ändern.
Beachten Sie, dass standardmäßig allen in Ihrem HTML-Layout definierten HTML-Klassen, die nicht mit attr_, roll_ oder Repeating_ beginnen, das Präfix sheet- vorangestellt wird. Wenn Sie beispielsweise einige Ihrer Eingabe-Tags kürzer gestalten möchten als andere und den HTML-Code als <input class='shortfield'>definieren, wird er bei der Verarbeitung Ihres Layouts in <input class='sheet-shortfield'>geändert.

Lesen Sie mehr über den Community-ArtikelCSS Wizardry.

Google-Schriftarten

Google Fonts können in Ihrem CSS mit der@import-Funktion aufgerufen werden:

@import url('https://fonts.googleapis.com/css?family=Sigmar+One&display=swap');

Sie können die Schriftart dann aus Ihrem CSS heraus mit demSchriftfamilie-Attributaufrufen:

Schriftart-Familie: 'Sigmar One';

Dies ist vorerst auf Google Fonts von fonts.googleapis.com beschränkt.

Lesen Sie hier mehr über Google Fonts.

Details zum Dark Mode-Styling

Theme-Schalter
Wenn ein Benutzer in den Dunkelmodus wechselt, fügt die virtuelle Tischplatte dem <body> Element die spezifische CSS-Klasse .sheet-darkmode hinzu. Wenn der Schalter wieder auf Licht gestellt wird, wird diese Klasse entfernt.
Theme-Änderung
Durch das Hinzufügen von Farboptionen am Ende Ihrer Blätter wird das CSS Ihres Blattes, verpackt in einem body.sheet-darkmode { } , Benutzern die Änderung angezeigt, wenn sie den Schalter betätigen.

Erweiterte Blattoptionen

Für ein einfaches Charakterblatt sind keine erweiterten Optionen erforderlich, sie können jedoch die Leistungsfähigkeit und Benutzerfreundlichkeit Ihres Zeichenblatts verbessern.

Standardblatteinstellungen

Auswählbare Optionen können in der Dateisheet.jsonangegeben werden, die mit Ihrem benutzerdefinierten Zeichenblatt geliefert wird. Diese Optionen bieten Standardeinstellungen für alle Charaktere, wenn Ihr Charakterbogen verwendet wird.

Lesen Sie mehr unter Standardblatteinstellungen.

Sheet-Worker-Skripte

Sheet Worker-Skripte sind eine erweiterte Funktion des Character Sheets-Systems, die es dem Blattautor ermöglicht, JavaScript anzugeben, das bei bestimmten Ereignissen ausgeführt wird, beispielsweise immer dann, wenn die Werte auf einem Blatt geändert werden. Es wird dringend empfohlen, diese anstelle der automatisch berechnenden Felder zu verwenden, wenn sich Werte selten ändern, z. B. wenn ein Charakter eine höhere Stufe erreicht oder einen neuen Zauber oder Angriff hinzufügt.

Lesen Sie mehr unterSheet Worker Scripts.

Rollenvorlagen

Mit Rollenvorlagen können Sie vollständig anpassen, wie die Rollen von Ihrem Blatt allen Spielern im Chatfenster angezeigt werden. Es ist eine großartige Möglichkeit, das gesamte Roll20-Erlebnis zu einem gemeinsamen Thema zu machen.

Lesen Sie mehr unterSo erstellen Sie Rollenvorlagen.

Kompendium-Integration

Die Roll20-Kompendium-Funktion ist eine Sammlung von Informationen wie Regeln, Zaubersprüchen, Gegenständen und Monstern für ausgewählte Spielesysteme mit offener Lizenz. Indem Sie festlegen, dass Ihr Blatt mit einem Kompendium kompatibel ist, haben Spieler während des Spiels in der rechten Seitenleiste direkten Zugriff auf dieses Kompendium.

Weitere Informationen finden Sie im Hauptartikelvon Compendium Integration.

Charaktermagier

Der Charactermancer ist ein Roll20-System, das einen Benutzer durch einen Entscheidungsprozess auf dem virtuellen Tisch führt.

Community-Blätter sollten aufgrund möglicher urheberrechtlicher Charaktererstellung oder -entwicklung enthalten. „By Roll20“-Blätter können diesen Inhalt dank unserer Partnerschaften mit Spieleentwicklern enthalten. Blätter, die aus dem Code eines „By Roll20“-Bogens entwickelt werden, müssen sicherstellen, dass jeglicher Code für die Charaktererstellung oder Weiterentwicklungsoptionen entfernt wird. Es ist in Ordnung, Attribute zu haben, die automatisch basierend auf anderen Attributen (einschließlich der aktuellen Ebene) berechnet werden. Wir informieren Sie, wenn Ihr eingereichtes Blatt gegen diese Regel verstößt.

Das Charactermancer-Framework könnte jedoch auch für andere Zwecke verwendet werden, beispielsweise zum Erstellen eines Charakterblatt-Importer-Frameworks.

Shadowrun 5E Blattverwendet Charamancer für den Charakterimport.
Einfachste Charamancer-Verwendung– Forum-Thread, in dem die Integration einfacher Implementierungen diskutiert wird.

Lesen Sie mehr unter Charactermancer Development.

Zeichenblätter übersetzen

Charakterbögen können mithilfe des Crowdsourcing-ÜbersetzungsdienstesCrowdinin andere Sprachen übersetzt werden. Autoren von Charakterblättern haben eine Reihe von Kontrollen darüber, wie das Blatt übersetzt und wie die Übersetzung angezeigt wird. Benutzer, die Übersetzer werden möchten, sollten sich über unserWebformularan uns wenden.

Lesen Sie mehr unterZeichenblattübersetzung.

Roll20-Charakterblätter-Repository

DasRoll20 GitHub-Repositoryist eine Sammlung aller von der Community bereitgestellten Charakterblätter, die für die Verwendung auf Roll20 verfügbar sind. Der beabsichtigte Zweck besteht darin, Fans eine Möglichkeit zu bieten, systemspezifische Unterstützung für Spiele zu erstellen, für die Roll20 kein offizielles Charakterblatt hat. Der Quellcode vieler offizieller Charakterblätter ist im Repository vorhanden, wird jedoch nicht mehr aktualisiert. Dies liegt daran, dass Roll20 seinen Arbeitsablauf geändert hat, um seine eigenen Blätter in einem separaten Repository aufzubewahren.

Eine Reihe älterer Blätter (die nicht in der Dropdown-Liste für die Blattauswahl von Roll20 angezeigt werden) sind ebenfalls im Repository vorhanden.

Patreon- und Tipeee-Verknüpfungsregeln für Community Sheet-Mitwirkende

Blattautoren, die zur Roll20-Community-Charakterblattdatenbank beitragen, dürfen Werbung über die Abonnement-/Spendendienstseiten Patreon und Tipeee schalten. Roll20 ist nicht für den Zahlungsverkehr verantwortlich und kann keine privaten Vereinbarungen durchsetzen.

Um sich zu qualifizieren, muss ein Sheet-Autor zunächst seinen Sheet-Beitrag von den Roll20-Mitarbeitern genehmigen lassen und in die Community-Character-Blatt-Datenbank aufnehmen.

Sie sollten Ihre Patreon- oder Tipeee-Kontoinformationen in die Dateisheet.jsonaufnehmen, die Ihrer Blatteinreichung auf GitHub beigefügt werden sollte.

Wenn Sie mit Patreon oder Tipeee werben möchten, sollte der JSON-Datei eines dieser Felder hinzugefügt werden:

Patreon:Geben Sie hier die URL für eine Patreon-Kampagne ein. Bei Auswahl wird sie unter der Beschreibung Ihres Blattes angezeigt. (z. B. „https://www.patreon.com/<name>“)

Tipeee:Geben Sie hier die URL für ein Tipeee ein. Wenn Sie es auswählen, wird es unter der Beschreibung Ihres Blattes angezeigt. (z. B. „https://www.tipeee.com/<name>“)

Weitere Informationen finden Sie unterhttps://github.com/Roll20/roll20-character-sheets#contributing.

Verlinkung zu Patreon/Tipeee in den Roll20-Foren

Die Verlinkung zu Patreon oder Tipeee in den Roll20-Foren ist nur vorab genehmigten Community-Mitgliedern gestattet, die entweder Charakterblätter oder API-Skripte beigesteuert haben. Wenn Sie Benutzer direkt um eine Finanzierung bitten möchten, können Sie dies privat tun. In einem öffentlichen Forum ohne beigesteuertes Material sind solche Links jedoch nicht gestattet.

Mindestanforderungen und Best Practices für das Community Sheet

Roll20 und die Community haben eine Reihe von Mindestanforderungen für die Einreichung von Arbeitsblättern zusammengestellt. Darüber hinaus haben wir einige allgemeine Best-Practice-Richtlinien beigefügt, um die Konsistenz zwischen den Blattautoren zu erhöhen. Dies trägt dazu bei, ein sauberes und besser wartbares Code-Repository für die Community zu erstellen.

Lesen Sie mehr unterMindestanforderungen & Best Practices.

Siehe auch

Blattvorlagen/Beispiele

Charakterblattvorlage von Roll20
Cassies Flexbox-basierte Blattvorlage
CSS-Rasterblattvorlage
Blattvorlage basierend auf Blades in the Darkvon Jakob
Einfaches Beispiel: Das Kitchen Sink-Beispiel von Roll20 ist ein Beispiel für ein einfaches Savage Worlds-Blatt, bestehend aus einer HTML & CSS-Datei, und zeigt, wie die meisten grundlegenden Steuerelemente verwendet werden, die beim Erstellen eines Roll20-Blatts verfügbar sind. Für das Layout werden die integrierten Spalten & Zeilen von Roll20 verwendet.
Mittleres Beispiel: Das Feast of Legends-Blatt kann als mittleres Beispiel angesehen werden, das einige Sheetworker und ein erweitertes Layout mit Bildern & CSS-Raster verwendet.
Erweitertes Beispiel: Das D&D5E von Roll20-Blattkann dagegen als Beispiel für die fortschrittlichsten Blätter angesehen werden, die Sheet Workers, Kompendium-Integration, Rollenvorlagen, Übersetzungsfunktionen & Standardoptionen nutzen. Der Quellcode enthält auch zugehörige PUG & SCSS-Dateien, die für die Entwicklung verwendet werden, aber nicht notwendig sind.

Nützliche Skripte

SublimeSettings– Roll20-spezifische HTML-Syntaxhervorhebung fürSublime Text
ACSI– Automatisierung zum Hinzufügen von Übersetzungsattributen zu einem Blatt