Mod «Simple Music Builder» for Project Zomboid

Simple Music Builder
Simple Music Builder is a tool for creating Project Zomboid Build 42 music-pack mods. It allows users to build companion mods that add real-song media items to the game.
What This Tool Does
The builder creates companion mods containing:

• Cassette items
• Vinyl record and vinyl album/sleeve items
• Music definition Lua files
• Script, model, and texture references
• mod.info and workshop.txt scaffolding
• Custom texture masks with previews
• High-resolution images for the album inspect feature

Requirements

• Windows and Project Zomboid Build 42
• Parent mod installed if the pack depends on one (e.g., TrueMoozic)
• Leaving the Parent Mod field blank packages dependent assets in the output

Quick Start

1. Launch the builder.
2. Set audio source and image source folders.
3. Add songs and choose Cassette or Vinyl output per row.
4. Set cover behavior (Poster Override or Mod Default).
5. Build and review the output.
6. Upload the generated mod using the standard Workshop workflow.

Main Workflow
1) Project Setup

• Define Mod ID and Mod Name
• Set Parent Mod dependency
• Enter Author(s)
• Select poster or preview image

2) Song Table

• Add or remove songs
• Toggle cassette and vinyl output
• Assign optional B-sides
• Assign covers per song
• Preview playback per row
• Track conversion status

3) Cover Pipeline

• Apply poster override for all song covers (without text if selected)
• Apply cassette/vinyl masking for non-default covers
• Select vinyl inner or outer mask options (Inner = custom sticker, Outer = everything but the center sticker)
• Export high-resolution textures (max 2048x2048) for album inspect support

4) Build + Export

• Generates a ready-to-publish mod folder structure
• Supports copying output directly into Workshop paths

Mix Builder

• Stitch together a list of songs to consolidate them into one item
• Automatically converts audio on consolidation and adds it to the list

Key Features

• Built-in ffmpeg conversion pipeline
• A-side / B-side support for media items with base-mod flip support
• Batch operations for cassette/vinyl toggles
• Save/load project state and recent files
• Automatic metadata and dependency generation
• Create Mix function to generate multi-song audio files directly in the builder

Keybinds

• Save Project: Ctrl+S
• Select All Songs: Ctrl+A
• Remove Selected Songs: Delete

Notes

• Child packs can be generated to rely on parent mod assets when configured for TrueMoozic.
• Designed to keep pack creation repeatable and Workshop-friendly.

Technical Information:

• Workshop ID: 3667952776
• Mod ID: SimpleMusicBuilder

Required mods: True MoooZIC B42.13+ and B42.14+ SP/MP