BeamJoy

Everything your BeamMP server needs

  • Races
  • Derby
  • Hunter
  • Infected
  • Deliveries
  • Drift
  • Drag
  • Bus routes
  • Convoys
  • Traffic
  • Time & weather sync
  • Discord integration
  • Whitelisting
  • Permissions
  • Server management
  • Map voting
  • In-game race editor
  • Share codes
  • Pit stops
  • Leaderboards
  • Modular plugins

Version 2.1.1  ·  MIT licence  ·  server plugin plus an optional client mod

What is BeamJoy?

A free, open-source mod for BeamNG.drive multiplayer that installs as a BeamMP server plugin. Everything is run and configured from inside the game — no messing with config files, no restart to start a race.

BeamJoy’s race editor open on a Mondello circuit race, with gate markers placed along the start/finish straight, a start position on the grid and the pit-out line beside it.

Build a race without leaving the server

Drop gates along a road, create branching paths, place props and obstacles, save it and it is live for everyone on the server. Share or import a race with a code, or try out one of the many races BeamJoy comes with.

BeamJoy’s race HUD during a lap of a Mondello circuit race: the position plate, the gap to the car behind, lap 1 of 3, a sector strip and the running order.

Live timing and leaderboards

Sector splits while you drive, and a record board that survives the session.

BeamJoy’s main window on the Activities tab, listing races with their slot counts, distances and authors, each with a Start button.

Everything in one window

Join what is running, start something new, or see who is on the server. No mouse required.

A city street lost in thick fog during a two-player session, beside the game’s Time & Weather panel with the fog density turned up.

Everything is synchronized

Traffic run by the server, the same time of day and weather for everyone, and doors and lights that stay in step, even for players who join late.

Eight ways to play

Races

Gates, laps, sectors and leaderboards, built in game and shared as a code.

Derby

Last car running, in an arena you mark out, with damage limits.

Hunter

One car runs, everyone else chases it across the map.

Infected

Tag, where the infected side keeps growing until nobody is clean.

Deliveries

Haul a package or a vehicle across the map, alone or in a convoy.

Drift

Scored zones that count up while you hold the angle.

Drag

A proper tree, a quarter mile, and a timeslip at the end.

Bus routes

Scheduled stops along a real line, on maps that have one.

Give your players something to do

One zip into your server's resources folder. It writes its own databases on first boot, and nothing else on the server has to change.

Back up BeamJoyData, not the plugin folder — that is where your races, settings and records live.

Where it goes on your server
BeamMP-Server/
└── Resources/
    ├── Server/
    │   ├── BeamJoyServer/        the plugin
    │   ├── BeamJoyServerHooks/   chat and console
    │   └── BeamJoyData/          your databases
    └── Client/
        └── BJ.zip                sent to players
  1. Unzip the release into Resources.
  2. Restart the server. It writes BeamJoyData on first boot.
  3. Run bj group YourName owner in the server console.
---

Where to go next

Documentation

Installing it, claiming ownership, groups and permissions, where your data lives, and updating in place.

Read

Route catalogPlanned

Races players have built, with a share code you paste into your own server.

PluginsPlanned

Extensions built on BeamJoy's server API, linking to each author's own releases.