numberNormalChannels |
int |
64 |
hodgepodge sound Maximum number of normal (non-streaming) channels available for simultaneous sound effects. OpenAL Soft defaults to 256 sources unless overridden. If fewer are available, Paulscode creates as many channels as it can. Takes effect after ‘Reload Sounds’ in the sound options, or a restart. |
numberStreamingChannels |
int |
8 |
Maximum number of streaming channels: music, records, and other streamed audio playing at once. Takes effect after ‘Reload Sounds’ in the sound options, or a restart. |
defaultAttenuationModel |
AttenuationType |
“ATTENUATION_ROLLOFF” |
Attenuation model to use if not specified. Attenuation is how a source’s volume fades with distance. ATTENUATION_NONE: Global identifier for no attenuation. Attenuation is how a source’s volume fades with distance. When there is no attenuation, a source’s volume remains constant regardless of distance. ATTENUATION_ROLLOFF: Global identifier for rolloff attenuation. Rolloff attenuation is a realistic attenuation model, which uses a rolloff factor to determine how quickly a source fades with distance. A smaller rolloff factor will fade at a further distance, and a rolloff factor of 0 will never fade. NOTE: In OpenAL, rolloff attenuation only works for monotone sounds. ATTENUATION_LINEAR: Global identifier for linear attenuation. Linear attenuation is less realistic than rolloff attenuation, but it allows the user to specify a maximum “fade distance” where a source’s volume becomes zero. ATTENUATION_ROLLOFF |
defaultRolloffFactor |
float |
0.03f |
Default value to use for the rolloff factor if not specified. |
dopplerFactor |
float |
0.0f |
Value to use for the Doppler factor, for determining Doppler scale. |
dopplerVelocity |
float |
1.0f |
Value to use for the Doppler velocity. |
defaultFadeDistance |
float |
1000.0f |
Default value to use for fade distance if not specified. |
streamingBufferSize |
int |
131072 |
Number of bytes to load at a time when streaming. |
numberStreamingBuffers |
int |
3 |
Number of buffers used for each streaming source. Slow codecs may require this number to be greater than 2 to prevent audio skipping during playback. |
streamQueueFormatsMatch |
boolean |
false |
Enables a transition-speed optimization by assuming all sounds in each streaming source’s queue will have exactly the same format once decoded (including channels, sample rate, and sample size). This is an advanced setting which should only be changed by experienced developers. NOTE: I have not checked if this is even true for vanilla. Changing this setting will most likely break things. |
maxFileSize |
int |
268435456 |
Maximum decoded size of a non-streaming sound. OGG decoding stops at this limit on a complete PCM frame. Streamed sounds are unaffected. |
fileChunkSize |
int |
1048576 |
Size of each chunk used by non-streaming codecs that honor it. OGG uses streamingBufferSize to keep decode copying bounded. |
overrideMIDISynthesizer |
String |
“” |
MIDI device to try using as the Synthesizer. May be the full name or part of the name. If this String is empty, the default Synthesizer will be used, or one of the common alternate synthesizers if the default Synthesizer is unavailable. |
downmixStereoSounds |
boolean |
true |
Downmix non-streaming stereo OGG sounds to mono, halving their decoded PCM size and allowing positional audio. Non-streaming is used as a proxy for positional, so rare non-positional effects may also be downmixed. Streaming sounds, normally music and records, are unaffected. Ignored for sounds handled by spatializeStereoSounds. Takes full effect after ‘Reload Sounds’ or a restart. |
spatializeStereoSounds |
boolean |
true |
Let OpenAL position stereo sounds that use distance attenuation without converting them to mono. This preserves the stereo PCM but uses roughly twice the buffer memory of mono. Requires lwjgl3ify and AL_SOFT_source_spatialize; otherwise downmixStereoSounds can provide the fallback. Takes full effect after ‘Reload Sounds’ or a restart. |
downmixExclusions |
String[] |
{ “button”, “click”, “/gui”, “menu”, “typing”, “page” } |
Sounds whose path contains any of these are never downmixed, so interface sounds keep their stereo. Matched case-insensitively against ‘domain:path’, e.g. ‘gregtech:sounds/buttonup.ogg’. Only used by downmixStereoSounds. spatializeStereoSounds needs no list because it decides per playback from the attenuation model. Broad patterns can also match world sounds; those stay stereo and cannot be positioned by the downmix fallback. button click /gui menu typing page |
releaseDecodedSoundData |
boolean |
true |
Discard the Java-heap PCM copy after a non-streaming sound is uploaded to OpenAL, removing one of the two cached decoded copies. Turn off only if you suspect it of causing missing or corrupted sounds. Takes full effect after ‘Reload Sounds’ or a restart. |
environmentalReverb |
boolean |
false |
Add environmental reverb to positional sounds based on how enclosed the listener is. Requires OpenAL EFX, available in the bundled Java 8 and lwjgl3ify backends. Surroundings are estimated by sampling 12 directions up to 20 blocks four times per second. Takes full effect after ‘Reload Sounds’ or a restart. |
reverbStrength |
float |
0.3f |
How wet the reverb gets in a fully enclosed space. Lower is subtler. Only used when environmentalReverb is on. |
hrtf |
Tristate |
“DEFAULT” |
Binaural 3D audio for headphones (HRTF): lets you hear whether a sound is above, below, in front or behind you, instead of just left/right. Designed for headphones; speakers may sound hollow or coloured. DEFAULT leaves it to OpenAL’s device configuration, ON forces it, OFF forces it off. Requires lwjgl3ify; ignored on Java 8. DEFAULT |
outputLimiter |
Tristate |
“DEFAULT” |
Protects the final output mix from clipping by reducing gain when its combined level exceeds the device range. It reacts to signal level, not the number of playing sounds, and does not limit sound or channel count. DEFAULT leaves it to OpenAL, ON forces it, OFF disables it. Requires lwjgl3ify; ignored on Java 8. DEFAULT |
manageOutputDevicesAtStartup |
boolean |
— |
Let Hodgepodge manage the OpenAL output device, including following system-default changes and recovering from disconnects. Requires lwjgl3ify and ALC_SOFT_reopen_device; otherwise this is ignored. Restart after changing this option. |
enabled |
boolean |
true |
Enables output device selection and recovery. |
outputDevice |
String |
“” |
OpenAL output device name. Empty follows the system default and switches when the default changes. Use the in-game Sound Enhancements menu instead of editing this value by hand. |