slippi-js - GitLite

KO | EN

gitlite — search

#react #android #machine-learning #rust #linux #docker #macos #nodejs #windows #awesome #cli #vue #ios #mcp

slippi-js

(★ 166)

Parse slp files and compute stats

파일 탐색기

최종 버전 다운로드 (.zip)

- - build.yml
  - publish.yml
  - test.yml
- launch.json
- settings.json
- - esbuild.config.mjs
  - index.html
  - package.json
  - README.md
- - package.json
  - README.md
  - realtimeFileReads.js
- README.md
- package.json
- - BowsVDK-SB-63.slp
  - DKVBows-nB.slp
  - FalcVBows-5UB-67.slp
  - GanonVDK-5UB-73.slp
  - KirbyVDK-Neutral-17.slp
  - KirbyVMario-nB.slp
  - MewTwoVDK-SB-42.slp
  - NessVFox-Absorb.slp
  - PichuVSelf-All-22.slp
  - Puff-MagnifyingGlass-10.slp
  - PuffVFalcon-Sing.slp
  - YoshiVDK-Egg-13.slp
- - ffa_1p2p3p_winner_3p.slp
  - ffa_1p2p4p_winner_4p.slp
  - ffa_1p2p_winner_2p.slp
  - incorrect-winner-timeout.slp
  - same-frame-death.slp
  - teams_p1p2_blueVSp4_green_winner_green.slp
  - teams_time_p3_redVSp1p2_blueVSp4_green_winner_blue.slp
- actionEdgeCases.slp
- BTTDK.slp
- controllerFixes.slp
- displayNameAndConnectCodeInGameStart.slp
- doubles.slp
- edge-cancel-1.slp
- edge-cancel-2.slp
- facingDirection.slp
- finalizedFrame.slp
- FodPlatforms.slp
- geckoCodes.slp
- gnwActions.slp
- homeRun_jp.slp
- homeRun_positive.slp
- incomplete.slp
- itemExport.slp
- japanese-names.slp
- lCancel.slp
- nametags.slp
- nametags2.slp
- nametags3.slp
- ntsc.slp
- pal.slp
- peachFsmash.slp
- pummel.slp
- ranked_game1_tiebreak.slp
- realtimeTest.slp
- rollbackFrameTest.slp
- sheik_vs_ics_yoshis.slp
- stadiumTransformations.slp
- techTester.slp
- test.slp
- throwGrab.slp
- unranked_game1.slp
- unranked_game2.slp
- wavedash-1.slp
- wavedash-2.slp
- wavedash-3.slp
- waveland-1.slp
- waveland-2.slp
- Whispy.slp
- - index.ts
  - SlippiGameWeb.ts
- - index.ts
  - SlippiGameBase.ts
  - types.ts
- - index.ts
  - SlippiGameNode.ts
- declarations.d.ts
- conversion.test.ts
- doubles.test.ts
- filewriter.test.ts
- game.test.ts
- homeRun.test.ts
- items.test.ts
- melee.test.ts
- placings.test.ts
- realtime.test.ts
- slpReader.test.ts
- stages.test.ts
- stats.test.ts
- targets.test.ts
.editorconfig
.eslintrc.js
.gitattributes
.gitignore
.npmignore
.npmrc
.prettierrc.js
jest.config.js
LICENSE
package-lock.json
package.json
README.md
rollup.config.mjs
tsconfig.json

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# `slippi-js`

