GUI Distribution

From Anarchy Online Wiki [AOWiki]

Overview

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

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

XML

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

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

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):

path_to_UVGA_file (ignored - consider it a comment line)
number_of_entries
entry1_key filepos length
entry2_key filepos length
...

Custom GUI: Naming and Placement of files

Recommended Locations

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

Files & Folders to avoid

You should never touch these folders, nor files within:

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