Test JSON Files Syntax

Validates the syntax of every JSON, JBeam, and PC file in the game by attempting to decode each.

Overview

util_testJSONFilesSyntax is a validation utility that scans the entire filesystem for .jbeam, .pc, and .json files and decodes each with jsonDebug.decode(). Parse errors and warnings are logged. This is used in CI/QA to catch malformed data files.

Extension path: lua/ge/extensions/util/testJSONFilesSyntax.lua

Exports (M)

Internals

Validation

Uses jsonDebug module (a stricter JSON decoder that returns warnings):

local state, data, warnings = xpcall(
  function() return jsonDebug.decode(content, context) end,
  debug.traceback
)

• Errors: Logged at 'E' level with the file path and error message.
• Warnings: Logged at 'W' level (e.g., trailing commas, duplicate keys).

File Discovery

FS:findFiles('/', "*.jbeam\t*.pc\t*.json", -1, true, false)

Scans recursively from root, including all mod content.

How It Works

1. Extension loads (typically via CLI).
2. onExtensionLoaded finds all matching files.
3. Each file is read and decoded.
4. Errors and warnings are logged to console.

Lua Examples

-- Run as a batch validation tool:
-- beamng.exe -onLevelLoad_ext "util/testJSONFilesSyntax"

-- Or load manually to validate all files:
extensions.load("util/testJSONFilesSyntax")
-- Check console output for errors/warnings

Additional Exports

• M.onExtensionLoaded - (undocumented)

See Also

• Auto Annotation - Related reference
• Booster - Related reference
• Calibrate ESC - Related reference
• Game Engine Overview - Guide