MCServerFinder Minecraft Plugin

The official Minecraft Plugin for MCServerFinder Platform
Report issue • Request feature

What is MCServerFinder?

MCServerFinder.com is a modern platform for discovering Minecraft servers, launched in April 2025. It features curated server listings across categories like PvP, Creative, Adventure, Minigames, and more. With real-time stats, community feedback, and trending picks, MCServerFinder makes it easy for players to find their next favorite server.

Supported Platforms

This plugin supports various platforms, current supported ones are:

• Bukkit/Spigot/Paper and other Bukkit-based forks: through the module mcsf-plugin-bukkit
• Velocity: through the module mcsf-plugin-velocity
• BungeeCord: through the module mcsf-plugin-bungeecord

Installation

1. Get your MCServerFinder API key from the Settings page.
2. Get your Server ID from Edit Server page.
3. Download the plugin you want to include in your platform from the Releases page.
4. Drop the plugin in your plugins/ directory.
5. Start your server to generate the configuration file.
6. Turn off your server and go to your plugin config.yml (located in plugins/mcsf-plugin/ for velocity, and plugins/MCSFPlugin/ for other platforms) put the API key there:

   settings:
      apiKey: "put-your-api-key-here"
      serverId: 0 # Your Server ID here

7. Done! the plugin is ready-to-go.

Leaderboards

Configuring leaderboards is easy and simple, it can be done with fewer steps:

1. Configure your leaderboards from your Edit Server page.
2. In plugin configuration, you can configure the leaderboard:

   leaderboardSettings:
       enabled: true # You can toggle leaderboards functionality
       updateInterval: 2 # What should be the period between each push in minutes
       leaderboards:
       - id: 'player_kills' # Leaderboard name in MCServerFinder Server panel
         placeholder: '%player_kills%' # PlaceholderAPI placeholder which will be used to retrieve stats for leaderboard

Just like that, you have successfully configured leaderboards 🎉!

Contributions

We welcome community contributions through pull requests!

Licensing

This project is licensed under MIT License, you can read it at LICENSE file