Halloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsSlow PC?RecommendedPC slow today? Run a repair scan before it gets worseResolve common Windows issues and optimize system performance.Scan NowHalloween DealsAmazon USOctober picks are moving - compare before checkoutAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
World desk9 min

How to Install Plugins on a BeamMP Server

Put each BeamMP server plugin in its own Resources/Server/ folder, keep required Lua files at the top level, restart the server, and use the console and Server.log to diagnose path or version errors.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

To install a BeamMP server plugin, place the plugin in its own folder under Resources/Server (or the directory specified by ResourceFolder in ServerConfig.toml), then restart the server and check its console. For example: Resources/Server/MyPlugin/main.lua.

BeamMP treats Lua files in a plugin’s top-level folder as automatically loadable. Lua files buried in subfolders are not automatically loaded unless the plugin code explicitly imports them. The most common installation failures are therefore an incorrect resource path, a missing top-level .lua file, a plugin written for a different server-generation, or an error visible in the server log.

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

What you need before installing a plugin

You need an initialized BeamMP server, access to its files, and a plugin that supports the major server version you are running. The official setup documentation covers both Windows and Linux. Start the server once before copying plugins: that first run creates ServerConfig.toml and the resource directory used by the server.

Home hosting does not require hosting fees, while the BeamMP setup guide describes VPS hosting as easier and more secure. That choice affects where you perform the file operation, but not the plugin directory structure.

#1 Best Overall
Sale
TOZO A1 Wireless Earbuds Bluetooth 5.3 Light Weight in Ear Headphones | IPX5 Waterproof,2 Mics for AI Calls,Immersive Premium Sound Bass Headset with Charging Case,32 EQ via App Black
  • [Ultra-Lightweight Ear Buds Designed for Small Ears] Each earbud weighs only 3.7g and features a compact, ergonomic in-ear design made especially for small ears. Secure, low-profile, and comfortable for workouts, all-day wear or overnight sleeping.The ultra-slim profile sits flush in your ear with no hard edges poking or rubbing, so you can even sleep on your side without discomfort.
  • [Immersive Stereo Sound with TOZO OrigX Technology] TOZO OrigX tuning delivers clear vocals, balanced mids, and natural stereo sound for music, podcasts, and videos.
  • [Long Battery Life for Daily Use] Get up to 7 hours of playtime on a single charge, with up to 32 hours total using the charging case—ideal for workdays, commuting, and extended listening sessions.
  • [Bluetooth 5.3 & Stable Connection] Bluetooth 5.3 provides fast pairing, stable wireless performance, and reduced dropouts as you move around home or office.
  • [Deep Bass with Clear Vocals] High-performance drivers produce punchy bass while keeping vocals clean and detailed for everyday listening.
  • A working BeamMP server installation and its Windows executable or Linux server binary.
  • A generated ServerConfig.toml file.
  • The server’s configured resource directory, normally named Resources.
  • A plugin package containing Lua files and any instructions or configuration files supplied by its author.
  • The plugin’s target BeamMP server version, particularly if you are using a 3.x server.

Understand the BeamMP resource folders

BeamMP separates server-side Lua plugins from client-side mods. Put server plugins in Resources/Server. Put client mods, which are ZIP files sent to players, in Resources/Client. A client mod is not a substitute for a server plugin.

Content Correct location What BeamMP does with it
Server plugin Resources/Server/<PluginName> Loads Lua files from the plugin’s top-level directory when the server starts.
Client mod Resources/Client Sends ZIP mods to connecting players.
Lua file in a plugin subfolder Any subfolder below the plugin directory Does not load automatically; the plugin must import it with require() or another documented mechanism.

The 3.x scripting reference defines a plugin as having its own subfolder in Resources/Server. The server manual likewise describes each folder in that directory containing at least one Lua file as a plugin.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Find the active resource directory

  1. Open the directory containing your BeamMP server binary and ServerConfig.toml.
  2. Open ServerConfig.toml in a plain-text editor.
  3. Find the ResourceFolder setting.
  4. Use the directory named by that setting as the starting point for the plugin path. If it points to Resources, the final path is Resources/Server/<PluginName>.

Do not assume that a second Resources directory elsewhere on the machine is active. A plugin copied into an unused folder will never be seen by the server, even if its files are otherwise correct.

