/MapRatingSystem

Because feedback is important.

Primary LanguageJavaOtherNOASSERTION

MapRatingSystem main build status develop build status

Because feedback is important.

discontinued due to personal reasons!

MapRatingSystem is a lightweight, inventory based feedback (rating) system for minecraft maps.

Features

  • allow your users to rate your maps
  • view user feedback on maps in an inventory (/maprating)
  • Multilingual console messages (languages currently available: English, German)
  • Each player may choose a suitable language via /language, otherwise the language will be picked automatically
  • No need to install anything by yourself - MapRatingSystem does everything for you (except for MapRatingSystem itself ¬‿¬ )!
  • Powerful API for Java Developers
  • Continuous development with many planned features
  • 24/7-Support at our Discord-Server

Requirements

  1. Java 16
  2. Spigot 1.17.1 (PaperMC recommended)
  3. Access to the server console (for the automated setup)
  4. Access to a database (MongoDB, MariaDB (MySQL), SQLite)

Installation

  1. Make sure your server is stopped, or will be restarted. Do not reload your server!
  2. Download the latest version of CoreAPI & MapRatingSystem from GitHub Releases
  3. Move the downloaded jar-file to the plugins-folder
  4. Start (or restart) your server
  5. Go through the installation process (setup) in your console by answering the prompted questions with commands (commands represent the data, may be infinitely long)

Development

//Docs: https://docs.dementisimus.dev/development/MapRatingSystem/1.3.0/
MapRating mapRating = new CustomMapRating();

//optional
mapRating.setMapRatingItemMaterial(Material.DIAMOND);
mapRating.setMapRatingItemSlot(8);

//gives the rate map item to a player
mapRating.setRateMapItem(player);

//disables the rate map item on player join
mapRating.doNotSetRateMapItemOnPlayerJoin();
@EventHandler
public void on(PlayerRateMapEvent event) {
    //Docs at https://docs.dementisimus.dev/development/MapRatingSystem/1.3.0/dev/dementisimus/mrs/api/events/PlayerRateMapEvent.html
        
    //to disable the default messages & sounds of the event
    event.setCancelled(true);
}

Images


Special thanks to

  • @TearingBooch482 for helping me stress-testing every new version of my plugins

License

» Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International Public License

find us on

Happy map rating!