AdvancedRanking

AdvancedRanking Plugin

!logo Overview: AdvancedRanking is a comprehensive Minecraft plugin that provides a detailed player ranking system based on configurable ratings. Players can rate each other, and the ratings are stored in a database for persistence. The plugin includes a GUI for easy interaction and supports PlaceholderAPI for dynamic placeholders.

Features:

• Player Ratings:

  • Players can increase or decrease each other’s ratings using a GUI.
  • Ratings are stored in a SQLite database for persistence.
  • Configurable cooldown period to prevent rating abuse.

• Graphical User Interface (GUI):

  • Interactive GUI for players to manage and view ratings.
  • Customizable using resource packs for unique visuals.

!Without resourcepack

!With resourcepack

• Commands:

  • /ranking: Displays the player's ranking.
  • /profile: Shows the player's profile with their rating.
  • /setrank: Allows setting a player's rank directly (admin command).

• PlaceholderAPI Integration:

  • Provides placeholders for player ratings and other related data.

• Logging:

  • Logs plugin activities and errors for debugging and auditing purposes.

Installation:

1. Download the AdvancedRanking plugin.
2. Place the downloaded file into your server's plugins directory.
3. Start or restart your server to load the plugin.
4. Configure the plugin as needed in the generated config.yml file.

Configuration:

• The config.yml file allows server administrators to configure settings such as database connection, cooldown periods, and GUI options.

Usage:

• Players can use the provided commands to interact with the ranking system.
• The GUI can be accessed to view and change player ratings.
• Admins can manage player rankings and configure plugin settings as required.

Commands:

• /ranking: Opens the ranking menu.
• /profile: Displays the profile of a player.
• /setrank <player> <rank>: Sets the rank of a specified player (admin command).
• /cancelcleanup: Cancels the upcoming item cleanup if the player has the necessary permission (advancedclear.cancel).

Placeholders:

• %advancedranking_rating%: Displays the player's rating.
• %advancedranking_last_change%: Displays the last time a player's rating was changed.

Support:

• For any issues or suggestions, please visit the plugin's support page or repository.

Metrics:

• This plugin uses bStats to collect anonymous usage statistics to help improve the plugin.

Example Config (config.yml):

# AdvancedRanking configuration
cooldown_minutes: 1440
use_resourcepack: false

buttons:
  increase: "Increase Rating"
  decrease: "Decrease Rating"

messages:
  en:
    rank_message: "Your current rank is: "
    change_success: "You have successfully changed the rating."
  ru:
    rank_message: "Ваш текущий ранг: "
    change_success: "Вы успешно изменили рейтинг."

Class Breakdown

AdvancedRanking Class

This is the main plugin class responsible for:

• Enabling and disabling the plugin.
• Managing database connections and operations.
• Copying necessary resources.
• Registering commands and event listeners.

RankingCommand Class

Handles the /ranking command which opens the ranking menu for the player.

ProfileCommand Class

Handles the /profile command which displays the player's profile with their current rating.

SetRankCommand Class

Handles the /setrank command allowing administrators to set a player's rank directly.

RankingGUI Class

Handles the GUI operations for the ranking system, including creating and displaying the inventory with player heads and buttons for increasing/decreasing ratings.

RankingPlaceholder Class

Integrates with PlaceholderAPI to provide placeholders related to the ranking system.

Note: Ensure you have the required dependencies like PlaceholderAPI and bStats in your server's plugin folder for full functionality.