⚠️ Disclaimer: BeamJoy only works with BeamMP. It does not run in singleplayer. This is why it’s posted in Content Creation / Programming instead of the Mods Repository. Hello everyone, I’m sharing BeamJoy, a multiplayer framework for BeamMP servers. I’m not the original creator — this post is published with the explicit permission of the developer Samaël (GitHub: my-name-is-samael). Quick links: GitHub • Releases (Download) • Basegame Maps Datapack • BeamMP Server Download • Discord • Patreon ✨ What is BeamJoy? BeamJoy is an all-in-one multiplayer framework for BeamMP servers. It provides: Player Moderation & Permissions Mute / Kick / Tempban / Ban • Vehicle freeze / teleport • Whitelist • Group-based ranks Organized Multiplayer Activities • Races (solo, time-trials, multiplayer) • Car-Hunt / Hunter (chaser vs runner, custom rules) • Deliveries (vehicle & package, solo or cooperative) • Bus Missions (routes with scoring, stops, passengers) • Destruction Derby (last car standing!) • Tag Duo (2v2 tag mode) • Infected (virus spreads on collisions) • Speed Game (drive above X km/h or lose!) Singleplayer Features in MP GPS navigation • Gas stations & garages • Interactive world markers • Waypoints • Time & Weather presets ⚙️ Quality of Life Custom nametags & chat • Ghost & respawn protection • Smooth freecam & FoV tools • Auto-headlights Theme editor • Vehicle selector with filters • Model blacklist Server Sync & Tools Sun, weather, gravity, sim-speed synchronization • Hourly environment presets Map switcher with voting • Reputation & XP system • Broadcast announcements Full in-game config menus (no file edits!) Technical (Dev-friendly) Modular structure • Events framework • Per-feature managers i18n (EN/FR/DE/IT/ES/PT/RU) • Improved client/server comms • Ready for database integration Inspired by CobaltEssentials (and its interface), BeamJoy is a brand-new codebase built after reverse-engineering BeamNG’s Lua side. Modular, clean, and extensible — a solid foundation for future MP features. Upcoming Features Development is active — stay tuned for frequent updates! Requirements & Notes BeamMP Server installed & configured — get it here: beammp.com Server-only: BeamJoy runs on BeamMP servers; not for singleplayer Languages included: EN, FR, DE, IT, ES, PT, RU How to install (Server) Install/prepare your BeamMP server → https://beammp.com/ (configure at least your AuthKey) Start the server once so it creates its folders/configs Download the latest BeamJoy release → GitHub Releases Unzip the mod into your server’s Resources folder (keep structure intact) Join your server from BeamNG In the server console, grant yourself permissions: bj setgroup <your_playername> owner (case-insensitive, partial match allowed) Starter Data (Basegame Maps Datapack) Download the Datapack (two variants: with / without race records) → Release page Extract into: Resources/Server/BeamJoyData/db/scenarii/ Restart the server (or switch map) → all vanilla maps + activities instantly available Tip: want clean leaderboards? Use the “no records” pack. ️ Adding a Modded Map Ensure your account has SetMaps permission Drop the map archive (e.g. [ICODE]ks_spa_v20230929.zip[/ICODE]) in Resources (not Client/Server subfolders) In-game: Config Menu → Server → Maps Labels Fill: Tech Name = ks_spa • Label = SPA Francorchamps • Archive = ks_spa_v20230929.zip Save → map appears in the vote switcher Note: switching modded maps restarts the server → use a watchdog/auto-restart. Links GitHub – BeamJoy (docs, features, FAQ) Releases (latest builds) Basegame Maps Datapack BeamMP Server (required) Discord • Patreon Closing words BeamJoy brings life into BeamMP multiplayer: activities, QoL tools, moderation, and soon tournaments. All credit goes to the original developer Samaël — I’m only sharing it here with permission. Feedback, contributions, or even just ideas are more than welcome.
