Themes

Theme mods are mods that alter the interface elements and sound files of the game, usually to resemble another game or to personalise your appearance.

settings.xml

Each theme uses settings.xml to determine various functionality aspects of the theme, such as what HUD layout it should use, or what colour the special gauge is. A default settings.xml should look like this:

<list>
    <hud style="DX"/>
    <heroes spinner=""/>
    <victory timer=""/>
    <round transition=""/>
    <logo style=""/>
    <bubbles on="" amount="" chance="" speed=""/>
    <scrolling on="" speed="" alpha=""/>
    <sounds life-pause="" loop-spin=""/>
    <background x="1920" y="1080"/>
    <gauge r="20" g="255" b="255" fr="120" fg="255" fb="255"/>
    <author is="Team Konpeito"/>
    <redring style="1"/>
</list>

A settings.xml is REQUIRED for a theme mod, as it is how the game recognises custom themes. In most cases you can just copy the DX Default settings.xml, and edit relevant values. DX's own settings.xml is stored in: Data/Themes/Settings.xml

HUD Style

<hud style=""/>

• Alters HUD placement in-game to closest match any of the following options:

DXLegacySA1SA2HeroesShadow06GenerationsForcesFrontiersClassic

Heroes Spinner

<heroes spinner=""/>

• Set to 1 to enable separate spinners for each team member when playing in teams.

Round Transition

<round transition=""/>

• Set to 1 to enable the round transitional image from heroes

Logo Style

<logo style=""/>

• Set to 1 to enable the R8 logo fly-in animation

<victory timer=""/>

• (CURRENTLY NOT FUNCTIONAL)

Author

<author is=""/>

• Write down the creator of the theme here

Bubbles

<bubbles on="1" amount="6" chance="2" speed="1"/>

• This enables Bubbles on the title screen, like the Adventure 2 Theme
• chance is the frequency they will spawn.
• amount is the maximum allowed to be on-screen.
• speed is a multiplier on their movement speed.

Scrolling Background

<scrolling on="" speed="" alpha=""/>

• See SA2 theme for details

Gauge Colour

<gauge r="" g="" b="" fr="" fg="" fb=""/>

• Set the normal and full gauge colours

Sound Settings

<sounds life-pause="" loop-spin=""/>

• Pauses music on life gain or loop the spin sound

Background Resolution

<background x="" y=""/>

• Sets the background resolution.
• Defaults at 1920 x 1080
• If porting a Pre-2022 theme, set this to 1440 x 900

Feel free to look at any base game theme’s settings xml and folder structure to figure out how they function. Remember in-game you can type themedata into the console to reload the theme’s settings without having to exit the game.

kerning.xml

Font Kerning

<list>
<A k="14"/>
<B k="14"/>
<C k="15"/>
<D k="14"/>
<E k="14"/>
<F k="14"/>
<G k="14"/>
<H k="14"/>
<I k="6"/>
<J k="14"/>
<K k="15"/>
<L k="12"/>
<M k="16"/>
<N k="14"/>
<O k="15"/>
<P k="14"/>
<Q k="17"/>
<R k="14"/>
<S k="14"/>
<T k="14"/>
<U k="15"/>
<V k="15"/>
<W k="24"/>
<X k="14"/>
<Y k="14"/>
<Z k="13"/>

<a k="14"/>
<b k="14"/>
<c k="13"/>
<d k="14"/>
<e k="14"/>
<f k="9"/>
<g k="14"/>
<h k="14"/>
<i k="11"/>
<j k="9"/>
<k k="14"/>
<l k="6"/>
<m k="20"/>
<n k="14"/>
<o k="14"/>
<p k="14"/>
<q k="14"/>
<r k="12"/>
<s k="14"/>
<t k="9"/>
<u k="14"/>
<v k="14"/>
<w k="22"/>
<x k="15"/>
<y k="14"/>
<z k="13"/>

<1 k="13"/>
<2 k="14"/>
<3 k="14"/>
<4 k="14"/>
<5 k="14"/>
<6 k="14"/>
<7 k="14"/>
<8 k="14"/>
<9 k="14"/>
<0 k="14"/>

<number k="20"/>


</list>

Most themes leave this file out, which uses the defaults shown above. If your custom text letters overlaps each other, you may need to alter these values. Most of the lines are kerning for all png files that begin with text, except for one:

HUD Kerning

<number k="20"/>

• This determines the kerning of the numbers on HUD elements. If making the numbers smaller than the base game, lower this value.