BBB NMS Save File Manipulator — Help

Inventory Processing → Node View → Inventory Sorter → Source Inventories

Source Inventories

Check actual inventories from which matching whole slot records may be moved. This is the legacy Sorter roster, not the Organizer roster; do not assume it has Organizer’s empty-slot and invalid-record exclusions.

Before using Source Inventories, read the shared safety limitations for this page.

Before using Source Inventories, read the shared safety limitations for this page.

Inventory Processing → Node View → Inventory Sorter → Target Inventories

Target Inventories

Check receiving inventories. Each target has its own category dropdown. Existing contents remain but positions are compacted first; the sorter resets each processed target to a 120-cell grid. Identical source/target inventories are skipped.

Before using Target Inventories, read the shared safety limitations for this page.

Before using Target Inventories, read the shared safety limitations for this page.

Inventory Processing → Node View → Inventory Sorter → Categories

Categories

Select one or more saved InventoryType categories for each target; names alone do not determine routing. The dropdown displays comma-separated selected labels and is not a free-text field.

Inventory Processing → Node View → Inventory Sorter → Use All Unselected Storage Containers For Overflow

Use All Unselected Storage Containers For Overflow

Checked initially. The current implementation scans backward from Storage Container 10 and adds unchecked targets until it meets the first checked container, then stops. Do not assume the label guarantees that every unchecked container is used. Added overflow targets accept all six categories.

Before using Use All Unselected Storage Containers For Overflow, read the shared safety limitations for this page.

Inventory Processing → Node View → Inventory Sorter → Execute Sort

Execute Sort

Runs immediately against app-model data; there is no Review/Apply stage. Saves sorter choices and normally reports Inventory has been sorted! before closing. Source/target/category choices must be meaningful. The legacy caller can still show its completion notice after an internal validation warning, so inspect the actual result rather than relying only on that notice. File saving remains separate.

Before using Execute Sort, read the shared safety limitations for this page.

Inventory Processing → Node View → Inventory Sorter → Cancel

Cancel

Closes without executing the sort.

Inventory Processing → Node View → Inventory Organizer → Gather from these sources

Gather from these sources

Choose inventories whose whole saved slot/stack records may be gathered. Parts means records, not individual quantity units: the organizer does not split/merge stacks or change amounts. Available rows follow the loaded inventory roster: Exosuit, Container 1–10, Freighter, Fish Platform, Fish Bait Box, Cooking Ingredients, then starships. Names come from loaded data; missing names use No name provided. The organizer omits identifiable empty ship slots and invalid inventory entries.

Inventory Processing → Node View → Inventory Organizer → One destination per category

One destination per category

Choose one receiving inventory for each category; multiple categories may share a destination. Routes use the saved InventoryType. Defaults route the six categories to Containers 1–6 when available; preferences override them.

Inventory Processing → Node View → Inventory Organizer → Optional

Optional

Two independent settings control overflow and destination expansion.

Inventory Processing → Node View → Inventory Organizer → Review Summary

Review Summary

Read-only proposal display. Before review it shows current source/category routes without move counts. After review it summarizes the proposal; the current renderer may omit overflow-only or retained-only rows, so absence of a row is not a complete inventory audit.

Inventory Processing → Node View → Inventory Organizer → Review Moves

Review Moves

Creates a private proposal without publishing inventory changes. Disabled when no sources are selected and expansion is off. Requires synchronized Raw JSON in every tab and valid loaded context. Any source, route or option change invalidates this review.

Before using Review Moves, read the shared safety limitations for this page.

Inventory Processing → Node View → Inventory Organizer → Apply to app data

Apply to app data

Enabled only after review proposes a change. Applies the exact candidate, refreshes app views, marks modified data and closes. Rejects changed source identity or data since review. This is not File Save.

Before using Apply to app data, read the shared safety limitations for this page.

Inventory Processing → Node View → Inventory Organizer → Close

Close

Closes without applying inventory changes; Escape/window-close have the same cancellation boundary. Preferences still persist, including choices changed without applying.

