Fertigkeitenvorlagencode: Unterschied zwischen den Versionen
(29 dazwischenliegende Versionen von 9 Benutzern werden nicht angezeigt) | |||
Zeile 1: | Zeile 1: | ||
[[Kategorie:Spielmechanik]] | |||
==allgemeines Format== | ==allgemeines Format== | ||
Die Fertigkeitenvorlage ist ein Bitstream in einer Zeile, der nach der [http://www.faqs.org/rfcs/rfc3548.html RFC3548] base64 verschlüsselt ist. Es werden '''+''' und '''/''' als 62. und 63. Zeichen verwendet. | Die Fertigkeitenvorlage ist ein Bitstream in einer Zeile, der nach der [http://www.faqs.org/rfcs/rfc3548.html RFC3548] base64 verschlüsselt ist. Es werden '''+''' und '''/''' als 62. und 63. Zeichen verwendet. | ||
Zeile 8: | Zeile 9: | ||
Wenn das Template vor dem Update am 5. April 2007 erstellt wurde: | Wenn das Template vor dem Update am 5. April 2007 erstellt wurde: | ||
*4 | *4 Bits - immer 0, Versionsnummer | ||
Wenn die Vorlage nach dem Update erstellt wurde: | Wenn die Vorlage nach dem Update erstellt wurde: | ||
*4 | *4 Bits - immer 14, steht für den Vorlagentyp (14 = Fertigkeitenvorlage) | ||
*4 | *4 Bits - immer 0, Versionsnummer | ||
===Klassen=== | ===Klassen=== | ||
Jetzt werden die beiden Klassen beschrieben: | Jetzt werden die beiden Klassen beschrieben: | ||
*2 | *2 Bits - Zusätzliche Bits zu 4 Standardbits, für die Verschlüsselung jeder Klassenid, wobei gilt <code>Code*2 + 4 = Gesamtzahl</code> (zurzeit ist der Code immer 0, also ist jede Klasse mit 4 Bits codiert) | ||
*n | *4 (<code>+ 2*n</code>) Bits - Primärklasse (siehe unten) | ||
*n | *4 (<code>+ 2*n</code>) Bits - Sekundärklasse (siehe unten) | ||
===Attribute=== | ===Attribute=== | ||
Nun folgen die Attribute: | Nun folgen die Attribute: | ||
*4 | *4 Bits - Anzahl der Attribute, die kodiert werden | ||
*4 | *4 Bits - Anzahl (n) der Bits, die zusätzlich zu 4 Standardbits für die Verschlüsselung jeder Attributs-ID verwendet wurden | ||
Danach für jedes Attribut: | Danach für jedes Attribut: | ||
*n | *4 (+ n) Bits - Die ID des Attributs (siehe unten) | ||
*4 | *4 Bits - Rang des Attributs | ||
===Fertigkeiten=== | ===Fertigkeiten=== | ||
Jetzt die acht Fertigkeiten: | Jetzt die acht Fertigkeiten: | ||
*4 | *4 Bits - Anzahl (n) der Bits, die zusätzlich zu 8 Standardbits für die Verschlüsselung der Fertigkeiten-IDs verwendet wurden | ||
Danach für jede Fertigkeit (also acht mal): | Danach für jede Fertigkeit (also acht mal): | ||
*n | *8 (+ n) Bits - ID der Fertigkeit (siehe unten) | ||
==Base64 nach Oktal konvertieren== | ==Base64 nach Oktal konvertieren== | ||
Der Windows Rechner kann im wissenschaftlichen Modus dezimal zu oktal umrechnen. | Der Windows-Rechner kann im wissenschaftlichen Modus dezimal zu oktal umrechnen. | ||
Paare von oktalen Ziffern können mit dieser Tabelle ver- und entschlüsselt werden. | Paare von oktalen Ziffern können mit dieser Tabelle ver- und entschlüsselt werden. | ||
{| {{Prettytable}} | {| {{Prettytable}} | ||
|- | |- | ||
|00||A||10||I||20||Q||30||Y||40||g||50||o||60||w||70||4 | |00||A||rowspan=8| ||10||I||rowspan=8| ||20||Q||rowspan=8| ||30||Y||rowspan=8| ||40||g||rowspan=8| ||50||o||rowspan=8| ||60||w||rowspan=8| ||70||4 | ||
|- | |- | ||
|01||B||11||J||21||R||31||Z||41||h||51||p||61||x||71||5 | |01||B||11||J||21||R||31||Z||41||h||51||p||61||x||71||5 | ||
Zeile 60: | Zeile 61: | ||
|07||H||17||P||27||X||37||f||47||n||57||v||67||3||77||/ | |07||H||17||P||27||X||37||f||47||n||57||v||67||3||77||/ | ||
|} | |} | ||
{{Hinweis|Der Taschenrechner rechnet mit Big Endian (das menschliche Stellenwertsystem, das mit den höchstwertigen Ziffern beginnt), allerdings nutzt Guild Wars Little Endian (kleinste Stelle zuerst). Du musst also die binären Zahlen vorn mit Nullen auf sechs Stellen auffüllen und sie danach umdrehen.}} | |||
{{Hinweis|Guild Wars verwendet das Little Endian-Format, und zwar sowohl zwischen Zahlenwerten und Binärarray als auch zwischen Binärarray und Base64-Wert. Base64 verwendet offiziell das Big Endian-Format. Dadurch ist es nicht möglich, normal verfügbare Methoden zur Arbeit mit Base64 zu verwenden, wenn Guild Wars-Vorlagencodes erstellt werden sollen.}} | |||
==Beispiel== | ==Beispiel== | ||
Für ein Komplettbeispiel siehe [[Fertigkeitenvorlagencode/Beispiel|hier]]. | |||
==Implementierung== | |||
===Lesen=== | |||
Um das Guild-Wars-Vorlagenformat zu lesen, sollte man zunächst einmal die Daten in binärer Form irgendwo speichern, um bitgenau darauf zugreifen zu können, zum Beispiel in einem String (aus 1 und 0) oder einem Array. Es sollten 576 Einträge möglich sein, da sich die wichtigen Informationen in Fertigkeitenvorlagencodes nur in den ersten 572 Bits befinden können (die 4 Bit danach füllen das letzte Base64-Zeichen auf). Wenn man diesen Speicher nach dem Einlesen mit Nullen füllt, kann es beim Lesen ungültiger Codes keine Fehler geben, bloß sinnlose Rückgabewerte. Zum Lesen verwendet man dann eine Funktion, der man sagt, ab welcher Bitstelle sie wie viele Bits lesen und entsprechend aufsummieren soll. | |||
===Schreiben=== | |||
Zum Schreiben von Vorlagencodes mit dem vollen Funktionsumfang nimmt man sich am besten wieder einen oben beschriebenen Speicher für die Binärdaten. Den füllt man dann mit den Daten. Der erste Schritt beim Schreiben von Vorlagencodes muss aber sein, dass man die zusätzlich benötigten Bits bestimmt. Bei den Klassen kann man 0 annehmen, da es in Guild Wars weniger als 16 Klassen gibt, was das durch die Grund-Größe definierte Minimum ist. Bei der Entwicklung der Codes ging man übrigens davon aus, dass Guild Wars einmal über 1.000 verschiedene Klassen (nicht Kombinationen) enthalten würde (2<sup>4+2·3</sup>). Bei den anderen beiden (Attribute und Fertigkeiten) muss man schauen, unter (nicht in!) welcher Zweierpotenz alle jeweiligen Werte liegen. | |||
Hat man alle Daten in diesen Speicher geschrieben, füllt man ihn auf volle 6 Bits auf und macht Base64-Zeichen draus. | |||
====Nur Klassen und Fertigkeiten schreiben==== | |||
Wenn man einfach nur Klassen und Fertigkeiten speichern will, gibt es dazu eine sehr banale Möglichkeit. Man kann nämlich die Angaben für die zusätzlich benötigten Bits so wählen, dass jede Klasse genau ein einzelnes Zeichen und jede Fertigkeit genau zwei einzelne Zeichen einnimmt. Dann braucht man diese Zeichen zusammen mit dem Header und den zusätzlich benötigten Bits nur noch hintereinander schreiben und erhält einen gültigen Vorlagencode, auch wenn Codes, die mit Q beginnen, vielleicht etwas ungewöhnlich aussehen. | |||
function vorlagencode($primärklasse, $sekundärklasse, $fertigkeiten) { | |||
$schlüssel = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/'; | |||
$vorlagencode = 'Q' . $schlüssel[$primärklasse] . $schlüssel[$sekundärklasse] . 'AQ'; | |||
for( $i = 0; $i < 8; $i++ ) { | |||
$vorlagencode .= $schlüssel[$fertigkeiten[$i] % 64] . $schlüssel[floor($fertigkeiten[$i] / 64)]; | |||
} | |||
return $vorlagencode; | |||
} | |||
==Codes== | ==Codes== | ||
Zeile 146: | Zeile 150: | ||
===Fertigkeiten-Codes=== | ===Fertigkeiten-Codes=== | ||
{| class="versteckte-liste" style="white-space: no-wrap;" | |||
| | |||
*0 - [[Bild:Beliebig.jpg|25px|link=]] leer | |||
*1 - {{Fertigkeit icon|Siegel der Heilung|nein}} | |||
*2 - {{Fertigkeit icon|Siegel der Wiederbelebung|nein}} | |||
*3 - {{Fertigkeit icon|Siegel der Erbeutung|nein}} | |||
*5 - {{Fertigkeit icon|Kraftblock|nein}} | |||
*6 - {{Fertigkeit icon|Mantra der Erde|nein}} | |||
*7 - {{Fertigkeit icon|Mantra des Feuers|nein}} | |||
*8 - {{Fertigkeit icon|Mantra des Frosts|nein}} | |||
*9 - {{Fertigkeit icon|Mantra des Blitzes|nein}} | |||
*10 - {{Fertigkeit icon|Gebrochene Verhexung|nein}} | |||
*11 - {{Fertigkeit icon|Verzerrung|nein}} | |||
*13 - {{Fertigkeit icon|Mantra der Erholung|nein}} | |||
*14 - {{Fertigkeit icon|Mantra des Bestehens|nein}} | |||
*15 - {{Fertigkeit icon|Mantra der Inschriften|nein}} | |||
*16 - {{Fertigkeit icon|Mantra der Konzentration|nein}} | |||
*17 - {{Fertigkeit icon|Mantra des Abschlusses|nein}} | |||
*18 - {{Fertigkeit icon|Mantra der Siegel|nein}} | |||
*19 - {{Fertigkeit icon|Zerbrechlichkeit|nein}} | |||
*21 - {{Fertigkeit icon|Inspirierte Verzauberung|nein}} | |||
*22 - {{Fertigkeit icon|Inspirierte Verhexung|nein}} | |||
*23 - {{Fertigkeit icon|Kraftdorn|nein}} | |||
*24 - {{Fertigkeit icon|Kraftleck|nein}} | |||
*25 - {{Fertigkeit icon|Kraftentzug|nein}} | |||
*26 - {{Fertigkeit icon|Empathie|nein}} | |||
*27 - {{Fertigkeit icon|Täuschungen brechen|nein}} | |||
*28 - {{Fertigkeit icon|Rückschlag|nein}} | |||
*29 - {{Fertigkeit icon|Blackout|nein}} | |||
*30 - {{Fertigkeit icon|Ablenkung|nein}} | |||
*31 - {{Fertigkeit icon|Trugbild beschwören|nein}} | |||
*32 - {{Fertigkeit icon|Illusion der Schwäche|nein}} | |||
*33 - {{Fertigkeit icon|Illusion der Waffen|nein}} | |||
*34 - {{Fertigkeit icon|Sympathisches Gesicht|nein}} | |||
*35 - {{Fertigkeit icon|Ignoranz|nein}} | |||
*36 - {{Fertigkeit icon|Arkanes Rätsel|nein}} | |||
*37 - {{Fertigkeit icon|Illusion der Eile|nein}} | |||
*38 - {{Fertigkeit icon|Kanalisieren|nein}} | |||
*39 - {{Fertigkeit icon|Energiewelle|nein}} | |||
*40 - {{Fertigkeit icon|Ätherschmaus|nein}} | |||
*41 - {{Fertigkeit icon|Herr über den Äther|nein}} | |||
*42 - {{Fertigkeit icon|Energiebrand|nein}} | |||
*43 - {{Fertigkeit icon|Ungeschick|nein}} | |||
*44 - {{Fertigkeit icon|Phantomschmerz|nein}} | |||
*45 - {{Fertigkeit icon|Ätherische Bürde|nein}} | |||
*46 - {{Fertigkeit icon|Schuld|nein}} | |||
*47 - {{Fertigkeit icon|Unbeholfenheit|nein}} | |||
*48 - {{Fertigkeit icon|Geist des Versagens|nein}} | |||
*49 - {{Fertigkeit icon|Geistiges Wrack|nein}} | |||
*50 - {{Fertigkeit icon|Verschwendung|nein}} | |||
*51 - {{Fertigkeit icon|Schande|nein}} | |||
*52 - {{Fertigkeit icon|Panik|nein}} | |||
*53 - {{Fertigkeit icon|Migräne|nein}} | |||
*54 - {{Fertigkeit icon|Verkrüppelnde Qual|nein}} | |||
*55 - {{Fertigkeit icon|Fieberträume|nein}} | |||
*56 - {{Fertigkeit icon|Beruhigende Bilder|nein}} | |||
*57 - {{Fertigkeit icon|Schrei der Frustration|nein}} | |||
*58 - {{Fertigkeit icon|Siegel der Mitternacht|nein}} | |||
*59 - {{Fertigkeit icon|Siegel der Müdigkeit|nein}} | |||
*61 - {{Fertigkeit icon|Blutsauger-Siegel|nein}} | |||
*62 - {{Fertigkeit icon|Siegel der Demut|nein}} | |||
*63 - {{Fertigkeit icon|Schlussstein-Siegel|nein}} | |||
*65 - {{Fertigkeit icon|Arkane Mimikry|nein}} | |||
*66 - {{Fertigkeit icon|Geistfesseln|nein}} | |||
*67 - {{Fertigkeit icon|Verhexung brechen|nein}} | |||
*68 - {{Fertigkeit icon|Verzauberung entziehen|nein}} | |||
*69 - {{Fertigkeit icon|Verzauberung brechen|nein}} | |||
*72 - {{Fertigkeit icon|Elementarwiderstand|nein}} | |||
*73 - {{Fertigkeit icon|Körperlicher Widerstand|nein}} | |||
*74 - {{Fertigkeit icon|Echo|nein}} | |||
*75 - {{Fertigkeit icon|Arkanes Echo|nein}} | |||
*76 - {{Fertigkeit icon|Eingebildete Bürde|nein}} | |||
*77 - {{Fertigkeit icon|Chaossturm|nein}} | |||
*78 - {{Fertigkeit icon|Epidemie|nein}} | |||
*79 - {{Fertigkeit icon|Energieentzug|nein}} | |||
*80 - {{Fertigkeit icon|Energie abzapfen|nein}} | |||
*81 - {{Fertigkeit icon|Arkaner Diebstahl|nein}} | |||
*82 - {{Fertigkeit icon|Mantra der Zurückrufung|nein}} | |||
*83 - {{Fertigkeit icon|Knochenschreck beleben|nein}} | |||
*84 - {{Fertigkeit icon|Knochenteufel beleben|nein}} | |||
*85 - {{Fertigkeit icon|Knochendiener beleben|nein}} | |||
*86 - {{Fertigkeit icon|Grenths Ausgleich|nein}} | |||
*87 - {{Fertigkeit icon|Veratas Starren|nein}} | |||
*88 - {{Fertigkeit icon|Veratas Aura|nein}} | |||
*89 - {{Fertigkeit icon|Tödliche Kühlung|nein}} | |||
*90 - {{Fertigkeit icon|Veratas Opfer|nein}} | |||
*91 - {{Fertigkeit icon|Brunnen der Kraft|nein}} | |||
*92 - {{Fertigkeit icon|Brunnen des Blutes|nein}} | |||
*93 - {{Fertigkeit icon|Brunnen | |||
{{en|Skill template format}} | {{en|Skill template format}} |
Aktuelle Version vom 4. April 2018, 16:00 Uhr
allgemeines Format[Bearbeiten]
Die Fertigkeitenvorlage ist ein Bitstream in einer Zeile, der nach der RFC3548 base64 verschlüsselt ist. Es werden + und / als 62. und 63. Zeichen verwendet.
Der Bitstream besteht aus folgender Abfolge von verschieden langen Sequenzen:
Header[Bearbeiten]
Zuerst werden die Header (Typ und Version) beschrieben:
Wenn das Template vor dem Update am 5. April 2007 erstellt wurde:
- 4 Bits - immer 0, Versionsnummer
Wenn die Vorlage nach dem Update erstellt wurde:
- 4 Bits - immer 14, steht für den Vorlagentyp (14 = Fertigkeitenvorlage)
- 4 Bits - immer 0, Versionsnummer
Klassen[Bearbeiten]
Jetzt werden die beiden Klassen beschrieben:
- 2 Bits - Zusätzliche Bits zu 4 Standardbits, für die Verschlüsselung jeder Klassenid, wobei gilt
Code*2 + 4 = Gesamtzahl
(zurzeit ist der Code immer 0, also ist jede Klasse mit 4 Bits codiert) - 4 (
+ 2*n
) Bits - Primärklasse (siehe unten) - 4 (
+ 2*n
) Bits - Sekundärklasse (siehe unten)
Attribute[Bearbeiten]
Nun folgen die Attribute:
- 4 Bits - Anzahl der Attribute, die kodiert werden
- 4 Bits - Anzahl (n) der Bits, die zusätzlich zu 4 Standardbits für die Verschlüsselung jeder Attributs-ID verwendet wurden
Danach für jedes Attribut:
- 4 (+ n) Bits - Die ID des Attributs (siehe unten)
- 4 Bits - Rang des Attributs
Fertigkeiten[Bearbeiten]
Jetzt die acht Fertigkeiten:
- 4 Bits - Anzahl (n) der Bits, die zusätzlich zu 8 Standardbits für die Verschlüsselung der Fertigkeiten-IDs verwendet wurden
Danach für jede Fertigkeit (also acht mal):
- 8 (+ n) Bits - ID der Fertigkeit (siehe unten)
Base64 nach Oktal konvertieren[Bearbeiten]
Der Windows-Rechner kann im wissenschaftlichen Modus dezimal zu oktal umrechnen. Paare von oktalen Ziffern können mit dieser Tabelle ver- und entschlüsselt werden.
00 | A | 10 | I | 20 | Q | 30 | Y | 40 | g | 50 | o | 60 | w | 70 | 4 | |||||||
01 | B | 11 | J | 21 | R | 31 | Z | 41 | h | 51 | p | 61 | x | 71 | 5 | |||||||
02 | C | 12 | K | 22 | S | 32 | a | 42 | i | 52 | q | 62 | y | 72 | 6 | |||||||
03 | D | 13 | L | 23 | T | 33 | b | 43 | j | 53 | r | 63 | z | 73 | 7 | |||||||
04 | E | 14 | M | 24 | U | 34 | c | 44 | k | 54 | s | 64 | 0 | 74 | 8 | |||||||
05 | F | 15 | N | 25 | V | 35 | d | 45 | l | 55 | t | 65 | 1 | 75 | 9 | |||||||
06 | G | 16 | O | 26 | W | 36 | e | 46 | m | 56 | u | 66 | 2 | 76 | + | |||||||
07 | H | 17 | P | 27 | X | 37 | f | 47 | n | 57 | v | 67 | 3 | 77 | / |
Beispiel[Bearbeiten]
Für ein Komplettbeispiel siehe hier.
Implementierung[Bearbeiten]
Lesen[Bearbeiten]
Um das Guild-Wars-Vorlagenformat zu lesen, sollte man zunächst einmal die Daten in binärer Form irgendwo speichern, um bitgenau darauf zugreifen zu können, zum Beispiel in einem String (aus 1 und 0) oder einem Array. Es sollten 576 Einträge möglich sein, da sich die wichtigen Informationen in Fertigkeitenvorlagencodes nur in den ersten 572 Bits befinden können (die 4 Bit danach füllen das letzte Base64-Zeichen auf). Wenn man diesen Speicher nach dem Einlesen mit Nullen füllt, kann es beim Lesen ungültiger Codes keine Fehler geben, bloß sinnlose Rückgabewerte. Zum Lesen verwendet man dann eine Funktion, der man sagt, ab welcher Bitstelle sie wie viele Bits lesen und entsprechend aufsummieren soll.
Schreiben[Bearbeiten]
Zum Schreiben von Vorlagencodes mit dem vollen Funktionsumfang nimmt man sich am besten wieder einen oben beschriebenen Speicher für die Binärdaten. Den füllt man dann mit den Daten. Der erste Schritt beim Schreiben von Vorlagencodes muss aber sein, dass man die zusätzlich benötigten Bits bestimmt. Bei den Klassen kann man 0 annehmen, da es in Guild Wars weniger als 16 Klassen gibt, was das durch die Grund-Größe definierte Minimum ist. Bei der Entwicklung der Codes ging man übrigens davon aus, dass Guild Wars einmal über 1.000 verschiedene Klassen (nicht Kombinationen) enthalten würde (24+2·3). Bei den anderen beiden (Attribute und Fertigkeiten) muss man schauen, unter (nicht in!) welcher Zweierpotenz alle jeweiligen Werte liegen.
Hat man alle Daten in diesen Speicher geschrieben, füllt man ihn auf volle 6 Bits auf und macht Base64-Zeichen draus.
Nur Klassen und Fertigkeiten schreiben[Bearbeiten]
Wenn man einfach nur Klassen und Fertigkeiten speichern will, gibt es dazu eine sehr banale Möglichkeit. Man kann nämlich die Angaben für die zusätzlich benötigten Bits so wählen, dass jede Klasse genau ein einzelnes Zeichen und jede Fertigkeit genau zwei einzelne Zeichen einnimmt. Dann braucht man diese Zeichen zusammen mit dem Header und den zusätzlich benötigten Bits nur noch hintereinander schreiben und erhält einen gültigen Vorlagencode, auch wenn Codes, die mit Q beginnen, vielleicht etwas ungewöhnlich aussehen.
function vorlagencode($primärklasse, $sekundärklasse, $fertigkeiten) { $schlüssel = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/'; $vorlagencode = 'Q' . $schlüssel[$primärklasse] . $schlüssel[$sekundärklasse] . 'AQ'; for( $i = 0; $i < 8; $i++ ) { $vorlagencode .= $schlüssel[$fertigkeiten[$i] % 64] . $schlüssel[floor($fertigkeiten[$i] / 64)]; } return $vorlagencode; }
Codes[Bearbeiten]
Klassen-Codes[Bearbeiten]
- 0 - Keine (nur für Sekundär-Klasse)
- 1 - Krieger
- 2 - Waldläufer
- 3 - Mönch
- 4 - Nekromant
- 5 - Mesmer
- 6 - Elementarmagier
- 7 - Assassine
- 8 - Ritualist
- 9 - Paragon
- 10 - Derwisch
Attribut-Codes[Bearbeiten]
- 0 - Schnellwirkung
- 1 - Illusionsmagie
- 2 - Beherrschungsmagie
- 3 - Inspirationsmagie
- 4 - Blutmagie
- 5 - Todesmagie
- 6 - Seelensammlung
- 7 - Flüche
- 8 - Luftmagie
- 9 - Erdmagie
- 10 - Feuermagie
- 11 - Wassermagie
- 12 - Energiespeicherung
- 13 - Heilgebete
- 14 - Peinigungsgebete
- 15 - Schutzgebete
- 16 - Gunst der Götter
- 17 - Stärke
- 18 - Axtbeherrschung
- 19 - Hammerbeherrschung
- 20 - Schwertkunst
- 21 - Taktik
- 22 - Tierbeherrschung
- 23 - Fachkenntnis
- 24 - Überleben in der Wildnis
- 25 - Treffsicherheit
- 26 - ?
- 27 - ?
- 28 - ?
- 29 - Dolchbeherrschung
- 30 - Tödliche Künste
- 31 - Schattenkünste
- 32 - Zwiesprache
- 33 - Wiederherstellungsmagie
- 34 - Kanalisierungsmagie
- 35 - Kritische Stöße
- 36 - Macht des Herbeirufens
- 37 - Speerbeherrschung
- 38 - Befehlsgewalt
- 39 - Motivation
- 40 - Führung
- 41 - Sensenbeherrschung
- 42 - Windgebete
- 43 - Erdgebete
- 44 - Mystik