KQuote ist ein AddOn, das es erlaubt, Ton-Zitate („Quotes“) über den in WoW eingebauten Chat zu „verschicken“.

Es basiert auf WoWQuote von Lev@Die Ewige Wacht und Harag@Die Ewige Wacht. An dieser Stelle meinen herzlichen Dank!

Natürlich kann KQuote nicht wirklich Töne an andere Spieler senden. Statt dessen postet es ganz normalen Text in den Chat, der eine ID des gewünschten Zitats enthält.
Hat der Empfänger ebenfalls KQuote installiert, erkennt dieses die ID und spielt den zugehörigen Sound ab.

Inhalt

Neu in KQuote
Umstieg von WoWQuote
Benutzung / Chat-Befehle
Media-AddOns erstellen
Was brauche ich?
Schritt-für-Schritt-Anleitung
Mögliche Fehler

Neu in KQuote

Inhalt

KQuote bietet gegenüber WoWQuote (v0.x) einige Vorteile:

Mute

Mit /kqm kann man KQuote stummschalten. Nochmalige Eingabe von /kqm schaltet die Tonausgabe wieder an. Diese Einstellung wird beim Ausloggen nicht gespeichert.
Der Mute-Funktion könnt ihr unter Optionen – Tastaturbelegung auch ein Tastenkürzel zuweisen.

Tags

Statt Kategorien benutzt KQuote Tags. Der Unterschied ist, daß ein einzelnes Zitat mehrere Tags haben kann. (Ihr könnt Euch natürlich auch vorstellen, daß es mehreren Kategorien zugeordnet ist.)

Suchfeld

In das Feld oben rechts im KQuote-Fenster kann man einen Suchtext eintragen. Es werden dann nur die Zitate angezeigt, deren Beschreibung den entsprechenden Text enthält. Dies funktioniert auch in Verbindung mit der Tag-Auswahl.

Schnellsuche

Gibt man beim Aufruf von KQuote hinter /kq einen Suchtext an, wird dieser automatisch in das Suchfeld des KQuote-Fensters eingetragen. /kq -t <tag> wählt das entsprechende Tag aus. Mehr dazu hier.

Separate Media-AddOns

In KQuote sind die eigentlichen Media-Daten in getrennten AddOns untergebracht. Das hat mehrere Vorteile:

Bei kleineren Änderungen an KQuote muß man nicht immer alle Sound-Dateien neu herunterladen.
Es lassen sich Zitate hinzufügen, ohne daß die alten Daten nochmals geladen werden müssen.

Wie man neue Media-AddOns schreibt, könnt ihr hier nachlesen.

Umstieg von WoWQuote

Inhalt

KQuote ist weitgehend kompatibel zu WoWQuote (Fan-Update 0.9c).
Das heißt, es erkennt alle alten Quotes und spielt sie ab. Umgekehrt werden alle alten Zitate so gesendet, daß sie auch von WoWQuote abgespielt werden. (Neue, wie zum Beispiel die von Barlow, kann WoWQuote natürlich nicht abspielen, da sie einfach nicht vorhanden sind.)

Benutzung / Chat-Befehle

Inhalt

KQuote ist im Normalfall nicht in der WoW-Benutzeroberfläche zu sehen. Es tut im Hintergrund seinen Dienst, erkennt Tonzitate und spielt sie ab.

Wollt ihr selbst etwas per KQuote senden, könnt ihr dazu direkt die Chat-Befehle benutzen, oder das Auswahl-Fenster öffnen - ebenfalls per Chat-Befehl.

/kq [<Suchbegriff>|-t <Tag>]: Öffnet oder schließt das Auswahl-Fenster.
Ist ein Suchbegriff oder ein Tag angegeben, wird dieser in das Suchfeld eingetragen bzw. das Tag ausgewählt.
/kqh: Zeigt eine Liste der Chat-Befehle an.
/kqm: Schaltet die Tonausgabe ab bzw. wieder an. Diese Einstellung wird nicht gespeichert. Das heißt, beim nächsten Start ist die Ausgabe auf jeden Fall wieder aktiviert.
/kqc [<Channel>] ["on"|"off"]: Zeigt oder verwaltet die Einstellungen für einen Channel. Mögliche Channels: s(ay), p(arty), r(aid), g(uild) oder (o)fficer. Diese Einstellung wird gespeichert.
/kqt: Listet alle verfügbaren Tags mit ihrer Beschreibung im Chat auf. Die Tag-Beschreibung ist das, was man im rechten Dropdown-Menü des Auswahl-Fensters sieht.
/kql <Tag>: Listet alle Zitate mit dem gegebenen Tag im Chat auf.
/kqf <Suchbegriff>: Listet alle Zitate, die den gegebenen Suchbegriff enthalten im Chat auf.
/kqa [<Alias> [<Quote-ID>]]: Legt einen Aliasnamen für ein Zitat fest. Wenn die Quote-ID fehlt, wird der Alias gelöscht.
/kqs <Quote-ID|Alias>: In die Umgebung posten.
/kqp <Quote-ID|Alias>: In den Gruppenchannel posten.
/kqg <Quote-ID|Alias>: In den Gildenchannel posten.
/kqr <Quote-ID|Alias>: In den Raidchannel posten.
/kqo <Quote-ID|Alias>: In den Offizierschannel posten.

