= 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. This is mostly recommended when using 800x600 and not really necessary when running 1024x768 or above. A small area at the top of the hangar image is removed, so that when using ten lines of chat, the last lines do not overlap with the hangar image (that makes them very hard to read). Additionally, the 'mouse hover' line is moved, so it doesn't overlap with the three 'critical info' lines at the bottom.

=== Number of chat lines ===

Defines the number of chat lines you want to see in the hangar, on the map and in the cockpit.

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

No matter what you choose here, the loadout (inventory) window will always be shown on the in-flight map.

When selected, the loadout window will always be shown in the cockpit. Due to the way this is implemented, you can not toggle it anymore. You should not press the F4 key, except to switch between loadout screen and hangar/map when in base.

When deselected, the loadout window will by default be off in the cockpit, but you can toggle it with F4.

=== 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 hangar and on the map when in base. (By default, it's only shown in the cockpit.)

=== 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 ||