Project Zomboid Mod:
True Music




The listed mods must always be installed and activated.

Tsar's Common Library


It’s time for true music in Project Zomboid again.

The mod allows all users to add their music to the game. In addition, you can add your own vinyl covers.

Features of the mod:

How to add your own music in SINGEPLAYER (only for Windows):

Video tutorial:

  1. Go to \workshop\content\108600\2613146550\mods\True Music\media\yourMusic

  2. Unpack yourMusic.rar or (before rename the file “yourMusic.zi” to “”) in the same folder where it is.

  3. Place audio files in mp3, wav, ogg format in the TCBoombox and TCVinylplayer folders.

  4. (optional) Place vinyl cover photos in TCVinylplayer folder in jpg format. They should be named the same as the music track file. Each music file can have its own cover.

    For example, the file with the track is called “AC DC - Highway To Hell (1979).mp3”, the file with the cover should be called “AC DC - Highway To Hell (1979).jpg”.

    The easiest way to find the cover is when you google it: “AC DC - Highway To Hell vinyl cover”.

  5. Run AddYourMusicToTheMod.exe. Depending on which folder the files is placed in, either a cassette or vinyl will be generated.

  6. After that, your cassettes and vinyl records will start spawning in the world, you just have to find them.

How to add your music in the MULTIPLAYER:

Video tutorial:

  1. Create a new mod from the template:
  2. WARNING In the file change the ID to your own
  3. WARNING To ensure that your mod does not conflict with other True Music addons, you need to rename the files:

    media\lua\server\Items\TCGLoadingTCBoombox.lua media\lua\server\Items\TCGLoadingTCVinylplayer.lua media\lua\shared\TCGMusicDefenitionsTCBombox.lua media\lua\shared\TCGMusicDefenitionsTCVinylplayer.lua media\scripts\TCGMusicScriptTCBoombox.txt media\scripts\TCTCGMusicScriptTCVinylplayer.txt media\scripts\TCGSoundsTCBombox.txt media\scripts\TCGSoundsTCVinylplayer.txt

    For example, add your mod Workshop ID to their names:

    media\lua\server\Items\TCGLoadingTCBoombox2722332157.lua media\lua\server\Items\TCGLoadingTCVinylplayer2722332157.lua media/lua/shared/TCGMusicDefenitionsTCBombox2722332157.lua media\lua\shared\TCGMusicDefenitionsTCVinylplayer2722332157.lua media\scripts\TCGMusicScriptTCBoombox2722332157.txt media\scripts\TCTCGMusicScriptTCVinylplayer2722332157.txt media\scripts\TCGSoundsTCBoombox2722332157.txt media\scripts\TCGSoundsTCVinylplayer2722332157.txt

  4. Send the mod to all users of the server (we allow to publish a mod created from the template)
  5. If you want to upload your work to Workshop, you will need to delete folders and files:

    \media\yourMusic\audioConverter \media\yourMusic\pictureConverter \media\yourMusic\AddYourMusicToTheMod.exe \media\yourMusic\DeleteYourMusicFromTheMod.exe

Workshop ID: 2613146550
Mod ID: truemusic

Where to download?

Steam Workshop: Open page

v.2.15 (12 Mar, 2023)

Minimum version of the game: 41.78
Yandex.Disk: Download

v.2.14 (22 Jan, 2023)

Minimum version of the game: 41.78
Yandex.Disk: Download

v.2.13 (03 Jan, 2023)

Minimum version of the game: 41.78
Yandex.Disk: Download

v.2.11 (16 Aug, 2022)

Minimum version of the game: 41.73
Yandex.Disk: Download

Don't see the latest version?

Click here.


Redistribution of this mod without explicit permission from the original creator is prohibited under any circumstances. This includes, but not limited to, uploading this mod to the Steam Workshop or any other site, distribution as part of another mod or modpack, distribution of modified versions.