README
slp-parser-js
This is the official .slp file parsing library. It parses a .slp file into structured data and can be used to compute stats. There are already many built-in stats that are computed by the library but the data provided can also be used to compute your own stats.
Quick-Start
Requirements
Installation
npm install slp-parser-js
Writing a simple script
- Create a fresh directory on your disk
- Inside this new directory, create a file called
script.js
- Fill the
script.js
file with the following contents:
const { default: SlippiGame } = require('slp-parser-js');
const game = new SlippiGame("test.slp");
// Get game settings – stage, characters, etc
const settings = game.getSettings();
console.log(settings);
// Get metadata - start time, platform played on, etc
const metadata = game.getMetadata();
console.log(metadata);
// Get computed stats - openings / kill, conversions, etc
const stats = game.getStats();
console.log(stats);
// Get frames – animation state, inputs, etc
// This is used to compute your own stats or get more frame-specific info (advanced)
const frames = game.getFrames();
console.log(frames[0].players); // Print frame when timer starts counting down
- Copy a .slp file into the directory and call it
test.slp
- Browse to the directory from the command line and run the command:
npm install slp-parser-js
. This should create anode_modules
directory in the folder. - Run the command:
node script.js
. This will run the script above and will print data about thetest.slp
file
Reading live files
When using Slippi to mirror gameplay, it can be useful to extract game data about the live game. There are a few different methods of doing this but slp-parser-js
can also be used to read live files. It is written in such a way where as long as the same SlippiGame class is used, it will only read from disk the data it has not yet read.
An example script for how to do this is provided as part of this repo here: https://github.com/project-slippi/slp-parser-js/blob/master/scripts/realtimeFileReads.js
To use the above script, do the following:
- Open a terminal prompt in the folder containing the script file and the package.json file
- Run
yarn
to fetch the dependencies - Run
node realtimeFileReads.js "C:\mirror\output\path"
replacing the path argument with where your connected console outputs replay files to
At this point, you should see an output as you play games on the connected console.
Notice about stats
While it is possible to load the stats in a real-time fashion, the stat calculation logic has not yet been optimized to work only on the latest data. Because of this, the longer the game goes, the longer stat calculation will take. As long as you don't call game.getStats()
you do not have to worry about this.
Development
Setup
git clone https://github.com/project-slippi/slp-parser-js
cd slp-parser-js
yarn install
Build
yarn run build
You can also run yarn run watch
to continuously build whenever changes are detected.
Test
yarn run test