Symbol Art Parser

English | 日本語

TypeScript implementation for parsing and serializing PSO2: NGS Symbol Art files (.sar).

This library focuses on SAR file parsing and serialization. It does not include rendering or drawing logic.

Demo

• https://logue.dev/symbol-art-parser/

Installation

pnpm add symbol-art-parser

Usage

import SymbolArt from "symbol-art-parser";

const sar = new SymbolArt();

const reader = new FileReader();
reader.onload = () => {
  sar.data = reader.result as ArrayBuffer;
};
reader.readAsArrayBuffer("[*.sar file]");

const json = sar.json;
sar.json = json;
const data = sar.data;

Data model

The library exposes the following JSON structures:

• src/types/SymbolArtData.ts
• src/types/Layer.ts
• schema.json

Development

pnpm install
pnpm run build
pnpm run test
pnpm run lint

The project uses:

• Rslib for the library build
• Rsbuild for the demo site
• Rstest for tests
• Biome and Rslint for linting

Reference

• saredit - The processing referred to this program.
• PSO2NGSのシンボルアートをパースするライブラリ「Symbol Art Parser」の技術仕様書

License

MIT

© 2022-2026 By Logue.

All rights to the copyrighted works (images, data, audios, texts, etc.) used in "PSO2: NGS" are owned by SEGA Corporation or its licensors.