Repository navigation
2.0.0
BeamJoy Revived 2.0
The biggest update yet: deliveries and convoys, Derby, crews, a redesigned main window, a full
props editor for races and arenas, passive races, drift spots and dragstrips, police chases between
players, Discord posts, a plugin API, and a server that can update itself.
Client build 2740, server build 2474. Built for BeamNG.drive 0.40 and BeamMP 4.23.1.
Updating: place both the Client and Server folders into your server's Resources folder, replacing Client/BJ.zip and the
BeamJoyServer folder (and BeamJoyServerHooks, if you don't have it yet), then restart the
server. Players should clear their game cache once: BeamJoy shows a notice if their UI is out of
date.
This release also includes everything from the 1.10.7 hotfix.
New activities
Deliveries and convoys
- Delivery points (Config > Freeroam > Deliveries): each point has a zone, what it sends
(packages, vehicles) and what it accepts (packages, cars, trucks). A point that sends something
is a depot. Import from map adds the map's own delivery locations (West Coast USA has
about 65), and Legacy Import brings over BeamJoy Free hubs and points. Nine maps come with
delivery points already set up. - Package jobs: drive up to a depot, open its job board and pick a job. Some jobs have 2 or 3
drop-offs in a row. Your score depends on the route distance and your time against the target. - Vehicle jobs: deliver a car or truck from the depot's start slot. The vehicle's condition
counts towards your score, resets don't repair it, garages stay closed until you deliver, and
Unstuck puts it back on the road. You keep the vehicle afterwards. - Convoys: up to 4 players take one job together, with bonuses for convoy size and for
driving together. Join from the depot, from the board, from an invite or from Happening now. - Jobs window and leaderboards: every depot on the map with its open jobs, plus package and
vehicle delivery leaderboards (jobs, success rate, distance, points). - Delivery settings (Config > General > Deliveries): route lengths, target speed, jobs per
depot, rotation, drop-off hold time, convoy lobby time and a vehicle blacklist by model or by
configuration.
Derby
- Three modes on the map's derby arenas: Last man standing (0-5 extra lives), Timed (most
wrecks wins) and Sumo (the arena zone shrinks). - A car is wrecked when its engine dies, it stays stuck, or it leaves the arena zone. The last
player to hit you gets the wreck, shown in a kill feed, and damage dealt breaks ties. - Lobbies work like the other modes (invites, crews, vehicle presets), with results, a Derby
leaderboard and Discord posts. - Derby arenas (Config > Arenas > Derby): several per map, each with start positions, an
optional zone (circle, rectangle or ellipse) and default settings.
Crews
- A crew is up to 8 players. When the crew leader opens a race, hunt, infected game, derby or
convoy, every crewmate who's free joins it automatically.
Passive races, drift spots and dragstrips
- Passive races: a race set to Passive starts when a player drives through its start gate in
freeroam. No lobby, one lap, timed on the race's own Passive board. Players can opt out in
Settings > Passive races. - Drift spots (Config > Freeroam): a start, a route of points and a finish, with a corridor
that can be wider or narrower at each point. The route curves smoothly between points; the
start and finish lines and the edges are painted on the road, with drift signs at the gates. - Dragstrips (Config > Freeroam): a start and a finish, with a choice of distance (1/4 mile,
1/8 mile or 1000 ft), sportsman or pro tree, lanes and lines painted on the road. BeamJoy
shows its own tree, live times and timeslip, since the game's drag apps never show on BeamMP. - Drift and drag leaderboards, including the game's own drift spots and drag strips.
- Drift spots, dragstrips, races and derby arenas all have pins on the Big Map.
Main window redesign
- A slim rail on the edge of the screen opens small panels: Now (everything happening that
you can join or spectate), Activities, Players, Crew, Settings and more. It can be dragged
anywhere, and can shrink to a small handle when not in use. - Full window: Home (Happening now, Players and You), Activities, Players, Leaderboards and
Settings, with a Server config button for staff. - Notifications: race, hunt, infected and convoy invites and new lobbies appear as cards beside
the rail with Join and Dismiss. Invites expire after 15 seconds. - Lobbies: one card with the race, the timer, ready tags, Invite player and Start now. The
leader can change race settings while the lobby is open, and race lobbies can be private
(invite only). - Players: each player is a row with their rank and car. Staff get Everyone's vehicles
(freeze, stop engines or remove all) and can cancel any session.
Controller support
- The whole main window, lobbies, the race HUD, race info, the job board, votes and the welcome
screen work with a gamepad. The Focus control (RB + X, rebindable in Controls > BeamJoy)
hands the pad to BeamJoy and gives it back. - The d-pad moves by direction, nothing is skipped, and readying up in a lobby takes two presses.
Races
Props editor
- Place props with the mouse in the race editor and in the Hunter, Infected and Derby arena
editors. A click places one; a click and drag lays a line. - Hundreds of curated props, including barriers, cushions, guardrails, fences, tapes, signs,
lights, gazebos, rocks and prefabs (several meshes placed as one), each with a preview, plus
every mesh in the game, other maps' meshes included. Lamps light up at night. - Lines curve through as many nodes as you like, can alternate two meshes, use a fixed gap,
have end caps and follow the ground's tilt. - Curbs and walls (raised, flat, sausage and sawtooth curbs, concrete walls), adjustable in
width at any point. - Painted lines: the game's road paint, tyre and skid marks, track rubber and spray paint.
- Editing: multiple selection and groups, copy and paste between races and arenas, an
eyedropper, Swap mesh, snap to ground, a collision switch, Keep placing, and Delete. - Up to 1000 props per race, loaded a few per frame to avoid hitches.
Import map races
- Config > Races > Import map races imports the map's own time trials and quick races, modded
maps included, along with their barriers and cones. Choose everything, gates only, or props
only.
Racing
- Rejoin after a disconnect: a racer who drops out keeps their place for the race's Rejoin
time and comes back at their last checkpoint, in their exact car. This works for guests too. - Everyone gets the green light at the same moment, from a shared clock.
- Race control for staff: 0.5, 5 and 10 second time penalties, disqualify and reinstate.
Penalties show beside racers' times. - New race options: reset penalties can add time instead of holding the car, Flip upright and
Last road respawns, Waypoint beams (a GPS-style beam over the next gate) and Gate markers. - Race gates and the fugitive's waypoints show on the minimap.
- Race HUD and race info redesign: three HUD layouts (Standard, Compact, Full standings) or
Disabled, built for full grids, long races and up to 12 sectors. Spectating shows the full
standings and the watched racer's checkpoints. - Race times show hours, and race distances follow the route.
- Race updates are a fraction of the size, which helps on big grids.
- Joining an activity clears your own GPS route.
Vehicles
- Shared builds: add the car you're driving (custom setup included) to a vehicle preset, and
every player can pick it in their vehicle selector, with a real photo of it. - Vehicle presets for Infected, one for each side, with optional random vehicles, like Hunter's.
- Late joiners see things right: lights, signals, police lightbars and open doors now show
correctly for players who join later. - Use other players' cars: door handles, the hood, the trunk, the horn and other buttons on
another player's car now work. - Dust and particles slider (Settings > Vehicle) for your game only.
- Staff explode matches the game's own Boom.
Freeroam
- Police chases between players: from your own police car you can chase players who break
the law near you, using the game's police rules. The server checks starts and arrests. Players
can opt out in Settings > Vehicle > Police chases. - Traffic chases pick a suspect you can actually reach, run one at a time, and the fugitive
can now get away. There are no chases during activities. - Ghost players outside games (Config > General > Freeroam): players in freeroam can't hit
players who are in a race, hunt, infected game or derby. - Weather sync (Config > General > Environment): everyone sees the same clouds, fog, wind
and temperature. - Big Map: pins for races and derby arenas, routes drawn on hover, and quick travel to every
BeamJoy activity, garage and gas station. - Settings > Visual can hide activity markers, or station and garage markers.
/nickname(or/nick) changes your nickname from chat. Nicknames are now for guests only:
players logged in to a BeamMP account keep their account name.
Leaderboards
- Redesigned race leaderboards with the track record, your best, and how far you are from the
next place. - A Leaderboards tab with Races, Deliveries, Derby, Drift and Drag boards.
Discord
- Add channel webhooks in Config > General > Discord; no extra plugin is needed. Each webhook
picks what it posts: race results (records, personal bests), hunter, infected and derby
results, deliveries, votes, joins and leaves, and chat. Nothing posted can ping anyone.
For server owners
- Self-updater: the server checks GitHub for new releases. Owners are told in game and
install with/bjupdate./bjupdate channel developmentswitches to test builds. - Plugin API (
BeamJoyServer/api/README.md): your own server plugins can read BeamJoy's data,
take part in races, add pages to the main window, add options to races and the config window,
show overlays, and set the time and weather. Players can't reach it. - Legacy Import now covers delivery points and shows a checklist of what to bring over.
bj setgroupworks in the server console.- The server logs an error when BeamJoyServerHooks is missing, since chat commands don't work
without it. - 316 bundled races on 14 maps, 88 of them new (Driver Training and the Nordschleife among
them), most dressed with props. Reverse directions are now named "Name (reverse)". - Bundled races are synced once. On the first boot after updating, every bundled race your
server has is renamed to its 2.0 name where it changed, then replaced with the 2.0 version
(course, props, default settings, vehicle rule). Its times stay unless the course changed.
Races you deleted stay deleted. If you edited a bundled race and want to keep your version,
rename it before updating.
Performance
- Faster join: the sidebar and weather no longer wait 7-10 seconds after loading.
- Less lag after joining a server with many vehicle mods.
- Fewer hitches from map markers and race props.
Languages
- The longest tooltips are shorter and clearer.
- Every supported language is filled in: all 12 client languages and 7 server languages.
Security
- Players' IP addresses and BeamMP IDs no longer go to every player.
- Traffic chases can't take over another player's car. Before, any car could be handed to the
flee AI, a player's own included. /loginlocks for 5 minutes after 5 wrong passwords.- The server drops messages from unknown players, checks race, hunter and infected results
against its own view, keeps player names inside the players folder, and no longer reads
{{in text as a template.
Fixes
Races
- Branching lap races could count a lap from anywhere on the start/finish line.
- Race gaps drifted on long races, worst between cars on different laps.
- Racers were ghosted at the start with "Ghost on countdown" off.
- The reset penalty started while you were still holding to rewind.
- Race, hunt and infected lobbies didn't show "Lobby closes in" until everyone was ready.
- Lobby countdowns flooded the log with errors and stalled the UI.
- Street Course 2 (West Coast USA) had a misplaced gate.
Hunter and Infected
- The fugitive's nametag and minimap icon showed during the countdown, giving away the start.
- Holding Alt over a car showed nametags a mode was hiding.
- A fugitive who was never revealed stayed off everyone's minimap after the hunt.
- The gizmo stayed on screen after saving an arena.
Freeroam, traffic and police
- Traffic piled up around players, and cars appeared on another player's screen, drove a few
metres and vanished. - Arresting a traffic fugitive barely ever worked.
- Traffic fugitives escaped as soon as they were about 175 m away.
- A rammed fugitive stopped to "exchange insurance" instead of fleeing.
- A fugitive the game respawned elsewhere kept its tag and couldn't be arrested.
- The fugitive tag could stay on a car after its arrest.
- Two traffic fugitives could be chased at once.
- Arresting another player's traffic car didn't end the chase.
- Other players saw "Not in Service" on your bus, and the bus sign was missing when you had to
pick a bus to start a line. - With time sync on, the date never moved on at midnight (the moon jumped back a day).
- BeamJoy's Big Map points only showed in the sidebar list or in clusters, never as their own pin.
- The Freeroam editor: you couldn't go back to a station or bus line after selecting one of its
pumps or stops, the toolbar showed no tool selected, and world labels stayed after switching
config tabs.
Game and connection
- BeamJoy's UI stayed on screen after "Exit level".
- The game crashed when closed while on a server (Alt+F4 or the window's X).
- The console flooded with errors after leaving a server or exiting the level.
- No BeamJoy UI after the connection dropped and the game rejoined.
- The BeamMP launcher could drop players right after they joined.
- Pausing logged a fake "FATAL LUA ERROR" every time.
- Picking a car while walking put you in the nearest vehicle instead.
- The node grabber made the camera go haywire in races without free cam.
- Opening Settings reset saved vehicle settings, like Automatic lights.
Interface
- Sliders showed the wrong position, ran off small menus, and some showed their value twice.
- A click on BeamJoy's UI or a gizmo also clicked the world behind it.
- The promote/demote buttons' tooltip kept showing the first rank.
- Nametags didn't show nicknames.
- Map and kick vote messages showed placeholder text.
- The Voting settings panel always showed the defaults instead of the saved values.
Server
- Text made only of spaces could freeze the whole server, and some characters in player text
caused errors or were cut off. - No BeamJoy UI on a server whose groups file wasn't a list.
Removed
- "Show HUD at start" (Config > General): "Force-enable BeamJoy HUD" is on by default.
- The unicycle desync workaround: the fix is in BeamMP itself now.