Install a BeamMP server plugin step by step

1. Initialize the server

If this is a new installation, launch the BeamMP server once and allow it to create ServerConfig.toml and the resource folders. Stop it before making structural changes if you prefer a quiet console, then continue with the generated directory.

2. Confirm the configured resource folder

Read ResourceFolder rather than relying on the folder name shown in an installer or download archive. A custom value changes the first part of the path, but not the required Server/<PluginName> structure.

Rank #2
Sale
Smart Watch for Men Women Compatible with iPhone Samsung Android Phone 1.69 inch Full Touch Screen IP68 Waterproof Bluetooh Fitness Tracker Heart Rate/Sleep Monitor (Black)
  • 【IP68 Waterproof Multifunctinal Smart Watch】Torjalph fitness activity tracker smart watch is IP68 waterproof technology ,you can wear it when swimming,handwashing,it's rain-proof which means that you perform multiple exercise modes outside without worrying about sweat or rain corroding your fitness smart watch,and this watch equipped with a 230 mAh large capacity battery magnetic charging ,and this sports activity tracker watch can be used 5-7 days If fully charged.
  • 【Larger 1.83'' Full Screen Watch & Multi-dial Selection】1.83 inch full HD color touch screen smart watch for men / women provides excellent 240*284 resolution image quality ,This Bluetooth smart watch offers a better touch experience and remarkable immersion and ,more than 200 watch faces for you to choose from App"Da Fit ", you can change the dial style according to your mood to wear keeping the world on your wrist
  • 【Accurate Activity Tracker Smart Watch 】sports watch activity tracker uses sweat and dust resistant breathable silicone strap, our Fitness Tracker Smart Watch for Android iOS Phones supports 12 sports modes,walking,running,bicycle,swimming,badminton,basketball,football,rope skipping. This bluetooth calls smart watch for men women is lightweight and stylish, bringing more convenient and relaxing sports experience while also providing more protection.
  • 【Your 24 Hour Personal Daily Health Monitor】Fitness watch for women men full touch screen IP67 waterproof bluetooth smartwatch for Android iOS Phones with heart rate blood pressure monitor multifunction Andriod smart watch with steps counter sleep monitor sports fitness watch, monitoring blood oxygen saturation allows you to understand your physical condition in real time to track fitness progress ,to know your health status in time.
  • 【More Functions Bluetooth Call Smart Watch】This fitness activity smart watch full screen for iPhone and Android phones includes a bunch of new features including:The bluetooth smart watch can hang up the phone, receive and display WhatsAPP /Text /Facebook /Twitter /Messenger reminder.Support sedentary reminder, alarm clock, stopwatch, timer,weather information,music control, remote camera control compatible with Android 5.0 and above or iOS 9.0 and above smartphones.

3. Create one folder for the plugin

Inside the configured resource directory, create a Server folder if it does not already exist. Inside Server, create a separate folder for the plugin, such as MyPlugin. Every installed plugin should have its own folder; do not merge unrelated plugins into one directory.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

4. Copy the plugin’s top-level Lua files

Copy the plugin’s main .lua files directly into its own folder. A minimal installation looks like this:

BeamMP-Server/
├── BeamMP-Server.exe (or Linux server binary)
├── ServerConfig.toml
└── Resources/
    ├── Client/
    └── Server/
        └── MyPlugin/
            └── main.lua

The names can differ, but the depth matters: main.lua must be directly inside MyPlugin for automatic discovery. If the download includes an extra wrapper directory, open it and place the actual Lua files in the plugin folder rather than copying the wrapper as the plugin itself.

5. Handle supporting files according to the plugin’s instructions

Some plugins include libraries or other Lua files in subdirectories. BeamMP does not automatically load those nested Lua files. Keep them in subfolders only when the plugin code is designed to load them with require() or another documented method. Moving every file to the top level can break a plugin that expects a particular internal layout.

6. Start or restart the server

