Halloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PCHalloween DealsAmazon USOctober picks are moving - compare before checkoutAmazon US: current deals, useful picks and tech finds.See Picks×
FREEDOM251

Freedom251 › Blog › BeamMP

How to Manage a BeamMP Server: Admins, Bans and Commands

By Freedom251 Team · · 11 min read

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

Manage a BeamMP server by running the current ServerConfig.toml configuration, installing a server-side Lua moderation plugin, and administering players with identifier-based permissions. The baseline BeamBase plugin provides player listings, identifiers, chat controls, kick and ban commands; community plugins can add roles, unbans, IP bans and temporary sanctions.

This guide covers first launch, configuration, admin setup, moderation, ban-file recovery, public networking and the practical choice between hosting at home and using a VPS. Command names and permission behavior are plugin-specific, so verify the README and version of every plugin you install.

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 administering a server

Prepare these items before inviting players:

  • A Windows or Linux machine running the BeamMP-Server build.
  • A dedicated server folder and a predictable working directory.
  • A valid BeamMP authentication key when the server will be publicly listed.
  • A configured listening port between 1024 and 65535. The port must be unique on that host.
  • A server-side plugin such as BeamBase for the documented baseline commands.
  • Administrative access to the machine, firewall and (for home hosting) router.

Keep the authentication key private. Treat moderation plugins as code with server access: install only versions you can inspect and maintain, and back up their data before upgrades.

Install the server and generate the current configuration

  1. Create a server directory, such as BeamMP-Server, and place the BeamMP-Server executable in it.
  2. Open a terminal or command prompt in that directory and launch the executable once. The first run creates ServerConfig.toml, log files and a Resources directory in the process working directory.
  3. Stop the process after generation, then open ServerConfig.toml in a text editor that preserves plain text.
  4. Set the general options, save the file, and start the executable from the same working directory.
  5. Install server plugins under Resources/Server. A plugin normally has its own folder containing one or more Lua files.

The former Server.cfg format is no longer used. It is incompatible with TOML, so renaming an old file or copying its syntax into the new configuration will not work.

#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.

Configure ServerConfig.toml correctly

ServerConfig.toml is TOML, not an INI file. Preserve section names, equals signs, quotation marks and Boolean values exactly as TOML expects. A representative general configuration includes the following keys; your release may expose additional options.

Key Purpose and practical guidance
Port Listening port for the server. Use a value from 1024 through 65535, and do not reuse a port already bound by another process.
AuthKey Associates a public server with the BeamMP backend. Keep it secret and replace it if it is exposed.
AllowGuests Controls whether players who are not on an allowlist can join.
LogChat Enables chat logging for moderation and incident review. Check local privacy requirements before retaining logs.
Debug Enables additional diagnostic output. Use it while troubleshooting, then return to normal logging if the volume is excessive.
IP Address on which the server listens. Leave it at the documented default unless the host has multiple interfaces and you need to bind a specific one.
Private With true, the server does not appear in the public server list. Setting it to false allows listing when the key, network and other requirements are valid.
InformationPacket Controls the information advertised to clients and the server listing.
Name Displayed server name. The BeamMP manual states a maximum of 250 characters.
Tags Search and classification tags. The documented limit is 100 characters.
MaxCars Maximum cars permitted per player or session according to the server version’s interpretation.
MaxPlayers Connection limit for the server. Choose a value your CPU, memory and upload bandwidth can sustain.
Map Default map identifier. The manual lists a 100-character limit.
Description Longer server description shown to prospective players. The documented limit is 1,000 characters.
ResourceFolder Location used for server resources when you need a custom resource layout.

Change one setting at a time while diagnosing a startup problem. A malformed quote, a missing equals sign or a value copied from the obsolete configuration format can prevent the server from starting; the console and log normally identify the line to correct.

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

Use environment variables when you need repeatable deployments

From server release 3.2.0, environment variables can override general settings. Convert a PascalCase key to uppercase and prefix it with BEAMMP_: Port becomes BEAMMP_PORT, Name becomes BEAMMP_NAME, and AuthKey becomes BEAMMP_AUTH_KEY. This is useful for service managers and containers because the secret and port can be supplied outside the file. Run ./BeamMP-Server --help to see command-line options supported by your build.

Find the real working directory and resource folders

The executable’s physical location does not determine where files are created. BeamMP documentation specifies that the process working directory controls the locations of ServerConfig.toml, server logs and Resources. If a service manager starts the binary from another directory, you may be editing a configuration that the running process never reads.

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.
  1. Stop the server.
  2. Identify the directory from which the service, shortcut or terminal launches it.
  3. Look there for ServerConfig.toml, logs and Resources.
  4. Start the server with that directory set as the working directory, or deliberately move the files and update the service definition.

