Skip to content

Releases: flintt/ghost-racer-telemetry

v0.2.0 — sectors, zoom, playback

Choose a tag to compare

@flintt flintt released this 12 Sep 04:15

Analysis tools: micro-sectors and the ideal lap, zoom on both panes, a pinnable cursor, stretch selection with playback, and in-game style input gauges.

分析能力大幅补齐:微分段与理论最佳圈、两边独立缩放、可锁定的游标、区间框选与回放、游戏风格的输入仪表。

Sectors and the ideal lap · 分段与理论最佳圈

Cut the shared route into 10 m cells, time every selected lap through each and award the cell to the quickest; runs of owned cells are that lap's best stretches, and the winning cells add up to the ideal lap. Cells are measured along the reference lap's path rather than each lap's own travelled distance — a wider line otherwise gets compared at a point it has not reached yet (16.6 m of bias over a 2290 m lap in testing). A Sectors tab lists every stretch worst-gap-first, a Sector owner colouring paints the map, and an ownership strip runs along the Δt chart.

把共同路线切成 10 米一格逐格比最快,连续同主的格子就是该记录的最佳区间,累加即理论最佳圈。格子按参照圈的路径取里程,不按各自跑过的距离——否则走外线的圈会被拿到它还没到达的位置去比。

Zoom, pin, select, play · 缩放、锁定、框选、回放

  • Zoom — wheel zooms the map about the pointer (to 40×) and the charts' X window (to 1/500 of a lap); drag pans, double-click resets. Chart Y axes scale to what is inside the window. A zoomed map follows the cursor driven from the charts, so the point never leaves the viewport.
  • Pin — click parks the cursor: hover can no longer move or clear it, so a position survives walking the mouse to the other pane. Escape releases.
  • Select and play — right-drag or Ctrl-drag picks a stretch (an X range on a chart, a rubber-banded box on the map) and the transport replays it on the reference lap's real clock with loop and 0.25×–4× speed, moving every selected recording at once.
  • Gauges — the map's bottom-right corner carries vertical throttle / brake / handbrake bars and the current gear, one cluster per recording.

Interface · 界面

English and Chinese, picked from the browser on first visit; auto / light / dark theme. The recording list and the summary panel both collapse, and the collapse, language, theme and tree state are remembered in the browser.

中英文界面(首次按浏览器语言自动选),自动/浅色/深色主题;上下两个面板可折叠,折叠、语言、主题和目录树状态都记在浏览器里。

Fixes · 修复

  • Lap ids are strings (g000001) in the mod's manifests; they were parsed as numbers, so every lap list came back empty.
  • The Windows user folder is nested under a vendor directory (%LOCALAPPDATA%\BeamNG\BeamNG.drive\current); autodetection missed it. Failures now print every path that was tried.
  • Pointing -data at the game's save folder is now called out at start-up: that directory is writable, and deleting there really deletes.
  • The map canvas pinned its own height, which locked the layout: collapsing a panel or resizing the window vertically moved nothing.
  • Chart series are clipped to the plot; a zoomed gear trace ran out over the axis labels.

Notes

  • Listens on 127.0.0.1 only; the game's save folder is read-only unless -allow-delete is passed.
  • The Windows binary is unsigned, so SmartScreen asks once. Verify a download against SHA256SUMS.
  • -version prints the build.

v0.1.0 — Ghost Racer telemetry web

Choose a tag to compare

@flintt flintt released this 09 Sep 14:18

Browse and compare the lap telemetry recorded by the Ghost Racer Enhanced BeamNG.drive mod: track map, channel charts and multi-lap Δt, from a single binary with no dependencies.

浏览和对比 Ghost Racer Enhanced 记录的圈速遥测:轨迹图、通道曲线、多圈 Δt 对比。单文件二进制,零依赖。

Quick start · 快速开始

Download the binary for your platform, then run it — on Windows that is usually all:

ghost-racer-telemetry-v0.1.0-windows-amd64.exe

It finds the BeamNG user folder on its own (%LOCALAPPDATA%\BeamNG\BeamNG.drive\current\ghostReplays, falling back to numbered version folders and older layouts) and opens http://127.0.0.1:8777/. To point it somewhere else:

ghost-racer-telemetry-v0.1.0-windows-amd64.exe -root "C:\Users\you\AppData\Local\BeamNG\BeamNG.drive\current"

下载对应平台的文件直接运行即可,会自动找到 BeamNG 用户目录并打开 http://127.0.0.1:8777/。要手动指定用 -root不是 -data,那是服务自己的可写导入目录)。

What's in it · 功能

  • Track map coloured by speed, throttle/brake, gear, lateral G or Δt, with the start and finish gates drawn.
  • Charts for speed, Δt, throttle/brake, lateral G, longitudinal acceleration and gear, all sharing one cursor with the map.
  • Multi-lap comparison aligned on distance from the start gate — the same alignment the mod uses for ghosts — so an abandoned run ends where it stopped instead of skewing the delta.
  • Library browser following the in-game level → saved start → track variant hierarchy, with category and vehicle filters, ranking, CSV export and guarded deletion.
  • Reads replay format 2 and the original 1.6 rows; derives distance, longitudinal acceleration, heading and lateral load, which the mod itself does not record.
  • POST /api/import is ready for an in-game "export for analysis" button (see docs/import-api.md); the mod side of that is not built yet.
  • English and Chinese interface, auto/light/dark theme.

Notes · 说明

  • Listens on 127.0.0.1 only, and the game's save folder is opened read-only unless you pass -allow-delete.
  • The Windows binary is unsigned, so SmartScreen will ask once. Windows 二进制没有签名,SmartScreen 会提示一次。
  • Verify a download against SHA256SUMS.

Requires the Ghost Racer Enhanced mod lineage to have written recordings; the mod is a separate project.