Subscribe to download
v7.60 Music Manual Replacement Template (X3 version)

v7.60 Music Manual Replacement Template (X3 version)

I created this for personal use, but I'm releasing it to the public anyway.

This is a simple template for an `.xml` file that allows players to manually replace the music played during movement and combat in X4.

To use this template as is, you must own the X3 series.

This mod only contains differential XML files that manage the X4 in-game music.

It does not contain any music files (`.ogg`).

Please place and convert the sound source from X3 to X4 format yourself.

---

### Compatible versions and DLC

* X4 Foundations v7.60
* Compatible with all DLC (Split Vendetta, Cradle of Humanity, etc.) (can be run without DLC)

---

### Required games

The following games are required:

* X3: Reunion
* X3: Terran Conflict
* X3: Albion Prelude
* X4: Foundations

---

### Instructions for use (installing X3 music)

1. Install X3: Reunion and Terran Conflict / Albion Prelude

2. Find the following `soundtrack` folder:

```
Steam\steamapps\common\X3 - Reunion\soundtrack\
Steam\steamapps\common\X3 Terran Conflict\soundtrack\
```

3. Change the `.mp3` files in the folder to `.ogg` (X4 does not recognize `.mp3`)

※File name cannot be changed.

Example:

Correct: `00012.ogg`

Incorrect: `00012_custom.ogg`

4. Create a new music folder in the following location and store the converted `.ogg`. Both Reunion and Terran Conflict music files are required, and duplicates will be overwritten. :

```
Steam\steamapps\common\X4 Foundations\extensions\ebi_x3_music\

↓
Steam\steamapps\common\X4 Foundations\extensions\ebi_x3_music\music
```

5. Start X4 and if the music has changed, it is a success. If there is no sound, it is a failure.

---

### Conversion example

I used the free software [Audacity].
Import your MP3 by dragging and dropping it, then save it by going to "File → Export → OGG".

---

### Steps to modify the template to make your own mod

1. Change `extensions\ebi_x3_music` to any name (e.g. `my_music_mod`)

2. Open `my_music_mod\content.xml` and edit it as follows:

```xml
<content id="my_music_mod" name="my_music_mod" description="my_music_mod" author="your_name" version="100" date="2025-07-10" save="0">
<dependency id="ego_dlc_split" name="Split Vendetta" optional="true"/>
<dependency id="ego_dlc_boron" name="Kingdom End" optional="true"/>
<dependency id="ego_dlc_terran" name="Cradle of Humanity" optional="true"/>
<dependency id="ego_dlc_pirate" name="Tides of Avarice" optional="true"/>

<dependency id="ego_dlc_timelines" name="Timelines" optional="true"/>

<dependency id="ego_dlc_mini_01" name="Hyperion Pack" optional="true"/>

</content>

``

3. Create a `music` folder under my_music_mod and store your favorite `.ogg`

4. Once you have extracted this mod using the official Egosoft [XRCatTool], delete the original .cat and .dat files as they are no longer needed.

5. Edit `libraries\sound_library.xml` and change the path of the BGM.

Example of change (main menu music):

```xml
<replace sel="//sound[@id='music_menu_main_music']">
<sound id="music_menu_main_music" description="Music for the main menu" repeat="-1" is3d="0" preload="0">
<sample selection="random">
<select start="extensions\my_music_mod\music\YourMusic1.ogg" />
<select start="extensions\my_music_mod\music\YourMusic2.ogg" />
<select start="extensions\my_music_mod\music\YourMusic3.ogg" />
</sample>
<volume start="0.5"/>
<effects>
<fade in="6" out="9"/>

</effects>

</sound>

</replace>
```

Other faction, sector, and battle music can be changed in the same way.

---

### Checklist for troubleshooting

* Incorrect `.ogg` file name/path
* Inconsistent information in `content.xml`
* Interference with other music mods
* Invalid `.ogg` format
* Syntax error in `sound_library.xml`
* Incorrect folder name

---

### Supplementary notes

This mod does not include X3 music files, so you will need to purchase X3 and convert it manually.