EQdkp Plus Navigation:   Home  |   Forum  |   Wiki  |   Translate  |   Bugtracker  |   WebSVN  |  USVN

CT-RaidTrackerImport

Aus EQdkp Plus Wiki

Artikel Veraltet.png Die Informationen in diesem Artikel oder Abschnitt sind veraltet oder beziehen sich auf eine frühere Version von EQdkp Plus / des Plugins.

Du kannst EQdkp Plus helfen, indem du aktuellere Informationen recherchierst und einfügst.


Inhaltsverzeichnis

Funktion

Das Plugin CT-RaidTrackerImport für EQDKP ist die Schnittstelle zwischen DKP-System und dem WoW-Addon CT-Raidtracker. Der Importer nimmt die Daten des CT-RaidTrackers entgegen und speichert sie im DKP-System. Dazu sind evtl. einige weitere Angaben nötig, bis der Raid gespeichert wird. Dazu mehr im folgenden.

Forum

Offizielles Englisches Support Forum (unter eqdkp.com)
Offizielles Deutsches Support Forum (unter eqdkp-plus.com)

Installation

Um den CT-RaidTrackerImport benutzen zu können benötigt ihr das Plugin für euer DKP-System sowie die Trigger, damit der Importer weiß wie die Bosse auf deutsch heißen. Die Trigger könnt ihr entweder selbst erstellen oder die vorgefertigten benutzen.

Download

Der CT-RaidTrackerImporter wird von Loganfive entwickelt.
Download wow.curse.com: http://wow.curse.com/downloads/details/4198/
Download eqdkp-plus.com: http://www.eqdkp-plus.com/download.php?view.25
Aktuelle Version (23.06.2008): 1.16.12 (bisher nur auf eqdkp-plus.com)

Entpacken der Importer Dateien

Entpackt die .zip Datei des Importers auf euren Rechner (WinRar ist ein geeignetes Tool um dies zu tun) und ladet die enthaltenen Dateien mit einem FTP-Programm auf euren Webspace in das EQDKP-Unterverzeichnis
/plugins/
Dann müsste die Struktur Beispielsweise so aussehen:
meinewebseite.de/eqdkp/plugins/ctrt/ctrt_plugin_class.php

Aktivieren des Plugins

Öffnet im Administrationsbereich eures DKP-Systems die Seite "Plugins verwalten". Dort solltet ihr den CT_RaidTrackerImporter sehen, klickt rechts auf "Installieren". Nun sollte EQDKP melden, dass die Installation erfolgreich war.

Importieren der Trigger

Bei den Triggern habt ihr mehrere Möglichkeiten. Prinzipiell sind die Trigger dazu da, den Input des CT_Raidtrackers so anzupassen, dass die Daten perfekt in euer EQdkp passen. Die zwei meistverwendeten Möglichkeiten sind:

  • Ein Raid pro Boss: Hier wird für jeden Bosskill ein extra Raid angelegt, welcher die bei diesem Boss gedroppten Items und die anwesenden Spieler enthält.
    • Vorteil: Es können die vorgefertigten Trigger benutzt werden. Öffnet dazu die .xml Dateien im Verzeichnis ctrt/trigger_imports/lang/german mit einem Texteditor und fügt die Daten auf den Event Trigger Import und Raidnote Trigger Import Seiten ein.
    • Nachteil: Die Statistiken werden leicht verfälscht, da für einen "Raidabend" nun nicht mehr ein einziger Raid eingetragen wird, sondern mehrere (je nachdem wie viele Bosse gelegt wurden).
  • Alle Bosse in einem Raid: Bei dieser Möglichkeit werden alle Bosse einer Instanz zu einem Raid zusammengefügt, der alle Items und alle Spieler enthält.
    • Vorteil: Die Statistiken stimmen.
    • Nachteil: Die Trigger müssen selbst erstellt werden und damit die Bosssuite die Bosse richtig erkennt, muss die Raidnotiz manuell angepasst werden.

Konfiguration

Die Konfiguration des Plugins erfolgt über den Menüpunkt "Einstellen" unter "CTRT Import" (ganz unten im Adminmenü). Im folgenden werden die einzelnen Einstellungen erklärt.

Einstellungen

Ctrtimport-settings 01.gif
Setzt die Mindestqualität der aufzuzeichnenden Items.
z.B.: "Rare" würde bedeuten, dass alle Items die Blau oder höherwertig sind importiert werden

  • Poor = Grau
  • Commom = Weiß
  • Uncommon = Grün
  • Rare = Blau
  • Epic = Lila
  • Legendary = Orange


