NekoMusic Client

中文

An online music player for Minecraft Fabric 1.21+

Server-side: NekoMusic_Server

[CAUTION]

This mod is no longer maintained. Critical bugs can still be reported via issues and will be addressed when possible, but no new features or version updates will be provided.

We have developed a modern successor, MoeMusic, featuring almost all functionality of this mod plus additional enhancements: single-player support, refined GUI, plugin-driven multi-source system, and still -- fully open source.

Server administrators: We provide MoeMusic NekoCompat to ensure compatibility with NekoMusic Client, eliminating migration concerns.

---

Features

• Supports mp3, flac, ogg (vorbis) formats
• Supports starting playback from the middle of a track
• Displays lyrics, song information, and album cover
• Comprehensive in-game settings
• Customizable local cache

FAQ

• Will 1.18- be supported?
  • No
• How do I adjust the volume?
  • In Minecraft's sound settings.
• What are the advanced settings?
  • Domain Whitelist: Only resources from whitelisted domains will be allowed to load. This check ignores port numbers and matches all subdomains.
  • Cache Size: By default, music files are cached to save time and bandwidth. You can adjust this based on your available disk space. Set it to -1 for unlimited, or 0 to disable it. Reference: A 3-minute 320kbps mp3 file (default server configuration) takes up about 10MB. A Flac file takes up about 40MB.
  • Cache Path: The location where the cache is stored. Make sure there are no personal or other program files here. If you're unsure, don't modify this.
    • This option is mainly designed for users with multiple os or those who have the game installed on a removable disk. You can use a relative path (e.g., ./cache/nekomusiccli) for multi-system compatibility or use environment variables (e.g., ${APPDATA}/NekoMusicCli) to avoid storing the cache on a removable disk.

Acknowledgements

• cloth-config Simple and easy-to-use settings interface
• badpackets Excellent server and client data packet solution
• OkHttp Powerful network request library
• jlayer (Github branch) mp3 decoding
• Flac-library-java Flac decoding
• Tika Powerful content detection and analysis framework