UI & Mod Guide

AoC UI & Mod Guide + F.A.Q.

Original von nick308 (AoC US Forum)

Übersetzt und weitergeführt von mir

Zusätzliche Informationen können gerne hier gepostet werden, ich werde sie dann hinzufügen.
Die Links führen natürlich nach wie vor zu englischen Seiten, wenn ihr äquivalente deutsche Seiten kennt bitte auch hier posten.
Und Übersetzungsverbesserungen selbsterständlich auch ^^ ich bin bei weitem nicht perfekt, vielleicht teils eine zu freie oder zu genaue Übersetzung,
bischen wegenommen, bischen hinzugefügt.

Ein paar Links:

- AoC Wiki Mods Seite
- Ingame Chat-Gildenwerbung Addon
- Makros, Scripts, Emotes
- Erweiterte Video Einstellungen(Stellt mehr Funktionen zur Performance und Grafikverbesserungen zur Verfügung)
- Ui Patcher (Ändert die Versionsnummer in den xml's nach einem patch von Funcom)

UI / Mod Download Seiten

- conanmods.com
- AoC Curse


Inhaltsverzeichnis:

I. Einleitung
II. Den Gui Ordner erforschen
III. Coden in xml
IV. Truevision Targa Graphic (.tga Dateien)
V. Buffleiste editieren
VI. Revisionsnummern ändern
VII. F.A.Q.


I. Einleitung


Wenn Du nach einer neuen AoC Mod fragst, die Du gerne haben möchtest, wird dein Vorschlag in 99,9% aller Fälle folgendermaßen beantwortet werden:
"Es ist möglich, nur noch nicht jetzt"

UI Anpassungen werden in AoC durch modifizieren der xml Dateien der Bedienoberfläche erreicht. Diese Dateien wurden netterweise von Funcom in unserem GUI Ordner bereitgestellt um wesentliche GUI Veränderungen zu ermöglichen.
Zum jetzigen Zeitpunkt wissen wir nichts über die Besonderheiten des API (Application Programming Interface). Funcom hat noch keine Details dazu veröffentlicht wie man das API zu unserem Vorteil nutzen kann.
Ohne dieses API sind wir relativ eingeschränkt.
Ein möglicher Grund warum Funcom das tut, könnte sein, dass sie einem Sicherheitsrisiko vorbeugen möchten, das etwas mit botten und exploits zu tun hat.

Beispiele was im Moment möglich ist:
- Bewegen/Verstecken von Objekten (Minimap, Leisten, Spielerpotrait etc.)
- Hinzufügen/Entfernen von Grafiken

Beispiele was im Moment nicht möglich ist:
- Dynamische Berechnungen (Beispiel von WoW: Titan Panel)
- Ausdauer/Mana Leisten zum Gruppenfenster hinzufügen

Zusammengefasst:
Man kann nur an Skins und der Benuteroberfläche herumbasteln, aber keinerlei neue Funktionen hinzufügen.
Das API existiert und man kann anscheinend damit arbeiten, nur weiß noch keiner wie (fehlende Informationen seitens Funcom)

Zitat von Kragule:

Cytat:
Bis Funcom ihr API herausrückt, wird es keine "echten" mods geben.
Das API ist das Gerüst der für Mod Entwickler verfügbaren Befehle, also solange es kein API gibt, wird es nichts geben außer skins für die Benutzeroberfläche.
Um Funcom unser Interesse hierfür zu zeigen bitte posten, dass wir das API so bald wie möglich haben wollen.
Danke für Eure Zeit.

Kod:

Until Funcom releases it API there will be no "real" mods out there.
The API is the framework of commands available to Mod developers so with no API all you have is new skins for the Conan UI.
To show Funcom our vested interest in this please show by posting here that we want the API ASAP. Ty for your time.


II. Den GUI Ordner erforschen


Der Gui Ordner:
Im Moment müssen wir uns, aufgrund der Einschränkungen hauptsächlich mit einem Ordner beschäftigen.
Dieser befindet sich standardmäßig in:
C:\Programme\Funcom\Age of Conan\cd_image\Gui (glaube ich zumindest mal ^^)

In diesem Ordner sollten sich zwei weitere Ordner, sowie evtl. zwei Readme Dateien befinden. Diese zwei Ordner heißen "Customized" und "Default"
Der Customized Ordner wird (wenn irgendwelche mods "installiert" sind) die gleichen oder weniger Dateien und Ordner enthalten wie der Default Ordner.
AoC checkt immer zuerst den Customized Ordner und lädt alle Dateien die sich dort befinden (die entsprechenden Dateien im Default Ordner werden dann nicht mehr geladen)
Falls sich geänderte Dateien im Default Ordner befinden, werden diese automatisch wieder vom Patcher geändert, deshalb müssen alle geänderten xml's in den Customized Ordner.
Geänderte Targa Dateien müssen umbenannt werden, dazu später mehr.


Der "Default" Ordner:
Wir werden uns nur den Default Ordner ansehen, weil er zum Großteil identisch mit dem Customized Ordner ist.

Dieses Bild zeigt eine Zusammenfassung des Ordner/Dateien Layouts des simplen GUI. Alle Bilder/Grafiken des Spiels befinden sich normalerweise im gfx Ordner.
Die meisten Dateien im Views Ordner sind .xml und .bxml Dateien. Uns beschäftien nur die .xml Dateien, denn diese sind es, die wir editieren müssen um Objekte zu verändern.

Readme.txt

Die Readme im Customized Ordner zu lesen, die Funcom uns netterweise bereitgestellt hat, wäre ein guter Anfang.

Cytat:


Dieser Ordner ist für angepasste GUI XML Dateien.
Wenn Du versuchst eine Datei im Ordner "Default" oder einem seiner Unterordner zu verändern, wird diese wieder autmatisch vom patcher wieder in den Normalzustand versetzt.
Wenn du eine von den GUI Dateien anpassen möchtest, solltestdu zuerst eine Kopie der Datei machen und diese an den selben Platz im "Customized" Ordner packen, es muss also immer genau die selbe Ordnerstruktur wie im Default Ordner vorhanden sein.
Das Spiel wird zuerst den Customized Ordner checken und sehen ob dort eien Datei vorhanden ist. Wenn dies der Fall ist und die Revisionsnummer die selbe ist wie in der Default Datei, wird die angepasste Version benutzt. Jedesmal wen die offizielle Version geupdated wird, wird sich die Revisionsnummer erhöhen. Wenn die angepasste Version eien andere Nummer hat als die offizielle, wird im Spiel ein Warndialog angezeigt und die offizielle Version benutzt werden.
Wenn das passiert, muss die Revisionsnummer in der angepassten Datei ebenfalls erhöht werden aber es wird empfohlen eine komplett neue Kopie der neuen Datei zu machen und alle Anpassungen neu vorzunehmen um zu verhindern dass evtl neu hinzugefügte Funktionen nicht vorhanden sind.
Die Revisionsnummer kann auch benutzt werden um das Spiel temporär daran zu hindern eine angepasste Datei zu laden. DAzu muss die Numemr einfach auf 0 gesetzt werden. In dem Fall wird auch kein Warndialog im Spiel angezeigt.
Alle GUI xml Dateien starten mti einem xml Kommentar der die Revisionsnummer enthält, in diesem Beispiel die XXXXXX

<!-- $Change: XXXXX $ (muss sich innerhalb der ersten 200 Buchstaben der Datei befinden) -->


Kod:

This folder is for customized GUI XML files.
If you try to modify a file in the "cd_image/Gui/Default/" folder or one of its children, it will automatically be reverted by the patcher.
If you want to customize any of the GUI files, you should first copy it to the "cd_image/Gui/Customized/" folder. If the file is located in a child folder of "cd_image/Gui/Default/" the same folder structure must be made in "cd_image/Gui/Customized/".
The game will first check the "cd_image/Gui/Customized/" folder to see if the file is there. If it is and the revision number is the same as the version in "cd_image/Gui/Default/", the customized version will be used. Any time the official version is updated the revision number will be increased. If the customized version has a different revision number than the official file, a warning dialog will be displayed ingame and the official file will be used.
If this happens, you must update the revision number in the customized file but it is recommended you copy over the entire official file and reapply your customizations. This is to prevent you from losing any new functionality that might have been added to the file.
The revision number can also be used to temporarily prevent the game from loading a customized file. If it is set to '0', the official file will always be loaded and no warning dialog will pop up.
All GUI XML files start with a XML comment containing the revision number, where XXXXX is the revision number:

<!-- $Change: XXXXX $ (must be within the first 200 characters of the file) -->


III. Coden in XML

So, jetzt fangen wir mal an diese xml Dateien zu öffnen.

Geh in Deinen AoC Ordner und dann cd_image\Gui\Default\Views\HUD
Dort findest du eine bottombar.xml, diese enthält die Daten für deine main bars, die Leisten unten wo du Zauber, Kombos etc. reinpackst.
Wir werden diese xml jetzt mal aufteilen um sie besser zu verstehen.

XML Grundlagen:

- Immer alle Angaben korrekt beginnen und beenden (ähnlich wie in php)
- Rect (x links, y oben, x rechts, y unten) sowohl positive (40) als auch negative (-40) Zahlen
- XML ist case sensitive (Groß- und Kleinschreibung beachten)
- Attribut-Werte müssen immer in Anführungstriche (wie html etc.)

Um die Dateien zu lesen kann man ein notepad benutzen, zB. pspad

Ist die Datei einmal geöffnet sehen wir zunächst die Zeilen 4-14, diese seehn folgendermaßen aus:

Kod:

<template:ShortcutView layout_borders="Rect(0,0,0,0)"
out_of_range_bitmap="icons/outofrange_icon.tga"
icon_spacing = "2"
slot_template="SlotTemplate">
<template:ItemSlotView template:name="SlotTemplate"
layout_borders="Rect(2,0,2,0)"
slot_size = "Point(47,47)"
icon_borders = "Point(0,0)"
max_zoom="1.0"
gfx_background=""
/>
</template:ShortcutView>


template:ShortcutView layout_borders="Rect(0,0,0,0)
(x links, y oben, x rechts, y unten)

out_of_range_bitmap="icons/outofrange_icon.tga
Diese Zeile gibt den Pfad des Bildes an, was angezeigt wird wenn der Caster außer Reichweite ist.

icon_spacing = "2"
Diese Ziffer bestimmt, wie weit die einzelnden Knöpfe einer Leiste auseinander sind

layout_borders="Rect(2,0,2,0)"
(x links, y oben, x rechts, y unten)

slot_size = "Point(47,47)"
Die Zahlen bestimmen die Höhe und Breite der Knöpfe, in de Fall 47x47

icon_borders = "Point(0,0)"
"Point(50,50)" Würde das Icon des Knopfes schrumpfen, aber genau in der Mitte der Hintergrund-tga-Datei halten.

Das Icon wird also kleiner, bleibt aber mittig auf der Hintergrundgrafik.

View ist ein allgemeines "View-Objekt". Die "bottombar" Ansicht benutzt eine Vorlage aus verschiedenen verschachtelten "views". Die Vorlage bestimmt Dinge wie zB. die Größe der hotbar Icons.

verschachtelt in etwa so:

--template:ShortcutView
----template:ItemSlot
--View
----View
----View
--View
----View
----ActionListView
----BitmapView
----BitmapView
--View
----View
----View

Im Grunde ein Haupt"view" mit unter- und nochmehr unter"views" ^^
Etwas schwierig, da man aufgrund der Verschachtelung häufig komplette Bilder "auseinanderreißt" obwohl man nur einen kleinen Teil bewegen wollte, der rein optisch garnicht damit zusammenhängt.
Da hilft nur ausprobieren oder sich auskennen ^^ ich probier meistens aus, funktioniert nie XD



Hier noch ein Bild dazu, wie der rect Befehl funktioniert:
Die Zahlen beziehen sich auf die Bildschirmränder




Und der dazugehörige Thread im US Forum:
http://forums.ageofconan.com/showthread.php?t=79661

IV. Truevision Targa Graphic (*.tga)


Eine tga Datei ist ein simples Bild, dem von den xml Dateien gesagt wird wo es sich befinden soll.
Um die tga Dateien agucken zu können benötigt man ein spezielles Programm, zB. IrfanView
Zum verändern halt sowas wie Photoshop.

Sehr wichtig: veränderte tga Dateien müssen sich im normalen default/gfx Ordner befinden, nicht im customized.

Edit* laut einem Post von TheVoodoo nicht zwingend nötig:
Cytat:
Falls noch nicht bekannt:
Es gibt eine Möglichkeit, eigens erstellte Grafiken zu laden, ohne das DEFAULT Verzeichnis verunstalten zu müssen!

Der Rootpfad der Grafikstrings sitzt ja bekanntlich in
"Age of Conan\cd_image\Gui\Default\gfx\"

Defaultmässig wird also bei dieser zeile:
<BitmapView bitmap_gfx="misc/fadeinout_center.tga" usw...
das Grafikfile von
"Age of Conan\cd_image\Gui\Default\gfx\misc\fadeinout_cent er.tga"
geladen.

Wenn ihr im Customized Verzeichnis nun auch die selbe verzeichnisstruktur
"Age of Conan\cd_image\Gui\Customized\gfx\misc\" anlegt und dort euer Ersatz Grafikfile hineinspielt könnt ihr es von dort folgendermassen laden:
<BitmapView bitmap_gfx="../../customized/gfx/misc/fadeinout_center.png"

Das erste ..\ wechselt vom root (\gfx) auf \default
Das zweite ..\ wechselt von \default auf \Gui

von dort an wird dann eben den folgende pfad weitergeführt (customized/gfx/misc/)

Durch diese Art und Weise bleibt hoffentlich zukünftig der Default Ordner von Anderungen verschont, und die Mods bleiben übersichtlich verwaltet.

Ihr müsst aber auf jeden Fall die umgestaltete Datei umbennen zB. von bottombar_inside.tga zu naiv_bottombar_inside.tga oder so ^^
Und der Pfad zu der Datei muss natürlich auch in der dazugehörigen xml im customized Ordner geändert werden.

Wenn ihr nämlich nur die default Dateien ändert und unter gleichem Namen speichert, ersetzt der Patcher diese automatisch wieder durch die Original Dateien (wie es in der Readme steht)


Um herauszufinden welche tga man verändern muss, einfach in der default xml nach dem Pfad suchen, die Grafiken befinden sich wie schoneinmal erwähnt alle in cd_image\Gui\default\gfx

Ihr könnt der Einfachheit halber einfach alle eure Bilder in einen neuen unterordner des gfx Ordner tun, z.B. cd_image\Gui\default\gfx\meinaddon\



V. Buffleiste editieren

Für die Buffs über der dem Charportrait (hp/mana leisten) braucht man folgende xml:

Views\HUD\CharPortraitLeft.xml

und darin folgenden Code:

Kod:

<BuffListView name="BuffListView"
h_local_alignment="LEFT"
layout_borders="Rect(15,0,0,0)"
icon_size="Point(31,31)"
icon_spacing="Point(3,3)"
full_size_limit="6"
max_columns="10"
filter="hostile"
/>


Für die Buffs oben am Bildschirm:

Views\HUD\HUDView.xml

und diesen Code:

Kod:

<BuffListView name="HudFriendlyBuffListView"
view_flags="WID_IGNORE_WHEN_HIDDEN"
hover_info_orientation="VERTICAL"
filter="friendly"
full_size_limit="10"
max_columns="20"
icon_size="Point(31,31)"
icon_spacing="Point(3,3)"
/>

filter gibt an welche buffs angezeigt werden, "friendly" = buffs // "hostile" = debuffs // "friendly | hostile" = beides

full_size_limit gibt an ab wievielen buffs die icons verkleinert werden, normal ist 10

max_columns gibt an wieviele buffs in eine Zeile kommen, in diesem Fall würde der 21. Buff in einer zweiten Zeile angezeigt werden.

icon_size gibt die Größe der Buff icons an

icon_spacing den Abstand zwischen den Buff icons


VI. Revisionsnummern ändern


Wie das funktioniert und warum man es tun muss, stand ja schon in der Readme von Funcom.

Man muss es aber nicht mehr per Hand machen, da ein sehr nettes Programm von solaris existiert, das dies automatisch duchführt.

Zu finden hier

F.A.Q.

1. Kann ich meinen Mauszeiger (Cursor) ändern?

Ja. Gehe dazu nach: Age of Conan\cd_image\Gui\Default\gfx\MousePointers
Die Datei mousepointer_default.cur ist dein Main Cursor und du kannst ihn editieren oder durch deinen gewünschten Cursor ersetzen.


2. Warum kann ich die Icons auf meiner Hotbar im Spiel nicht verschieben?

Dies hat nichts den xmls zu tun und ist nur eine ingame option, entweder im ui menü ausschalten oder shift+L drücken

3. Wie kann ich meine FPS im Spiel anzeigen lassen?
Dies ist auch kein Addon, einfach shift+alt+F drücken

4. Kann ich G11/15 Makros verwenden?

Ein sehr vages Thema, ich glaube bis jetzt ist dazu nicht viel bekannt, Diskussionen dazu findest du hier, hier und hier (englisch)


5. Kann ich die Castbar oder Combo Indicator Box bewegen?

Die Kombo Box kann man einfach so bewegen während man eine Kombo ausführt, indem man sie oben mit der Maus anklickt.
Um die cast bar zu bewegen, muss man in den ingame Optionen unter Interface // advanced // "Show Timer Bars" aktivieren (kA wie's auf deutsch heißt sry)

6. UI funktioniert nach Patch nichtmehr

Die Revisionsnumemrn müssen geändert werden, genug Information dazu weiter oben.

7. Wie installiere ich ein custom UI?

Wenn man ein custom UI herunterlädt, erhält man meistens eine rar datei die entweder den Ordner cd_image (dieser muss dann einfach nur ins AoC Installationsverzeichnis kopiert werden) oder 2 Ordner mit Namen "Customized" und "Default" enthält. Letztere müssen dann in Age of Conan\cd_image\Gui kopiert werden.
In beiden Fällen einfach auf ersetzen klicken (es werden keine Dateien ersetzt, nur hinzugefügt. Das Ersetzen bezieht sich nru auf die Ordner)

8. Wie "deinstalliere" ich mein custom UI wieder?

Dazu einfach den customized Ordner komplett löschen.
Oder um auch die Targa Dateien loszuwerden (Die ohne customized Ordner nur nicht mehr geladen werden aber trotzdem noch da sind) einfach den kompletten Gui Ordner löschen.
Die Original Dateien werden dann per Patcher wieder runtergeladen. (ca. 180 MB)

9. Habe mir ein Custom UI installiert und jetzt ist das obere Menü weg (inventar, feats, quests etc.)

Lösche die Datei cd_image\Gui\customized\Views\MainGUI\MainSplitVie w.xml

10. Kann ich die Farben der Friendslist ändern weil ich bei dem ganzen Grau nichts erkenne?

Ja, die Einstellungen dazu sind zu finden in der Datei:

Age of Conan\cd_image\Gui\Default\Views\SocialGUI\GuildMe mberView.xml

Diese einfach in den entsprechenden Customized Ordner kopieren und die Zeile
Kod:

guild_color = "STANDARD_BRIGHT"

in
Kod:

guild_color = "lime"

ändern, dann werden Gildenmitglieder schön grün angezeigt ^^ für was anderes einfach ausprobieren....

11. Ich möchte meine Komboleiste horizontal haben, was tun?

mod von ghordansk benutzen ^^ klick

12. kann ich das Fragezeichen neben den social buttons oben links entfernen?

Ja, folgendes aus der cd_image\Gui\Customized\Views\HUD\Hudview.xml löschen

Kod:

<Button name="HelpButton" layout_borders="Rect(-38,3,0,0)"
interaction_borders="Rect(25,0,0,0)"
gfxid_raised="tutorialgui/field_manual.tga"
gfxid_pressed="tutorialgui/field_manual_click.tga"
gfxid_highlight="tutorialgui/field_manual_hover.tga"
/>

13. Was ist das für ne komische Uhr? Die geht total falsch!!

Die Uhr zeigt die ingame Zeit, nicht die richtige Zeit an. Man kann sie in den Interface Optionen aussschalten.

14. Ich hätte gern ein hübscheres Gruppenfenster

Viper's Grp Window, im Moment das beliebteste.

15. Gibt's eine Möglichkeit das UI ingame neuzuladen um Änderungen sofort zu sehen?

/reloadui