Skip to content

Releases

2.1.1

Choose a tag to compare

@foodcache3 foodcache3 released this 13 Nov 19:28

BeamJoy Sandbox — release notes

  • Version: 2.1.1
  • Builds: server 2497, client 2785
  • Previous public release: 2.1.0

These notes cover everything since 2.0.1. 2.1.0 shipped it all except the server-side
pit lane speed check, which is what 2.1.1 adds.


Updating

This release changes both the server and the client.

Automatic, from in game

BeamJoy checks this project's GitHub for a new version by itself, every 6 hours, and tells the
server's owners in game when it finds one.

  1. An owner types /bjupdate in chat, or bj update in the server console.
  2. Restart the BeamMP server once it reports the install finished.

It replaces Resources/Server/BeamJoyServer, Resources/Server/BeamJoyServerHooks and
Resources/Client/BJ.zip, moving the previous ones to BeamJoyData/update/backup-...; if any of
them can't be moved, everything goes back as it was. BeamJoyData — races, players, settings and
leaderboards — is never touched.

  • Players should clear their cache before rejoining.
  • Updates come from GitHub releases directly by default. bj update channel development follows the
    development branch instead, and bj update channel says which is in use.
  • Auto-install needs curl, built into Windows 10 1803 and later, and on Linux unzip and zip. A missing
    tool is reported to whoever asked for the update, with how to install it.

Manual

  1. Server: replace Resources/Server/BeamJoyServer and Resources/Server/BeamJoyServerHooks,
    and put the new BJ.zip in Resources/Client. That is the copy players download in multiplayer,
    so a stale one there leaves the whole server on the old client.
  2. Restart the BeamMP server.
  3. Singleplayer, or testing a client build: BJ.zip into your own BeamNG mods folder.
  4. Restart BeamNG once. Translations are read at load, and this release changes the file they
    live in.

Important Note

Servers that are updating keep their recorded times on the East Coast USA Races.
A race an admin edited themselves will be overwritten.


Highlights

  • Race phases. A race session can be an event of up to 20 phases — practice, qualifying, heats,
    a final — each with its own start, length, ranking, grid and rules.
  • Five new start types: a five-light gantry with jump-start penalties, releases in waves, one
    racer at a time, flying starts and out laps.
  • Pit stops for circuit races. A pit lane with its own speed limit and a box per start slot,
    refuelling and damage-timed repairs from a pit menu on the race HUD, and optional required stops.
  • Driving your own car works again on BeamNG 0.40. Dead controls, a hidden driver camera and
    sitting in the passenger seat were all one cause.
  • Translations work again on BeamNG 0.40, community language packs included, and Italian is a
    new language.
  • Framerate optimizations in nametags, the race, the vehicle selector, and two stutters that
    recurred on a timer.
  • Drift spots can be driven in either direction, sharing one leaderboard, as the game's own do.
  • A larger plugin API: race control and stewarding, plugin-run lobbies and phases, GPS,
    the whitelist and labels on the race HUD. New rallycross plugin with joker lap example.

Races

Events and phases

  • Phases. A race session is an event of one or more phases (20 at most). Each has its own start
    (together from the grid, one at a time, or open runs), length (laps, a time limit, or both),
    ranking (race order, best lap, total time), grid (the lobby's, an earlier phase's result or the
    standings, reversed or not), who races it (the top n of an earlier phase: knockouts and finals),
    rules and break. The event's result is its last counted phase, or every counted phase added up.
    A race started the way it always was is one phase and behaves exactly as before.
  • Formats in the start menu: race, qualifying + race, practice + qualifying + race, sprint +
    feature (reversed grid), time attack, knockout qualifying + race, two runs added up — all editable
    in the phase editor. A race can carry its own phases as its default.
  • Saved formats. Save a format of your own from the start menu's Format list (50 at most, kept
    in your own game's settings).
  • Timed races. Length can be laps, a time limit, or both, with a choice of what happens when the
    time runs out: the leader's lap, everyone's own lap, or stop at once. The HUD counts it down.
  • Between phases. A break showing that phase's results — a tab per phase and one for the event —
    then a countdown to the next, which the leader can start early. Cars taken away come back.
  • Knockouts. The finish popup tells you the place you finished in and whether it puts you
    through. The results tab draws a line under the ones advancing: green for through, red for out.
  • Point-to-point tracks. Practice and qualifying become repeat runs from the first slot, each on
    its own clock, until the runs or the time are up.
  • Race control. Staff can end a phase (a red flag), add 5 minutes to a timed phase or a lap to
    one on laps, and hand out penalties.

