Custom songs seem to have been available through Electronauts for a bit of time so this guide is a way to hopefully get some more interest stirred for custom songs.

Please note that adding your own custom songs isn't as easy as dragging and dropping a file - there's a lot of steps to set up your own songs like separating the instrumentals and the vocals and getting the files to line up correctly.

For my personal custom songs I use FL Studio to make sure the samples are at the correct BPM and are at the correct length - if you don't use FL Studio or a different DAW I'd recommend finding samples that are the same BPM and using Audacity to chop them to the correct size. (There are a lot of videos/tutorials out there on how to use Audacity or your preferred DAW already.)

1. Open up your Electronauts game folder and head to Electronauts\Electronauts_Data\StreamingAssets\DefaultMods\ and 'copy' this folder.
   
   
2. Head to your default Documents folder and into the Electronauts folder.
   
   
3. Paste the DefautMods folder you copied into this folder and rename it to 'Mods'.
   
   
4. Go into your new Mods folder and open the file called ModsConfig.txt
   
   
5. Select all of the text and replace it with the following:
   m_ModsEnabled:true
   
   
6. Head back to your Electronauts game folder (Electronauts\Electronauts_Data\) and go into the Managed folder.
   
   
7. Download this file[drive.google.com] and copy it into the Managed folder. If a message asks you if you want to replace any files, click Yes.
   (full link here: https://drive.google.com/file/d/1F7qFKzgA4YrAQWH50OBv6ViyvZNEZoEK/view?usp=sharing )
   
   
8. Once copied, start Electronauts. If all went well you should see a new genre called 'Mods' and some example songs!

The song support is very in-depth - anything used in normal songs can be used in custom songs. This includes all instruments and visualisers as well.

To look at the format/layout any of the default custom songs just open up your Documents folder and head to the /Electronauts/Mods/ folder you created previously.

Loop and sample length depends on the instrument in use and if you set the m_numberOfBars option in the config file (more info on that later). Generally:

• Looper: Each loop goes for 1 bar/quarter of a loop. I've yet to test the looper with anything more than 2 bars set under m_numberOfBars, so message me if this is something you've tested!
  
  
• Stems/Backing Track: Depends on how many bars are in your song, of course make sure all samples used for the backing track are the same length/BPM.
  
  
• Vocals: 4 loops long

Custom songs are laid out as below, with short descriptions of each of the folders/files underneath:

The below is an example folder - your own custom song can potentially look different than this. Lines with the '-' at the start of the name indicate this is a file, lines with no '-' at the start are folders.


MY_SONG: Unique song folder name required to be in ALL CAPS.

---

GROOVE_SAMPLER: Two sounds used in the REMIX 1 and REMIX 2 sections of the FX Cube when the Glitch preset is pressed. Usually a drum fill. For examples of these sounds check out the same folder in the default custom songs.

---

INSTRUMENTS: Instruments in this folder need to be named in all capitals and with a number at the end, for example ORBS1, ORBS2 and HARP1. Multiple instruments like two orbs need to increment the number at the end, so four orbs will look like ORBS1, ORBS2, ORBS3, ORBS4.

Valid instruments:

• ORBS
  
• LOOPER
  
• HARP

InstrumentConfig.txt
In any Instrument folder you can add a text file named 'InstrumentConfig.txt' which lets you set instrument-specific options:

• m_mono: Set the instrument to mono audio (so one channel instead of two, like stereo audio). Set to 0 for no mono, 1 for mono.
  
  
• m_ducking: 'Ducking' is when the audio signal briefly lowers, or 'ducks' while another audio signal is playing - the options for this are 'Off', 'Slow', 'Medium' or 'Fast'.
  
  
• m_quantizerResolution: This affects the quantization (or 'snapping' of notes to the beat). Value is a float (0.0, 1.3 etc.)
  
  
• m_overrideThemeQuantizerResolution: Overrides the theme quantizer resolution for an independent option. Same as above.
  
  
• m_volume: Volume of the instrument independent to the default theme volume. Defaults to 1.

You often don't need to adjust any of the above options or even create the InstrumentConfig.txt file - most instruments/audio clips will work fine with the default options set through the main Config.txt file.

---

ONESHOTS: Oneshots are the grenades - each song has 5 grenades, so 5 files each need to be labelled from 1 to 5.

---

STEMS: This folder contains the files that make up the backing track of the song. Each folder in this needs to be numbered between 1 and 6 and have a unique track name that can be up to 6 letters long.

In each track name folder there can be up to 9 different 'stems' (loops). Each stem needs to be named as one of the following:

• Bass
  
• Clap
  
• Guitar
  
• Kick
  
• Synth
  
• Hat
  
• Wobble
  
• Percussion
  
• Pad
  
• Snare
  
• FX
  
• Tom
  
• Keys

Your stems in each track can be named any of the above as long as the total stems in the track is less or equal to 9.

---

VOCALS: There can be up to 3 vocals on the track, named VERSE1.wav and so on.

---

TRANSITIONS: The transition sounds used on the Backing Track instrument. Every song requires 4.

---

Other files:

Config.txt: Explained in more depth in next section.
Icon.png: The song's icon used in the main menu - file needs to be 1024x1024 24-bit PNG.
Preview.wav: A preview of your song - this should be about 2 loops/8 bars long. Around 20 seconds in real time.
readme.txt: Used for any attribution, such as using sounds or images from public sites. This is optional.

---

Other notes:

• HARP and ORBS instruments require 7 notes (files)
  
• LOOPER instrument requires 5 loops (files)

The config.txt file contains a couple of options for your song's details like title, artist and genre as well as a bunch of settings for using your own custom files for the visualiser.

---

The options with some default values that can be used are as below:

Required options:

m_name: The name of the song.

m_artists: The artists on the song - if there are multiple, separate them with a comma (,)

m_description: The description of the song. Shocking!

m_genres: The genre/s of the song. Separate multiple genres with a comma, can list up to 3. Valid genres are any of the below:


m_BPM: The song's beats per minute. This is important to set correctly as it's used for song timing.

m_numberOfBars: Number of bars the song loop has - defaults to 2. This is also important to set correctly.

m_visualizer: Choice of visualiser. Can range from 1 to 14, with 14 being a blank visualiser. Use 14 if you're planning on using your own custom image/video/URL. Full list of visualiser options is in Additional info section at end of guide.

m_volume: Volume of the song. Typically this should be set to 1 and then tested to see if the song is too quiet/too loud and to adjust accordingly, however min = 0, max = 2. Decimal points are accepted (0.5, 1.3 etc.)

m_defaultCameraView: The default camera view as listed in the FX tool - ranges from 1 to 6 with 6 being first person.

---

Optional options:

m_MediaFiles: The file name (including file extension) that you are using.

m_MediaType: The type of media used. Types can be: URL, Video (.mp4), Image (.png), 360 Video (.mp4), 360 Image (.png). See example songs for some image, video, 360 and URLs used.

m_MediaPlaybackType: When the media should play. Right now On Load is the only option.

m_MediaScaleX/m_MediaScaleY: Scales the media on the X or Y axis - only applies to Image or Video types.

m_BrowserWidth/m_BrowserHeight The width/height of the browser window. Only applies to URL type of media.

m_BrowserScale The scale of the browser window. Only applies to URL type of media.

The modding community for this game is very quiet and very dead, and I'd love to help in any way with getting more people to play this amazing game - be it hosting websites, creating more specialised mods or by just spreading the word.
I'd love to see a huge custom song library in the future so I hope this guide motivates you to create your own songs, either using the files from your own personal songs or creating your own funky remixes from sounds and loops that are already out there.

Below is a couple of my personal favourite loop sites:

https://www.looperman.com/

https://primeloops.com/

https://sampleswap.org/

https://www.bigfishaudio.com/

---

If you have any ideas, questions or feedback leave a comment or shoot me a message on Steam or on Discord (zer0ney#0025)!

I've also created a Discord server for this topic since there doesn't seem to be any others - come join at https://discord.gg/y76xhCSnBM if you're interested in keeping this alive :)

---

Below is some assorted info that hasn't been tested or verified as of yet to work with either the config.txt file or as a folder to use in the 'folder structure' layout.

Variables:

• m_featuredArtists: This seems to be the same as the m_artists option except the artists here get added to the end of the song with "ft." added in front, for example "My Song ft. Artist"
  
  
• m_remixArtists: This adds " Remix" at the end with the artist/s name in front.
  
  
• m_previewMenuAudioFile: If this is set the .wav file specified will be used for the preview, otherwise the preview will come from /MYSONG/PREVIEW/ folder. (unsure if this affects the default Preview.wav file in the root song folder)
  
  
• m_visualizationId: untested - may use the direct viz IDs, full list further below.
  
  
• m_colorPaletteId: unsure and needs testing
  
  
• m_canRecord: Seems to add recording start and recording stop buttons that outputs to a .wav file - untested
  
  
• m_backingTracks: manually sets backing track amount, better off just using the folder structure as this is automatically set depending on the amount of folders in the STEMS folder.
  
  
• m_vocalTracks: Amount of vocal tracks in song - this is also set automatically when using the VOCALS folder so no need to set this usually.
  
  
• m_barLengthExponent: This can be set from 0 to 4 to set the bar length to 1, 2, 4, 8, or 16 (power of 2) - this is untested as well, once confirmed to be working will add to config.txt section.

Folders

PADSYNTH is a valid instrument name but is untested as well, same layout as the HARP instrument.

Other info

There's an 'admin panel' that can be used by pressing the O key that lets you adjust master volume, change song instantly as well as some other stuff like enabling an overlay that shows the currently playing song details and an Electronauts logo.


Syncing the tracks to the visualizer is automatically done as long as you name your files in the STEMS folder correctly (like Kick.wav and Snare.wav).

Visualization IDs and names