RPG MAKER MZ Plugin: Music Media Player
A downloadable plugin
🎵 Introducing the Simple Music Player Plugin for RPG Maker MZ! 🌟
Transform your game's auditory experience with our user-friendly and dynamic music player. Designed specifically for RPG Maker MZ, this plugin offers seamless integration and a host of compelling features:
✨ Customizable Playlist - Create and manage your own song list. Add songs complete with custom names, cover images, and additional details. Tailor the playlist to fit the mood and theme of your game.
🔄 Interactive Control - Enjoy full control over your music playback. Navigate through tracks easily, adjust playback speed with PageUp/PageDown keys, and toggle loop mode with a simple Ctrl click.
🎚️ Progress Bar & Playback Rate Adjustment - Track the progress of your songs with a customizable progress bar and dynamically adjust playback speeds to match the pace of your game.
🔊 High-Quality Audio Experience - The plugin ensures high-quality audio playback, maintaining the richness and depth of your game's soundtrack.
💾 Effortless Integration & Compatibility - Designed for RPG Maker MZ, the plugin integrates smoothly without disrupting the core functionalities of your game.
👨💻 Advanced Customization - Advanced users can further customize the plugin using detailed JavaScript code, allowing for personalized adjustments and enhancements.
🔒 Try and Buy - Experience the plugin's capabilities with a free version. Upgrade to the full version to unlock its full potential and elevate your game's audio experience!
🎮 Elevate Your RPG Maker MZ Game - Whether it's an epic adventure or a serene narrative, Simple Music Player is your go-to plugin for an immersive auditory experience.
How to use?
- Downloading the Plugin:
- First, download the "Simple Music Player" plugin file.
- Placing the Plugin File:
- Place the downloaded plugin file into the
/js/plugins
folder within your RPG Maker MZ project directory.
- Place the downloaded plugin file into the
- Managing Music and Cover Images:
- Store your music files (preferably in .mp3 or .ogg format) in :
/media/player
in your project directory. - Cover images for each song are specified in the plugin's parameters and should be placed in the
Pictures
folder within your project's directory.
- Store your music files (preferably in .mp3 or .ogg format) in :
- Activating the Plugin:
- Open your RPG Maker MZ project.
- Navigate to the
Plugin Manager
- Add "Simple Music Player" to your project's active plugins.
- Configuring the Plugin:
- In the Plugin Manager, configure the settings of "Simple Music Player".
- Adjust parameters as needed.
- In the
SongList
parameter, input details of the songs in JSON format, includingfileName
,customName
,coverImage
(the name of the image file in yourPictures
folder),detail1
, etc.
- Using the Plugin in Your Game:
- Implement the music player in your game using Plugin Commands.
- The command
OpenMusicPlayer
can be used to open the music player interface. - Players will have the ability to browse the song list, select tracks, and control playback, including loop and speed adjustments.
Note:
- Compression and Encryption: RPG Maker MZ typically compresses and encrypts audio files in its original audio folder. This is done to protect the game's assets and reduce file sizes. However, this compression and encryption process alters the format of the audio files, making them incompatible with many custom plugins.
- Playback Issues with Custom Plugins: The "Simple Music Player" plugin, like many others, is designed to work with standard audio file formats (such as .mp3 or .ogg). When RPG Maker MZ compresses and encrypts these files, it changes their structure, which prevent the plugin from properly reading and playing back these files.
- Alternative File Storage: To avoid these playback issues, it's mandatory to store your audio files for the "Simple Music Player" in a separate folder, in this case,
/media/player
. This ensures the files remain in their original, unaltered state, allowing the plugin to access and play them without any compatibility issues. - Maintaining File Integrity: By keeping your audio files in a standard, uncompressed format in a dedicated folder, you maintain the integrity and quality of the audio, which is essential for ensuring the best possible experience for players of your RPG Maker MZ game.
- Custom Plugin Compatibility: Storing audio files outside the original audio folder of RPG Maker MZ is not just a workaround but a recommended practice for better compatibility with custom plugins. This method ensures that your audio files are readily accessible and playable by the plugin.
Check the video for more information:
Feature | Demo Version | Full Version |
---|---|---|
Music Playback | Yes | Yes |
Loop Function | Yes | Yes |
Playback Speed Function | Yes | Yes |
Plugin Interface | Very Simple and Basic | Optimized and Refined |
Customization | No | Yes |
Conditional Songs Function | No | Yes |
Encrypted Code | Yes | No |
Updated | 2 days ago |
Status | Released |
Author | Undermax |
Tags | Controller, Music, music-player-rpg-maker, plugin, RPG Maker, rpg-maker-media, rpg-maker-mz-plugin, spotify |
Purchase
In order to download this plugin you must purchase it at or above the minimum price of $5.24 USD. You will get access to the following files:
Download demo
Development log
- Small Update: v1.1.32 days ago
- Small Update: v1.1.23 days ago
- Update: v1.1.113 days ago
- Update: v1.1.069 days ago
- Small Update - v1.0.1Mar 04, 2024
Comments
Log in with itch.io to leave a comment.
Thanks for the great plugin, I'm having a little trouble with the detail zones, they appear for a split second before disappearing. I've put a video to demonstrate.
Also, is it possible to remove the default background if you're using a picture background?
Hi my friend, I’m glad you like the plugin and I’m sorry you’re experiencing issues.
I appreciate the video, it really helps me better understand the issue we’re dealing with.
Interesting... In my workspace, I didn’t detect that problem, but while I ask you a few things:
I won’t ask if you’re using the latest version, because I assume you are, since the Background feature is something included in the most recent version. What I understand is that you want the background image to be fully visible, removing the window borders.
While this can be achieved by changing the "Scene Window Type" value to Transparent in the plugin, I understand that the result might not be as expected due to how RPG Maker handles child windows and so on. I’d need to modify a few things, but I can try to fix it in the next update and see if we can find something that works better. Does that sound good?
As for the second issue with the text, I can see it in your video, although it’s strange since it doesn’t happen to me and works fine on my end... I’m not sure if it’s a device speed issue or something else... I’ll try to find a way to fix it, but these are the most complex problems for me to solve since, without experiencing them myself, I can’t know whether the fix works or not.
I ask if you can give me a few days to investigate the issue and see if I can improve the plugin so you don’t have these problems. I’m currently working with many plugins and my schedule is a bit tight unfortunately, but I’ll try to find a solution.
When there’s an update to the plugin, if you’re following me on Itch.io you’ll receive an email of itch.io about the feed and I’ll create a devpost, so you can keep track of the status there :)
Sounds good! Thank you so much for the reply!
Just updating, I think I've found the issue. My game's resolution is 680x480, when i turned it up to for example 680x800, it worked. I think my game's height was too small. And thanks for telling me about the scene window type paramater, totally missed that ! But yeah It'd be really nice if you could find something so the child windows don't look strange haha
Oh, great, thank you for clearing that up for me. I generally recommend that games use 1280 x 720 resolution, as it's a great resolution for games and allows for better visualization and more room without being too large.
Anyway, don't worry. I'll try to polish the UI a bit more as soon as I have some free time. ^^
Hi my friend, try the new v1.1.2 it should work better now :)
really appreciate you taking the time to fix this ! I do still have some issues with the detail zones... The reason my game's resolution is so low is artistical and trying to emulate older indie games, and I don't really plan on changing it. Would it be hard to add a plugin parameter to change the size of the fonts for the title of the song, and detail zones? That way I could make them smaller and it should work. I understand if you need time or if this isn't your priority but I thought I'd ask :)
Hey buddy, sorry to hear it's still not working properly for you...
Have you tried resetting the plugin? (Deleting it, saving the RPG Maker MZ editor, and reinstalling the plugin?)
Because I tested it with the resolution you mentioned, 640x480, and it's displaying fine for me:
If you'd be so kind as to share your graphic settings and the resolution you have set in RPG Maker MZ—both the Screen Width Size and the UI Area Width/Size—that would be ideal so I can replicate it on my end.
And if you can tell me which texts you want to make smaller or larger, even better—I can give you a quicker and more direct solution that way.
If you want to attach photos or a video, that will also help me understand it better. Thanks a lot!
Would it be possible to make it so that the playback volume scales with the game's BGM volume setting? Currently, players of my game are turning down the game volume and then getting blasted by extremely loud audio from this plugin, with no way to adjust it in-game.
Hello! Sure, try this new version if it works for you :)
https://undermax.itch.io/mediaplayer/devlog/871714/update-v110
Awesome, thanks!
♥️
Would it be possible to add an option to mask songs that haven't been discovered/unlocked? So they would display as ???? or something and can't be played? I know currently they can just be hidden but I'd like to have the option for masking as well.
Hello, sorry for the delay in my response; I've been a bit busy.
It might be possible, yes. But I’ll need a few days since I'm working on something else, and it’s taking up a lot of my time. If I manage to do it, I'll update you, don't worry. Just give me a few days to free myself up. :)
Best regards
Hi,
thank you for adding this via switches. :)
Hi!
Would it still be possible to still get this feature sometime? I'm just looking for a little more consistency across my game's UI, so masking titles and allowing the player to be able to see what can still be found would be good.
Hello, my friend! Yes, of course!
I apologize for the delay in doing it. As you know, I have a ton of plugins, and I'm doing my best to maintain them properly in my free time. That feature completely slipped my mind, and I forgot to implement it in the last update of this plugin.
I have now released version 1.1.1, which should allow you to do what you want, and I’ve also added some extra features. I hope everything works well for you! Best regards, and sorry for any inconvenience caused 🙏🏻
No worries.
Thank you so much for adding it, it works perfectly!
🥳 I'm very happy to hear it!
Hi there, one of my players just had this crash. It happened by clicking the OK button repeatedly too fast when opening the player scene. Hopefully it can be fixed. Thanks!

