Skip to main content

​
Scripting Your Virtual Environment

BeamMP (BeamNG.drive Multiplayer) provides a strong server-side logic framework using the Lua programming language. This extensibility allows administrators and developers to architect complex community experiences - ranging from simple automated welcome messages and chat moderation to sophisticated race timing systems and dynamic event management. By mastering the native technical hooks, you can transform a standard driving lobby into a unique and highly interactive gaming ecosystem.

Difficulty

Intermediate

Time

10 Minutes

​
Technical Infrastructure: The Server Registry

All server-side logic resources are situated within a centralized repository on your FREAKHOSTING instance.
  • Primary Directory: /Resources/Server/

​
Architecting Your First Resource

1

Initialize the Container

Using the Game Panel File Manager, create a new folder within the Server directory (e.g., freak_event_manager).
2

Establish the Entry Point

Inside your new folder, create a file named precisely main.lua. This is the authoritative file the engine searches for during initialization.
3

Implement Event Hooks

use the native BeamMP event library to trigger your logic.
function onPlayerJoin(playerID)
    Chat.send("Welcome to the FREAKHOSTING Rally Event!", playerID)
end

​
Strategic Functional Capabilities

The BeamMP API allows for complex interaction between the server node and individual player clients.
use Chat.send to communicate with the entire server or target specific participants using their playerID. This is essential for notifying the community of upcoming restarts or event rules.
Every Lua script executed on the server consumes CPU cycles on the primary game thread. To ensure your server maintains its physical simulation integrity, avoid using tight while true do loops without appropriate Wait intervals. Unoptimized scripts are the primary cause of “Server Hitching” in the BeamMP environment.
For a complete registry of all available functions and variables (e.g., onVehicleSpawn, onChatMessage), we recommend consulting the official BeamMP Developer Wiki.

​
Need Extra Help?

If you encounter any issues, our support team is ready to assist:

​
Save on Your Hosting

Ready to get a new server? Use code KB20 at checkout for 20% off your first month!
Last Updated: January 2026 | Scripting: Unleash your creativity.