KillRanks icon

KillRanks -----

A plugin for customizing player rankings based on fighting skills



With KillRanks, you have the ability to customize how players are ranked based on their fighting skills. If your server is all about PVP battles, this plugin is perfect for adding more excitement to the game. You can adjust the ranking system in a way that suits your server and creates a more competitive atmosphere.
[​IMG]
SUPPORT
For support with this plugin, please visit my discord server.

CONFIGURATION
Code (Text):

# PLACEHOLDERS
# {player}: The name of the player being tracked.
# {victim}: The name of the player who was killed.
# {killer}: The name of the player who killed {victim}.
# {rank}: {player}'s current rank.
# {new_rank}: {player}'s next rank.
# {points}: The number of points {player} has.
# {killstreak}: The number of consecutive kills {player} has achieved without dying.
# {tag}: {player}'s rank tag.
# ACTIONS
# [message|msg] <message>: Sends <message> to {player}.
# [chat] <message>: Sends <message> to the chat as {player}.
# [console] <command>: Executes <command> as the console.
# [command|cmd] <command>: Runs <command> as {player}.
# [op|operator] <command>: Executes <command> as {player} in operator mode.
# [broadcast|bc] <message>: Broadcasts <message>.
# [(add|remove|set)-points]: Modifies the number of points {player} currently holds.
# Any kill that happens in a disabled world will be ignored by KillRanks.
Worlds:
  Enabled: ['world', 'nether']
  Disabled: 'world2'
PlaceholderAPI:
  # This enables PlaceholderAPI functionality.
  Enabled: false
  # This sets the identifier for the PlaceholderAPI expansion.
  Identifier: 'krs'
# The automatic save period for plugin data in ticks (20 ticks per second).
# To convert seconds to ticks, multiply the number of seconds by 20 (<seconds> * 20).
# To convert minutes to ticks, multiply the number of minutes by 60 (the number of seconds in a minute) and then by 20 (<minutes> * 1200).
# To convert hours to ticks, multiply the number of hours by 60 (the number of minutes in an hour), by 60 (the number of seconds in a minute) and then by 20 (<hours> * 72000).
AutoSavePeriod: 12000 # 12000 ticks = 10 minutes
# The minimum number of points a player can have.
PointsFloor: 0
# Determines whether KillRanks should execute any action when a player's point count change due to executing the 'killranks (add|remove|set)-points' command.
PointCountActionsOnCommand: false
# Determines whether KillRanks should execute any action when a player's killstreak is changed due to executing the 'killranks set-killstreak' command.
KillStreakActionsOnCommand: false
Leaderboard:
  # For additional details, visit: https://mc-rankings.com/
  # To find the leaderboard URL, simply execute the command /KillRanks McRankings
  McRankings: false
  # The maximum number of players to display on the leaderboard.
  Length: 10
  # This prevents the leaderboard from updating for 2000 milliseconds (2 seconds).
  UpdatePeriod: 2000
  Format: '&f{pos}. {tag} {player}&7: &b{points} &7points'
KillStreaks:
  1:  
    Identifier: '&a5-10&6, &b15&6, &c>20:3'
   
    # The range of consecutive kills that will trigger this killstreak.
    # The value is a string that can include multiple ranges, separated by commas.
    # Each range can be a single number, or a range of numbers separated by a hyphen.
    # A range of "<10" means that any streak with less than 10 kills will count, while a range of ">20" means that any streak with more than 20 kills will count.
    Range: '5-10, 15, >20:3'
    # A list of actions to execute when the killstreak is triggered.
    Actions:
      - '[command] give {killer} diamond 1'
      - '&aYou have reached a killstreak of {killstreak}!'
      - '[broadcast] &3{player} &ahas reached a killstreak of {killstreak}!'
      # A list of actions to execute when the killstreak is broken.
    BreakActions:
      - '[command] give {killer} diamond 5'
      - '&aYou have broken a killstreak of {killstreak}!'
      - '[broadcast] &3{player} &bhas broken a killstreak of {killstreak}!'
Assist:
  # The maximum number of players allowed to assist.
  Limit: 1
  # An assist is only awarded if it occurs within the following time (in milliseconds) after the last damage.
  TimeLimit: 10000
  # A list of actions to execute when {player} assists in killing {victim}.
  Actions:
    - '&aYou got an assist on killing {victim}.'
