CurseForge.com

AOC UI Installer

UI Authors readme

Lets get started:

There are some new editions to the xml file that I would like to share with you, with some code snippets.
The new xml is an expansion to the current one, but offers more options.

The xml below will give you 2 wizard options one for the timerbar and one for the lootview.

<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
<!-- This is AOC install xml for the XX UI 1.6 -->
<install name="XX UI">
  <corefiles>
    <files path="GFX" topath="Data\GUI\Customized\GFX"/>
  </corefiles>
  <options index="0">
    <option name="Default" path=""/>		
    <optiongroup name="Timerbar visual" description="Choose look of your timerbar">
      <option name="Normal" path="Views\CommandTimerBar.xml" topath="" selected="true"/>
      <option name="Normal blue" path="Views\CommandTimerBar.NormalBlue.xml" topath="Data\GUI\Customized\CommandTimerBar.xml" selected="false"/>
      <option name="Big blue" path="Views\CommandTimerBar.BigBlue.xml" topath="Data\GUI\Customized\CommandTimerBar.xml" selected="false"/>
    </optiongroup>
    <optiongroup name="Loot" description="Select if you want to use default or small lootview">
      <option name="Default" path="" selected="true"/>
      <option name="Small" path="View\LootView.Small.xml" topath="Data\GUI\Customized\View\LootView.xml"/>
    </optiongroup>			
  </options>
</install>

optiongroup is simply a page in the wizard, you simply describe what the option is about in "name" and describe what it does in description.
Each optiongroup can have x options and the name is show to the user.

  1. PATHS
    The optiongroup option "path" and "topath" can point to folders or single files, please note that path is the "path" within your zip file.
    The "topath" is the location in the age of conan folder.

If you look at the lootview option you will notice that the first option is empty and named default, this will not install anything (hence it is empty)
REMARK: if the "topath" is not filled in the installer will try and locate the proper location for the files.

Btw. required files should be put in the "corefile" section as they will always be copied.

Now for some more hardcore stuff:

Each optiongroup\option can have several paths depending on what is selected in the layout section.
To illustrate this you can see the following home made Stonerune example.

<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
<!-- This is AOC install xml for the Stonerune UI 1.5 -->
<install name="Stonerune">
  <corefiles>
    <files path="Customized" topath="Data\Gui\Customized"/>
    <files path="Customized\StoneruneScripts" topath="Scripts"/>
  </corefiles>
  <options index="0">
    <option name="Stonerune 2x25" path="Customized\StoneruneLayouts\stonerune_2x25"/>
    <option name="Stonerune 3x17" path="Customized\StoneruneLayouts\stonerune_3x17"/>
    <optiongroup name="Minimap location" description="Choose where you would like to place the minimap">
      <option name="Place at top" path="Customized\StoneruneLayouts\minimaps\top" topath="" selected="true">
        <optionpath sizeindex="0" path="Folder2x25"/>
	<optionpath sizeindex="1" path="Folder3x17"/>
      </option>
      <option name="Place at bottom" path="Customized\StoneruneLayouts\minimaps\bottom">
	<optionpath sizeindex="0" path="Folder2x25"/>
	<optionpath sizeindex="1" path="Folder3x17"/>
      </option>
    </optiongroup>
    <optiongroup name="Loot" description="Select if you want to use default or Stonerune lootview">
      <option name="Default" path="" selected="true"/>
      <option name="Stonerune" path="Customized\StoneruneLayouts\LootView"/>
    </optiongroup>			
  </options>
</install>


Imagine a user selects layout named "Stonerune 3x17" and then goes to the wizard for the advanced options.
As you can see there is a new xml tag called "optionpath" wich allows you to specify locations bound to the selected layout.
This is done by the "sizeindex" attribute, in this case 1, because the layout is in position 1 (starts with 0).
The optionpath works like the normal optiongroup option regarding paths (see #PATHS), incl. the topath bit.
If no topath is specified the installer will try and locate the proper location for each file in the directory specified.

IMPORTANT:
The "path" in optionpath is the file or folder location UNDER the option path
IE. The option "path" + optionpath "path" (Customized\StoneruneLayouts\minimaps\top\Folder3x17)
The optionpath path is appended to the option path (god damn I have choosen some bad names)

Each option in an optiongroup can have an image specified. This image is shown when the user selects something in the wizard.
To show an image use this syntax:

<option name="Stonerune" path="Customized\StoneruneLayouts\LootView" previewpath="\gfx\previews\smallloot.png"/>


previewpath is the new attribute, and the path is where you have placed the preview image inside the zip file!

If you take a look at this snippet I made for Corruption 2, you can see that an option does not need to be a folder, it can be a file.

<optiongroup name="Timerbar visual" description="Choose look of your timerbar">		
<option name="Purple" path="Customized\gfx\COR\Castbar\o1.tga" topath="Data\Gui\Customized\gfx\COR\Castbar\o1.tga" previewpath="path" selected="true"/>
<option name="Bronze" path="Customized\gfx\COR\Castbar\o2.tga" topath="Data\Gui\Customized\gfx\COR\Castbar\o1.tga" previewpath="path" selected="false"/>
</optiongroup>


The topath has been set and previewpath is simply pointing to the actual image in the "path"
- Hint: you can specify previewpath="path" it will use the graphics from the "path"

You must login to post a comment. Don't have an account? Register to get one!

Facts

Date created
Jun 09, 2010
Last updated
Jun 09, 2010

Author