Choose a Version

NeteaseMiniPlayer v3 maintains two product lines in the same open-source repository. NMPv3 handles lightweight embedding. NMPv3+ handles advanced extension scenarios.

Recommendation

Scenario	Version	Notes
Embed a NetEase player in a public page, blog, CMS, or static site	NMPv3	One JavaScript file is enough
Render the base player in React, Vue3, Nuxt, Astro, or Svelte	NMPv3	Use the native <nmp-player> element
Use local JSON, lyric files, plugins, skins, or host sync	NMPv3+	These features belong to the advanced framework
Add a basic WordPress shortcode	NMPv3	Frontend only loads nmpv3.min.js
Build a WordPress admin, Gutenberg block, or resource package	NMPv3+	This is advanced integration

NMPv3 boundary

NMPv3 is designed to stay embeddable, publishable, and easy to migrate:

• Browser usage only needs nmpv3.min.js
• No required CSS file
• No runtime dependency on React, Vue, Lit, or jQuery
• NetEase Cloud Music and compatible API proxies only
• v2.5-style base UI, shortcodes, and legacy DOM migration

NMPv3 supports attributes, global config, and CSS variables. It does not include plugins, full skin packages, custom music sources, or HostBridge.

NMPv3+ boundary

NMPv3+ is for integrations that need extension points:

• Plugins
• Skins
• Custom music sources
• Custom lyrics
• Host page integration
• Framework adapters
• Advanced WordPress and PHP integration
• CLI custom builds

NMPv3+ starts from the base NMPv3 player surface. Its value is a clear extension framework, not a heavier default UI.