= Installation options =

CortUI offers various ways of configuring it to your needs. The most fundamental one is which normal HUD and software HUD you choose, but there's more.

== Choosing settings in the installer ==

While running the automatic installer, you will come across the following screen.

[[Image(/site/Installer.png)]]

The options mean in detail:

=== Install modified lobby screen ===

When selected, installs a modification of the game lobby screen (where commanders and teams are decided on). The main difference is that the size of the chat is increased to ten lines, making it easier to follow fast discussions.

=== Install modified hangar screen ===

When selected, installs a modification of the hangar screen. [TODO]

=== Number of chat lines ===

Defines the number of chat lines you want to see in the hangar, on the map and in the cockpit. [INSERT TICKET LINK]

=== Always show loadout window in cockpit ===

When selected, the loadout (inventory) window will always be shown in the cockpit and on the map. Due to the way this is implemented, you can not toggle it anymore. If you have this selected, do not press F4 ever.

=== Show minimap at loadout screen ===

When selected, the minimap will be shown on the loadout screen. It can not be toggled, so do not press F7.

=== Show last orders in cockpit, hangar and map when in base ===

When selected, the last orders will also be shown in the hanger and on the map when in base.

=== Show scrollbar for chat display in cockpit ===

When selected, the in-game chat will display a scrollbar like the one in the game lobby. This also fixes the issue of letters sometimes missing at the end of lines. (In the vanilla configuration, the scrollbar is just cut off, but long lines can overlap with the scrollbar, so they are cut off, too.)

=== Normal HUD style ===

The HUD to replace the vanilla 'Normal HUD'. See [wiki:Features#HUDs Features] for more information.

=== Software HUD style ===

The HUD to replace the vanilla 'Software HUD'. See [wiki:Features#HUDs Features] for more information.

== Modifying the settings manually after installation ==

If you want to modify the settings after you have already installed CortUI, you can simply run the installer again. Please note that the game lobby and hangar modifications can't be reverted this way. To remove them, an uninstallation of CortUI is necessary.

If you do not want to reinstall, you can also edit the settings file by hand, using any text editor. However, note that a simple mistake like a missing semicolon can (and most likely will) make the game crash.

The settings file can be found in the `artwork` directory of your Allegiance directory and is named `cortui_settings.mdl`. It consists of blocks of a comment and an assignment each.

{{{
#!C
// Parameter: Number of chat lines. Keep between 1 and 10.
NumChatLinesGlobal = 10;
}}}

Just replace the value at the right side of the equal sign with whatever valid value you want.

|| '''Setting name'''          || '''Corresponding option in installer''' || '''Default value''' || '''Notes''' ||
|| cortUIVersionString         || n/a || name and current version number || Obviously shouldn't be changed. ||
|| !NumChatLinesLobby          || 'Install modified lobby screen' || 10 || Keep between 1 and 10. ||
|| !NumChatLinesGlobal         || 'Number of chat lines (global)' || 10 || Keep between 1 and 10. ||
|| !NumChatLinesLoadout        || 'Number of chat lines (loadout)' || 6 || Keep between 1 and 10. More than 6 might overlap with controls. ||
|| !AlwaysShowLoadoutWindow    || 'Always show loadout window in cockpit' || 1 (on) || 1=on, 0=off ||
|| !ShowMinimapAtLoadoutScreen || 'Show minimap at loadout screen' || 1 (on) || 1=on, 0=off ||
|| !ShowLastOrders             || 'Show last orders in cockpit, hangar and map when in base' || 1 (on) || 1=on, 0=off ||
|| !ShowScrollbarOnCockpitChat || 'Show scrollbar for chat display in cockpit' || 1 (on) || 1=on, 0=off ||
|| NormalHUDMode               || 'Normal HUD style' || 0 (Classic CortUI) || 0=Classic CortUI, 1=lessHUD, 2=!JelloShot ||
|| SoftwareHUDMode             || 'Software HUD style' || 0 (default software HUD) || 0=default HUD, 1=software HUD with targeting, 2=Raveen-style, 3=Parci-style ||