Input System Utils

Utilities for analyzing and re-formatting input map JSON files. Prints binding statistics and resaves all inputmap files with consistent formatting and sorting.

Overview

util_inputSystemUtils provides two main tools: printStats() dumps statistics about input bindings across all inputmap files, and resave() reformats every inputmap JSON with consistent sorting, vendor name resolution, and custom pretty-printing.

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

Exports (M)

Internals

printStats

1. Scans all *.json files containing inputmaps/ in the path.
2. Counts total bindings and per-action usage.
3. Prints the top 20 most-used actions sorted by frequency.

resave

For each inputmap JSON file:

1. VID/PID resolution: Extracts vendor/product IDs from vidpid field or filename.
2. Vendor name lookup: Uses vendorNames.json to resolve vendor names.
3. Binding sorting: Bindings are sorted by control (natural sort), then by action.
4. Custom JSON encoding: Uses jsonPrettyEncoderCustom with:
   • Key weight ordering: control first (10), default (50), bindings last (99).
   • Folding callback: Collapses small tables (< 4 items) under /bindings/.
5. Only writes if content changed.

Natural Sort

Uses zero-padded number comparison for natural sorting:

"axis1" < "axis2" < "axis11"  -- instead of "axis1" < "axis11" < "axis2"

VID/PID Validation

isValidVIdPId() checks that the string is exactly 8 hex characters. Invalid IDs are cleared.

How It Works

1. Call printStats() to see binding statistics.
2. Call resave() to reformat all inputmap files in-place.
3. Files that are already correctly formatted are skipped.

Lua Examples

-- Print input binding statistics
extensions.util_inputSystemUtils.printStats()
-- Output:
-- 1523 total bindings
-- top 20 actions:
--  * steering - 45
--  * throttle - 42
--  * brake - 41
--  ...

-- Resave all inputmap files with consistent formatting
extensions.util_inputSystemUtils.resave()

Additional Exports

• M.printStats - (undocumented)
• M.resave - (undocumented)

See Also

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