Bbtools-flver To Sdm- ((top))
Converting FromSoftware FLVER files to SMD for editing involves unpacking game assets and utilizing specialized conversion tools like BBTools, which drag-and-drop converts the model into an importable format. Alternatively, modern Blender plugins allow for direct FLVER file importing, simplifying the workflow and enabling direct mesh and armature manipulation. For a comprehensive guide on this process, visit this YouTube video AI responses may include mistakes. Learn more Souls Modding Basics: Flver to SMD and troubleshooting
2. Definitions and Architecture
6) Storage and serialization
- Prefer JSON Lines (one JSON object per record) for streaming; optionally support compressed NDJSON (.jsonl.gz).
- Example JSON record:
"id":"read123",
"sequence":"ACGTN",
"quality":[40,40,40,40,30],
"attributes":"cigar":"76M","mapq":60,
"provenance":"sample":"libA","source_file":"in.flver",
"metrics":"length":5,"gc_percent":40
Example command (representative)
bbtools-flver2sdm --input sample.flv --min-coverage 5 --min-quality 20 --output sample.sdm --format tsv
4) Metadata and provenance
- Include a header block: conversion.timestamp (ISO 8601), converter.version, source.file, source.format.
- Preserve and rename source metadata keys into provenance and original_fields sections.
- Example header:
- conversion.timestamp: "2026-03-23T00:00:00Z"
- converter.version: "Bbtools-flver→Sdm v1.0"
Step 2: Analyze FLVER Structure
Launch FLVER Editor, open the .flver file. Note: Bbtools-flver To Sdm-
- Number of meshes
- Bone list (names + indices)
- Shader/material assignments
- Vertex count
This metadata will help map to SDM.
1) Scope and goals
- Goal: convert or map data produced by "Bbtools-flver" into the target "Sdm-" representation while preserving semantics and key metadata.
- Input assumptions: source contains sequence/read data, metadata, and per-record annotations (typical of BBTools outputs or a FLVER-like file).
- Output assumptions: SDM is a compact structured data model with fields for ID, payload, quality/score, and optional annotations.
FLVER (FromSoftware Model Format)
- Versions: FLVER0 (Dark Souls 1), FLVER1 (Dark Souls 2), FLVER2 (Dark Souls 3/Bloodborne), FLVER3 (Sekiro), FLVER4 (Elden Ring)
- Contents: Vertex buffers (positions, normals, UVs, bone weights), index buffers, material definitions (GX .mcb or .matbin), and skeleton (bone hierarchy).
- Tools to extract: Yabber, UXM, WitchyBND, SoulsFormats.