ELO & Ranks

How ELO calculations function, details on the 34-tier rank progression tree, and rank customization guides.

How ELO Matchmaking Works

The ELO system measures a player's relative skill level. All players start at 1000 ELO. Following a matchmaking duel:

• Winner: Receives ELO based on a base gain formula and bonus points for kills.
• Loser: Loses ELO based on a base loss formula, adjusted by the loss multiplier of their current rank.

ELO cannot drop below 0. FFA kills/deaths do not affect ELO ratings.

Default Ranks Database

If not customized inside the configuration files, the plugin loads these 34 default ranks defined in the source code:

Customizing Ranks

Define custom ranks inside config.yml under the elo.ranks section. The plugin orders ranks based on their minimum ELO thresholds:

yamlelo:
  enabled: true
  base-gain: 25
  base-loss: 20
  kill-bonus: 5
  minimum: 0

  ranks:
    iron:
      name: "Iron"
      colored: "&7[Iron]"
      min-elo: 0
      max-elo: 499
      loss-multiplier: 0.5
    gold:
      name: "Gold"
      colored: "&6[Gold]"
      min-elo: 500
      max-elo: 999
      loss-multiplier: 1.0
    diamond:
      name: "Diamond"
      colored: "&b[Diamond]"
      min-elo: 1000
      max-elo: 9999
      loss-multiplier: 1.5

The colored property supports Kyori MiniMessage components.

Tracked Player Statistics

The plugin tracks various player stats, accessible via /stats or PlaceholderAPI: