{"id":99497,"date":"2026-06-05T20:12:52","date_gmt":"2026-06-05T17:12:52","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/mclista-plugin\/"},"modified":"2026-06-05T20:12:52","modified_gmt":"2026-06-05T17:12:52","slug":"mclista-plugin","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/mclista-plugin\/","title":{"rendered":"MclistaPlugin"},"content":{"rendered":"<p align=\"center\">\n  <img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/i.imgur.com\/ngXnPK7.png\" width=\"500\" height=\"400\">\n<\/p>\n<p>![Release](https:\/\/github.com\/kerpsondev\/mclista-plugin\/releases)<\/p>\n<p>Official plugin created for mclista.pl website.<br \/>\n<br \/>\nSimple configuration, very fast and reliable.<br \/>\n<\/p>\n<p>## \u2699\ufe0f Requirements <\/p>\n<p>&#8211; Paper engine (1.8 &#8211; 1.21.8)<br \/>\n&#8211; Server on website mclista.pl<br \/>\n&#8211; OPTIONAL: Database mysql\/mariadb\/mongodb<\/p>\n<p>## \ud83d\udc9b API module<\/p>\n<p>Api may add to project maven\/gradle<br \/>\n<br \/>\nCurrently supported platforms:<br \/>\n&#8211; bukkit<br \/>\n&#8211; velocity (in feature)<\/p>\n<p>### Maven<\/p>\n<p>&#8220;`xml<br \/>\n<repositories><br \/>\n  <repository><br \/>\n    <id>mclista-repository-releases<\/id><br \/>\n    <name>Repozytorium McLista<\/name><br \/>\n    <url>https:\/\/repository.mclista.pl\/releases<\/url><br \/>\n  <\/repository><br \/>\n<\/repositories><\/p>\n<p><dependencies><br \/>\n  <dependency><br \/>\n    <groupId>pl.mclista<\/groupId><br \/>\n    <artifactId>mclista-{platform}-api<\/artifactId><br \/>\n    <version>1.1.0-beta2<\/version><br \/>\n  <\/dependency><br \/>\n<\/dependencies><br \/>\n&#8220;`<\/p>\n<p>### Gradle<br \/>\n&#8220;`gradle<br \/>\nmaven {<br \/>\n    name = &#8220;mclistaRepositoryReleases&#8221;<br \/>\n    url = uri(&#8220;https:\/\/repository.mclista.pl\/releases&#8221;)<br \/>\n}<\/p>\n<p>implementation(&#8220;pl.mclista:mclista-{platform}-api:1.1.0-beta2&#8221;)<br \/>\n&#8220;`<br \/>\n<\/p>\n<p>## \ud83e\udd16 API usage<\/p>\n<p>In first order i recommend get class DeveloperService by registry.<br \/>\n<br \/>\nExample for bukkit api:<\/p>\n<p>&#8220;`java<br \/>\nRegisteredServiceProvider<DeveloperService> provider = Bukkit.getServicesManager().getRegistration(DeveloperService.class);<br \/>\nif (provider != null) {<br \/>\n  DeveloperService developerService = provider.getProvider();<br \/>\n}<br \/>\n&#8220;`<\/p>\n<p>DeveloperService returns two objects, UserService and RewardApiClient.<br \/>\n<br \/>\nEvery action that returns object will return DeveloperService:<br \/>\n&#8220;`java<br \/>\n  @NotNull RESULT getResult();<\/p>\n<p>  @Nullable Optional<Throwable> getThrowable();<br \/>\n&#8220;`<\/p>\n<p>### Event handling<\/p>\n<p>Plugin currently has 2 events:<br \/>\n&#8211; PostRewardReceiveEvent (Event calling after receive reward)<br \/>\n&#8211; PreRewardReceiveEvent (Event calling beforce receive reward, is cancellable)<\/p>\n<p>Event for every module has prefix {platform}, e.g.:<br \/>\nBukkitPreRewardReceiveEvent.<br \/>\n<\/p>\n<p>### UserService<\/p>\n<p>Class UserService allows to operate on users, include offline users.<br \/>\n<br \/>\nIt gives you complete freedom in managing users.<\/p>\n<p>&#8220;`java<br \/>\n  void addUser(@NotNull User user);<\/p>\n<p>  void removeUser(@NotNull UUID uuid);<\/p>\n<p>  Optional<User> getUser(@NotNull UUID uuid);<\/p>\n<p>  @NotNull CompletableFuture<DeveloperAction<User>> loadUser(@NotNull UUID uuid);<\/p>\n<p>  @NotNull CompletableFuture<DeveloperAction<User>> modifyUser(@NotNull UUID uuid, @NotNull Consumer<User> userConsumer);<\/p>\n<p>  @NotNull CompletableFuture<DeveloperAction<Boolean>> saveUser(@NotNull User user);<\/p>\n<p>  @NotNull Set<User> getUsers();<\/p>\n<p>  @NotNull CompletableFuture<DeveloperAction<Set<User>>> loadUsers();<br \/>\n&#8220;`<\/p>\n<p>### RewardApiClient<\/p>\n<p>This object allows you to send a query to the API and receive a response indicating whether the player has voted on the list on our server or not.<br \/>\n<br \/>\nTo check whether the user has received a reward today, you need to compare the delay with the current time from the [User](#userservice) object.<br \/>\n<br \/>\nAlternatively, you can also set your own delay\u2014the choice is yours!<\/p>\n<p>### \ud83d\udc9b Project status<br \/>\n![Alt](https:\/\/repobeats.axiom.co\/api\/embed\/70650ca5fb9b12b8f5921304cf89af4fc8861c42.svg &#8220;Repobeats analytics image&#8221;)<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Official plugin Minecraft server list mclista.pl<\/p>\n","protected":false},"featured_media":99498,"template":"","meta":{"_minecraft_slug":"mclista-plugin","_minecraft_project_id":"kNqmYxKh","_minecraft_author":"kerpsondev","_minecraft_license":"MIT","_minecraft_downloads":106,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"mclista-plugin.zip","_minecraft_size_bytes":25170468,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-15T19:38:01.236482Z","_minecraft_date_created":"2025-08-19T20:17:49.108338Z","_minecraft_date_modified":"2026-02-23T16:45:17.693675Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/mclista-plugin","_minecraft_icon_attachment_id":99498,"_minecraft_imported_at":"2026-06-05T17:12:53+00:00","_minecraft_import_hash":"c8de61ec465d4dfa08a4ad8f3343cad5","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,867],"mod_loader":[130],"minecraft_version":[41,81,30,31],"class_list":["post-99497","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-social","mod_loader-bukkit","minecraft_version-1-21-11","minecraft_version-1-21-8","minecraft_version-1-8-8","minecraft_version-1-8-9"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.6 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>MclistaPlugin - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/mclista-plugin\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"MclistaPlugin - Minecraft\" \/>\n<meta property=\"og:description\" content=\"Official plugin Minecraft server list mclista.pl\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/mclista-plugin\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta property=\"og:image\" content=\"https:\/\/i.imgur.com\/ngXnPK7.png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/mclista-plugin\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/mclista-plugin\\\/\",\"name\":\"MclistaPlugin - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/mclista-plugin\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/mclista-plugin\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/mclista-plugin-icon-08007a5d12259be745bf687a4ab09755e6484004_96.webp\",\"datePublished\":\"2026-06-05T17:12:52+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/mclista-plugin\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/mclista-plugin\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/mclista-plugin\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/mclista-plugin-icon-08007a5d12259be745bf687a4ab09755e6484004_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/mclista-plugin-icon-08007a5d12259be745bf687a4ab09755e6484004_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/mclista-plugin\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"MclistaPlugin\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"MclistaPlugin - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/mclista-plugin\/","og_locale":"en_US","og_type":"article","og_title":"MclistaPlugin - Minecraft","og_description":"Official plugin Minecraft server list mclista.pl","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/mclista-plugin\/","og_site_name":"Minecraft","og_image":[{"url":"https:\/\/i.imgur.com\/ngXnPK7.png","type":"","width":"","height":""}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/mclista-plugin\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/mclista-plugin\/","name":"MclistaPlugin - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/mclista-plugin\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/mclista-plugin\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/mclista-plugin-icon-08007a5d12259be745bf687a4ab09755e6484004_96.webp","datePublished":"2026-06-05T17:12:52+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/mclista-plugin\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/mclista-plugin\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/mclista-plugin\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/mclista-plugin-icon-08007a5d12259be745bf687a4ab09755e6484004_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/mclista-plugin-icon-08007a5d12259be745bf687a4ab09755e6484004_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/mclista-plugin\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"MclistaPlugin"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/99497","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/99498"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=99497"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=99497"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=99497"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=99497"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}