NekoMusic Client

中文

An online music player for Minecraft Fabric 1.21+

Server-side: NekoMusic_Server

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
• Will (Neo)Forge be supported?
  • It's planned, but there's no set timeline
  • An experimental neoforge ver is available as beta
  • Forge will NOT be supported
• 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
• sound-categories Custom volume category support