Media-AddOns erstellen

Inhalt

Media-AddOns funktionieren zwar nur in Verbindung mit KQuote, trotzdem sind es technisch eigenständige AddOns.
Sie haben daher die gleich Ordner-Struktur wie andere AddOns und werden auch genauso installiert.

Was brauche ich?

Inhalt

einen Entpacker für ZIP-Dateien
einen Texteditor, der Dateien mit UTF8-Kodierung lesen und schreiben kann
(für Windows z.B. notepad2; auf dem Mac einfach das beiliegende TextEdit)
Tondateien mit den gewünschten Zitaten ;)

Schritt-für-Schritt-Anleitung

Inhalt

Diese Vorlage für ein Media-AddOn (KQMediaTemplate.zip, 6 KB) laden.
Archiv auspacken und das „Template“ im Ordnernamen durch einen passenden Namen für das neue AddOn ersetzen. (Der Ordner heißt danach z.B. „KQMediaMeins“.)
Die Namen der beiden Dateien innerhalb des Ordners (KQMediaTemplate.toc und MediaTemplate.lua) ebenfalls entsprechend abändern.
Die .toc-Datei öffnen und alle Vorkommen von „Template“ durch den neuen Namen ersetzen. Die übrigen Angaben, wie Author, URL und Title sollten natürlich auch angepaßt werden.
Nun die .lua-Datei öffnen und dort ebenfalls jedes „Template“ durch den neuen AddOn-Namen ersetzen. (Alle betreffenden Zeilen sind in der Datei mit !!! markiert.)
Außerdem muß in der Zeile local moduleid = "tpl"; das tpl durch ein Kürzel für das neue AddOn ersetzt werden. Dieses Kürzel muß eindeutig sein. Es können keine zwei Media-AddOns mit dem gleichen Kürzel benutzt werden. Es sollte aber auch kurz sein, da es Teil der ID ist, die im Chat gepostet wird.
Zwischen diesen beiden Zeilen …
-- replace this list of data with your own
-- end of media data
… müssen nun die Daten für die einzelnen Zitate eingetragen werden. Das genaue Format ist hier beschrieben.
Zuletzt noch die einzelnen Tondateien (vorzugsweise im MP3-Format) in den media-Ordner innerhalb des AddOn-Ordners legen.

Wenn Du alles richtig gemacht hast, hast Du nun Dein eigenes, funktionsfähiges Media-AddOn!

Zum Testen legst Du es in den WoW-AddOns-Ordner und startest WoW neu. Überprüfe, daß das AddOn aktiviert ist und log dann ein. Wenn die neuen Zitate abspielbar sind, mußt Du das AddOn nur noch an alle Deine Freunde verteilen, damit die sie auch hören können. :)

Media-Daten

Inhalt

Ein einzelner Eintrag innerhalb der .lua-Datei sieht so aus:

{
    id = "tpl:02",
    file = "secondfile.mp3",
    len = 4,
    msg = "Description for second file",
},

Die id besteht aus dem Kürzel des AddOns, gefolgt von einem Doppelpunkt und einer laufenden Nummer.

file gibt den Namen der Tondatei im media-Ordner an.

len ist die Länge des Zitats in Sekunden.

msg enthält die Beschreibung für das Zitat.

Wahlweise können dem Eintrag noch ein oder mehrere Tags hinzugefügt werden. Das sieht dann so aus:

{
    id = "tpl:02",
    file = "secondfile.mp3",
    len = 4,
    msg = "Description for second file",
    tags = {"hi", "rogue"}
},

Dieses Zitat taucht unter den Rubriken Hi und Schurke auf. Die Standard-Rubriken sind in der Datei Localization.de.lua innerhalb des KQuote-Ordners definiert.

Mögliche Fehler

Inhalt

Das AddOn wird nicht geladen.

Stelle sicher, daß …

… der Name der .lua-Datei innerhalb der .toc-Datei korrekt angegeben ist.
… Du alle Vorkommen von Template durch den neuen Namen ersetzt hast.

WoW zeigt beim Laden eine Fehlermeldung.

Stelle sicher, daß Du keinen Syntax-Fehler in die .lua-Datei eingebaut hast; wie zum Beispiel ein vergessenes Komma oder Semikolon.

Ein oder mehrere Zitate lassen sich nicht abspielen.

WoW kann nur Tondateien im MP3- oder WAV-Format abspielen.
Stelle sicher, daß die Dateinamen in der .lua-Datei den Dateinamen innerhalb des media-Ordners entsprechen.

Umlaute oder andere Sonderzeichen werden falsch dargestellt.

Die .lua-Datei muß mit UTF8-Zeichenkodierung abgespeichert werden. Überprüfe die Einstellungen Deines Editors.