Codexs Text Mod

Client/server NeoForge mod for Minecraft 1.21.1 focused on immersive local jukebox playback, over-shoulder camera behavior, and creator-oriented debugging tools.

Features

• Replaces the default F4 third-person back/front cycle with an over-shoulder third-person view.
• Extends the vanilla jukebox without adding a new block:
  • 32-slot playlist UI.
  • Start, stop, previous, next, and play mode controls.
  • Local audio playback from renamed music discs or imported local files.
  • MP3 playback support bundled in the mod jar.
  • Native Minecraft sound-system mode and Java audio-thread fallback mode.
• Local jukebox acoustic simulation:
  • Distance falloff.
  • Left/right stereo positioning.
  • Block occlusion.
  • Lightweight reflection, echo, and reverb processing.
  • Acoustic ray debug visualization when F3+B hitboxes are shown.
• 8-band jukebox EQ with presets.
• Bluetooth helmet enchantment:
  • Bind an enchanted helmet to a jukebox by right-clicking the jukebox with the helmet.
  • While worn, the bound jukebox can be heard without spatial obstruction or room simulation inside the level-based range.
• DSP Immortal advancement for using the EQ.
• Optional entity manager tools with configuration-based access control.

Local Music Folder

Put local audio files here, then use the jukebox playlist import button:

config/codexs_text_mod/local_music

Supported local playback includes MP3 plus formats available through Java Sound.

Build

.\gradlew.bat build

The built jar is generated under:

build/libs/

License

This project is released under the MIT License. The NeoForge MDK template license is preserved in TEMPLATE_LICENSE.txt.

Do not commit personal game saves, run folders, crash reports, or local audio files. This project is built from a NeoForge MDK base and targets Minecraft 1.21.1.