Explained

This wiki page explains all custom events only present in the Thirty Dollar Tools projects.

Format

The formatting of the TDWex events is a bit different to not fully break compatibility with the Thirty Dollar Website. Custom events start with # instead of ! and those that allow setting values, use parenthesis (). This is so that the Thirty Dollar Website doesn't recognize them as sounds and try to parse them, which will result in an error.

Currently the only way to use these custom events is to edit the TDW sequence files directly, but in the near future, the Thirty Dollar Visualizer will support editing sequences and the editor will also include support for the TDWex events.

TDWex Events

Comments

This isn't really an event, but given how the Thirty Dollar Website parses sequences, it's counted as an event. The comment disappears entirely when the sequence calculation stage is reached. You make a comment using a hash with a space after it # |. Here's an example.

# 
Epic commented information here. Feast your eyes upon thee, commenteer.
Multiple lines are supported until a pipe has invaded the castle.
On no! A pipe symbol, run! |

!speed@128|!speed@2@x|
boom@1|_pause=3|!divider|

The Define Event

Allows you to create a shorthand for a combination of sounds and events.

Defining

To define a shorthand you have two custom events you have to use. You start a define window with |#define(name)| and replace name with an actual name you want to use. One thing to keep in mind is that using a name that is already used by a sound will result in the sound being used. Once you have added all events that the shorthand will put, you end the define window with the event |#enddefine|

Here's a full example of a define.

#define(cool_sound)|
mariopaint_flower|!combine|mariopaint_car%70|!combine|mariopaint_plane@-12%30| 
# keep in mind that you have to close the events that you are defining so that the parser can see the #enddefine event |
# this applies to comments as well |
#enddefine|

Usage

After a shorthand is defined you can use it in the sequence directly just like you would a normal sound. You can even pitch it up / down and it will pitch all sound in the define. Their volume is also affected with the % modifier.

Example:

# the define is above this line.
!speed@128|!speed@2@x|!divider|

cool_sound|cool_sound@-2|!combine|cool_sound@4%50| # and continuing ...

The Individual Cut Event

This event acts like the Thirty Dollar Website's |!cut| event but only cuts the sound you specify. Example:

boom|!combine|mariopaint_car|!combine|mariopaint_plane|!combine|mariopaint_flower|
#icut(boom)|# cuts the boom |
_pause|
#icut(mariopaint_flower, mariopaint_car)|# cuts both mariopaint_flower and mariopaint_car |

The Bookmark Event

This event sets a bookmark in the Thirty Dollar Visualizer which points to where it's placed. Example:

boom|
boom|
boom|
#bookmark(1)|
boom| # when pressing the number 1 in the visualizer, it seeks to the last boom. |

TDWex Modifiers

The Pan Modifier

This is a new addition to sounds. This modifier pans the audio of the sample for the left and right channels. It uses the ^ "caret" symbol.

Values

It accepts values from -1 (100% left - 0% right) to 1 (100% right - 0% left), and by default it's set to 0 (equal audio on both channels) on all events. This addition is the only save breaking addition from the Thirty Dollar Tools, but in my opinion it should be added to the Thirty Dollar Website itself. Here's an example on how to use it.

Usage

boom@1%150^1| # a boom pitched 1 semitone up, with a volume of 150% playing only on the right channel |
boom@1%150^-1| # a boom pitched 1 semitone up, with a volume of 150% playing only on the left channel |
boom@-1%120^0.8| # a boom pitched 1 semitone down, with a volume of 120% mostly audible on the right channel, but can be still heard from the left channel|
boom@-1%120^-0.8| # a boom pitched 1 semitone down, with a volume of 120% mostly audible on the left channel, but can be still heard from the right channel|

The Divide Value Scale

All events that support addition and multiplication, also support division with the / slash symbol in the ThirtyDollarTools

Edit: 11 Feb 2025. The Thirty Dollar Website now natively supports division by holding ALT + Multiply button in the tempo dialog. This is no longer an exclusive feature of the Tools.

Example: |!speed@3@x|boom|boom|boom|boom|!speed@3@/|