MCPromote: Automatic Rank Promotion Plugin for Minecraft

Streamlining Rank Management with MCPromote Running a Minecraft server involves countless administrative tasks, and managing player ranks is one of the most frequent. Whether you are rewarding a loyal community member, assigning a staff role, or granting access to special perks, the process shoul...

Download MCPromote

Original name: MCPromote

FileVersionLoaderSize
MCPromote.jar——12 КБDownload

Streamlining Rank Management with MCPromote

Running a Minecraft server involves countless administrative tasks, and managing player ranks is one of the most frequent. Whether you are rewarding a loyal community member, assigning a staff role, or granting access to special perks, the process should be quick and painless. MCPromote is a lightweight, powerful plugin designed to make rank promotion effortless, even for players who have never logged into your server before. It strips away complexity, leaving you with a single command that handles everything from instant promotion to automatic queuing for offline users.

What Makes MCPromote Stand Out

Many permission plugins offer rank commands, but they often require the target player to be online. MCPromote breaks that limitation. If you promote a player who has not yet joined your world, the plugin stores the request in a file. The moment that player logs in for the first time, the promotion is applied automatically. This is a game-changer for server networks, pre-launch setups, or any scenario where you need to prepare ranks in advance. The plugin works seamlessly with any permission system that integrates with Vault, making it universally compatible across Bukkit, Spigot, and Paper servers.

Core Features at a Glance

  • Instant In-Game Promotion: Promote online players with a single command, no complicated syntax required.
  • Offline Queuing: Players who have never joined are added to a queue file and promoted automatically upon first login.
  • Vault Integration: Works with any permissions plugin that supports Vault, such as LuckPerms, PermissionsEx, or GroupManager.
  • Configurable Messages: All feedback messages sent to admins and players can be customized in the config file.
  • Console-Friendly: Every command works perfectly from the server console, ideal for automated scripts or remote management.
  • Zero Known Bugs: The plugin is stable and reliable, with a clean codebase that avoids conflicts.

Commands and Permissions

MCPromote keeps things simple with just two commands, each with a clear purpose. The primary command is /mcpromote <player> (aliased as /mcp), which instantly promotes the specified player to the rank defined in the configuration file. If the player is offline and has never joined, they are added to the queue. The second command, /mcpromotereload (aliased as /mcpr), reloads the configuration file without needing a full server restart.

Permissions are equally straightforward. Granting mcpromote.promote allows a user or group to run the promotion command, while mcpromote.reload gives access to the reload function. This clean separation ensures that only trusted staff can modify ranks or reload settings.

How the Queue System Works

When you promote a player who has never joined the server, MCPromote doesn't just discard the request. Instead, it writes the player's name and target rank to a dedicated queue file. The next time that player connects, the plugin checks the queue, applies the promotion instantly, and removes the entry. This mechanism is perfect for pre-configuring ranks on a new server or for networks where players might not have visited a specific lobby yet. The queue file is human-readable, so you can even manually add or remove entries if needed.

While setting up your server infrastructure, you might find that managing multiple plugins and configurations becomes tedious. A modern launcher like foxygame.net can simplify the client-side experience, offering a convenient way to download and organize mods directly from its menu. This flexibility lets you focus on server-side tools like MCPromote, knowing that your players have a smooth entry point.

Configuration Made Easy

The plugin's config.yml file is designed with clarity in mind. Inside, you will find detailed comments explaining every option. You can define the exact rank name to be applied upon promotion, set whether a player must already hold a specific rank before being eligible, and customize all messages sent to admins and the target player. The reload command lets you tweak these settings on the fly without disrupting gameplay.

For example, you might configure the plugin to only promote players who currently have the "Member" rank, preventing accidental promotions of higher-tier staff. Or you could set up a custom broadcast message that announces the promotion server-wide. The flexibility is there without overwhelming you with unnecessary complexity.

Dependencies and Compatibility

MCPromote has a single dependency: Vault. Vault acts as a bridge between your server and various permission, chat, and economy plugins. As long as you have Vault installed and a compatible permissions plugin, MCPromote will function flawlessly. It does not require any specific permission plugin, so you can stick with your current setup. The plugin is lightweight and does not introduce lag or performance issues, making it suitable for servers of any size.

Practical Use Cases

Imagine you are launching a new minigame hub. You want to pre-assign VIP ranks to a list of early supporters, but many of them have not yet joined the server. With MCPromote, you simply run the command for each player from the console. The plugin queues all promotions, and as soon as each supporter logs in, they receive their VIP status automatically. No manual tracking, no missed promotions.

Another scenario: a staff member needs to be promoted to moderator while they are offline. Instead of waiting for them to come online, you execute the command. If they have played before, the rank change takes effect immediately in the permissions system. If they are brand new, the promotion is queued. Either way, the process is seamless.

Community Feedback and Stability

MCPromote has a track record of reliability. The developer reports zero known bugs, and the plugin is actively maintained. Suggestions from the community are welcomed, and the comment section on its official page serves as a direct line for feature requests. This open dialogue ensures the tool evolves to meet real server administration needs.

Conclusion

MCPromote fills a specific but critical niche in Minecraft server management. It removes the friction from rank assignments, handles offline players intelligently, and integrates with any Vault-compatible permissions plugin. The straightforward commands, clear permissions, and configurable messages make it accessible to both novice and experienced admins. If you are looking for a no-fuss solution to streamline promotions and eliminate the hassle of waiting for players to come online, MCPromote is a plugin worth adding to your server toolkit.