The main window
Everything a player does in BeamJoy happens in one window. It has two shapes — a rail with small side panels, and a full window with tabs — and the same content in both, so there is nothing to learn twice.
It is HTML rather than the game’s own interface, which means it is resizable, movable, and works with a controller.
Opening, hiding and moving it
Section titled “Opening, hiding and moving it”The rail sits down the right edge of the screen as soon as you join a BeamJoy server.
- Full opens the full window. Small goes back to the rail and panels.
- Hide puts BeamJoy away entirely. The F4 menu brings it back.
- Drag the logo to move the rail; double-click it to put it back.
- Hide the sidebar when not in use (Settings → Menu) tucks the rail away until you reach for it.
Hide is not always there. The server decides whether the window may be closed at all: staff keep it, and a host who has turned on ForceHud keeps it for everyone. When it is forced open the rail has no Hide button; otherwise the F4 menu toggles it and Hide closes it.
The rail
Section titled “The rail”| Rail item | What it opens |
|---|---|
| Now | Happening now. A badge counts what is running. |
| Play | Activities: everything you can start or join. |
| Crew | Your crew, and the crews on the server. |
| (a number) | The player list. The label is how many players are connected. |
| Vote | Start a map vote or a kick vote. Shown only if your group holds VoteMap or VoteKick. Anyone can still join a running vote with /votemap join. |
| Setup | Your own settings. |
| Full / Small | Switch shape. |
| Station / Refuel | Appears only when you are low on fuel. |
| Hide | Puts BeamJoy away. |
If you are staff, the rail says Staff under the logo. A server plugin can add up to four items of its own below Setup.
With the full window open, a rail item switches to that tab instead of opening a panel, and shrinking returns you to the panel for the tab you were on. The two shapes are the same thing.
The full window’s tabs
Section titled “The full window’s tabs”In order: Home, Activities, Crew, Players, Leaderboards, Settings. Staff get a Server config button beside them, which opens the separate configuration window.
A plugin’s own pages are inserted before Settings.
Three columns side by side: Happening now, Players, and You.
You starts with the car you are in, with the low-fuel button when you need it. Under it is your record on this server: your standing on the package and vehicle delivery boards (points and place, or Not ranked yet), arrests made and police escapes. Then shortcuts: a nametag toggle, Start a vote if you may start one, Change nickname if you joined as a guest, and the Welcome screen again if the server has one.
Happening now
Section titled “Happening now”Every lobby and every running game on the server, as rows you can act on:
- {name}’s race lobby, 3 of 12 — Join while there are open slots.
- {name}’s game, 5 playing — already under way, so Spectate.
- Your own row says You’re in this lobby or You’re playing, with Open.
- Delivery jobs has its own block: the nearest depot and its distance, how many convoys are forming, and Open jobs.
When nothing is running it says so, and offers Start an activity rather than leaving you on an empty list.
Activities
Section titled “Activities”The lists you start things from, in sections: Races, Bus Lines, Hunter, Infected, Derby and Jobs. Each list is per map — a race built on Italy does not appear on West Coast USA — and says so plainly when the map has none yet.
Picking a race opens its start menu; that whole flow is Your first race night.
A crew is up to 8 players who play together. When the leader opens a race, hunt, infected game, derby or convoy, every crewmate who is free joins it automatically.
| Create crew | Names it, optionally, and makes you the leader. |
| Open to anyone | On: anyone joins from the crew list. Off: they ask first, or you invite them. |
| Invite players | Also available from a player’s row in Players. |
| Make leader / Remove from crew | The leader’s own controls. |
Each member shows a status — Free, joins your activities, Busy, With you or Offline — so a leader can see who an invitation would actually pull in.
Players
Section titled “Players”Every connected player, with their rank and the vehicle they are in, or No vehicle if they are on foot. Your own row is marked you. Click a row to open it; opening another closes it.
A row’s actions depend on your permissions, not on the row: Invite to crew if you lead a crew with room, Spectate, Teleport to, Bring here, and Queue deleted vehicles to respawn for a player whose car was deleted, which anyone may use. Staff also see the player’s vehicles one by one (Freeze, Stop engine, Launch, Explode, Remove), and in the full window three buttons that act on all of that player’s vehicles at once.
The Players tab of the full window is the one with the moderation box for a player ranked below you: promote and demote, then a reason and a button each for mute, kick and ban, and a tempban that takes the ban reason and a length you set in steps. Everywhere else the row has a Moderate button that takes you there, with that player open.
Everyone’s vehicles, at the top of the Players tab for staff, acts in bulk — Freeze all, Unfreeze all, Stop all engines, Start all engines, Remove all — and states the limit out loud: acts on every player ranked below you. Removal asks twice (Press again to remove).
What any of this does, and who may do it, is groups and permissions.
Leaderboards
Section titled “Leaderboards”Five boards: Races, Deliveries, Derby, Drift and Drag. They survive restarts.
The drift and drag boards cover the game’s own drift spots and dragstrips as well as the server’s own, and will tell you if you have those turned off in your own settings — with a button to turn them back on, since an empty board is otherwise indistinguishable from a broken one.
Settings
Section titled “Settings”Your own settings, which affect your game alone. Six sections:
| Section | Covers |
|---|---|
| Menu | Rail auto-hide, Race HUD layout (Standard, Compact, Full standings, Disabled), plugin labels on the race HUD, activity overlay corner and offsets |
| Vehicle | Automatic lights, Lock my vehicles, Police chases (opting in or out) |
| Passive races | Whether driving through a passive race’s start gate puts you in it |
| Visual | Dust and particles, the two marker toggles, and Disable ghost transparency — ghosts stay solid instead of see-through. They are still ghosts |
| Nametags | Hiding, distance fade in either direction, shortening, a character limit, showing distance, showing spectators, and the colours for players, idle players and spectators |
| Free Camera | Smoothing, field of view, movement speed |
Markers have no heading of their own: Hide activity markers and Hide station and garage markers sit under Visual, beside dust and ghost transparency.
Nametag colours are kept on your own machine and follow you between BeamJoy servers.
Map Vote and Kick Vote, each with a search box. Thresholds and timeouts are the server’s to set, and a live status panel shows a vote in progress.
Cards beside the rail
Section titled “Cards beside the rail”BeamJoy does not interrupt you with dialogs. Things that want an answer arrive as cards next to the rail:
| Card | Buttons |
|---|---|
| {name} invited you to their race | Join, Dismiss |
| {name} opened a race lobby | Open lobby, Dismiss |
| Your crew joined {name}’s hunt | Open lobby |
| The derby is over: {name} won | Open results |
With a controller, the card tells you which button answers it.
Using a controller
Section titled “Using a controller”The whole window is navigable with a pad:
RB + X takes focus, after which the window is listening to the pad rather than the car. From there it is Move, Select, Back to the rail, Full window, Switch tab and Back to the side — and the window draws a footer naming whichever button currently does what, so the mapping is on screen rather than in a manual. Pressing back from the rail returns you to driving.
- Your first race night — the flow this window exists to run.
- Racing — the rules behind the race lists.
- Groups and permissions — why a row is greyed out for you.