Server Lua plugins belong in Resources/Server. A typical layout is Resources/Server/BeamBase/main.lua. Top-level Lua files are hot-reloaded when changed, but client resources are ZIP files loaded when the server starts. Restart after installing or updating a client resource and after any plugin whose README does not explicitly support hot reload.

Add administrators with stable BeamMP identifiers

Do not authorize staff solely by display name: players can change names, use look-alikes or collide with another name. BeamBase keeps an admins table of BeamMP identifier type/value pairs and uses a checkAdmin function to compare a connecting player’s identifiers against that allowlist.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  1. Start the server with BeamBase installed.
  2. Join with the account that should become an administrator.
  3. Run /id or /identifiers to display your identifier values. An optional player ID lets an existing administrator inspect another connected player.
  4. Copy the identifier type and value into the plugin’s administrator table using the syntax required by that plugin version.
  5. Save the Lua file and reload or restart the server as documented by the plugin.
  6. Test a protected command from the new account and from a normal account. A non-admin should receive an “Insufficient Permissions” response.

Use /players to map the temporary player ID shown in commands to a current name. Player IDs can change after reconnects; identifiers are the durable value for an allowlist.

BeamBase command reference

The following commands are documented by the BeamBase implementation. They are not guaranteed to exist, or to use the same arguments, in another moderation plugin.

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
Command Use Permission and notes
/help Displays commands exposed by the plugin. Usually available to everyone; output depends on the installed version.
/players Lists connected player IDs and names. Use the ID from this list for moderation actions.
/say <message> Sends a server message. Use for maintenance notices and rule reminders.
/id or /identifiers Shows your identifiers; an optional player ID inspects another player. Restrict detailed identifier output to trusted staff.
/allowGuestChat Controls whether guest users may use chat. Admin-protected in BeamBase.
/allowGuests Controls whether guest users may join. Admin-protected in BeamBase.
/kick <id> <reason> Disconnects the selected player and broadcasts the kick and optional reason. Admin-protected; quote or omit the reason according to the plugin’s parser.
/ban <id> <reason> Records identifiers, disconnects the target and broadcasts the ban and optional reason. Admin-protected; BeamBase refuses to ban another recognized administrator.

Run /help in the live server rather than relying on a copied command list after an update. Third-party plugins may change target syntax, add role checks or reserve commands for a named role.

Kick and ban a player safely

Use a kick for a reversible incident

  1. Run /players and confirm the target’s current ID and name.
  2. Use /kick <id> <reason>, keeping the reason factual and short.
  3. Record the time, player identifier and reason in your private moderation log if the incident may recur.

BeamBase calls the server drop function, announces the kick and includes the supplied reason. A kick does not add the player’s identifiers to the ban list.

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

Use a ban when reconnection should be blocked

  1. Confirm the target with /players and, where appropriate, inspect identifiers with /id <id> or /identifiers <id>.
  2. Run /ban <id> <reason>.
  3. Verify the player is disconnected and that the ban entry was written.
  4. Keep a dated record of the reason and staff member who applied it.

BeamBase obtains the target’s identifiers, refuses the action if the target is a recognized administrator, drops the player, appends the identifiers to its bans file, stores them in memory and broadcasts the ban. Identifier matching is more resistant to display-name changes than name-only moderation.

Locate the bans file and recover from a mistaken ban

Ban storage is implementation-specific. In the cited BeamBase source, initialization builds a path under Resources/Server/<plugin>/bans.txt, while the ban handler also opens bans.txt for append. This means the effective path depends on the plugin version and working directory. Do not assume that every moderation plugin uses the same filename or folder.

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.
  1. Stop the server before editing moderation data.
  2. Check the running plugin’s README and source for its exact bans path.
  3. Resolve that path relative to the process working directory, not merely the executable’s folder.
  4. Back up the file before changing it.
  5. Remove only the exact identifier entry for the player who should return, preserving line endings and the file’s format.
  6. Start the server and test with that account.

The BeamBase command set does not document an unban command. If you require in-game unbanning, install a moderation plugin that explicitly supports it rather than inventing a command. Nickel, for example, documents unban <targetname>, but that command belongs to Nickel and is not a universal BeamMP feature.

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

Optional role and moderation plugins

Community plugins can provide a broader policy model than the baseline admin table. Nickel documents commands including ban, banip, tempban, kick, mute, tempmute and unban. It also documents /grantrole administrator <username> and /listroles.

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

These are plugin-specific commands, not official BeamMP commands. Before deploying one, check:

  • Which identifier types it stores and whether an IP address is retained.
  • Whether temporary bans survive a restart and how expiration times are represented.
  • Where bans, roles and audit data are written.
  • Whether its command parser accepts player IDs, names or both.
  • Its BeamMP compatibility, maintenance history and release notes.
  • Whether its permissions prevent one administrator from silently granting excessive access.

