Difference between revisions of "Cluster"

 
(20 intermediate revisions by the same user not shown)
Line 9: Line 9:
 
Cluster supports most commonly used audio formats including WAV/MP3/WMA/MIDI/OGG/FLAC, the Tracker formats XM/S3M/MOD/IT as well as the PSX2 ADPCM format.
 
Cluster supports most commonly used audio formats including WAV/MP3/WMA/MIDI/OGG/FLAC, the Tracker formats XM/S3M/MOD/IT as well as the PSX2 ADPCM format.
  
In general there is no separation in support for these formats between either of ''Sound'', ''Music'' or CD emulation, except PSX2 ADPCM support is not available for CD emulation.
+
In general there is no separation in support for these formats between either of ''Sound'', ''Music'' or CD emulation, except that PSX2 ADPCM support is not available for CD emulation.
  
 
===== Recommended Audio Formats =====
 
===== Recommended Audio Formats =====
  
Outside the use of tracker formats, I recommend using the MP3 file format, as it offers both compression and very efficient support inside FMOD.
+
Outside the use of tracker formats, I recommend using the MP3 file format as it's efficiently supported inside FMOD.
  
 
===== PSX2 ADPCM Notes =====
 
===== PSX2 ADPCM Notes =====
Line 23: Line 23:
 
The music for the PSX2 games was stored directly on disk with VGM (Unreal Tournament and Rune) or 000-006 (Deus Ex) file extension. These files do not contain a header and are always encoded in a fixed format. You can import these files as is, and they will be identified by FileType VGM or 000-007. These files are not interchangeable with the FileType PS2 ''Sound'' objects above.
 
The music for the PSX2 games was stored directly on disk with VGM (Unreal Tournament and Rune) or 000-006 (Deus Ex) file extension. These files do not contain a header and are always encoded in a fixed format. You can import these files as is, and they will be identified by FileType VGM or 000-007. These files are not interchangeable with the FileType PS2 ''Sound'' objects above.
  
==== EAGLE Environments ====
+
==== CD Music Emulation ====
  
For five minutes of nostalgia Cluster supports the use of audio environments originally features in the UT EAX patch made by Creative. See the [[EAGLE]] page for details.
+
Games such as Klingon Honor Guard or X-Com: Enforcer shipped used CD music. Cluster emulates this feature by reading the individual music tracks from files within the game directory.
 +
 
 +
The individual tracks must be placed directly inside the Music directory and named Track<Number>.<Extension>, where <Number> is the at least two digit track number and <Extension> is any of the following file extensions: wav, mp3, wma, asf, ogg or flac. For example "KHG/Music/Track04.mp3".
 +
 
 +
The UseCDMusic option needs to be enabled.
  
 
== Configuration ==
 
== Configuration ==
===== UseDigitalMusic =====
 
===== UseCDMusic =====
 
===== EffectsChannels =====
 
 
===== SoundVolume =====
 
===== SoundVolume =====
 +
Volume of sounds played except music. Some games will have additional options for parts of the sounds played, e.g. Deus Ex has a separate setting for voice over.
 +
 
===== SpeechVolume (Deus Ex) =====
 
===== SpeechVolume (Deus Ex) =====
 +
Volume of the voice over played in Deus Ex.
 +
 
===== MusicVolume =====
 
===== MusicVolume =====
 +
Volume of music.
  
 +
===== UseDigitalMusic =====
 +
A slightly oversimplified explanation of this option would be "music which comes from umx files".
  
 +
===== UseCDMusic =====
 +
Enables CD music emulation.
  
 
===== CDMusicVolumeFactor =====
 
===== CDMusicVolumeFactor =====
 +
Correction factor intended to deal with a potential missmatch between volume in CD and Digital music in case both are used.
  
== How to obtain ==
+
===== UseFrenchLipsync (Deus Ex) =====
 +
Uses a different lipsynch implementation. The term french is used as in "french rifling", not in relation to a particular language.
  
===== Deus Ex =====  
+
===== UsePatches =====
 +
Injects patches to modify or fix broadly audio related functionality in parts of the Engine outside of Cluster. You may or may not need to disable this to comply with anti cheat mods or software when playing online.
  
Future standalone release and shipping as part of Launch Bag in HX.
+
===== EffectsChannels =====
 +
Upper limit of concurrently playing sounds. Higher values tend to just oversaturate the output. The sweetspot is probably around 8-12, the highest useful value is probably around 16. Sadly stock Unreal Engine lacks proper a priority system...
  
===== Klingon Honor Guard =====
+
== How to obtain ==
  
Future standalone release.
+
Standalone builds of Cluster can be obtained on it's [https://coding.hanfling.de/cluster/ website].
 
 
===== Unreal Gold =====
 
 
 