Inventory Processing → Node View → Inventory tree → Right-button drag selection → Delete N Nodes

Right-button drag selection → Delete N Nodes

The shared right-button range-selection handler can expose Delete N Nodes even on this tab, although its ordinary right-click menu has no Delete Node item. Confirmation removes the selected structure through the generic handler. This is structural deletion, not the category-based Organizer; do not use it casually on inventory fields.

Before using Right-button drag selection → Delete N Nodes, read the shared safety limitations for this page.

This generic tree-to-model path also reaches the defective inventory set_json branch; it is not a reliable supported inventory-edit workflow. Prefer the documented Organizer/replacement controls and inspect actual model data before saving.

Inventory Processing → Divider between Node View and Raw JSON

Node View / Raw JSON pane divider

Inventory Processing sets Node View/Raw JSON stretch weights to 5:7; it does not explicitly set equal initial sizes.

Drag the vertical handle of the horizontal QSplitter between the two pane containers to change their widths. This changes layout only: Raw JSON text, shared model values and disk save data remain unchanged. It is not record drag/drop, node movement, synchronization or Pretty Print.

Inventory Processing → Node View → Right-click menu → Backup this Inventory

Backup this Inventory

Writes the selected inventory’s Node View JSON to a chosen *.nms_inventory.json file. Its Name supplies the proposed filename, or default if unnamed. This exports one inventory record, not the whole save.

Inventory Processing → Node View → Right-click menu → Replace Items from Backup

Replace Items from Backup

Opens Replace Inventory Contents and reads a selected *.nms_inventory.json file. Replaces only the selected inventory’s Slots from the backup, not its whole record. If its ValidSlotIndices has fewer than 120 entries, the helper expands it to the 120-cell grid first. This edits app data and is not a full-save restore. Review the selected target and replacement contents before saving.

Before using Replace Items from Backup, read the shared safety limitations for this page.

Before using Replace Items from Backup, read the shared safety limitations for this page.

Existing occupied item slots are replaced, not merged; destination name and other metadata are not wholesale restored. Compare actual target Slots and ValidSlotIndices, including after a failed attempt, before any live save.

Inventory Processing → Node View → Right-click menu → Toggle Expansion 2 Levels

Toggle Expansion 2 Levels

Collapses an expanded node or expands a collapsed node through the configured two-level helper. This changes only what is visible.

Inventory Processing → Node View → Right-click menu → Highlight In Text Box

Highlight In Text Box

Selects the corresponding line in Raw JSON without changing data. It refuses if the captured node structure and current text cannot be matched reliably; it does not silently synchronize them.

Inventory Processing → Node View → Right-click menu → Copy This Node's Text

Copy This Node's Text

Copies the selected node’s displayed label to the clipboard. It does not serialize that node’s full JSON or export the complete record.

This command copies the visible label of the clicked node, not the node’s complete JSON subtree. To copy JSON, select the desired text in Raw JSON and use Copy; use the whole-context clipboard export only when that larger scope is intended.

Inventory Processing → Raw JSON → Sync to Node View → Processing — Node View synch

Processing — Node View synch

The text-only notice reads: Processing the Node View synch. This can take a few seconds after the Node View appears to update...

This window-modal notice has no Close or Cancel button; Escape does not cancel the operation. The app dismisses it when the enclosing synchronization completes or raises an error. It may also cover the work that follows a confirmed generic node deletion.

Inventory Processing → Raw JSON → Right-click menu → Standard editing commands

Standard editing commands

Undo, Redo, Cut, Copy, Paste, Delete and Select All operate on the text editor, subject to its current selection and available edit history. These are text operations, not a general undo facility for tree operations.

Inventory Processing → Raw JSON → Right-click menu → Search Text

Search Text

Opens Search Dialog for this tab’s Raw JSON.

Searching follows the current text cursor in the chosen direction. No more occurrences found. means the search reached its end; it does not automatically wrap to the other end. To search again from the beginning or end, close the dialog, reposition the Raw JSON cursor and reopen Search Text.