LiveSplit has a GUI to edit settings, but LiveSplit One platforms currently do not. The only way to edit settings for these is to edit them in the .lss file directly. This serves as a guide to add/change settings manually.

.lss files are XML files. It is recommended to use software which can make this look more "pretty," such as using VSCodium with the Pretty XML extension.

At the bottom of the XML, there may exist a tag for <AutoSplitterSettings />. It should be just before the ending tag of </Run>. Something like this:

    <!-- snip -->
    </Segments>
    <AutoSplitterSettings />
</Run>

Replace the tag with a more verbose version so there's room to add settings:

    <!-- snip -->
    </Segments>
    <AutoSplitterSettings>
        <CustomSettings>
            <!-- Settings go here! -->
        </CustomSettings>
    </AutoSplitterSettings>
</Run>

For all the examples below, you should place the snippets inside the comment block within <CustomSettings> so the auto-splitter can recognize them.

The simplest setting, where its value can either be True or False. In ASL, this is the only way for settings to be set. Since WASM gives more versatility, the only setting in which a bool is useful is for resetting on the title screen:

<!-- This setting is False by default. -->
<!-- You don't need to add a setting if you want to keep the default. -->
<Setting id="reset_on_title" type="bool">True</Setting>

This is the most common setting for the auto-splitter. Most settings are defined by an event which can occur multiple times within a run (i.e. exiting a level or killing a boss). This setting controls when the specified event should trigger a timer split. These options are:

• FirstTime
• EveryTime
• Never

In practice, the XML looks something like this:

<!-- This setting is FirstTime by default. -->
<!-- You don't need to add a setting if you want to keep the default. -->
<Setting id="s3_molten_crater" type="string" value="EveryTime" />

Any setting to split for a given level will do so upon exiting the level. Entering a level will never trigger a split unless the level being exited does so.

There are exceptions for when specific level-transitions should occur, such as level storage and going from one home world to another. You can see these exceptions in MapCache::is_valid_map_transition().

Below is a table of levels with their corresponding id values that can be added to the settings like in the Split example.

Any setting to split for a given boss will do so upon killing them. Below is a table of supported bosses with their corresponding id values that can be added to the settings like in the Split example.

Similar to Split, this is also defined by an event. In this case, it's picking up a collectable, dependent on the game. The options are:

• Never
• OnCategoryRequirement
• EveryCollection

The category requirement is specifically for category extensions. These are as follows:

• Spyro the Dragon - 80 Dragons
• Spyro 2: Ripto's Rage - 40 Orbs (not supported by auto-splitter)
• Spyro: Year of the Dragon - 149 Eggs

In practice, the XML looks something like this:

<!-- This setting is Never by default. -->
<!-- You don't need to add a setting if you want to keep the default. -->
<Setting id="s3_egg_collected" type="string" value="EveryCollection"/>

Below is a table of the games with their corresponding id values that can be added to the settings like in the above example.