Clean some code, add README
This commit is contained in:
parent
200cf73248
commit
447ad25c8a
101
README.md
Normal file
101
README.md
Normal file
@ -0,0 +1,101 @@
|
|||||||
|
# skyrim-cell-dump
|
||||||
|
|
||||||
|
Library and binary for parsing Skyrim plugin files and extracing CELL data.
|
||||||
|
|
||||||
|
The main objective of this library is to extract the form ID and X and Y coordinates of every exterior cell a plugin edits as fast as possible, ignoring the rest of the plugin.
|
||||||
|
|
||||||
|
## Install
|
||||||
|
|
||||||
|
```
|
||||||
|
cargo install skyrim_cell_dump
|
||||||
|
```
|
||||||
|
|
||||||
|
Or, build yourself by checking out the repository and running:
|
||||||
|
|
||||||
|
```
|
||||||
|
cargo build --release --features build-binary
|
||||||
|
```
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
```
|
||||||
|
Usage: skyrim-cell-dump.exe <plugin> [-f <format>] [-p]
|
||||||
|
|
||||||
|
Extracts cell edits from a TES5 Skyrim plugin file
|
||||||
|
|
||||||
|
Options:
|
||||||
|
-f, --format format of the output (json or text)
|
||||||
|
-p, --pretty pretty print json output
|
||||||
|
--help display usage information
|
||||||
|
```
|
||||||
|
|
||||||
|
The pretty JSON format looks something like:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"header": {
|
||||||
|
"version": 1.0,
|
||||||
|
"num_records_and_groups": 792,
|
||||||
|
"next_object_id": 221145,
|
||||||
|
"author": "Critterman",
|
||||||
|
"description": "An example plugin",
|
||||||
|
"masters": [
|
||||||
|
"Skyrim.esm",
|
||||||
|
"Update.esm",
|
||||||
|
"Dawnguard.esm",
|
||||||
|
"HearthFires.esm",
|
||||||
|
"Dragonborn.esm"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"cells": [
|
||||||
|
{
|
||||||
|
"form_id": 100000001,
|
||||||
|
"editor_id": "SomeInterior",
|
||||||
|
"x": null,
|
||||||
|
"y": null,
|
||||||
|
"is_persistent": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"form_id": 3444,
|
||||||
|
"editor_id": null,
|
||||||
|
"x": 0,
|
||||||
|
"y": 0,
|
||||||
|
"is_persistent": true
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"form_id": 46432,
|
||||||
|
"editor_id": "SomeExterior01",
|
||||||
|
"x": 32,
|
||||||
|
"y": 3,
|
||||||
|
"is_persistent": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"form_id": 46464,
|
||||||
|
"editor_id": "SomeExterior02",
|
||||||
|
"x": 33,
|
||||||
|
"y": 2,
|
||||||
|
"is_persistent": false
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"form_id": 46498,
|
||||||
|
"editor_id": null,
|
||||||
|
"x": 32,
|
||||||
|
"y": 1,
|
||||||
|
"is_persistent": false
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Import
|
||||||
|
|
||||||
|
You can include this crate in your `Cargo.toml` and get the parsed `Plugin` struct with:
|
||||||
|
|
||||||
|
```rust
|
||||||
|
use skyrim_cell_dump::parse_plugin;
|
||||||
|
|
||||||
|
fn main() {
|
||||||
|
let plugin_contents = std::fs::read("Plugin.esp").unwrap();
|
||||||
|
let plugin = parse_plugin(&plugin_contents).unwrap();
|
||||||
|
}
|
||||||
|
```
|
@ -17,10 +17,7 @@ impl FromStr for Format {
|
|||||||
fn from_str(s: &str) -> Result<Self> {
|
fn from_str(s: &str) -> Result<Self> {
|
||||||
match s.trim().to_lowercase().as_str() {
|
match s.trim().to_lowercase().as_str() {
|
||||||
"json" => Ok(Format::Json),
|
"json" => Ok(Format::Json),
|
||||||
"text" => Ok(Format::PlainText),
|
"text" | "plain" | "plain_text" | "plaintext" => Ok(Format::PlainText),
|
||||||
"plain" => Ok(Format::PlainText),
|
|
||||||
"plain_text" => Ok(Format::PlainText),
|
|
||||||
"plaintext" => Ok(Format::PlainText),
|
|
||||||
_ => Err(anyhow!("Unrecognized format {}", s)),
|
_ => Err(anyhow!("Unrecognized format {}", s)),
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
@ -364,7 +364,6 @@ fn parse_field_header(input: &[u8]) -> IResult<&[u8], FieldHeader> {
|
|||||||
todo!()
|
todo!()
|
||||||
}
|
}
|
||||||
let (input, size) = le_u16(input)?;
|
let (input, size) = le_u16(input)?;
|
||||||
// let (input, data) = take(size)(input)?;
|
|
||||||
Ok((input, FieldHeader { field_type, size }))
|
Ok((input, FieldHeader { field_type, size }))
|
||||||
}
|
}
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user