GUI Distribution

From Anarchy Online Wiki [AOWiki]

Overview[edit]

The Anarchy Online GUI can be modified quite throughly. Some of the things which can be modified:

  • The entire static screenspace
  • F10 options menu
  • Textures of most GUI elements
  • Loading screens

A GUI distribution consist of three sets of files: XML, Loading Screens and Graphics Archive. All these may be placed under cd_image\GUI\GUIName (see Custom GUI: Naming and Placement of files for more info)

Enabling a custom GUI[edit]

Lets take a specific gui as example: Demoder's upcoming GUI; currently named "DemodersGUI".

/setoption GUIName "DemodersGUI"
/setoption GUISkin "GUI\DemodersGUI\Archives\default.uvgi"

If you are distributing a GUI, you might want to add the above to a script which the user can execute.

Technical Information[edit]

XML[edit]

Locations

  • Custom: cd_image\gui\GUINAME\
  • Default: cd_image\gui\Default

These define where static GUI elements are located, and how many GUI elements look.

Loading Screens[edit]

Locations

  • Custom: cd_image\gui\GUINAME\gfx\
  • Default: cd_image\gui\Default\gfx\

This folder contains an AI, SL and RK loading screen. AO chose which loading screen to use based on the highest expansion of the logged in account.

  • ai_loading_login.png: Alien Invasion login screen
  • loadingimage_fullscreen.jpg: Shadowlands login screen
  • welcome_to_rubika_shadowlands.jpg: Default loading screen

Graphics Archive[edit]

Locations

  • Custom: cd_image\GUI\GUIName\Archives\*.UVGI
  • Static archive: cd_image\textures\archives\GUIGFX.UVGI
  • Default active archive: cd_image\textures\archives_ep1\GUIGFX.UVGI

The active archive overrides the keys in the static archive, and adds custom keys if present.

Custom GUIs archives replace the role of the default active archive.

This folder contains *.UVGA and *.UVGI files. The *.UVGA files contain a series of image files appended one after another. The *.UVGI file is an index with the following format (as of 18.4.0):

number_of_entries
entry1_key filepos length
entry2_key filepos length
...

Custom GUI: Naming and Placement of files[edit]

Recommended Locations[edit]

  • XML files: cd_image\gui\GUIName\
  • Graphical Archives: cd_image\GUI\GUINAME\Arhives

Files & Folders to avoid[edit]

You should never touch these folders, nor files within:

  • cd_image\gui\Default
  • cd_image\textures\archives
  • cd_image\textures\Archives_ep1