score-based-elo

Score-based Elo system

Score-based Elo is a rating system similar to classical Elo used in different sports like chess or go, but this calculates ratings by the players' score proportion.

Installation

In the console:

npm install --save score-based-elo

In node.js:

const elo = require('score-based-elo');

Usage

• First of all you need to import the package as seen above.

• Create a new Elo system with the EloSystem constructor, with the k factor as an argument:

let eloSystem = new elo(32); //argument is the k factor

k factor can vary depending on the game, in chess is commonly set to 32. More info about Elo system and k factor in this link.

EloSystem class

• Method eloSystem.getNewElo(player1, player2) Receives two objects representing the players that are competing. player object must have two properties:
• Number player.score, representing the game score obtained.
• Number player.rating, the current Elo rating.

Return the new player1 rating.

• Method eloSystem.setKFactor(number) Reset Elo K factor, a common value is 32. Always returns undefined.

Example

const elo = require('score-based-elo');
 
let eloSystem = new elo(32); // k factor
 
let player1 = {
        score: 800,
        rating: 2000
    },
    player2 = {
        score: 500,
        rating: 2200
    }
;
 
player1.rating = eloSystem.getNewElo(player1, player2);
 
// now player1 rating is 2012.0042093450425