Beyond all reason widget documentation and most useful widgets
Where to find widget docs, the most commonly used BAR widgets, and unused interface code worth knowing about.
Widget documentation
BAR does not ship a single centralized widget manual. Documentation lives across several resources. The SpringRTS wiki covers the widget API and callback system. BAR repository source files in luaui/Widgets/ serve as reference implementations. Community widget repos contain practical examples of advanced functionality.
The fastest way to understand any specific widget is reading its source. BAR widgets are single Lua files with a standard header section listing the widget name, author, and purpose. Read the header first, then trace the Initialize and Update methods.
Most useful widgets for BAR players
The reclaim field display widget ranks as one of the most commonly needed. It shows metal deposit locations and their values directly on the ground, which is essential for economy planning. Without it, spotting metal spots requires memorizing markers or watching experienced players place them.
Other widely used widgets include the large health bars display for clearer target identification and the attack range widget for understanding engagement distances before committing forces.
Unused interface code
BAR ships with some widget files that are not active by default. The gui_healthbars_gl4.lua file uses OpenGL4 rendering for health bars. If you encounter a widget file in the repository that seems inactive, check whether it requires specific hardware or engine settings to function. GL4 widgets need a graphics card that fully supports OpenGL 4.1 or higher.
Learn with people who share knowledge
Finding the right widgets saves hours of searching. Creed of Champions members share configuration advice and recommend widgets that fit different play styles and hardware setups.
[Crd] Having a space like here that offers a community, trainings, events, and the guarantee to not be judged or insulted by fellow members is really precious. Keeping the game safe, and more importantly, fun.
Competitive play. Zero team-blame.