Widget Configuration

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

Repositioning the UI Panels

1. Start a battle.
2. Open the ingame menu by pressing the Menu button in the top right or pressing Escape or F10.
3. Disable 'Simple Settings' by unticking the checkbox in the the bottom right of the ingame menu.
4. Navigate to 'Settings/HUD Panels'.
5. Untick 'Stay up to date' and 'Reset on screen resolution change'.
6. Select the UI Preset 'None'.
7. Close the ingame menu.
8. Press Ctrl+F11 to enter tweak mode.
9. Use the transparent green boxes that appear to drag and resize the interface.
10. 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 Zero-K/sounds/music with the five subfolders war, peace, briefing, victory and defeat. Put your music files in the appropriate folders. The only supported format is .ogg.

To use your music, untick simple settings through the ingame menu and toggle Settings/Audio/Use Included Tracks then type /luaui reload 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 download and unzip this in Zero-K\LuaUI\Configs such that the filepath Zero-K\LuaUI\Configs\LocalColors.lua exists. Edit LocalColors.lua with any text editor to configure your color as well as those of neutral units, allies, and enemies.

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 /luaui reload to apply the updates.

Using custom widgets

Menu → Settings/Misc/Widget List

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

Activate local widgets

In menu → Settings/Misc and tick 'Show Advanced Settings'. Then open 'Local Widget Config' tick the boxes and type '/luaui reload'.

File location

Widgets get placed in Zero-K\LuaUI\Widgets.

Access widget menu

You can find the Widget List under Menu → 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.