Hello. I tried pressing the button quickly to call the scene, and I haven’t been able to replicate the error at any point. Additionally, I would need more detailed information about the issue (an F12 with error details would also help). It would also be helpful to know when it happened or if other plugins are involved. Unfortunately, I can’t solve the issue with such limited information, especially if I can’t replicate it. I’ll be standing by in case you can expand further on the issue details.
Hello, I was wondering if there was a way to have the plugin continue to play the music when you exit it? Like walking around, listening to the music freely
Or does it already to that?
Thank you
Hello! Well, currently the plugin only plays the music while you are inside the player scene. It does not support background playback. Implement that functionality It would require a relatively high modification of the plugin as many additional situations would have to be considered. I hope I have answered your question! A big greeting.
do you think its possible to implement that as a feature in a future update?
I recommend you use this plugin, maybe it will help you:
https://undermax.itch.io/radio-system
There is a major bug in this plugin - if you unlock tracks (with their switches) in an order outside of the order they are listed in the plugin parameters (ie unlocking track 1 and then track 3 without track 2 first), the songs wont play until you also unlock the other tracks listed before them. I'll try sending an email with a demo project file with this bug. Atm, it is making the plugin unusable for my game.
Hello! I'm sorry to hear that you are having problems with the plugin.
I'll check that out as soon as possible :)
I will create a new answer in this thread as soon as I have an answer to give you.
All the best!
I have released an update to the plugin, hopefully that solves the problem, I made the modification directly from your demo to make sure it works, but just in case I want you to try it yourself.
I have deleted the link you attached. Remember not to expose the projects publicly since they contain paid content and anyone could access them.
All the best!
Awesome, thanks! it is working perfectly now.
🩵
Easy to use and does exactly what I need it to do, I am using it to put in a few friends music tracks and being able to have the album cover art is a nice touch
I'm glad you like it! All the best! 💪🏻