From The Battle for Wesnoth Wiki
Revision as of 07:24, 22 January 2021 by Pentarctagon (talk | contribs) (Links)


This is a new toolkit aiming to make it possible to make the look of Wesnoth fully skinnable. This will be used in Wesnoth the make it easier to optimize for different screen resolutions. The initial work in progress version has been released with Wesnoth 1.6. Since the development isn't done yet, these pages reflect the state of the trunk.

The engine has two parts:

  • Widget definition, which defines how a widget looks.
  • Window definition, which defines how a certain window looks and it uses the widget definitions.

Todo list

Here's a(n incomplete) list of items which still need to be done.

  • The layout engine can still have problems with not finding a solution and stop.
    • Make sure labels buttons etc can shrink and show ellipses to shrink small enough
    • Optimize the shrink algorithm
  • The code for the events is not entirely to my liking and I want to look at using signals instead, events are there bug not yet used everywhere.
  • EasyCoding#GUI2_related_features
  • Improve the markup for the text
  • Convert more dialogs


  • Widgets - the various widgets, the options which can be used when a widget is "instantiated" in a window definition, and the types of GUI2 variables available.
  • Layout - describes how to place widgets in a window.
  • WindowDefinitionWML - describes the windows available and which widgets the 'know' about.
  • GUIToolkit - describes the basics of the engine.
  • GUICanvas - describes what to draw on a widget.