API ReferenceGE Extensionscore
Hardware Info
Gathers and reports system hardware information (CPU, GPU, memory, disk, OS, power) with health warnings for low resources, unsupported hardware, and mod overload.
Gathers and reports system hardware information (CPU, GPU, memory, disk, OS, power) with health warnings for low resources, unsupported hardware, and mod overload.
Public API
| Function | Signature | Description |
|---|---|---|
M.getInfo | () → table | Returns comprehensive hardware info with warnings. Includes os, cpu, gpu, mem, disk, pwr, mods sections, each with a state and warnings array. |
M.requestInfo | () | Sends hardware info to UI via HardwareInfo guihook. |
M.logInfo | (filename) | Writes hardware info JSON to the specified file. |
M.runPhysicsBenchmark | () | Starts the "banana bench" physics benchmark. |
M.onBananaBenchReady | (outFilename) | Hook: reads benchmark results and sends to UI via BananaBenchReady. |
M.latestBananbench | () → table|nil | Reads and returns the latest bananabench.json results. |
M.latestBenchmarkExists | () → bool | Returns true if a benchmark result file exists. |
M.acknowledgeWarning | (warning) | Persists a warning acknowledgment in settings. |
M.runDiskUsage | () | Triggers disk usage analysis via Engine.Platform.runDiskUsage(). |
M.diskInfoCallback | (data) | Callback for disk usage results; triggers diskInfoCallback guihook. |
Warning Types
| Category | Warning Key | Condition |
|---|---|---|
| Memory | minmem | < 16 GB RAM (with 60% threshold for shared memory) |
| Memory | freememlow | < 1 GB free RAM |
| GPU | intelgpu | Intel integrated GPU (excluding Arc/BMG) |
| Disk | lowfreespace | < 1 GB free on root or user disk |
| Disk | rootmodified | Game install size deviates from manifest |
| Disk | onedrive | User path is inside OneDrive folder |
| Mods | toomanymods | > 20 unpacked or > 150 zip mods (error), > 10/100 (warn) |
| OS | powerdisconnected | Running on battery (currently disabled) |
| Piracy | highseas | sailingTheHighSeas global is true |
Global State Levels
ok → warn → error (highest severity across all categories becomes globalState)
Hooks
| Hook | Purpose |
|---|---|
M.onModManagerReady | Called on ModManagerReady event |
Usage Example
-- Get hardware info with all warnings
local info = core_hardwareinfo.getInfo()
if info.globalState == 'error' then
log('W', 'hw', 'Hardware warnings detected!')
for _, w in ipairs(info.gpu.warnings) do
log('W', 'hw', 'GPU: ' .. w.msg)
end
end
-- Run physics benchmark
core_hardwareinfo.runPhysicsBenchmark()Ground Markers
Renders navigation ground-decal arrows and floating 3D arrows along a computed route path. The primary navigation display system used by freeroam GPS and missions.
Highscores
Persistent highscore storage for scenario races. Stores per-scenario, per-config lap times with player and vehicle info, sorted by fastest time.