luxannas-spellbook

About

[!CAUTION] The library is currently WIP.

An ALPHA version of the library calculating League of Legends spells and items properties.

The library is designed to resolve variables that may be found across League of Legends localization entries from both Data Dragon and Community Dragon (e.g. wdamage in <physicalDamage>{{ wdamage }} physical damage</physicalDamage>)

Basic usage

const context = await playerContext({championName: "Zyra"})
context.setLevel(3)

const passive = context.getPassiveSpell()

console.log(passive)

returns

[
  { name: 'SeedCooldown', value: 13, formula: '14 - 9 @level@' },
  {
    name: 'PlantDamage',
    value: 24,
    formula: '16 - 84 @level@ + 18% @total@ @abilityPower@'
  },
  {
    name: 'monstermod',
    value: 64.70588235294117,
    formula: '60 - 100 @level@'
  },
  { name: '{c951f1e1}', value: 48, formula: '50 - 33 @level@' }
]

Configuration

playerContext needs to be configured with an object:

Name	Required	Type	Description	Default
championName	yes	string	Any valid League champion name
source		DataSource	Champion data source. Available values: DataSource.Web, DataSource.Local	DataSource.Web
customUri		string	An URI used to locate a champion data. A path to the actual data is being resolved as ${customUri}/${championName}/${championName}.bin.json	""

Default URI

DataSource.Local: src/test-data/champions/${championName}/${championName}.bin.json DataSource.Web: a Community Dragon server

Known issues

• the lib does not calculate buff-dependent properties yet since there is no officially supported interface to obtain the buff status from the game;
• it is yet needed to test the lib against Akali Q, Zyra passive, TF Q;
• it is yet needed to test the percent missing health spells calculation behavior.

Roadmap

1. Fix current issues and implement minor features (e.g. percentage view and precision settings);
2. Implement item properties calculation;
3. Implement rune properties calculation;
4. TBD.

See also

• an official Riot Games Developer Portal
• a default data source Community Dragon
• a basic guide Resolving spells and variables in spell texts
• a similar lib written in C# by OsOmE1