[![npm version](http://img.shields.io/npm/v/@slippi/slippi-js.svg?style=flat)](https://npmjs.org/package/@slippi/slippi-js "View this project on npm")
[![Build Status](https://github.com/project-slippi/slippi-js/actions/workflows/build.yml/badge.svg?branch=master)](https://github.com/project-slippi/slippi-js/actions/workflows/build.yml?query=branch%3Amaster)
[![Coverage Status](https://coveralls.io/repos/github/project-slippi/slippi-js/badge.svg)](https://coveralls.io/github/project-slippi/slippi-js)
[![License](https://img.shields.io/npm/l/@slippi/slippi-js)](https://github.com/project-slippi/slippi-js/blob/master/LICENSE)

This is the official Project Slippi Javascript SDK. It provides tools for parsing `.slp` files 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.

## Installation

**With NPM**

```bash
npm install @slippi/slippi-js
```

**With Yarn**

```bash
yarn add @slippi/slippi-js
```

## Browser vs Node.js

This library provides two separate entry points depending on your environment:

### Default Export: `@slippi/slippi-js` (Browser/Web)

The default export is optimized for browser and web environments. It only accepts binary data as input (buffers, ArrayBuffers, Uint8Arrays, etc.) and **cannot read files from disk**.

```js
import { SlippiGame } from "@slippi/slippi-js";

// Works with binary data
const arrayBuffer = await fetch("game.slp").then((r) => r.arrayBuffer());
const game = new SlippiGame(arrayBuffer);

// Will throw an error in the browser
const game = new SlippiGame("path/to/file.slp"); // ❌ Error!
```

> **💡 See the [browser-stream example](./examples/browser-stream/)** for a demo of real-time replay file stream processing in the browser.

### Node.js Export: `@slippi/slippi-js/node`

The Node.js export is designed for server-side and Node.js environments. It includes everything that is in the web export, but can also read files directly from disk using file paths **and** also accepts binary data. It also includes Node.js-specific features like console connections, and SLP file writing.

```js
const { SlippiGame } = require("@slippi/slippi-js/node");
// or with ES modules:
// import { SlippiGame } from "@slippi/slippi-js/node";

// Works with file paths
const game = new SlippiGame("path/to/file.slp"); // ✅

// Also works with binary data
const buffer = fs.readFileSync("path/to/file.slp");
const game = new SlippiGame(buffer); // ✅
```

**Additional Node.js-only exports:**

- Console and Dolphin connection utilities for real-time game capture
- `SlpFileWriter` for creating `.slp` files

**Rule of thumb:** Use `@slippi/slippi-js/node` for Node.js applications and scripts. Use the default `@slippi/slippi-js` for browser/web applications.

> **💡 See the [realtime-file-reads example](./examples/realtime-file-reads/)** for a Node.js script that monitors live games using file system watching.

## Quick Start

### Writing a Simple Script

1. Create a fresh directory on your disk
2. Inside this new directory, create a file called `script.js`
3. Fill the `script.js` file with the following contents:

```js
const { SlippiGame } = require("@slippi/slippi-js/node");

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
```

4. Copy a .slp file into the directory and call it `test.slp`
5. Browse to the directory from the command line and run the command: `npm install @slippi/slippi-js`. This should create a `node_modules` directory in the folder.
6. Run the command: `node script.js`. This will run the script above and will print data about the `test.slp` file

> **💡 Tip:** See the [examples](./examples/) directory for more advanced usage including live file monitoring and browser-based replay processing.

## Examples

The library supports processing replay files in real-time as they're being written. This is useful for live overlays, game monitoring, and analysis tools.

### 🌐 [Browser Stream Example](./examples/browser-stream/)

Demonstrates processing replay files in a web browser with simulated streaming using the low-level `SlpStream` and `SlpParser` APIs. Perfect for understanding how to handle chunked data in browser environments.

**Features:** Interactive web UI, configurable chunk sizes, real-time event log, progress tracking

### 📂 [Realtime File Reads Example](./examples/realtime-file-reads/)

Demonstrates monitoring a directory for live `.slp` file changes and processing them as they're written using the high-level `SlippiGame` API in Node.js.

**Features:** File system watching, live game state (stocks/damage), incremental updates, game end detection

### Reading Live Files

When reading files that are actively being written (e.g., during a live game), use the `processOnTheFly` option:

```javascript
const { SlippiGame } = require("@slippi/slippi-js/node");

const game = new SlippiGame("path/to/live/file.slp", { processOnTheFly: true });
```

This allows the `SlippiGame` instance to read partial files and be re-read as new data becomes available. See the [realtime-file-reads example](./examples/realtime-file-reads/) for a complete implementation with file watching.

## Development

### Setup

```bash
git clone https://github.com/project-slippi/slippi-js
cd slippi-js
npm install
```

### Build

```bash
npm run build
```

You can also run `npm run watch` to continuously build whenever changes are detected.

### Test

```bash
npm run test
```