Start the server and watch the console while it discovers and executes the plugin. The server manual documents hot reloading for changed Lua files, but the scripting reference notes that some current 3.x versions do not track files added after startup. A full restart is therefore the dependable activation step after adding a new plugin or adding new Lua files.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
New Bee Guitar Cable 10ft Electric Instrument Bass AMP Cord
  • [Low Noise High Fidelity] New bee guitar cord with 22AWG oxygen-free-copper center conductors provides enhanced signal transfer, the PVC insulation material and the high-density stranded copper double shield provide noise rejection for quiet operation
  • [Ideal for Choice] New bee 1/4 straight and right angle metal connectors, ensures a secure connection in any instrument, pedal, or amp jack. L shape great fro on stage guitar stands
  • [Wide Compatible] Suitable for mixer, power amplifier, microphone, effector, decoder, equalizer, electoronic organ, electric guitar, electric bass and other electronic equipments. Widely used in the installation of smart home, karaoke speaker, professional stage audio, etc
  • [Easy Disassemble] Making incidental repairs quick and easy! Very nice, flexible cable
  • [Dont Hesite to Order] 24 hours customer services and professional technology team are standing by

7. Confirm successful loading

Look for the plugin’s startup output, expected commands, or other behavior described by its author. If there is no indication that it loaded, inspect the console and Server.log before changing files at random. A clean server start without plugin output does not prove the plugin is installed correctly; the plugin may simply be silent.

Server plugin versus client mod

Choosing the wrong resource type is a common cause of “the plugin does nothing.” Server plugins run on the BeamMP server and are Lua folders. Client mods are ZIP files distributed to players. Some features require both sides: the server component may be a Lua plugin, while client-side behavior additionally needs a Lua client extension and a modScript.lua file as described in the official server-side documentation.

Question Server plugin Client mod
Where is it installed? Resources/Server/<PluginName> Resources/Client
Typical package form A folder containing one or more Lua files A ZIP file
Where does it run? On the BeamMP server On the player’s game client after distribution by the server
Automatic discovery rule Each plugin folder needs at least one top-level Lua file Client resources follow the client-mod packaging rules
Can it require the other type? Some features also need a client extension or modScript.lua It cannot replace server-side Lua logic

BeamMP 3.x compatibility matters

BeamMP Server 3.0.0 introduced drastic changes to the Lua plugin system. Old Lua plugins cannot necessarily be used unchanged with a new server. Before installing, check the plugin’s stated target server version and any migration notes. If an author provides separate releases for pre-3.x and 3.x servers, choose the one matching your server rather than trying to repair an incompatible package by moving files.

Version compatibility is separate from folder placement. A plugin can be in the exact correct path and still fail because it uses an API or loading behavior removed by the 3.x changes. When the console reports an API, syntax, or runtime problem immediately after startup, compare the plugin’s supported version before troubleshooting the filesystem further.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Why a BeamMP plugin is not loading

The folder is in the wrong place

Re-read ResourceFolder in ServerConfig.toml, then verify the complete path is:

Rank #4
BSIMB 15.6" Digital Family Calendar & Chore Chart, No Subscription Fees
  • Digital Family Calendar: BSIMB digital calendar wall touch screen puts an end to your chaotic life. Designed for busy families, the digital calendar keeps you organised and in step with your family. Assign different colours and tasks to each family member to make family scheduling easier and more intuitive.
  • Easy Setup and Auto-Sync: Plug in, connect to WLAN and auto-syn your electric calendar in minutes. Digital wall calendar compatible with Google calendar, iCloud calendar, Outlook calendar, Cozi calendar and Yahoo calendar. Add events directly on the device or through the ecalendar app. Electronic calendar stays current whether you're at work or traveling—no manual updates needed.
  • All-In-One Home Assistant: Smart calendar builds habits and encourage independence with personalised chores. Display daily meal plan to reduce the daily ‘What's for dinner?’ stress. To-do lists keep track of everything you want. Turning chores into valuable achievements with stars and rewards, making life easier and more enjoyable.
  • Manage Anytime Anywhere: BSIMB electronic calendar for family stay connected with the powerful ecalendar app. Access and manage your digital wall calendar anytime, anywhere with free features like stars & rewards, photo screensaver, chore charts, meals plans, to-do lists etc. Electronic planner paid features like Magic Import tailor advanced tools for users with special needs.
  • Stay in Touch with Loved Ones: Share photos or videos from your phone to electronic wall calendar with app, instantly update your life moment, and keep in touch with your family, especially those who are far away; you can also surprise your smart calendar digital wall by sending him a wish card; it's also great for keeping tech-illiterate elders in touch with the youngsters.
<ResourceFolder>/Server/<PluginName>/<file>.lua

