A downloadable plugin

Get this plugin and 4 more for $19.99 USD
View bundle
Buy Now$6.99 USD or more



🎵 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?
  1. Downloading the Plugin:
    • First, download the "Simple Music Player" plugin file.
  2. Placing the Plugin File:
    • Place the downloaded plugin file into the /js/plugins folder within your RPG Maker MZ project directory.
  3. 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.
  4. Activating the Plugin:
    • Open your RPG Maker MZ project.
    • Navigate to the Plugin Manager
    • Add "Simple Music Player" to your project's active plugins.
  5. 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, including fileName, customName, coverImage (the name of the image file in your Pictures folder), detail1, etc.
  6. 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:

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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 NoYes
Encrypted Code Yes No




Purchase

Get this plugin and 4 more for $19.99 USD
View bundle
Buy Now$6.99 USD or more

In order to download this plugin you must purchase it at or above the minimum price of $6.99 USD. You will get access to the following files:

SimpleMusicPlayer.zip 12 kB

Download demo

Download
SimpleMusicPlayerDEMO.js 79 kB

Development log

Comments

Log in with itch.io to leave a comment.

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 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.

(+1)

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!

(+1)

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! 💪🏻