net10.0
Core library for parsing YSM Minecraft player model files. Supports V1 (AES-CBC+zlib), V2 (JavaRandom key derivation), and V3 (XChaCha20+MT19937+zstd).
Published
Jun 6, 2026
4mo ago
Total Downloads
962
962
Install
dotnet add package YSMParser.Core --version 1.0.3
| Product | Versions |
|---|---|
| .NET |
README
YSMParser.Net
A pure .NET parser for .ysm model files — a encrypted binary format used for Minecraft player models.
Quick Start
dotnet build
dotnet run --project CLI -- -i ./input -o ./output
- SDK: .NET 10.0.300 (see
global.json) - Test:
dotnet test(xunit v3)
CLI Usage
YSMParser -i <input> -o <output> [options]
YSMParser -i <input> -n [--info]
| Flag | Description |
|---|---|
-i, --input <dir> |
Input directory (required). |
-o, --output <dir> |
Output directory. |
-n, --info |
Print model details without extracting. |
-v, --verbose |
Verbose logging. |
-d, --debug |
Export all raw binary products (V3 only). |
-f, --format |
Pretty-print JSON output. |
-j, --threads <n> |
Parallel worker count (default 1). |
--version |
Print version and exit. |
-h, --help |
Show help. |
Supported Formats
- V1 — AES-CBC + zlib
- V2 — AES-CBC + JavaRandom key derivation + zlib
- V3 — XChaCha20 (dynamic rounds) + MT19937 XOR + zstd, with structured output layout
Acknowlegements
Project Structure
| Project | Purpose |
|---|---|
Core/ |
Parsing, crypto, binary reading, JSON generation. |
CLI/ |
Console entrypoint, file discovery, batch processing. |
Export/ |
Standalone GLB/glTF exporter from Bedrock geometry JSON. |
Tests/ |
Unit tests for crypto and utilities. |
Changes from Previous Version
No structural changes between v1.0.2 and v1.0.3.
Adoption Assessment
Assess this package against its supported frameworks, license, maintenance signals and dependency graph before making it a project standard.
Compatibility metadata lists 1 target framework; confirm the exact target used by your application.
Related Guides & Workflows
Learn how to evaluate, integrate, or audit this package in your .NET project.