The Bukkit\/Spigot\/Paper server-side plugin implementation of MusicHud.<\/p>\n
### ***You must install the mod on the client before using this plugin!!!***
\n– Mod project link: **https:\/\/github.com\/Etern-34520\/MusicHud**
\n– Modrinth: **https:\/\/modrinth.com\/mod\/music-hud**<\/p>\n
## Features
\n– Communicates with the client mod via Plugin Messaging and synchronizes playback status
\n– Supports song request queue and vote-to-skip
\n– Supports idle playlist playback
\n– Supports anonymous \/ Cookie login<\/p>\n
## Installation
\n1. Put the built artifact into the server `plugins\/` directory
\n2. Start the server to generate the configuration files
\n3. Modify the configuration as needed and restart the server or execute the reload command
\n4. Deploy Netease Cloud Music API Enhanced (https:\/\/github.com\/neteasecloudmusicapienhanced\/api-enhanced). Please follow the api-enhanced README for deployment instructions
\n5. If you do not use the default port (3000) of NCM API Enhanced or deploy it on another server, you need to modify the `base-url` property in the configuration file<\/p>\n
## Configuration
\nConfiguration file location: `plugins\/MusicHud-Bukkit\/config.yml`<\/p>\n
Key configuration options:
\n– `api.base-url`: Netease Cloud Music API address (default `http:\/\/localhost:3000`)
\n– `api.timeout`: API request timeout (milliseconds)
\n– `playback.interval`: Interval between songs (milliseconds)
\n– `playback.enable-idle-playlist`: Whether to enable idle playlist playback
\n– `vote-skip.enabled`: Whether to enable vote-to-skip
\n– `vote-skip.required-ratio`: Required vote ratio to skip
\n– `vote-skip.min-votes`: Minimum number of votes
\n– `debug.enabled`: Debug logging<\/p>\n
## Commands
\n– `\/musichud status`: View current playback status
\n– `\/musichud queue`: View the playback queue
\n– `\/musichud skip`: Force skip the current song (permission required)
\n– `\/musichud start`: Start the music service (permission required)
\n– `\/musichud stop`: Stop the music service (permission required)
\n– `\/musichud reload`: Reload the configuration (permission required)
\n– `\/musichud help`: Show help<\/p>\n
## Permissions
\n– `musichud.admin`: Administrative permission (default OP)
\n– `musichud.use`: Basic usage permission
\n– `musichud.queue`: Song request queue permission
\n– `musichud.skip`: Vote-to-skip permission
\n– `musichud.playlist`: Idle playlist management permission<\/p>\n
—<\/p>\n
MusicHud \u7684 Bukkit\/Spigot\/Paper \u670d\u52a1\u7aef\u63d2\u4ef6\u5b9e\u73b0\u3002<\/p>\n
### ***\u4f60\u9700\u8981\u5148\u5728\u5ba2\u6237\u7aef\u5b89\u88c5mod\u624d\u80fd\u4f7f\u7528\u8fd9\u4e2a\u63d2\u4ef6\uff01\uff01\uff01***
\n– Mod \u9879\u76ee\u94fe\u63a5\uff1a**https:\/\/github.com\/Etern-34520\/MusicHud**
\n– Modrinth: **https:\/\/modrinth.com\/mod\/music-hud**<\/p>\n
## \u529f\u80fd\u7b80\u4ecb
\n– \u4e0e\u5ba2\u6237\u7aef Mod \u901a\u8fc7 Plugin Messaging \u901a\u8baf\u5e76\u540c\u6b65\u64ad\u653e\u72b6\u6001
\n– \u652f\u6301\u70b9\u6b4c\u961f\u5217\u4e0e\u6295\u7968\u5207\u6b4c
\n– \u652f\u6301\u7a7a\u95f2\u6b4c\u5355\u64ad\u653e
\n– \u652f\u6301\u533f\u540d\/Cookie \u767b\u5f55<\/p>\n
## \u5b89\u88c5
\n1. \u5c06\u6784\u5efa\u4ea7\u7269\u653e\u5165\u670d\u52a1\u5668 `plugins\/` \u76ee\u5f55
\n2. \u542f\u52a8\u670d\u52a1\u5668\u751f\u6210\u914d\u7f6e\u6587\u4ef6
\n3. \u6309\u9700\u4fee\u6539\u914d\u7f6e\u5e76\u91cd\u542f\u6216\u6267\u884c\u91cd\u8f7d\u547d\u4ee4
\n4. \u90e8\u7f72 Netease Cloud Music API Enhanced (https:\/\/github.com\/neteasecloudmusicapienhanced\/api-enhanced)\uff0c\u8bf7\u81ea\u884c\u53c2\u8003api-enhanced\u7684readme\u8fdb\u884c\u90e8\u7f72
\n5. \u5982\u679c\u4e0d\u4f7f\u7528 NCM API Enhanced \u7684\u9ed8\u8ba4\u7aef\u53e3 ( 3000 ) \u6216\u5728\u5176\u4ed6\u670d\u52a1\u5668\u4e0a\u90e8\u7f72\uff0c\u9700\u8981\u4fee\u6539\u914d\u7f6e\u6587\u4ef6\u7684 base-url \u5c5e\u6027<\/p>\n
## \u914d\u7f6e
\n\u914d\u7f6e\u6587\u4ef6\u4f4d\u7f6e\uff1a`plugins\/MusicHud-Bukkit\/config.yml`<\/p>\n
\u5173\u952e\u914d\u7f6e\u9879\uff1a
\n– `api.base-url`\uff1a\u7f51\u6613\u4e91\u97f3\u4e50 API \u5730\u5740\uff08\u9ed8\u8ba4 `http:\/\/localhost:3000`\uff09
\n– `api.timeout`\uff1aAPI \u8bf7\u6c42\u8d85\u65f6\uff08\u6beb\u79d2\uff09
\n– `playback.interval`\uff1a\u6b4c\u66f2\u95f4\u9694\uff08\u6beb\u79d2\uff09
\n– `playback.enable-idle-playlist`\uff1a\u662f\u5426\u542f\u7528\u7a7a\u95f2\u6b4c\u5355
\n– `vote-skip.enabled`\uff1a\u662f\u5426\u542f\u7528\u6295\u7968\u5207\u6b4c
\n– `vote-skip.required-ratio`\uff1a\u6295\u7968\u5207\u6b4c\u6bd4\u4f8b
\n– `vote-skip.min-votes`\uff1a\u6700\u5c0f\u7968\u6570
\n– `debug.enabled`\uff1a\u8c03\u8bd5\u65e5\u5fd7<\/p>\n
## \u6307\u4ee4
\n– `\/musichud status`\uff1a\u67e5\u770b\u5f53\u524d\u64ad\u653e\u72b6\u6001
\n– `\/musichud queue`\uff1a\u67e5\u770b\u64ad\u653e\u961f\u5217
\n– `\/musichud skip`\uff1a\u5f3a\u5236\u8df3\u8fc7\u5f53\u524d\u97f3\u4e50\uff08\u9700\u8981\u6743\u9650\uff09
\n– `\/musichud start`\uff1a\u542f\u52a8\u97f3\u4e50\u670d\u52a1\uff08\u9700\u8981\u6743\u9650\uff09
\n– `\/musichud stop`\uff1a\u505c\u6b62\u97f3\u4e50\u670d\u52a1\uff08\u9700\u8981\u6743\u9650\uff09
\n– `\/musichud reload`\uff1a\u91cd\u8f7d\u914d\u7f6e\uff08\u9700\u8981\u6743\u9650\uff09
\n– `\/musichud help`\uff1a\u663e\u793a\u5e2e\u52a9<\/p>\n
## \u6743\u9650
\n– `musichud.admin`\uff1a\u7ba1\u7406\u6743\u9650\uff08\u9ed8\u8ba4 OP\uff09
\n– `musichud.use`\uff1a\u57fa\u7840\u4f7f\u7528\u6743\u9650
\n– `musichud.queue`\uff1a\u70b9\u6b4c\u961f\u5217\u6743\u9650
\n– `musichud.skip`\uff1a\u6295\u7968\u5207\u6b4c\u6743\u9650
\n– `musichud.playlist`\uff1a\u7a7a\u95f2\u6b4c\u5355\u7ba1\u7406\u6743\u9650<\/p>\n","protected":false},"excerpt":{"rendered":"
MusicHud Bukkit Plugin Implementation. MusicHud is a Minecraft mod allow to play music from NCM in whole server.<\/p>\n","protected":false},"featured_media":107782,"template":"","meta":{"_minecraft_slug":"musichud-bukkit","_minecraft_project_id":"yLuVYY1Z","_minecraft_author":"Shiroame_Kusu","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":16,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"musichud-bukkit.zip","_minecraft_size_bytes":2337498,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:47:50.877739Z","_minecraft_date_created":"2026-02-10T01:28:21.775214Z","_minecraft_date_modified":"2026-01-28T06:26:29.409449Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/musichud-bukkit","_minecraft_icon_attachment_id":107782,"_minecraft_imported_at":"2026-06-06T05:39:23+00:00","_minecraft_import_hash":"8c01e75c1b45a97e98b24f85ea9e5fa4","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127,128,867,129,92],"mod_loader":[132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-107842","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-utility","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n