Starts

  • Lights. A five-light gantry replaces the counted countdown: one light a second, held lit for a
    moment the server picks fresh every time (0.2–3 s, so it can't be learnt), then out together for
    the green. Your car is released as the first light comes on, so holding it on the brake is your
    job — and moving off early is a jump start, worth a penalty you set in seconds.
  • Waves. The grid is released a few cars at a time, each wave a set interval after the last,
    every car timed from its own start.
  • One at a time. Each racer does their whole phase alone before the next is released. The others
    either wait on their slots or, by default, have their cars put away and watch whoever is on track —
    and everyone starts from the first slot, the first racer included, to keep it fair. "You're up
    next" warns the racer whose turn is coming.
  • Time offset. Every racer starts from the first slot a set interval apart, several on track at
    once, for time trials and hill climbs.
  • Flying starts. On a point-to-point track, choose whether a racer's time starts as they're
    released or as they cross the first checkpoint. The lap clock waits at 0 for the line.
  • Out lap. A circuit can give everyone an untimed lap from the grid first, each racer's time
    starting as they cross the line at its end. Its laps and sectors count for nothing.
  • The start lights hang near the top of the screen instead of sitting in the middle of it, over
    the stretch of track you're about to launch down.

Race settings

  • A reset speed limit. A tickbox and a speed: resetting or recovering only works below it, so a
    reset can't be used as an airbrake — press it mid-crash and you keep the crash. A refused reset
    says so on screen rather than the key quietly doing nothing, and every way of asking for one is
    covered, down to the pause menu's own Repair and Flip upright buttons. Off by default, and hidden
    when the race has resets turned off.
  • Reset in place. A new respawn option: whatever the racer presses, the car is rebuilt and
    repaired where it stands, upright and facing the way it was. A crash costs its time but never
    sends anyone back to a checkpoint.
  • Hide other racers. Every other racer's car is simply not drawn on your client — not
    translucent, gone — with their nametags, and your own car ghosted so you can't hit what you can't
    see. Cars outside the race are left alone, since traffic is part of the track. Meant as a
    qualifying rule, so quali runs on an empty track and the race that follows doesn't.
  • Players can join mid-race, per race and per phase. Off by default.
  • Settings can be set for a whole race, in a race's own defaults in the editor, in the lobby's
    "Change settings", or as one phase's rule.

The race browser and editor

  • The race list searches and sorts. One icon opens a name box that filters as you type, another
    cycles the order between A–Z, Newest and Oldest. Closing the box clears the filter, so a hidden
    one can't make races look missing.
  • Drag start positions into order. The Start positions list has the same drag handles as the
    gates — the first is pole, so this is the grid order. In the lobby, manual placement still lets
    racers pick their own slot.
  • The start form's Phases button sits right under the format list.

Race fixes

  • Joining a race already under way takes you to its lobby, where the "ready up to start" button
    lives, instead of just closing the menu. The same for a hunt, an infected game or a derby.
  • A late joiner's next gate turns green. The route now also leads the way while they're still
    waiting to ready up, rather than leaving them a track of plain gates.
  • A race with collisions off ghosts everyone else, not you. The look is recomputed from the race
    itself, so swapping cars at the grid, rejoining in another one, spectating or another player's
    mid-race reset no longer leaves the wrong car solid.
  • A number typed past a slider's maximum is no longer lost. A race time of 86400 used to empty
    the box and fall back to three laps; a typed value is brought down to the maximum instead.
  • Older vehicle presets no longer refuse the right car. When a preset's captured parts don't
    match, its configuration is checked as the game has it today. Stock configurations match too.
  • Saving a race no longer claims the name is taken when it's the same race. Servers that ended up
    with two copies of each bundled race could save neither; extra copies are now cleaned up once, on
    the next start — only exact duplicates with no recorded times...
Read more

2.0.1

Choose a tag to compare

@foodcache3 foodcache3 released this 23 Oct 17:08

BeamJoy Revived 2.0.1

Derby arena turning and a round of fixes, including the launcher crash when someone saves a
vehicle preset.

Client build 2752, server build 2478. Built for BeamNG.drive 0.40 and BeamMP 4.23.1.
Both the client and the server changed: update both.

Updating: run bj update in the server console (or /bjupdate in chat as an owner), then
restart the server. Or by hand: place both the Client and Server folders into your server's
Resources folder, replacing Client/BJ.zip and the BeamJoyServer folder, then restart the
server.

New in 2.0.1

Turn a whole Derby arena

  • In the Derby arena editor, pick the Rotate tool with nothing selected: the gizmo sits on the
    arena's centre (its zone's centre, or the middle of its start positions without a zone).
    Turning it turns the whole arena when you let go: every start position and its facing, the
    zone, and every prop, including lines, curbs and painted lines.
  • With snapping on, everything keeps its height above the ground, and props that follow the
    ground are laid on it again. It's an ordinary edit until you save. Selecting a start position,
    the zone or a prop still rotates just that one.

Fixes

  • Launcher crash when another player saves a vehicle preset. Every game downloads the new
    preset's photos, and the server sent them faster than some connections could take, which could
    break a packet and close the BeamMP launcher. The server now sends at each player's own pace,
    and big messages from a game to the server are paced too.
  • Older vehicle presets refused the right car in races ("This race requires ..."). Presets
    saved before the parts check existed, or made stale by a game update, are now checked against
    the configuration as the game has it today, including the game's own stock configurations.
  • Error messages stayed on screen until the game was restarted (for example enabling an arena
    without 2 start positions). They now fade after 10 seconds.
  • Delivery HUD buttons were squashed: with the HUD focused, the "B to go back to driving" hint
    crushed Hold to abandon. It now sits on its own line.
  • No traffic while alone on the server, and traffic that stayed off until a restart. Each
    game now tops up its own share of traffic and parked cars every few seconds.
  • Console and chat commands couldn't find some players: names with characters such as -,
    (, [ or + only matched in their exact case. Names now match as plain text in any case, and
    by a guest's nickname. /votemap had the same problem with map names.
  • Bundled race authors: the bundled races credited to a guest account are now credited to
    BeamNG, and four Utah races to yep. New servers and servers updating from before 2.0 get the new
    authors.
  • The one-time bundled race sync now only runs for servers updating from before 2.0. A server
    that already ran 2.0.0 keeps its races as they are.

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. Th...
Read more

2.0.0

Choose a tag to compare

@foodcache3 foodcache3 released this 21 Oct 02:04

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 p...
Read more

1.10.7

Choose a tag to compare

@foodcache3 foodcache3 released this 09 Oct 21:05

Hotfix for 1.10.6. Client build 2495, server build 2355. Both the client and the server changed: update Client/BJ.zip and the server.

Spawn queue

  • The spawn queue is now only forced during the countdown of a race, hunt or infected round, when every grid car is (re)spawned at once. It used to stay forced for the whole round. Once the countdown is over, anything still queued is applied and the player's own spawn-queue setting is put back.
  • Fixed: leaving the server or quitting the game during a round left the spawn queue turned on in the player's game settings. It's now put back then too.

Fresh installs

  • Fixed: a fresh install's first boot could come up without its bundled races (and Hunter arenas, bus lines and the rest), depending on the order the server happened to start its modules in.
  • Fixed: on a fresh install, seeded content could be lost for good: saves into a data folder that wasn't created yet failed silently while the server recorded them as done. Missing data folders are now created when saving.

If a server already booted 1.10.6 or the first 1.10.7 fresh and came up without its bundled content, delete Resources/Server/BeamJoyData/db/bundledSeedLedger.json (and the empty db/activities folder) and restart.

1.10.6

Choose a tag to compare

@foodcache3 foodcache3 released this 24 Sep 18:45

Client build 2494, server build 2354. See CHANGELOG.md for the full, detailed history - this covers the headline items only. Both client and server changed: update the server too.

Day/night cycle

  • Night now runs from each map's real sunset to sunrise (the same astronomy the game itself uses), instead of a fixed 18:00 to 06:00.
  • New night speed slider (0.1x to 10x) in Config > Time & Environment, with a live readout of the real full-cycle length. The game's own day length limits (5 minutes to 24 hours) are always respected, and the slider says when that limits it.
  • The game's clock now runs itself at the right speed for day and night instead of being corrected every frame.
  • The calendar date is synced: a date picked by an admin applies to everyone (sunrise, sunset and the moon all depend on it).
  • Fixed pausing/unpausing or changing the day length teleporting the clock, sometimes a whole cycle in under a second.
  • Fixed the clock running on through a game pause (J) and snapping back afterwards.

Performance

  • Fixed a large hitch when opening the config window (also hit race and Hunter starts and a few vehicle lookups): the vehicle list was copying the whole vehicle database on every use, around 37 MB at a time.
  • Gravity sync and paused time of day no longer rewrite the game state every frame.

Other

  • The server now only accepts the environment fields it is meant to change from a client.
  • Removed the one time derby race migration from 1.10.5 (it already ran on any server that needed it).

1.10.5

Choose a tag to compare

@foodcache3 foodcache3 released this 24 Sep 05:14

Client build 2487, server build 2349. See CHANGELOG.md for the full, detailed history - this covers the headline items only.

Time of day

  • Redesigned around a server-pushed epoch instead of a per-tick value, so every client derives its own exact current time locally with no further network cost.
  • Fixed a shared native-table mutation bug, a client-side two-clock precision race, a server-side whole-second rounding bug, and the routine correction's own fixed-interval throttle, all confirmed contributing to visible jerk at high framerate.
  • Night sky and daytime shadows are now smooth. A separate noon-specific shadow issue was confirmed to be a native BeamNG bug, not this mod's.

Freeroam refuel and repair

  • Refuel amount now matches the vehicle's own tuned starting fuel level instead of always topping to max.
  • Refuel and repair both take a configurable duration with the vehicle held on the external camera.
  • The map's own vanilla gas stations now go through this same flow (self healing against level reloads), instead of instantly topping off with no hold.
  • A vehicle with no fuel type match for a station is rejected immediately with a clear message instead of running the full hold for nothing.

Other fixes

  • Race/Hunter/Infected lobby "Starting in Xs" countdown showed an inconsistent number instead of a real, always the same wait.
  • Race and Infected were missing a spawn queue auto flush that Hunter already had.

Bundled default content

  • Removed bundled gas stations and garages that duplicated a real vanilla facility at the same spot, on maps that ship them.
  • Added a one time migration that corrects two "derby" races on servers that seeded them before a later fix already in this release.
  • Removed the ks_nord_races.json bundled content.

Docs

  • README now documents three previously undocumented features: freeroam energy stations and garages, bus lines, and Infected mode.

v1.9.0 - Infected mode complete, full localization, reset-exploit fixes

Choose a tag to compare

@foodcache3 foodcache3 released this 09 Sep 17:49

Client v1.9.0, server v1.9.0. This release finishes the Infected gamemode and rolls up
everything since v1.8.67 into one numbered release. Deploy BeamJoyServer/ to your server,
not just the client mod.

Added

  • Infected mode, a new gamemode alongside Race and Hunter: a lobby of survivors (green
    nametags) starts with a random subset already infected (red nametags), who spread the
    infection by touching a survivor's vehicle; survivors win by outlasting a host-configurable
    round timer, infected win once every survivor is caught. Full in-world arena editor, lobby/join
    window with live roster and tag counts, countdown and in-round HUD, start-options panel, and
    legacy BeamJoy Free (BJI) import.
  • Infected results screen: a floating panel (matching Races' own Live/Results convention)
    auto-opens a few seconds after a round ends, showing every participant's time survived and how
    many others they personally infected, longest survival first.
  • Nickname login, until BeamMP's own account system is reliable again: a skippable prompt on
    connect lets a player pick a display name used for their nametag and race leaderboard entries.
    Nothing identity-critical (bans, mutes, permissions, chat) is affected.
  • Single /login <password> command for both staff and owner tiers (tried against the owner
    password first, then staff), replacing separate /staff//owner commands.
  • Race editor: "One-way gates" option, off by default. Off, a gate counts crossed in either
    direction, so a missed gate can just be backed through once. On, only a forward crossing counts
    (the prior hardcoded-only behavior).
  • Infected "Disable resets" and Hunter "Velocity-gated resets" arena options, both off by
    default, for hosts who want resetting shut off entirely rather than just speed-gated.
  • Infected/Hunter HUD: hold-to-confirm "Unstuck" button (5-second hold) that teleports the
    local vehicle to the nearest arena spawn point, a controlled escape hatch for a genuinely stuck
    vehicle without opening up the reset restrictions the round is otherwise enforcing.
  • Full translations for all 12 non-English locales, covering every string added throughout
    this release (previously fell back to English).

Changed

  • Race gates now render as just their left/right edges (two thin posts) during a live race
    instead of a solid filled quad, less visually cluttering with several gates on screen. The race
    editor and test-builder preview keep the solid quad.
  • Infected's reset policy reworked after live testing and cross-referencing BJI/the community
    "Outbreak" mod: recover_vehicle is the one reset method left reachable during a round, gated
    on vehicle speed and a brief post-reset relock; every other reset/recover/reposition path is
    blocked outright.
  • Hunter and Infected countdowns now extend through the post-countdown release delay instead
    of vanishing at 0 and freezing again with no visible timer.
  • Hunter/Infected arena editors split into Settings/Spawns(/Waypoints) tabs, matching the race
    editor's own layout instead of one long scrolling view.
  • Several verbose tooltips simplified to be shorter and more direct.

Fixed

  • The pause menu's Repair, Recover-to-road, and Flip-upright actions bypassed every reset
    restriction entirely, in Races, Hunter, and Infected
    - they call native functions directly,
    with no keybind or action-filter involved, so nothing in this codebase's restriction system ever
    saw them. All three now route through the same authorization every other reset type already
    goes through, gated per-gamemode exactly like recover_vehicle already was. A related gap (the
    same panel's "Reset" tile) is still open.
  • Infected's tag detection used a bounding-circle touch test, not an actual collision - a
    circle always overestimates a rectangular footprint, worst for long vehicles approached at an
    angle. Replaced with a real oriented-bounding-box overlap test on each vehicle's own footprint.
  • A logged-in nickname never showed up in the Races/Hunter/Infected lobby roster, live HUD
    opponent names, or race results/leaderboard panels
    - only the general player list and
    nametags resolved it. Fixed at the source and in every client-side template that was dropping
    the field along the way.
  • The pause-menu vehicle panel (Repair/Reset/Clone/Delete) stayed fully usable mid-race/mid-hunt
    in Races and Hunter
    , since neither ever blocked the two actions its own "can I use this panel"
    check depends on (only Infected did). Closed in both.
  • Traffic spawning could leave the loading spinner stuck on screen (until a full UI reload),
    worse with more players connected - an uncaught error partway through the spawn job skipped its
    own cleanup entirely, silently wedging every future traffic spawn too. The whole job now runs
    under a proper error guard.
  • Big Map wasn't actually blocked during Infected, unlike Races and Hunter (a fix that existed
    locally but was never deployed).
  • Vehicle switching mid-race was never actually blocked in Races, unlike Hunter/Infected.
  • Getting tagged (or otherwise respawning) in Infected could leave the camera stuck, unable to
    reach a working view again, traced to a native vehicle query going stale around vehicle-attach
    transitions.
  • Clearing one role's color in the Infected arena editor could bleed into the other role's
    color
    - a classic Lua and/or-as-ternary trap in the color lookup, found and fixed with an
    explicit if/else.
  • Several Infected/Hunter arena-editor save and lobby-join bugs: a rejected save silently left
    the editor showing an unsaved, inconsistent state instead of resyncing and reporting the real
    error; a lobby stayed joinable after its arena was disabled; a freshly (re)opened spawn-point
    list sat empty until some unrelated edit happened to trigger a refresh.
  • Traffic vehicles could brake to a stop the instant they spawned, or spawn overlapping
    another vehicle in multiplayer, or keep their headlights on while parked at night.
  • Assorted smaller fixes: a vehicle-preset dropdown crash on an empty list, a Legacy Import crash
    on an empty scan result, Infected's round timer never actually starting for 2-player test
    lobbies, and more - see CHANGELOG.md for the full list.

v1.8.67 - Race share codes, grid placement, traffic overhaul, crash fixes

Choose a tag to compare

@foodcache3 foodcache3 released this 01 Sep 15:49

Client v1.8.67, server v1.8.57. Server-side changes in this range need deploying to the live
server separately (see below); the client is a straight mod update.

Added

  • Race Share Codes. The race editor (Config > Races) now has "Copy Share Code" and "Import
    from Code" buttons, letting a race be exported as a compact BJRACE1:-prefixed text code
    (gzip + base64, entirely client-side, no bundled library) and imported back on any server. An
    imported race is never trusted further than one built from scratch: it still goes through the
    same server-side validation at save time. Races only for now, not Hunter arenas.
  • Race grid placement strategies, contributed by Bytestorm5 via
    PR #1. How starting slots are assigned
    when a race's countdown begins is now host-configurable: Join order, Random (new default), or
    Manual (drag/assign per player from the lobby list).
  • Native vehGroup.json traffic bundle support, so third-party curated traffic packs (e.g.
    regional/themed packs built on a shared model like simple_traffic) show up as selectable
    sources in Config > Traffic.
  • Per-source rarity weighting for traffic model/vehGroup selection, so a large vehicle pack no
    longer drowns out a small one purely by config count.
  • License plate controls for traffic (front plate usage, US/EU shape, plate design), ported
    from Agent's Traffic Tool.
  • Parked vehicles and "Smart Selection" for traffic: a separate parked-vehicle budget placed
    via real map parking-spot data, plus population/region-weighted selection matching native's own
    traffic behavior.

Fixed

  • Several real bugs in parked-vehicle placement that could land vehicles in the middle of the
    road instead of an actual parking spot, including a regression where the fix itself briefly
    disabled parked vehicles entirely, and a later one where large parked batches still got
    relocated onto the road by the moving-traffic rubberband tick mid-spawn.
    (client only)
  • Traffic could break entirely when a vehGroup's model name didn't contain "traffic" (e.g.
    SimpleNG's SNG_* line): affected vehicles were misclassified as the local player's own car,
    which also leaked a stuck traffic-settings lock. (client only)
  • Reduced traffic pop-in and fixed a throughput bottleneck that kept AI traffic sparse at high
    speed, matching native traffic's own spawn-search behavior more closely. (client only)
  • Hard game crash right after a race ends, caused by spawning the player's post-race vehicle
    back in synchronously from inside a network handler while the engine was still mid-frame on
    another vehicle's destruction. (client only)
  • Nametag rendering crash spam right after connecting, from indexing the local player's own
    record before the server's player-list push had arrived. (client only)
  • Manual grid-slot assignment silently reverted after being changed in the lobby, due to an
    Angular two-way-binding timing issue in the picker component. (client only)
  • Random grid placement never actually teleported anyone to their assigned start position,
    because the shuffle deep-cloned the participant list instead of shuffling it in place.
    (server only)
  • Hunter arena distance settings (reveal proximity, reset threshold, nametag fade) now actually
    round to the 10m increments their own tooltips promise, instead of only flooring.
    (server only)

Deployment

Server-side pieces of this release (traffic vehGroup/rarity/plates/parked vehicles, race grid
placement, Hunter distance rounding) need deploying to the live BeamMP server; the client mod
package is a drop-in update on its own.

v1.8.47 - Bundled races, branching-race fixes, worldspace editor fixes, repo renamed

Choose a tag to compare

@foodcache3 foodcache3 released this 27 Aug 19:33

19 builds since v1.8.28: bundled default content, several real bug fixes across racing, Hunter,
and Legacy Import, and this repo's rename to BeamJoy-Revived.

Repo renamed

This fork is now BeamJoy-Revived, to distinguish it from the original BeamJoy Sandbox it
started from. The in-game Settings window's GitHub link and the README were updated to match.
Internal code naming is unchanged.

Bundled default content

New Server/BeamJoyServer/bundledContent/activities/ folder ships default races and Hunter
arenas for 12 maps, auto-seeded into a server's live data on first boot per map, no admin action
required. Deliberately additive only: never overwrites or removes anything an admin has already
created, edited, or deleted, and a later mod update's new bundled content is picked up
automatically. Seeding outcomes (seeded, skipped as a duplicate, or a validation failure) are now
logged clearly to the console. A malformed bundled file (a stray trailing comma) was found and
fixed, and the JSON loader was hardened so a bad file can never again silently break race loading
for every map on that boot, just that one file.

Racing

  • Branching-race false-lap exploit fixed: crossing the start/finish line, backing up, and
    crossing it again with zero real progress no longer counts as a completed lap.
  • Legacy Import (BJI) gate rotation fixed, in two rounds: a multi-lane loop's start/finish
    gates could come in skewed from a bipartite-connection bug in the loop-closing rewrite, and
    even after that fix, gates could still come in rotated because the importer ignored BJI's own
    captured rotation data entirely in favor of a route-topology guess. Both fixed; re-run Legacy
    Import to pick up correctly-oriented gates for an affected race.
  • "Limit visible gates" now works for branching races, walking the actual parents graph
    breadth-first instead of the old linear-only computation.
  • Hunter/prey spawn-on-roof fix applied to races too: a vehicle teleport could land on top of
    a covering structure (an awning, a tunnel ceiling) instead of the authored position underneath.
  • A player's currently-selected vehicle now shows next to their name in the race lobby, the
    Hunter lobby, and both race info screens.
  • Maximum gate height increased from 15 to 30 (hard cap 60), matching gate width, including
    the in-viewport 3D drag handle that was missed in the first pass.
  • A gate (or Hunter arena point marker) can now be clicked to select in the world while looking
    steeply upward at it
    with open sky behind it, previously impossible since the underlying click
    hook only ever fired on an actual raycast hit.
  • "Multiplayer" is now the topmost start option, and starting a race from the Activities tab
    now hides every other race in the list while its options panel is open.
  • Promote/demote in the player list now actually broadcasts the new rank to every client. The race
    starter can now Leave, not just Retire or Cancel. Ghost mode no longer silently drops on a
    just-spawned vehicle that hadn't finished syncing yet. Editing parts/tuning after readying up now
    correctly un-readies you, in both race and Hunter lobbies. Race "Mandatory stop" (never actually
    implemented) removed outright rather than left as a non-functional stub.

Hunter

  • Arena editor's translate/rotate/snap-to-ground toolbar now actually stays pinned at the top
    while scrolling, matching the race editor (needed two rounds: a real layout split, then a fix
    for a CSS selector that never matched the real component name).
  • Shares the worldspace click-selection and vehicle-next-to-name fixes above.

UI and quality of life

  • Camera now auto-recenters when control is handed back after a race/Hunter countdown.
  • Big Map is now blocked at the actual native engine entry point during a race/Hunter lock, not
    just reactively via camera name, closing gaps the old approach couldn't (a quick-access menu
    path that bypassed it entirely).
  • Scroll-wheel-to-adjust removed from every slider (silently changed values when scrolling a
    settings page).
  • Welcome/intro panel supports a custom external image URL, with a folder-browse assist in the
    editor, not just the built-in image list.
  • Config > Core (including Legacy Import) is restricted to SetCore/owner rank only, closing a gap
    where an EditRaces/EditHunterArenas account could still reach it.

Server-side deployment note: this release's server files must be deployed to your BeamMP
server the same way as always, extract into your server's Resources folder. No update should
ever replace existing server or player data. Please have your players clear their cache before
launching.

v1.8.28 - Racing, Hunter, vehicle presets, voting, and full localization

Choose a tag to compare

@foodcache3 foodcache3 released this 25 Aug 15:17

Major update since v1.2.0, the biggest jump in this fork's history, bringing racing, Hunter,
vehicle presets, voting, teleportation, and a full locale expansion into one release.

Racing

Full grid-based racing (solo hotlapping and head-to-head): join/ready/leave/cancel/retire,
gate-crossing detection, lap and manual/automatic sector timing, DNF handling, configurable
respawn strategies, ghost backmarkers, a disable-collisions option, and configurable phase timers.
Includes an in-world 3D gate/start editor (translate/rotate gizmos, edge-resize handles, ground
snapping, reverse-race), persistent leaderboards (top 100 plus your own rank, new-PB/record
popups), a live race-info panel (standings while racing, results and lap breakdown after), and a
redesigned sim-racing-style HUD (live delta vs. your own best lap, position, gaps ahead/behind).

Hunter

New asymmetric hide-and-seek chase mode: one random player becomes the hunted fugitive, everyone
else hunts. Stuck-timer elimination, a three-trigger reveal system (proximity, final-waypoint,
post-crash), asymmetric grid release, native GPS routing plus an in-world beacon guiding the
fugitive, a hunter crash-reset penalty, and a staff force-fugitive tool. Has its own in-world
arena editor (built on a new shared point-list editor toolkit) and a Legacy Import tool that
converts an old BeamJoy Free (BJI) server's Hunter arenas and races straight into this fork's
format.

Vehicle presets

Admin-curated, shareable vehicle lists (captured model/config/parts/tuning) usable to restrict a
race or Hunter session to one exact vehicle or a host-picked pool, with matching that tolerates
post-spawn paint and tuning changes.

Voting and moderation

Map voting (/votemap) and vote-kick (/votekick), both with configurable thresholds/timeouts
and a live status panel. New chat commands ported from BeamJoy Free plus this fork's own
additions (moderation, teleport, race). /help only lists what the caller actually has
permission for.

Teleportation

Self-teleport to another player (rate-limited) and a moderator-relayed "summon", plus /tp/
/tpfrom chat command equivalents.

Internationalization

Every client (12) and server (7) translation brought up-to-date with the English source.

UI and quality of life

Draggable/resizable windows, faster UI animations, configurable respawn-ghost protection and a
global collisions mode, safe zones, and a long tail of bug fixes across every system above (see
this fork's own commit history for the full detail, this release closes roughly 224 builds of
work).


Server-side deployment note: this release's server files must be deployed to your BeamMP
server the same way as always, extract into your server's Resources folder. No update should
ever replace existing server or player data. Please have your players clear their cache before launching.