On Windows, check that the file extension is really .lua and not a hidden extension such as .lua.txt. Also check capitalization and spelling when working on a case-sensitive Linux filesystem.

The Lua file is nested too deeply

BeamMP’s automatic loader looks in the plugin’s main directory. This will not be discovered automatically:

Resources/Server/MyPlugin/scripts/main.lua

It can work only if the plugin’s code explicitly imports that file. For an ordinary single-file plugin, the reliable layout is:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Resources/Server/MyPlugin/main.lua

The plugin was added while the server was running

Changed Lua files may be hot-reloaded, but newly added files are not tracked in some current 3.x versions. Stop and restart the server after copying a new plugin, creating a new top-level Lua file, or changing the plugin’s folder structure.

The package targets another server generation

Check the release notes or installation instructions for the plugin’s supported BeamMP version. The 3.x Lua-system changes mean that a legacy plugin may require a port or a different release; copying it again will not resolve an API incompatibility.

The server reports a Lua or path error

Read the console output and Server.log. Separate the symptom from the cause:

  • A syntax error points to invalid Lua in the plugin or one of its loaded files.
  • A runtime or API error commonly indicates a code problem or server-version mismatch.
  • A path or module error usually means a supporting file is missing, in the wrong subfolder, or not imported using the mechanism the plugin expects.
  • No output at all generally warrants checking the resource path, top-level file placement, and restart status first.

Fix one reported error at a time, restart, and read the newest log output. Avoid copying a second version of the same plugin into another folder: duplicate installations make it difficult to know which files the server is reading.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Players cannot connect after setup

If the plugin appears to load but players cannot connect, investigate networking separately from plugin installation. The BeamMP FAQ identifies forwarding the configured server port for both TCP and UDP as a requirement in common setups; the commonly used default is port 30814. Confirm the actual port in your configuration and forward that port on the router or firewall for both protocols. A connection failure does not by itself indicate that the Lua plugin path is wrong.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

How to evaluate a plugin before installing it

There is no universal official ranking of BeamMP plugins. Evaluate a candidate against the server and community you actually operate:

  • Major-version compatibility: verify support for your BeamMP server generation, especially 3.x.
  • Server-only or client-dependent design: determine whether players also need a client ZIP, a Lua client extension, or modScript.lua.
  • Installation complexity: note whether it is a single top-level Lua file or a package with required subfolders and configuration.
  • Configuration requirements: identify required entries in configuration files, permissions, commands, or other documented setup steps before enabling it on a live server.
  • Maintenance activity: prefer a package whose release information and compatibility notes are kept current with the server versions you use.
  • Performance and resource impact: consider how often it runs and what it does for every connected player; the official documentation does not publish a universal performance rating, so treat the plugin author’s measurements and your own logs as separate evidence.
  • License: confirm that its license permits your intended private, community, or commercial use.

A repeatable installation and update workflow

  1. Record the BeamMP server version and the plugin version before changing files.
  2. Read the plugin’s own compatibility and configuration instructions.
  3. Confirm ResourceFolder and create exactly one directory under Server for the plugin.
  4. Place the required top-level Lua file or files in that directory, preserving documented subfolders for imported support files.
  5. Restart the server after adding the plugin or any new Lua files.
  6. Watch the startup console and inspect Server.log for syntax, runtime, module, or path errors.
  7. Test the feature with a controlled connection before making the plugin part of a larger server setup.

For later edits, remember the distinction between changing an already tracked Lua file and adding a new file. Hot reload may handle the former, while a restart remains the safer choice for the latter and for any structural change.

Folder checklist

  • ServerConfig.toml exists and has been read.
  • The active ResourceFolder is known.
  • The plugin has its own folder under ResourceFolder/Server.
  • At least one required .lua file is directly inside that plugin folder.
  • Nested Lua files are present only when the plugin explicitly loads them.
  • The plugin release matches the BeamMP server’s major version.
  • The server was restarted after the new files were copied.
  • The console and Server.log were checked for errors.
  • Client ZIPs, when required, are in ResourceFolder/Client rather than the server-plugin folder.
  • Port forwarding is checked separately if players cannot connect.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Windows Errors? Fix Them Before They SpreadFree repair scan
Crashes, No Sound, or Screen Glitches?Free driver scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.