Ctrtimport-settings 02.gif
Hiermit kann man festlegen, ob die Checkbox "Loot DKP - Add Item value/attendees" standardmäßig aktiviert oder deaktiviert ist. Diese Einstellung ist nur interessant, wenn ihr ein sogenanntes "zero-sum" oder "NULL-DKP" System verwendet, bei dem die für Items ausgegebenen DKP als PlusDKP auf die vorhandenen Mitglieder aufgeteilt werden.

Ctrtimport-settings 03.gif
Setzt die Namen fest, die ignoriert werden.
z.B.: "disenchanted" Mit diesem Eintrag werden entzauberte Items nicht mitgeloggt.

Ctrtimport-settings 04.gif
Hier kann festgelegt werden ob Sonderzeichen im Namen konvertiert werden sollen oder nicht.
z.B.: "Âvâtâr" zu "Avatar"

Ctrtimport-settings 05.gif
Mit dieser Einstellung könnt ihr steuern, ob pro Boss ein Raid angelegt werden soll oder ob alle Bosse zu einem Eintrag zusammengfasst werden sollen.

  • Ein: Alle Bosse dieses Raids werden zusammengelegt, es wird im DKP-System ein Raideintrag erstellt. Das ist zwar besser für die Statistiken, allerdings wird die BossSuite so eventuell nicht erkennen, welche Bosse bei diesem Raid gelegt wurden.
  • Aus: Pro Boss eines Raids wird im DKP-System auch ein Raideintrag angelegt, die BossSuite erkennt somit 100%ig die bosse und erstellt schöne Kill-Statistiken. Allerdings kann das die Raid-Statistik und die Aktivitäts-Statistik der einzelnen Mitglieder durcheinanderbringen.


Ctrtimport-settings 06.gif
Hier kann festgelegt werden, welchen Rang neue Raidteilnehmer (die noch nicht im DKP-System vorhanden sind) erhalten. Dieser Rang sollte vorher festgelegt werden.

