🥇 Elo

On this page, you will learn what Elo is and explore all of its options.

#Elo System

Elo is a system used to calculate the relative skill levels of players in competitive games, where ratings are adjusted based on match outcomes. Every player holds a separate rating per mode, so being strong at one mode says nothing about their rating in another.

Only Ranked matches change a rating. Unranked and custom matches never do.

#elo.yml

The elo settings live in their own file, elo.yml, in the PhoenixDuels folder. The options sit at the top level of that file, with nothing wrapping them.

k-factor: 32
min-rating: 0
max-rating: 3500
default-rating: 500
tolerance: 200

They are also editable in the editor, under Settings > Elo Settings.

k-factor (32) - Determines how much a rating moves after each match. A higher K-factor means larger swings, so ratings settle faster but are noisier.
min-rating (0) - The lowest rating a player can fall to.
max-rating (3500) - The highest rating a player can climb to.
default-rating (500) - The rating a player starts on, in every mode, before they have played it.
tolerance (200) - The ranked matchmaking window. See below.

#Tolerance

Tolerance is not a margin of error on a rating. It is how far apart two sides in the ranked queue may be before the plugin refuses to pair them.

When someone queues for Ranked, the plugin looks at everyone else waiting for the same mode and player type, and only considers those whose average rating is within tolerance of theirs. With the default of 200, a player rated 500 can be matched against anyone between 300 and 700, and nobody outside that band.

On a small or quiet server this is the setting that stops ranked queues from popping. Two players can sit in the queue indefinitely if their ratings are more than tolerance apart. Raising it widens the net at the cost of less even matches.

#Global Elo

%phoenixduels_ranked_global_elo% is a single number summarising a player across every mode, and it is the average of their per-mode ratings, not a sum and not a rating of its own.

The average is taken across every mode that allows a ranked player type. Modes the player has never touched still count, at default-rating, which pulls the average toward the default. A player rated 900 in the only mode they play, on a server with four ranked modes, has a global elo of 600 rather than 900.

#Managing Ratings

Ratings can be adjusted from the console or in game:

/pduels setRating <player> <mode> <amount>
/pduels addRating <player> <mode> <amount>
/pduels removeRating <player> <mode> <amount>
/pduels resetRating <player> <mode> <amount>
/pduels reset <player> - resets every mode at once.

#Ranked Requirements

You can keep newer players out of Ranked until they have won a number of Unranked games. See Main Configuration.

#Ranks

To turn ratings into visible tiers such as Bronze or Diamond, install the Elo Ranks add-on.

Last updated 1 day ago