Editing Widget Configuration

This page is intended to answer frequently asked questions about configuration.

==Frequently Asked Questions==

===Repositioning the UI Panels===
# Start a battle.
# Open the ingame menu by pressing the Menu button in the top right or pressing Escape or F10.
# Disable 'Simple Settings' by unticking the checkbox in the the bottom right of the ingame menu.
# Navigate to 'Settings/HUD Panels'.
# Untick 'Stay up to date' and 'Reset on screen resolution change'.
# Select the UI Preset 'None'.
# Close the ingame menu.
# Press Ctrl+F11 to enter tweak mode.
# Use the transparent green boxes that appear to drag and resize the interface.
# Press Escape to leave tweak mode.

If the UI Preset is not set to 'None' then the main parts of the UI will reset their positions next time the game is launched. Note that by setting 'None' you have become responsible for fixing your own UI if things break it, such as screen resolution changes.

=== Adding or removing music ===
Create the folder <code>Zero-K/sounds/music</code> with the five subfolders <code>war</code>, <code>peace</code>, <code>briefing</code>, <code>victory</code> and <code>defeat</code>. Put your music files in the appropriate folders. The only supported format is <code>.ogg</code>.

To use your music, untick simple settings through the ingame menu and toggle <code>Settings/Audio/Use Included Tracks</code> then type <code>/luaui reload</code> in the game chat. There is also an option to not play any of the music included with the game.

=== Changing team color ===
To set custom team colors [[:File:LocalColors.zip|download and unzip this]] in <code>Zero-K\LuaUI\Configs</code> such that the filepath <code>Zero-K\LuaUI\Configs\LocalColors.lua</code> exists. Edit LocalColors.lua with any text editor to configure your color as well as those of neutral units, allies, and enemies.

[[File:colorSelection.png]]

The 'Custom' option should appear in the color selection menu that can be found in the top left corner of the ingame interface. Select it to use your custom colors. You can make changes to the colors during the game by editing the file and typing <code>/luaui reload</code> to apply the updates.

==Using custom widgets==

Menu &rarr; Settings/Misc/Widget List

https://github.com/ZeroK-RTS/Zero-K/tree/master/LuaUI/Widgets

===Activate local widgets===

In the ingame menu tntick simple settings, then go to Settings/Misc and tick 'Show Advanced Settings'. Then open 'Local Widget Config' tick the boxes and type '/luaui reload'.

[[File:Local Widget Config SS.JPG]]

===File location===

Widgets get placed in <code>Zero-K\LuaUI\Widgets</code>.

===Access widget menu===

You can find the Widget List under Menu &rarr; Settings/Misc 'Widget List'. Default bound to Alt+F11, you can change the hotkey from here. The widget menu contains many active widgets important to the default UI. Your custom widgets should be at the top, in a group called User local, from which you can activate them.

{{Navbox manual}}
[[Category:Development]]