OUTDATED REPO: READ

IMPORTANT!

If you are here, you were likely following an outdated modding guide.
All mods (including TrombLoader) are now hosted on Thunderstore.
You can use r2modman to easily manage your mods on Windows and Linux.
If you are on MacOS, you can use Candygoblen123's mod manager in place of r2modman

Please follow this guide or this video if you wish to mod your game.

Related Links:

• Trombone Champ Modding Community Discord
• Trombone Champ Modding Wiki
• Trombone Champ Thunderstore Page
• r2modman

v1.4.1: Fix for Trombone Champ 1.08

Changelog:

• Fixed TrombLoader crashing the game on 1.08 when Fart sound is selected
• Fixed TrombLoader making other trombone sounds out of order
• Added the ability for .trombackground creators to customize tromboner movement types

Installation

Detailed installation instructions can be found on https://trombone.wiki.

v1.4.0: Fix song loading bugs

Changelog:

• Fixed duplicate songs breaking the game (thanks @emmett-shark!)
• Disables creating/deleting a save if errors are thrown on load
  • A few people unnecessarily overwrote their save previously because of a bug, this should make this less likely to happen
• Made song loading recursive
  • Extracting a song into a subfolder will make it still load with this change
• Added song loading capabilities to the plugins folder for thunderstore compatibility
• Fixed lyrics having quotes unintentionally
• Fixed .trombackground files layering over champ meter & breath UI
• Added player input on/off events for chart creators

Installation

Detailed installation instructions can be found on https://trombone.wiki.

v1.3.1 Minor Bugfixing for new BG Features

• Fixes crashes when using the new BeatCounter class in a background project
• Fixes the 20 songs achievement
• Further bugfixes for the 100 songs limit

Installation

Step 1: Install BepInEx
Download latest BepinEx release and extract the contents of BepinEx_x64_VERSION.zip directly into the root of the Trombone Champ folder, IE C:\Program Files (x86)\Steam\steamapps\common\TromboneChamp\

Step 2: Patch Trombone Champ with BepInEx
Run the game once to install BepinEx properly.

Step 3: Install the TrombLoader plugin
Download the latest release from Releases, and under the "assets" section, download TrombLoader.dll and put it into the BepInEx/plugins folder that was created in Step 2. IE: C:\Program Files (x86)\Steam\steamapps\common\TromboneChamp\BepInEx\plugins

v1.3.0: Remove 100 Chart Limit, Fix Bugs

Changelog:

• Removed the 100 chart limit (thanks @emmett-shark!)
• Fixed songs not loading when folder name is incorrect
• The secret ending no longer plays the wrong chart
• Made chart paths more robust and resistant to breakage
• Added SceneLightingHelper to allow chart background creators to more accurately control lighting
• Added BeatCounter for more finetuned control of beat events in backgrounds

Installation

Step 1: Install BepInEx
Download latest BepinEx release and extract the contents of BepinEx_x64_VERSION.zip directly into the root of the Trombone Champ folder, IE C:\Program Files (x86)\Steam\steamapps\common\TromboneChamp\

Step 2: Patch Trombone Champ with BepInEx
Run the game once to install BepinEx properly.

Step 3: Install the TrombLoader plugin
Download the latest release from Releases, and under the "assets" section, download TrombLoader.dll and put it into the BepInEx/plugins folder that was created in Step 2. IE: C:\Program Files (x86)\Steam\steamapps\common\TromboneChamp\BepInEx\plugins

v1.2.2: Fix for Trombone Champ 1.07

Changelog:

• Fixed TrombLoader crashing the game on 1.07
• Fixed song length being in bars instead of real time

Installation

Step 1: Install BepInEx
Download latest BepinEx release and extract the contents of BepinEx_x64_VERSION.zip directly into the root of the Trombone Champ folder, IE C:\Program Files (x86)\Steam\steamapps\common\TromboneChamp\

Step 2: Patch Trombone Champ with BepInEx
Run the game once to install BepinEx properly.

Step 3: Install the TrombLoader plugin
Download the latest release from Releases, and under the "assets" section, download TrombLoader.dll and put it into the BepInEx/plugins folder that was created in Step 2. IE: C:\Program Files (x86)\Steam\steamapps\common\TromboneChamp\BepInEx\plugins

v1.2.1: Note Colors & Background Features

Changelog:

• Fixed a video player bug in 1.2.0

1.2.0 Changelog:

• Added the ability for chart creators to change the note colors.
  • Fields are note_color_start and note_color_end in song.tmb
• Video backgrounds can now be easily added to charts by placing a bg.mp4 file in a song folder
  • More robust support now exists in the TrombLoaderBackgroundProject
• Added Tromboners to the Background project, giving chart creators the ability to change where the player is, create clones of the player, etc
  • The Tromboner skin & Trombone skins can both be overridden to create a tromboner that looks different from the player
• Minor bug fixes

More detailed instructions for chart creators can be found in the Background Project's README

Installation

Step 1: Install BepInEx
Download latest BepinEx release and extract the contents of BepinEx_x64_VERSION.zip directly into the root of the Trombone Champ folder, IE C:\Program Files (x86)\Steam\steamapps\common\TromboneChamp\

Step 2: Patch Trombone Champ with BepInEx
Run the game once to install BepinEx properly.

Step 3: Install the TrombLoader plugin
Download the latest release from Releases, and under the "assets" section, download TrombLoader.dll and put it into the BepInEx/plugins folder that was created in Step 2. IE: C:\Program Files (x86)\Steam\steamapps\common\TromboneChamp\BepInEx\plugins

v1.2.0: Note Colors & Background Features

Changelog:

• Added the ability for chart creators to change the note colors.
  • Fields are note_color_start and note_color_end in song.tmb
• Video backgrounds can now be easily added to charts by placing a bg.mp4 file in a song folder
  • More robust support now exists in the TrombLoaderBackgroundProject
• Added Tromboners to the Background project, giving chart creators the ability to change where the player is, create clones of the player, etc
  • The Tromboner skin & Trombone skins can both be overridden to create a tromboner that looks different from the player
• Minor bug fixes

More detailed instructions for chart creators can be found in the Background Project's README

Installation

Step 1: Install BepInEx
Download latest BepinEx release and extract the contents of BepinEx_x64_VERSION.zip directly into the root of the Trombone Champ folder, IE C:\Program Files (x86)\Steam\steamapps\common\TromboneChamp\

Step 2: Patch Trombone Champ with BepInEx
Run the game once to install BepinEx properly.

Step 3: Install the TrombLoader plugin
Download the latest release from Releases, and under the "assets" section, download TrombLoader.dll and put it into the BepInEx/plugins folder that was created in Step 2. IE: C:\Program Files (x86)\Steam\steamapps\common\TromboneChamp\BepInEx\plugins

v1.1.0 Tween Support

• Added support for tweens on backgrounds, greatly speeding up the creation of complex background elements

v1.0.0: Complex backgrounds

Changelog:

• Added bgdata and backgroundMovement fields to allow more complex background control
• Added the ability to load AssetBundle chart backgrounds created with the TrombLoaderBackgroundProject
• Minor bug fixes

More detailed instructions for chart creators can be found in the Background Project's README

Installation

Step 1: Install BepInEx
Download latest BepinEx release and extract the contents of BepinEx_x64_VERSION.zip directly into the root of the Trombone Champ folder, IE C:\Program Files (x86)\Steam\steamapps\common\TromboneChamp\

Step 2: Patch Trombone Champ with BepInEx
Run the game once to install BepinEx properly.

Step 3: Install the TrombLoader plugin
Download the latest release from Releases, and under the "assets" section, download TrombLoader.dll and put it into the BepInEx/plugins folder that was created in Step 2. IE: C:\Program Files (x86)\Steam\steamapps\common\TromboneChamp\BepInEx\plugins