Ctrtimport-settings 07.gif
Hier wird festgelegt wie die Anwesenheit verfolgt werden soll

  • none = überhaupt nicht (wenn einen Person im Raid war, wird sie zu allen Bossen hinzugefügt
  • Loot Time = Zeitpunkt des Loots (wenn ein Spieler beim Loot eines Bosses anwesend war)
  • Boss Kill = Zeitpunkt des Bosskills (wenn ein Spieler im Raid ist, während der Boss fällt)


Ctrtimport-settings 08.gif
Hier kann festgelegt werden ob Events, die keine Raidnotiz haben, übersprungen werden sollen.

Ctrtimport-settings 09.gif
Hier kann man einstellen, ob Items, denen ihr in WoW mit dem CT_Raidtracker noch keine DKP-Kosten zugewiesen habt, standardmäßig etwas kosten sollen.

Ctrtimport-settings 10.gif
Wird vom CT-RaidTrackerImporter ein neues Mitglied (das vorher noch nciht in der Datenbank war) hinzugefügt, so erhält dieses Mitglied die hier eingestellten DKP sozusagen als StartDKP. Achtung: Diese Einstellung ist nicht kompatibel mit Multidkp!

Ctrtimport-settings 11.gif
Mit dieser Einstellung erstellt der CT-RaidTrackerImporter einen Startraid, mit dem man zusätzlich zu den BossDKP noch z.B. ZeitDKP oder TrashmobDKP verteilen kann.

Ctrtimport-settings 12.gif
Dies ist der DKP-Wert, der standardmäßig für den Startraid (siehe oben) verwendet wird.

Ctrtimport-settings 13.gif
Hiermit versetzt man den CT-RaidTrackerImporter in den Simulationsmodus. Man kann dann Strings aus dem CT_Raidtracker in den Importer einfügen und mal testen ob alles glatt gehen würde. Der Importer erzeugt hierfür nach dem "einfügen" (was wegen dem Simulationsmodus jedoch übersprungen wird) eine Ausgabe, über die er mitteilt, was denn alles geschehen wäre.

Event Triggers

Hier legt ihr die Namen der Instanzen fest. Der CT_Raidtracker liefert die Instanznamen auf Englisch, diese werden über die hier definierten Einträge ins Deutsche übersetzt. Hierbei ist "Trigger" der englische Name, "Ereignis" der dazugehörige Deutsche. (todo: Was passiert wenn "Loot Note Event Trigger" eingeschaltet ist?)

Raid Note Triggers

Hier legt ihr die Namen der Bosse fest. Der CT_Raidtracker liefert die Bossnamen auf Englisch, diese werden über die hier definierten Einträge ins Deutsche übersetzt. Hierbei ist "Trigger" der englische Name, "Raid Note" der dazugehörige Deutsche. (todo: Was passiert wenn "Loot Note Event Trigger" eingeschaltet ist?)

Eigene Raids

Die Einstellungen auf dieser Seite sind nur interessant, wenn ihr die Einstellung "Loot Note Event Trigger" aktiviert habt. Dann wird für bestimmte Lootnotes immer ein extra Raid erstellt, auch wenn dies ja normalerweise nicht vorgesehen wäre. (todo: überprüfen!, Anmerkung: Ich hasse diese Loot Note Event Trigger Einstellung *grml*)

Items hinzufügen

Items, die ihr hier eintragt, werden immer als Loot eingetragen, auch wenn ihre Qualität unter der Grenze liegt. Dies bezieht sich auf
Ctrtimport-settings 01.gif
Habt ihr also "Minimum Qualität" beispielsweise auf Rare (blau) gestellt und möchtet ein bestimmtes grünes Item trotzdem loggen, dann könnt ihr die ItemID hier eintragen. Die Item ID erfahrt ihr, indem ihr z.B. auf http://wow.buffed.de/ rechts oben im Suchfeld nach dem Itemnamen sucht. Die ItemID ist dann die Zahl am Ende der Adresse: "wow.buffed.de/?i=xxxxx". So hat zum Beispiel der Arkankristall (http://wow.buffed.de/?i=12363) die ItemID 12363.

Ignorierte Items

Hier eingetragene Items werden NIE als Loot eingetragen (z.B. für Kristalle der Leere). Auch hier braucht ihr die ItemID.

Aliases

Hier könnt ihr Twinks und ihre zugehörigen Mainchars eintragen. Der Mainchar muss hierfür schon in der Datenbank existieren, der Twink natürlich nicht.

  • Name ist der Name des Twink
  • Mitglied ist der Name des Mainchars

Sollte jetzt ein Twink mitraiden, so wird der Name des Twinks automatisch durch den hier definierten Namen des zugehörigen Hauptchars ersetzt.
Achtung: hierfür wurde extra ein Plugin entwickelt, mit dem sich der Autor dieses Textes aber bisher noch nicht auseinandergesetzt hat: Tsync

DKP String importieren

Im Adminmenü findet ihr zwei mal die Funktion "Importiere DKP String". Beide sind absolut gleichwertig, der zweite Eintrag wurde nur der Übersicht wegen eingefügt.

Seite 1

Auf der ersten Seite fügt ihr den DKP String ein, den ihr aus dem CT_Raidtracker kopiert habt.

Seite 2

Ctrtimport-import 2.gif

  • Raid Notiz: Hier steht der Boss
  • DKP Wert: Die Anzahl an DKP, die dieser Boss wert sein soll. Gibt es in eurem System keine Bossdkp (sondern z.B. nur ZeitDKP, so müsst ihr die Funktion "Loot Note Event Trigger" aktivieren (todo: überprüfen ~.~)
  • Raid Zeit: Datum (amerikanisches Format) und Uhrzeit
  • Teilnehmer: Alle Member, die zu dieser Zeit im Raid waren
  • Item Name: Der genaue Name des Items. Sollte es ein Item mit zufälligen Stats sein, entfernt den hinteren Teil des Namens! So wird zum Beispiel aus "Shadikiths Schienbeinschützer des Ebers" dann nur "Shadikiths Schienbeinschützer". Das ist erforderlich, damit das Item in den Datenbanken von Blasc etc. gefunden wird!
  • Item ID: Hier seht ihr auch die ItemID
  • Looter: Der Member, der das Item bekommen hat
  • DKP Wert: Die Kosten für das Item

Pro Item und pro Boss werden diese Felder wiederholt, also vergesst nicht nach unten zu scrollen ;)

Seite 3

Auf der dritten Seite seht ihr das Ergebnis des Imports. Wie bereits beim Simulationsmodus erwähnt, könnt ihr hier sehen was der Importer alles angestellt hat.
Ctrtimport-import 3.gif
Erklärungen:

  • Zeile 1: Es wurde ein neuer Raid im DKP-System angelegt
  • Zeile 2-4: Es wurden neue Mitglieder in die Datenbank eingefügt
  • Zeile 5: Es wurden zu dem gerade erstellten Raid 3 Teilnehmer hinzugefügt
  • Zeile 6-7: Es wurden Items zu Membern zugewiesen