Donut Team is a labor of love, built and maintained by a small group of passionate developers. We invest our own time and resources to offer our tools, mods, and web services completely free of charge.

We don't run ads, and we will never sell your data - period.

If you've enjoyed anything we've created, please consider supporting our work with a one-time or monthly donation via our Ko-fi page . Every contribution helps us continue building great experiences for the community.

Dismiss
Donut TeamForumMod BakeryDocs
Search
Default avatar
  • Modding Tools
  • Lucas' Simpsons Hit & Run Mod Launcher
  • Hacks
  • Mod Requirable Hacks

Custom Audio Support

Available since Version 1.18.

This hack must be required by a mod to be enabled.

This hack allows mods to control various audio related features such as the starting ambience track for each story mission.

Requiring This Hack

To require this hack, add this line to your mod's Meta.ini:

RequiredHack=CustomAudioSupport

Your mod must provide a configuration file when requiring this hack.

Configuring This Hack

To configure this hack, create a file named CustomAudioSupport.xml and add the parameters necessary for your mod inside it.

<?xml version="1.0" encoding="utf-8"?>
<CustomAudioSupport MusicSamplingRate="24000">
	<!--

	<CustomAudioSupport>
		ForcedMusicRMSLevel: Specify an RMS file to load at startup and use all the time. 
			This will prevent the game from ever unloading that level's RMS file.
			This means this can be used for seamless music when switching to/from the main menu and between levels.
		MusicSamplingRate: Defaults to 24,000. Optional.
				
	<Interior>
		Name: The name of the interior.
		MusicEventIndex: The index of the music event to trigger when entering the interior.
		
	<Level>
		Index: The index of the level. 0-6.
		 OR
		Number: The number of the level. 1-7.
		
		StartAmbienceEventIndex: The ambience index that will be used for mission's that use 76 (interior).
		BirdSound: The daSoundResourceData to play when entering an Event Locator using event 47 for the level.
			Defaults to pigeon_takeoff in Levels 2/5, gull_takeoff in Levels 3/6 and null in Levels 1/4/7.
			Using null disables the sound.

		<Mission>
			Index: The index of the mission from 0 to 7.
				0 refers to the Tutorial in Level 1.
				0 refers to Mission 1 in Levels 2 to 7.
				7 does nothing in Levels 2 to 7 since there is only the 7 story missions and no tutorial.
			StartAmbienceEventIndex: The ambience index that will be used when selecting the mission.
				76 means the mission starts in an interior and it will use the one specified on the level.
			BirdSound: The daSoundResourceData to play when entering an Event Locator using event 47 for the mission.
				Defaults to the Level's BirdSound.
		
	-->

	<Interior Name="KwikEMart" MusicEventIndex="20"/>
	<Interior Name="SpringfieldElementary" MusicEventIndex="21"/>
	<Interior Name="SimpsonsHouse" MusicEventIndex="19"/>
	<Interior Name="Krustylu" MusicEventIndex="19"/>
	<Interior Name="dmv" MusicEventIndex="23"/>
	
	<Level Number="1" StartAmbienceEventIndex="9">
		<Mission Index="0" StartAmbienceEventIndex="6" />
		<Mission Index="1" StartAmbienceEventIndex="6" />
		<Mission Index="2" StartAmbienceEventIndex="6" />
		<Mission Index="3" StartAmbienceEventIndex="6" />
		<Mission Index="4" StartAmbienceEventIndex="39" />
		<Mission Index="5" StartAmbienceEventIndex="6" />
		<Mission Index="6" StartAmbienceEventIndex="6" />
		<Mission Index="7" StartAmbienceEventIndex="26" />
	</Level>
	<Level Number="2" StartAmbienceEventIndex="7">
		<Mission Index="0" StartAmbienceEventIndex="4" />
		<Mission Index="1" StartAmbienceEventIndex="4" />
		<Mission Index="2" StartAmbienceEventIndex="4" />
		<Mission Index="3" StartAmbienceEventIndex="4" />
		<Mission Index="4" StartAmbienceEventIndex="4" />
		<Mission Index="5" StartAmbienceEventIndex="4" />
		<Mission Index="6" StartAmbienceEventIndex="4" />
		<Mission Index="7" StartAmbienceEventIndex="76" />
	</Level>
	<Level Number="3" StartAmbienceEventIndex="25">
		<Mission Index="0" StartAmbienceEventIndex="22" />
		<Mission Index="1" StartAmbienceEventIndex="22" />
		<Mission Index="2" StartAmbienceEventIndex="22" />
		<Mission Index="3" StartAmbienceEventIndex="29" />
		<Mission Index="4" StartAmbienceEventIndex="22" />
		<Mission Index="5" StartAmbienceEventIndex="24" />
		<Mission Index="6" StartAmbienceEventIndex="24" />
		<Mission Index="7" StartAmbienceEventIndex="76" />
	</Level>
	<Level Number="4" StartAmbienceEventIndex="51">
		<Mission Index="0" StartAmbienceEventIndex="76" />
		<Mission Index="1" StartAmbienceEventIndex="47" />
		<Mission Index="2" StartAmbienceEventIndex="48" />
		<Mission Index="3" StartAmbienceEventIndex="48" />
		<Mission Index="4" StartAmbienceEventIndex="48" />
		<Mission Index="5" StartAmbienceEventIndex="48" />
		<Mission Index="6" StartAmbienceEventIndex="48" />
		<Mission Index="7" StartAmbienceEventIndex="76" />
	</Level>
	<Level Number="5" StartAmbienceEventIndex="7">
		<Mission Index="0" StartAmbienceEventIndex="4" />
		<Mission Index="1" StartAmbienceEventIndex="4" />
		<Mission Index="2" StartAmbienceEventIndex="4" />
		<Mission Index="3" StartAmbienceEventIndex="4" />
		<Mission Index="4" StartAmbienceEventIndex="4" />
		<Mission Index="5" StartAmbienceEventIndex="4" />
		<Mission Index="6" StartAmbienceEventIndex="4" />
		<Mission Index="7" StartAmbienceEventIndex="76" />
	</Level>
	<Level Number="6" StartAmbienceEventIndex="70">
		<Mission Index="0" StartAmbienceEventIndex="67" />
		<Mission Index="1" StartAmbienceEventIndex="67" />
		<Mission Index="2" StartAmbienceEventIndex="64" />
		<Mission Index="3" StartAmbienceEventIndex="47" />
		<Mission Index="4" StartAmbienceEventIndex="64" />
		<Mission Index="5" StartAmbienceEventIndex="67" />
		<Mission Index="6" StartAmbienceEventIndex="67" />
		<Mission Index="7" StartAmbienceEventIndex="76" />
	</Level>
	<Level Number="7" StartAmbienceEventIndex="53">
		<Mission Index="0" StartAmbienceEventIndex="76" />
		<Mission Index="1" StartAmbienceEventIndex="57" />
		<Mission Index="2" StartAmbienceEventIndex="50" />
		<Mission Index="3" StartAmbienceEventIndex="76" />
		<Mission Index="4" StartAmbienceEventIndex="76" />
		<Mission Index="5" StartAmbienceEventIndex="57" />
		<Mission Index="6" StartAmbienceEventIndex="57" />
		<Mission Index="7" StartAmbienceEventIndex="76" />
	</Level>
</CustomAudioSupport>

Debug Text Mode

This hack registers a debug mode for the Debug Text hack when used alongside it.

Version History

Version 1.27

  • Added a new BirdSound attribute for <Level> elements that lets you set what daSoundResourceData plays when entering an Event Locator using event 47 for a level.
  • Added a new BirdSound attribute for <Mission> elements that lets you set what daSoundResourceData plays when entering an Event Locator using event 47 for a mission.

Version 1.22

Added support for a Number attributes on <Level> and <Mission> elements.

Edit on GitHub · Authored by Loren
Log inCreate an account
Discord server