Skip to content

Instantly share code, notes, and snippets.

@jumpinjackie

jumpinjackie/Expedition 33 Music mod for Forge Adventure mode.md

Last active August 30, 2025 19:31
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save jumpinjackie/a1e2ee5c7da29bf444b0e76870ad1f97 to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save jumpinjackie/a1e2ee5c7da29bf444b0e76870ad1f97 to your computer and use it in GitHub Desktop.
Download ZIP
Expedition 33 Music mod for Forge Adventure mode
Raw
Expedition 33 Music mod for Forge Adventure mode.md

forge-expedition33-music-mod

Music mod for Forge Adventure Mode

This mod replaces the standard music soundtrack with select tracks from the OST of Clair Obscur: Expedition 33

How to mod

In the res/adventure/common/music folder resides all the music that is played in various parts of adventure mode:

  • black - Tracks that are played in the black magic biome in the overworld
  • blue - Tracks that are played in the blue magic biome in the overworld
  • boss - Tracks that are played in a boss battle
  • castle - Tracks that are played inside biome boss dungeons
  • cave - Tracks that are played in most dungeons. Despite the name, if you enter a dungeon that is not for a biome-specific boss, it will be playing tracks from this folder
  • colorless - Tracks that are played in the colorless magic (wastes) biome in the overworld
  • green - Tracks that are played in the green magic biome in the overworld
  • match - Tracks that are played during a non-boss battle
  • menus - Tracks that are played in the opening menu of adventure mode
  • red - Tracks that are played in the red magic biome in the overworld
  • town - Tracks that are played when you are in any town
  • white - Tracks that are played in the white magic biome in the overworld

The game will play a track from any of the above folders at random. The tracks can be any file name with a .mp3, .wav or .m4a extension.

To mod the music, simply replace this res/adventure/common/music folder with your own and use a tool like yt-dlp to download the referenced tracks to their respective subfolder. Or if you already own the soundtrack, copy the referenced tracks to their respective folders below.

Modding notes

  • Although the source code indicates that .m4a files should be playable, my experience on Steam Deck is that such files won't be played, so if you have such files, convert them to .mp3 files to be safe
  • On Steam Deck, if you added Forge Adventure mode to Steam Deck gaming mode, the game may have issues playing tracks that have non-ascii characters in its name. Due to the themes and setting of Expedition 33, its OST contains many tracks with french names (containing accented characters), a workaround is to rename such tracks with accented characters to their ascii equivalents (eg. é to e) and such tracks will play again. Reference: Card-Forge/forge#8290
  • Tracks in the following areas will play in a loop until you leave the area. It will not cycle to the next random track.
    • town
  • Don't put too any tracks under the boss directory. Due to the rarity of such encounters, there's a low chance of your track being played if you put too many tracks in here.

Music Selection

Menu: res/adventure/common/music/menu

Overworld - Wastes: res/adventure/common/music/colorless

Overworld - Black: res/adventure/common/music/black

Overworld - Blue: res/adventure/common/music/blue

Overworld - Red: res/adventure/common/music/red

Overworld - Green: res/adventure/common/music/green

Overworld - White: res/adventure/common/music/white

Interior - Cave: res/adventure/common/music/cave

Interior - Castle: res/adventure/common/music/castle

Interior - Town: res/adventure/common/music/town

Match/Battle: res/adventure/common/music/match

NOTE: Some overworld/interior tracks duplicated here because a) they're too good to be just walled off behind certain biomes or certain interiors b) they're short enough to match the pace/duration of a regular battle

Boss: res/adventure/common/music/boss

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment