The Choicer Voicer: Custom Voice Packs & Dub Packs Technical Specification

This document provides the exact system directories, file constraints, format parameters, and execution steps needed to create and install standard Voice Packs, Dub Packs, and Player Modpacks in The Choicer Voicer.

1. Storage Directories & Paths

Custom packages must be placed within specific directories inside the root folder of the local game files for the engine to identify them:

• Standard Voice Packs & Dub Packs: [Game_Root]/packs_voice/
• Contestant Player Modpacks: [Game_Root]/packs_player/

2. Standard Voice Packs Specification

Standard Voice Packs contain the raw audio samples that players mimic in the core game modes. The engine evaluates vocal inputs against these reference waveforms.

A. Audio File Requirements

• Supported Containers: WAV, MP3, and OGG. (If duplicate names exist with different formats, the engine resolves priority in this order: WAV > MP3 > OGG).
• Audio Codec: Use standard uncompressed 16-bit PCM for WAV files. Avoid compressed or multi-channel WAV containers as they can cause engine decoding errors.
• Duration Limit: Maximum of 60 seconds per clip.
• Acoustic Level: Audio files must have clear, high-amplitude waveforms. Ensure tracks are volume-normalized, as low amplitude leads to scoring calculation errors.

B. Metadata & Display Assets

• Creator Attribution: A plain text file named _author.txt containing only the author name.
• Pack Description: A plain text file named _subtitle.txt containing the pack's descriptive subtitle.
• Specific Clip Subtitles: Provide a .txt file matching the exact file name of the audio clip (e.g., clip_01.txt contains the subtitle for clip_01.wav).
• Clip Graphics: Provide a PNG or JPG graphic sharing the exact name of the audio clip.
• Filler Image: Name an image file _pack_filler_image or _icon (PNG or JPG) to set a fallback graphic for clips lacking dedicated assets.

3. Cinematic Dub Packs Specification (Version 0.5.0+)

Dub Packs run in "Dub Mode", synchronizing live player voiceovers with a video track.

• Video Track Requirements: The video must be in OGV (Ogg Video) format, placed in the voice pack's folder.
• Backing Track: Isolate dialogue from background sound effects and music. Save the music/SFX layer as _backing_track (WAV/MP3/OGG) to keep them playing during voiceover loops.
• Vocal Dialogue Samples: Export vocal references in sequential numbering (e.g., 01_line.wav, 02_line.wav). Recommended length per line is 2 to 6 seconds.
• Timing Synchronization: To bind lines to specific video frame timelines:
  1. Go to the game's main menu, navigate to Extras, and select Edit Voice Packs & Clip Metadata.
  2. Input precise target millisecond timestamps for each audio clip.
  3. Enable the "dub-only" toggle to restrict these clips from rendering in non-dub game modes.

4. Player Contestant Modpacks

Contestant modpacks enable the customization of local avatars, introductions, and score reactions inside packs_player/.

Asset File Name	Specification	Vocal Reaction Triggers
player.png / player.webp	Vertical aspect ratio. Recommended height is 1000px or greater.	Serves as the static model for the contestant podium.
talk_greet.wav	Short audio introduction clip (under 5 seconds).	Triggers when the host introduces the contestant.
talk_cheer.wav	High-energy celebration clip (under 5 seconds).	Triggers automatically when an impression scores 85% or higher.
talk_upset.wav	Disappointed vocal reaction clip (under 5 seconds).	Triggers automatically when an impression receives a low score from the judges.

5. Packaging, Sharing, and Installation

To package a custom mod for distribution:

1. Compress the mod folder into a standard ZIP file. Ensure that files are nested inside a single root folder named after the pack (do not zip loose files directly).
2. To install custom packs: Extract the ZIP file directly into the corresponding directory (packs_voice for audio/dub packs, packs_player for character avatars).
3. Restart the game instance or navigate to the custom menu to reload game assets.