Future standalone release.
 
 
 
===== Unreal 226f =====
 
 
 
Future standalone release and shipping as part of Project Velora and Project Vendora.
 
 
 
===== Unreal 227 "Oldunreal" =====
 
 
 
Not supported.
 
 
 
===== Unreal Tournament 436  =====
 
 
 
Future standalone release.
 
 
 
===== Unreal Tournament 440-451b  =====
 
 
 
Not supported.
 
 
 
===== Unreal Tournament 469 "Oldunreal"  =====
 
 
 
A modified Cluster version is included.
 
 
 
===== Nerf Arena Blast =====
 
 
 
Shipping as part of Nerf 300 project.
 
  
 
== Known issues ==
 
== Known issues ==
Line 82: Line 68:
 
== Frequently asked questions ==
 
== Frequently asked questions ==
  
'''TBD'''.
+
Q: Why is there a Galaxy.int in the zip file?
 +
 
 +
A: The original Galaxy.int will make Galaxy occupy the whole Audio preferences section inside the Advanded Options. This Galaxy.int will move it to a subentry, so it can be happily configured thereafter alongside Cluster!

Latest revision as of 04:28, 28 November 2023

Preamble

Goals

Features

Supported Audio Formats

Cluster supports most commonly used audio formats including WAV/MP3/WMA/MIDI/OGG/FLAC, the Tracker formats XM/S3M/MOD/IT as well as the PSX2 ADPCM format.

In general there is no separation in support for these formats between either of Sound, Music or CD emulation, except that PSX2 ADPCM support is not available for CD emulation.

Recommended Audio Formats

Outside the use of tracker formats, I recommend using the MP3 file format as it's efficiently supported inside FMOD.

PSX2 ADPCM Notes

The PSX2 Sounds and on disk music files to not contain an identification header in the file data itsself, so Cluster identifies them based on the FileType stored on both "Sound" and "Music" (which is based on the file extension on import).

Sound objects in the PSX2 version were converted with the PS2ConvertCommandlet, which alongside convertion, added a small header and set the FileType to PS2. In case you reimport these files, make sure they still have PS2 as file extension. I recommend using tools which use the stored FileType as extension for the exported file (e.g. fullbatchexport commandlet).

The music for the PSX2 games was stored directly on disk with VGM (Unreal Tournament and Rune) or 000-006 (Deus Ex) file extension. These files do not contain a header and are always encoded in a fixed format. You can import these files as is, and they will be identified by FileType VGM or 000-007. These files are not interchangeable with the FileType PS2 Sound objects above.

CD Music Emulation

Games such as Klingon Honor Guard or X-Com: Enforcer shipped used CD music. Cluster emulates this feature by reading the individual music tracks from files within the game directory.

The individual tracks must be placed directly inside the Music directory and named Track<Number>.<Extension>, where <Number> is the at least two digit track number and <Extension> is any of the following file extensions: wav, mp3, wma, asf, ogg or flac. For example "KHG/Music/Track04.mp3".

The UseCDMusic option needs to be enabled.

Configuration

SoundVolume

Volume of sounds played except music. Some games will have additional options for parts of the sounds played, e.g. Deus Ex has a separate setting for voice over.

SpeechVolume (Deus Ex)

Volume of the voice over played in Deus Ex.

MusicVolume

Volume of music.

UseDigitalMusic

A slightly oversimplified explanation of this option would be "music which comes from umx files".

UseCDMusic

Enables CD music emulation.

CDMusicVolumeFactor

Correction factor intended to deal with a potential missmatch between volume in CD and Digital music in case both are used.

UseFrenchLipsync (Deus Ex)

Uses a different lipsynch implementation. The term french is used as in "french rifling", not in relation to a particular language.

UsePatches

Injects patches to modify or fix broadly audio related functionality in parts of the Engine outside of Cluster. You may or may not need to disable this to comply with anti cheat mods or software when playing online.

EffectsChannels

Upper limit of concurrently playing sounds. Higher values tend to just oversaturate the output. The sweetspot is probably around 8-12, the highest useful value is probably around 16. Sadly stock Unreal Engine lacks proper a priority system...

How to obtain

Standalone builds of Cluster can be obtained on it's website.

Known issues

  • FMOD will not reset S3M state such as volume on loop, and will break for S3M files relying on this non standard behaviour.

Frequently asked questions

Q: Why is there a Galaxy.int in the zip file?

A: The original Galaxy.int will make Galaxy occupy the whole Audio preferences section inside the Advanded Options. This Galaxy.int will move it to a subentry, so it can be happily configured thereafter alongside Cluster!