# If player X kills player Y a total of <KillCount> times within a time span of <Period> milliseconds, any associated award with killing player Y will not be received for a duration of <PenaltyTime> milliseconds.
AntiAbuse:
  KillCount: 5
  Period: 10000
  PenaltyTime: 20000
# If set to 'true', players will lose a kill on death and can be demoted to a lower rank if they fall below the required kill count range.
# If set to 'false', players' rank will not be affected by their deaths.
RankDown: true
# This text will replace the 'rank' placeholders if a player has not achieved any rank yet.
NoRankText: '&4N/A'
# This text will replace the 'tag' placeholders if a player does not have any tag.
NoTagText: '&4N/A'
# Rank definitions
Ranks:
  '&7Silver':
    # The tag to use for players with this rank.
    # The tags can also be accessed in other plugins via PlaceholderAPI, using the placeholder %krs_tag%.
    Tag: '&8[{rank}&8]&7'
    # The number of points a player must acquire to reach this rank.
    # These points determine a player's performance and are a key factor in their promotion or demotion.
    Points: 20
    # A list of commands to run when a player achieves this rank.
    Commands:
      - 'money give {killer} 100'
      - 'money take {victim} 100'
    # The message to broadcast when a player achieves this rank.
    Broadcast: '&3{killer} &ahas achieved {new_rank} &arank after killing &3{victim}&a.'
    RankDown:
      # A list of actions to run when a player is demoted to this rank due to death.
      Actions:
        - '[console] money take {victim} 50'
        - '&cYou''ve been demoted to the {new_rank} &crank, &3{victim}&c!'
        - '&7Your point count fell below the required range for {rank} &7rank: &b{points}'
        - '[broadcast] &3{victim} &chas been demoted to {new_rank} &crank after falling below the required point count.'
  '&1Supreme':
    # The tag to use for players with this rank.
    Tag: '&8[{rank}&8]&1'
    # The number of points a player must acquire to reach this rank.
    # These points determine a player's performance and are a key factor in their promotion or demotion.
    Points: 200
    # A list of commands to run when a player achieves this rank.
    Commands:
      - 'money give {killer} 1000'
    # The messages to display when a player achieves this rank.
    Messages:
      - '&7Congratulations on achieving the {new_rank} &7rank, &3{killer}&7!'
      - 'You''ve proven your skills in battle and earned this honor.'
      - 'Keep up the good work and aim for even greater heights!'
 

PLACEHOLDERAPI EXPANSION
  • %krs_points%: the current number of points a player has.
  • %krs_rank%: the current rank of a player.
  • %krs_next%: the next rank a player will achieve.
  • %krs_prev%: the previous rank.
  • %krs_rp%: the number of points a player has in their current rank.
  • %krs_nrp%: the number of points a player needs to achieve the next rank.
  • %krs_tag%: the rank tag associated with the player's current rank.
  • %krs_ks%: the current killstreak of a player.
  • %krs_ksi%: the identifier of the killstreak.
  • %krs_top<i>%: the username of the player who is currently ranked at the index <i> in the Points Leaderboard. For example, %krs_top9% would display the username of the player ranked in 10th position.
  • %krs_top<i>_points%: the number of points the player ranked at index <i> has.
  • %krs_kstop<i>%: the username of the player who is currently ranked at the index <i> in the KillStreak Leaderboard.
  • %krs_kstop<i>_streak%: the current kill streak of the player ranked at index <i>.
  • %krs_pb%: player's highest points.
COMMANDS
  • /KillRanks info <player> - Provides information about the player.
  • /KillRanks set-points <amount> <player> - Modifies the amount of points held by the specified player.
  • /KillRanks set-killstreak <amount> <player> - Modifies the killstreak of the specified player.
  • /KillRanks top - Displays a leaderboard of players based on their current point count.
  • /KillRanks mcrankings - Displays the URL of the Web Leaderboard.
  • /KillRanks reload - Reloads this plugin.
  • /KillRanks reset - Resets the Database (CONSOLE).
PERMISSIONS
  • killranks.set-points - Permission to change the amount of points a player has.
  • killranks.set-killstreak - Permission to change the killstreak of a player.
  • killranks.mcrankings - Permission to execute /KillRanks McRankings.
Resource Information
Author:
----------
Total Downloads: 784
First Release: Mar 30, 2023
Last Update: Aug 18, 2023
Category: ---------------
All-Time Rating:
3 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings