Driver Profile and Persistence

Driver Profile and Persistence

TaxiDriver stores user data outside the mod archive under:

%LOCALAPPDATA%\BeamNG\BeamNG.drive\current\settings\TaxiDriver\

General settings, portable difficulty, profile, progress, and LAN pairing identity are separate so one corrupt document does not reset unrelated data.

settings.json

{
  "schemaVersion": 1,
  "modVersion": "2.23.0",
  "language": "en",
  "rememberLanguage": false,
  "difficulty": "standard",
  "fontBoost": 2,
  "appVolume": 0.65,
  "unitSystem": "metric",
  "timeFormat": "12h",
  "dynamicZoomIntensity": 100,
  "economyMultiplier": 1,
  "deliveryOrderSharePercent": 50,
  "silentMode": false,
  "showRouteGuidance": true,
  "realisticMode": false
}

fontBoost is rounded and clamped to 0–5. appVolume is clamped to 0–1. Unsupported languages and difficulties return to defaults. Connected phone is deliberately excluded and always starts disabled.

difficulty.json

This portable file contains the Custom difficulty slider values and the seven individual penalty switches. It can be shared between players without exposing profile, wallet, language, or LAN pairing data. Invalid fields are clamped to the ranges defined in config.lua.

profile.json

{
  "schemaVersion": 1,
  "modVersion": "2.23.0",
  "fullName": "John Doe",
  "birthDate": "",
  "avatar": "🙂"
}

• Names are trimmed, internal repeated spaces are collapsed, and length is limited to 160 bytes.
• Birth date uses YYYY-MM-DD, must represent a valid calendar date, and accepts years from 1900 through the current year.
• Avatar must be one of the 32 values defined in identity.lua.

Age is calculated by the UI and is not persisted.

progress.json

The progress document contains:

• wallet balance;
• current rating;
• accumulated rating total and count;
• completed ride count;
• monotonically increasing sequence ID;
• passenger reviews;
• rating history;
• balance history.

Representative structure:

{
  "schemaVersion": 1,
  "modVersion": "2.23.0",
  "balance": 24.75,
  "rating": 4.82,
  "ratingTotal": 48.2,
  "ratingCount": 10,
  "completedRides": 10,
  "sequence": 10,
  "reviews": [
    {
      "id": 10,
      "passengerName": "Amelia Howard",
      "emoji": "😍",
      "quality": 94,
      "fare": 12.85,
      "rating": 4.82,
      "timestamp": 1784040000,
      "outcome": "completed"
    }
  ],
  "ratingHistory": [{"index": 10, "value": 4.82, "timestamp": 1784040000}],
  "balanceHistory": [{"index": 10, "value": 24.75, "timestamp": 1784040000}]
}

Valid outcomes include passenger completion/exit/abandonment and delivery completion/abandonment.

Reviews and history are not given a fixed retention limit. The UI paginates reviews in groups of six.

Validation and recovery

Every file has schemaVersion = 1. On extension load:

1. the file is read inside pcall;
2. schema and fields are sanitized;
3. unsupported schema or invalid root data falls back to defaults;
4. a canonical sanitized document is immediately written back.

If progress.json does not exist, the extension can import balance/rating values from BeamNG extension serialization once, then writes the new progress file.

Write points

• Settings and portable difficulty: automatically after a UI change debounce.
• Profile: when the profile identity page is saved.
• Progress: completed ride, passenger exit, driver abandonment, fuel purchase, mission end, and extension unload.

Backup and reset

To back up progress, copy the complete settings/TaxiDriver directory while the game is not writing it.

To reset only one category, remove the corresponding JSON file. The next extension load recreates that file with defaults and leaves the other documents untouched.

lan.json

lan.json stores the stable random External Web UI token and last selected private IPv4 address. It does not store an enabled flag. Connected phone remains off after every mod/UI App start. Delete this file to generate a new pairing token.