Struct KeyMapping 

pub struct KeyMapping {
    pub version: String,
    /* private fields */
}

Bidirectional key mapping for NMS save file deobfuscation.

Maps obfuscated 3-character keys (e.g., "F2P") to readable names (e.g., "Version").

Fields

version: String

Version string from the primary mapping file.

Implementations

impl KeyMapping

pub fn bundled() -> Self

Load the bundled (compiled-in) mapping.

Merges all three mapping sources:

• mapping_mbincompiler.json (primary)
• mapping_legacy.json (older keys)
• mapping_savewizard.json (name fixups)

pub fn from_json(json: &str) -> Result<Self, SaveError>

Load a mapping from a JSON string (single mapping file).

pub fn from_file(path: &Path) -> Result<Self, SaveError>

Load a mapping from a file on disk.

pub fn get(&self, obfuscated: &str) -> Option<&str>

Look up the readable name for an obfuscated key.

pub fn len(&self) -> usize

Return the number of mapping entries.

pub fn is_empty(&self) -> bool

Return whether the mapping is empty.

pub fn deobfuscate(&self, value: &mut Value)

Deobfuscate all keys in a serde_json::Value tree in place.

Walks the tree recursively. For each JSON object, replaces obfuscated keys with their readable equivalents. Unknown keys are preserved as-is. After key replacement, applies any fixups (e.g., case corrections).

Trait Implementations

impl Clone for KeyMapping

fn clone(&self) -> KeyMapping

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for KeyMapping

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.