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!'