Skip to content
Adrian K edited this page Mar 12, 2026 · 69 revisions

A lot has changed, the old things still work, but are considered legacy, please wait warmly while the documentation is being updated.

Quick overview:

Folder structure is flatter: (the block type is now directly in the root). Textures is now a single root folder.

for sand it is now sands[screen].xml, root <Sands> then <Sand>. for conveyors its <Conveyors> then <Conveyor>.

switchBlocksMod
⊢ auto
⊢ ⊢ platforms[screen].xml
⊢ ⊢ conveyors[screen].xml
⊢ countdown
⊢ ⊢ platforms[screen].xml
⊢ ⊢ levers[screen].xml
⊢ sand
⊢ ⊢ sands[screen].xml
⊢ textures

boolean elements can now be self closing to be true, as if a statement that something should be just that, or a fully written element true.

Additionally some QoL options have been added to create the blocks.xml, reload the blocks.xml as well as reload all drawables (platforms, levers, sands, conveyors). This requires the map to be open in debug as well as the WS folder structure existing. That is the xnbs in a "bin" folder and the pngs in the parent folder. This is also where the created xmls will be written to.


Welcome to the SwitchBlocksMod wiki!

This wiki contains information for map makers on how to use this mod.

Type Overviews

Group and Sequence block types increase the system requirements and load times significantly depending on amount of use.

Experimental

Conveyor Colours

Type Red Green Blue
Auto On 238 110 _ Going left by default
Auto Off _ 110 238 Going right by default
Basic On 238 120 _ Going left by default
Basic Off _ 120 238 Going right by default
Countdown On 238 130 _ Going left by default
Countdown Off _ 130 238 Going right by default
Jump On 238 170 _ Going left by default
Jump Off _ 170 238 Going right by default

_ = a color from 1 to 30, 1 slowest, 30 fastest.

Conveyor Platforms

Path: YOUR MAP\switchBlocksMod\conveyors\basic or YOUR MAP\switchBlocksMod\conveyors\countdown Name same as other plaforms, platform_.xml, with _ being the screen.

<?xml version="1.0"?>
<Platforms xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <Platform>
        <Background>example_background</Background>
        <Scrolling>example_scrolling</Scrolling>
        <Position>
            <X>432</X>
            <Y>104</Y>
        </Position>
        <StartState>on</StartState>
        <IsForeground />
        <Multiplier>3.5</Multiplier>
    </Platform>
</Platforms>

<Multiplier> determines the scroll speed, not influenced by the multiplier set in the blocks.xml.

Platform texture

The platform requires a background or foreground texture to be set, this texture determines the size used for the platforms scrolling animation. To convey information about the state the platform texture contains both the ON and OFF state in its texture. The texture does this by rendering the left half of the texture should the state be ON and the right half should the state be off. The scrolling texture should be at least as wide as the background/foreground and half as tall (as tall as one of the states). This texture will be looped and the left and right will be next to each other.

Wiki

Home

Type Overviews

Auto

Basic

Countdown

Group

Jump

Sand

Sequence

Clone this wiki locally