Import and Export

Export writes every Bondsmith category to one JSON file. Import reads that file back and asks which categories to apply.

The Data tab

The Data tab of the settings panel holds Export Data and Import Data. Scan Compendiums opens a window that lists untracked actors in the compendiums you pick. The Danger Zone reset controls are covered on the Settings reference.

Exporting

Click Export Data to download a JSON file named for the current date. The file records the world it came from, the time it was written, and the Bondsmith version that wrote it.

The file holds four categories.

• Settings: the reputation range, the modes, the display preferences, and the decay and integration options.
• Reputation data: the tracked actors, factions, locations, relations, changelog, automation rules, decay configuration, visibility flags, and active party.
• Presets: your custom tier scales and any built-in scale you have edited.
• Graphs: the graph index and the stored graph data.

Per-client preferences, graph link label defaults, and map shape drawing defaults are left out of the file.

Importing

Click Import Data and pick an exported JSON file. Bondsmith shows an error and changes nothing when the file is not valid JSON or is not a Bondsmith export. A valid file opens the Import Preview.

Bondsmith converts a file from an older version as it reads it. A single reputation score on an actor becomes a row for each player character. A faction score held against a player moves to that player’s character. A faction score held by the whole group is copied to every player character. Slot graphs become force-directed graphs. Political maps become geographic maps. The version stamp in the file decides which conversions run. The preview compares the converted file against your world.

Caution

Export a backup before you update Bondsmith. Retired data formats convert only when a file is imported, never when a world is loaded.

The preview

The preview shows four counts.

• Factions added counts the factions the file has and your world does not, and lists their names.
• Factions removed counts the factions your world has and the file does not, and lists their names.
• Reputation changes does not compare reputation scores between the file and your world. It reads zero for files exported by the current version.
• Graph conflicts counts the graphs whose identifier already exists in your world, and lists their names.

Selecting categories

Each category has a checkbox, and all four start checked. Clear a checkbox to leave that category in your world untouched.

Import replaces each selected category in full. It does not merge row by row.

Applying

The backup checkbox starts checked. While it is checked, Bondsmith downloads an export of your current world before applying the import.

Click Confirm Import to apply the selected categories. A pip confirms when the import finishes. Cancel closes the preview and discards the file.