Simply Speakers

This mod introduces a versatile speaker block, allowing you to broadcast custom audio throughout your world. Whether you want to set the mood with background music, play unique sound effects for events, or share your favorite tunes, Simply Speakers has you covered.

Features

• Speaker Block: A new block that can be placed in the world.
• Custom Audio: Play audio from any direct .mp3 or .wav URL. Note: Only local file URLs are supported. Streaming from internet URLs is not supported.
• Proxy Speaker System: Synchronize audio playback across multiple locations using proxy speakers linked to a main speaker.
• Cross-Platform: Supports both Fabric and Forge mod loaders.

How it works

1. Main Speaker: The main Speaker block controls the audio playback state (play, pause, stop) and stores information about which audio file is selected.
2. Proxy Speakers: These blocks can be placed anywhere in the world and linked to a main Speaker by setting the same Speaker ID in their configuration interface.
3. Synchronization: When the main Speaker starts playing audio, all Proxy Speakers with the same Speaker ID will begin playing the same audio at exactly the same position, creating a synchronized audio experience across multiple locations.
4. Redstone Control: Both Speaker and Proxy Speaker blocks can be controlled using redstone signals. When powered, they will play audio; when unpowered, they will stop.
5. Range-based Audio: Audio from both Speaker and Proxy Speaker blocks can be heard within a configurable range, and players entering or leaving this range will automatically start or stop hearing the audio.

Manually Adding Audio Files

Audio files are stored in the simply_speakers_audios directory within your world's save folder. To manually add a new audio file, follow these steps:

1. Generate a UUID: Create a new UUID (e.g., using an online generator: https://www.uuidgenerator.net/).

2. Rename and Place the File: Rename your .mp3 or .wav file to <your-uuid>.mp3 (or .wav) and place it in the simply_speakers_audios directory (located at "{your save directory}\simply_speakers_audios").

3. Update the Manifest: Open the audio_manifest.json file and add a new entry with the UUID as the key and the original filename as the value, like this:

   {
     "your-uuid": {
       "uuid": "your-uuid",
       "originalFilename": "your-song.mp3"
     }
   }

User-Friendly GUI: Right-click a speaker block to open a simple interface where you can paste the path to your audio file.

Multiplayer Ready: Designed to work smoothly in multiplayer environments, ensuring all nearby players can share the auditory experience.

Planned Features:

• Ability to pause audio
• Customizing playback speed for each speaker
• And more!

Dependencies:

• Architectury API
• Fabric API (For Fabric)

Suggestions & Bug Reports

Discord: Join the community
Github Issues: Report issues