Zasubskrybuj, aby pobrać
WinterDream Achievements Plugin v1.3

Please support me on Ko-Fi[ko-fi.com] for more!
Other plugins on my Itch[winterdreamgamescreator.itch.io] store!

This plugin allows you to add Achievements to your game. Those Achievements will be stored in a JSON and will be shared among all plays and savegames of your project

Be sure to have installed the .js file in the js/plugins folder of your project and the .JSON file in the data folder of your project.

If at any time you want to wipe your achievements data, just open the JSON and write []



PRO TIP: As the Achievments changes are PERMANENT it's useful to keep a hidden event in that adds all the achievements, once you are ready to distribute your game you can whipe and re-add the achievements to reset them.

This plugin comes with the following features:

• Pictures or Icons: You can use pictures (48x48 px) or RMMZ icons for your achievements
  
• AutoGray Feature (only pictures): If you use pictures and you enable Autogray, the plugin will turn pictures to grayscale if the achievement is locked
  
• Fulfillments: You can add up to 3 fulfillments per Achievement and you can decide how every each of them is displayed (text, gauge or combination of both). If ALL active fulfillments are met, the plugin will auto-unlock the achievement
  
• Hidden achievements: You can set Achievements to "Hidden", they will use a standard format and will hide fulfillments and rewards in the menu
  
• PopUp Window: You can choose to show a popUp message when the achievement is unlocked, it can also play a Sound Effect when popping. PopUp window have a built in queque and will display multiple unlocked achievements one by one
  
• JSON Auto-Encryption: The plugin offer the option to soft encrypt the JSON file, it's nothing a programmer can't decrypt but it should stop average users from just changing "false" with "true" in the isDone field

CALLING THE PLUGIN FROM EXTERNAL SOURCES:
The achievement completion can be also called from outside the plugin, for example you could call it from the Title Screen if you want to create a "Start the game" achievement! To do so, just write the script call: window.WD_Interplugin_Achievements.complete(id);
Where "id" is the ID of the achievement!
Please make sure the database is ready and plugins are loaded before the external script call commence.

Terms of use

Please refer to the Terms of Use[drive.google.com]. By using this plugin you accept WinterDream terms

Version, bugs and further development


VERSION 1.0:

• Initial Release

VERSION 1.1:

• Hotfix for a problem reported by Rizky Fauzy Ananda. The save/load feature of the JSON would crash on web distribution. Added a check to control if the game is played on a local machine and added a new save/load method by key foraging in the event the game is a web distribution. Thanks to Aerosys and caethyril for the help with this fix!

VERSION 1.2:

• Added two Quality of Life plugin commands: Re-Hide an achievement (useful if you manually de-hidden an achievement) and Reset all Achievements to Not Done, you can simply hit this command to undo all achievements, hopefully this will speed up the pre-distribution process of your project

VERSION 1.2.1:

• Fixed a minor bug in the data load that shouldn't have caused any issues anyway
  
• Removed a couple of dead variables that were implemented but never used

VERSION 1.3:

• Fixed pictures misplacements if using a different Screen vs UI resolution
  
• Investigated the possible issue of teleporting to another map while popping the achievement complete window, no issues have been recorded
  
• Investigated the possible issue of changing scene (menu, save, game over, title screen) while achievement windows is popping. No fatal error, but it would be better to avoid such simultaneous events or the pop window might be lost
  
• Investigated the possible issue about giving out rewards while not in the game. The game will IGNORE all the rewards, there is no way to recover them. That said, popping an achievement outside the game need the special external script call to be doable. So shame on you if you pop a rewarding achievement outside the game!
  
• Added a script call to run the "Complete Achievement" command outside the plugin (see instructions in the description). Be sure to have the database and plugins ready before doing so.

You can find more scripts and games on my Ko-Fi page:
https://ko-fi.com/winterdream
and on my Itch.io page:
https://winterdreamgamescreator.itch.io/