Skip to content

BeamDash alpha 0.02: info pages, trip computer, Deck & macros

Pre-release
Pre-release

Choose a tag to compare

@samsad001 samsad001 released this 30 Oct 12:28
· 4 commits to main since this release

BeamDash alpha 0.02

Live gauge clusters, telemetry and car control for BeamNG.drive, on your phone, tablet or second screen.

Warning

Alpha release. Cruise control and adaptive cruise don't respond in-game yet (a fix is planned for the next release). Everything else works.

Downloads

  • BeamDash-alpha-0.02.zip: everything (server, web app, mod, install scripts, docs). Start here.
  • BeamDash-mod.zip: just the BeamNG mod, for your mods folder.

Install

  1. Put BeamDash-mod.zip in your BeamNG mods folder (or run install-mod.sh / install-mod.ps1).
  2. Unzip BeamDash-alpha-0.02.zip and run start-server.sh (Linux) or start-server.bat (Windows). Needs Node.js 18+.
  3. Open the address it prints on your phone and spawn a car.

Full guide: docs/MOD_DOCUMENTATION.md


What's in alpha 0.02

Mod: no changes (same Lua as 0.01, so no reinstall needed).

Server

  • New actions.js: about 50 named actions, each with its own URL /api/action/<id> for Stream Deck, Companion, Touch Portal, curl or keyboard shortcuts. /api/actions lists them.
    • Toggles (cruise, parking brake, ADAS settings, following distance 1→4) are worked out on the server from the current state, so one URL works as a toggle.
    • Hold actions (horn) take ?state=up to release. Cruise ± takes step and unit (km/h or mph).
  • New trips.js, trip computer: Trip A, Trip B, Since start and a resettable Economy counter (distance, drive time, engine time, average and max speed, fuel used, L/100 km). Saved to data/trips.json every 10 s. Since start resets when you spawn a different car. The demo car uses its own throw-away counters.
  • New media.js, now playing: reads playerctl once a second (title, artist, album, art, position) and sends play / pause / next / previous. /api/media/art serves only the current track's album art.
  • server.js
    • New endpoints /api/action/<id>, /api/actions, /api/deck (GET / PUT, saved in data/deck.json) and /api/media/art.
    • New live events: trips, media, ui (flip pages on every screen) and deck.
    • ADAS settings are saved in data/settings.json and sent back to the game when it reconnects.
  • beamdash.service is now a systemd user unit, so the server can reach the desktop's media player.

Web app

  • Info pages (multi-function display), flipped with ◀ OK ▶, swipes, keys, the Deck or macros: Trip, Economy, Now playing, Navigation, Driver assist, Digital speed, Tires, G-force, Engine, Vehicle & service. Hold OK to reset a trip.
    • Shown on each design's own screen, in the check-control line on the E46-style design, or as a pop-up on classic designs.
  • 4 new designs (20 total): Bavaria Black Panel '12, Stuttgart Five-Dial '19, Neo Skyline '99, Heartland Pickup '19.
  • Nicer gauges: needle shadows and caps, glass reflections, per-design page colours, and more polish on the existing designs.
  • Deck page (/deck): a button pad for a second phone, with editable pages.
  • Macros page (/macros): every action's URL, ready to copy, plus keyboard bindings.
  • Telemetry shows the trip computer.

Known issues

  • Cruise control does nothing in-game (a fix is planned for the next release).