Do not run two plugins that both intercept the same command unless their documentation explains the interaction. Conflicting handlers can produce duplicate messages, inconsistent bans or a permission check being bypassed.

Make a home-hosted public server reachable

Home hosting has no hosting bill, but a public server must be reachable from the internet. Forward the configured BeamMP port on your router to the host’s private address and allow it through the host firewall. BeamMP’s FAQ specifically says to check both TCP and UDP forwarding when players see connection errors 10060, 10061 or 10038.

  1. Give the server computer a stable local address, preferably with a DHCP reservation.
  2. Set the same port in ServerConfig.toml and in the router’s forwarding rule.
  3. Create forwarding rules for both TCP and UDP to that address.
  4. Allow the executable or port through the operating system firewall.
  5. Set Private = false only after local connectivity works and the authentication key is valid.
  6. Test from a different network, such as a phone hotspot. A test from inside the same LAN may succeed even when internet forwarding is broken.

Carrier-grade NAT, double NAT, changing public addresses and ISP restrictions can prevent inbound connections even when the router rule looks correct. In those cases, request a public address, place the forwarding rule on the upstream router, or use a VPS.

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

Choose between a home host and a VPS

BeamMP describes home hosting as free and VPS hosting as easier and more secure. The trade-off is not simply price: it is who handles routing, uptime, patching and exposure to the internet.

Consideration Home host VPS
Upfront cost No separate hosting fee, but you use household electricity and existing hardware. Recurring provider charge; size the instance for player count, mods and logging.
Network setup Requires router forwarding, firewall rules and a reachable public address. Usually requires only the provider’s firewall and the server’s listening port.
Uptime Depends on power, broadband and whether the host machine is available. Designed for continuous operation, subject to the provider and your maintenance.
Isolation The game server shares a home network with personal devices. A separate virtual machine limits the blast radius of a server compromise.
Maintenance You maintain hardware, operating system, router and backups. You maintain the guest operating system, BeamMP files, plugins and backups; the provider maintains the underlying platform.

For Linux, follow BeamMP’s recommendation not to run the server as root, with sudo, or as your personal account. Create a dedicated service account, give it ownership of only the server directory, and run the process through a service manager with an explicit working directory. This also prevents the working-directory mistake that causes configuration and logs to appear in unexpected locations.

Troubleshoot the failures players report most often

The server is not visible in the list

  • Confirm Private = false.
  • Verify that AuthKey is present and valid.
  • Check that the configured port is unique and within the documented range.
  • Read the startup log for authentication, binding or configuration errors.
  • Confirm that the process is using the directory containing the file you edited.

Players receive error 10060, 10061 or 10038

  • Check TCP and UDP forwarding for the configured port.
  • Confirm the host firewall allows both protocols.
  • Test from outside the home network.
  • Investigate double NAT or carrier-grade NAT with the ISP.
  • Verify that the server is actually listening on the expected interface and port.

An admin command returns “Insufficient Permissions”

  • Run /id and compare the account’s identifier type and value with the plugin’s admins table.
  • Check for whitespace, quotation or case errors in the Lua file.
  • Reload or restart the plugin after editing.
  • Ensure another plugin is not replacing the command or permission handler.

A ban does not survive a restart

  • Confirm the plugin can write to its resource directory.
  • Locate the actual bans file relative to the process working directory.
  • Check the log for file-permission or parsing errors.
  • Make sure you are testing the same plugin instance and configuration after restart.

The server starts but a resource is missing

  • Place server Lua files under Resources/Server, not in a client-only ZIP.
  • Check the folder and entry-file names expected by the plugin.
  • Restart for client ZIP resources, because they are loaded at server start.
  • Read the console for a Lua syntax error or dependency that loads earlier in the startup sequence.

Operate the server securely over time

  • Back up ServerConfig.toml, plugin folders and bans data before changing versions.
  • Keep the authentication key out of public repositories, screenshots and chat.
  • Use identifier-based administration and grant the smallest role needed.
  • Review the admin table and role list after staff changes.
  • Retain only the chat and identifier data you need for moderation, and protect those files.
  • Apply BeamMP and plugin updates in a staging copy first; confirm command syntax and data-file behavior before updating a busy server.
  • Watch disk usage when chat or debug logging is enabled.
  • Document the working directory, listening port, plugin versions and recovery location so another operator can restore the service.

With the current TOML configuration, a known working directory, identifier-based admins and a tested network path, routine BeamMP moderation becomes predictable: list the player, verify the identifier, apply the least severe command that fits the incident, and preserve the relevant record.

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.

BeamMPGame ServersLinuxLua pluginsnetworkingserver administrationWindows

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.

Recommended PC Tool
Recommended PC Tool
Outdated Drivers Are Slowing You DownFree scan - exact matches
PC Slower Than It Used to Be?Free scan - under a minute

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.