THC - The Harmonic Client

THC is an audio-reactive Minecraft visualizer mod built around music, particles, HUD visualizers, listening parties, and customizable player-driven effects.

Turn your music into animated particle systems, glowing geometry, responsive HUD widgets, lyrics, cover art, and immersive player-centered audio visuals.

Image Gallery

Main Showcase Banner

Particle Showcase

THC Particle Showcase 1

THC Particle Showcase 2

GUI Screenshot

Features

Audio-reactive particles and geometry visualizers
HUD media player with cover art, playback controls, progress, volume, and visualizer styles
Multiple visualizer types, including bars, waveform, oscilloscope, dot sphere, network, rain, float, emerge, fly, cloud, cube, pyramid, sphere, and true sphere
Custom themes with color presets, color picker, RGB/hex input, opacity controls, and particle color slots
Lyrics HUD with scrolling lyric display
Song queue support with automatic preparation for upcoming tracks
Listening party system with party codes, party permissions, member controls, and shared queues
Player music controls for muting or lowering other players
Configurable HUD scale, UI scale, blur, animations, fonts, and layout options
Designed for compatibility with Fabric, NeoForge, Sodium, Iris, and dynamic lighting setups

Music Support

THC is designed to support music from common sources such as:

YouTube links and searches
SoundCloud links
Spotify metadata and fallback lookup
Local or system output capture where supported

The mod can display track information, artist names, cover art, progress, queue state, and lyrics when available.

Customization

THC is built around personalization. Players can adjust:

Particle count, size, distance, height, speed, bass reaction, BPM reaction, drift, gravity, and glow
Visualizer style, animation type, world shape, and optional second visualizer
HUD layout, media player layout, lyrics HUD, visualizer HUD, opacity, and positioning
Theme colors, glow colors, panel colors, particle colors, and custom hex/RGB values
Fonts, UI scale, HUD scale, background blur, and animations

Multiplayer

THC includes multiplayer-focused controls so players can manage how they experience other people’s music and visuals.

Mute or lower other players’ music
Disable other players’ particles or HUD song display locally
Join listening parties with shared queues
Use party leader controls for skipping, locking, muting, kicking, banning, or limiting member actions

Compatibility

Minecraft 1.21.1
Fabric 1.21.1
NeoForge 1.21.1 (21.1.233)
Sodium compatible
Iris shader compatible
Designed with dynamic lights support in mind

Notes

THC is actively being developed. Some provider features, synced lyrics, cover art, party features, dynamic lighting, and audio capture behavior may vary depending on platform, installed dependencies (yt-dlp & ffmpeg), and server configuration.

Server owners can configure restrictions for music playback, particles, HUD visibility, listening parties, and player permissions.

Plugin version will be developed later on so servers can use plugins if they'd like servers to use this.

Common Questions

Will this be open source?
- Most likely, yes. Once THC reaches a point where player-made visualizers can sync between clients without requiring the server to have the mod installed, I believe it would make more sense to open source it.
Will this be uploaded to Modrinth?
- Most likely not. Their moderation is good, but it takes too long for the amount of bug fixes and updates I am currently making.
Can I help or be part of the project?
- Coding-wise, no. However, you can still help by submitting issues, bug reports, and feedback.
Will there be any supporter features?
- I personally do not want to do that, but maybe. If it ever happens, it would most likely be extra visualizers that I make which are not part of the normal presets. There is also a possibility that players could share or sell their own visualizers in some way.
Is there a Discord server?
- No. I personally do not like owning servers because they can cause drama, need constant moderation, and become problematic to manage. In general, I also do not really enjoy having to constantly converse with others in that kind of setting.
Will there be a Forge port or backport?
- The furthest back I would most likely support is Minecraft 1.20.1, and that may be the only Forge port. There is a chance I may support newer Forge versions in the future, but the main issue is making sure the mod stays optimized and stable across different loaders and versions.
I have a suggestion. Where should I suggest it?
- Please suggest it on the THC-Issues GitHub page and label it properly. You can also leave suggestions in the CurseForge comments, but they are less likely to be seen.

Planned Features

More media player HUD layouts
More visualizer styles and geometry modes
Improved synced lyrics support
Expanded server-side controls
Better cover art and metadata fetching
More particle presets inspired by advanced visual clients
Improved dynamic lighting and shader glow integration
Player made audio visualizers
Plugin Version
Compatibility/Integration with Voice Chat Mod & EmoteCraft
Client-Side Syncing (Like Lunar does with emotes)
Icons instead of just text symbols/words

Credits

Created by incold.

THC is inspired by modern visual clients, music visualizers, particle systems, and sleek animated UI design.