CVP Audio Compatibility

By
Momik_jpg

Fixes bundled audio converter lookup for DragNSounds API on NeoForge 1.21.1, without changing gameplay.

CVP Audio Compatibility

A small original compatibility component for BlockBeats and DragNSounds API in Create Vanilla+ Boss Adventure, on Minecraft 1.21.1 with NeoForge 21.1.262 and Java 21.

What it does

In the tested NeoForge configuration, JAVE cannot find the native audio-converter executable already bundled inside DragNSounds API. This component obtains the original nested resource through the NeoForge mod-file interface and places the unchanged executable into the cache expected by JAVE. It checks the exact size and SHA-256, uses a lock and an atomic rename, and preserves an existing file if its contents differ.

The component contains original Java code and its source files. It does not bundle a third-party executable and does not download programs. The converter comes from your separately installed, unchanged DragNSounds API file. No tick handler, new blocks, recipes or gameplay changes are added.

Requirements

Minecraft 1.21.1, NeoForge 21.1.262, Java 21.
DragNSounds API 1.21.1-beta-0.2.1. This release targets that exact API version.
The CVP pack uses BlockBeats 1.21.1-beta-0.2.0. Its DragonLib dependency is embedded in DragNSounds API; do not add another DragonLib for this beta combination.
Tested platforms: Windows amd64 and Linux amd64. Other architectures retain upstream behaviour and are not covered by this fix.

An extracted converter uses approximately 74 MiB of temporary/cache storage. The cache file is checked at startup. An existing mismatching cache binary is left untouched and produces an explicit error instead of being silently replaced.

Verification

Automated native dedicated-server and client checks passed with the pinned Create/JEG pack. They cover loading, block registration and placement, client-to-dedicated-server connection, and WAV-to-OGG conversion followed by decoding. Fresh independent temporary directories were used. A separate test ran the bundled converter on the actual Linux host. Full user-upload/playlists, long music sessions and human listening tests remain open.

Source and licence

Original code: CVP contributors, MIT. Full source is included inside the JAR under source/ and in the accompanying source archive. Existing upstream projects retain their own licences:

Deutsch: Kleine eigene Kompatibilitätshilfe für die Ressourcenauflösung des bereits mitgelieferten Audio-Konverters. Geprüft unter Windows/Linux amd64; keine Spielmechaniken werden verändert.