Driver FixRecommendedSound, Wi-Fi or graphics acting up? Check drivers firstFind missing or outdated drivers fast.Check DriversOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsClean PCRecommendedOne scan can reveal what keeps slowing WindowsLook for cleanup and repair opportunities.Run Scan×
Skip to content
World desk11 min

How to Use a MySQL Database on Your Minecraft Server

A practical guide to connecting Minecraft plugins to MySQL, from database creation and credentials to YAML configuration, LuckPerms setup, backups, security and troubleshooting.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

To use MySQL with a Minecraft server plugin, create a database and a restricted database user, record the host, port, database name, username and password, select MySQL in the plugin configuration, then save and restart the server. The workflow is consistent across most plugins, but configuration keys and file names vary by plugin and version.

What MySQL does for a Minecraft server

Minecraft plugins need somewhere to store data such as permissions, economy records, player settings, statistics or other persistent state. Many plugins can store that information in local files or an embedded database on the server machine. MySQL moves the data into a separate database service that the plugin reaches over a network connection.

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.

That separation matters most when more than one Minecraft server must read and write the same data. A network running behind BungeeCord, for example, can point its plugin instances at one database so permissions or other supported data are available consistently on every server. A database can also be useful for a data-heavy plugin, but it does not automatically make a small server faster.

Server situation Usually appropriate storage Reason
One small server with modest plugin data Default file, H2 or SQLite storage There is no need to operate a separate database service when local storage meets the plugin’s requirements.
Several servers sharing permissions or player data Remote MySQL database Each server can use the same central data store.
One server planning a future network MySQL after confirming plugin support The official LuckPerms guidance identifies a remote database as necessary for a network or a planned network.
A plugin with substantial or shared data MySQL if the plugin documents it The plugin’s own documentation determines whether MySQL is supported and which settings it requires.

MySQL is not a universal replacement for a plugin’s default store. A plugin must explicitly support MySQL, and its schema, migration process and connection settings are plugin-specific.

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

Information and access you need before configuring the plugin

Have these five connection values ready:

  • Hostname: the database server address, such as a host name or an address supplied by your provider.
  • Port: the TCP port exposed by the database service.
  • Database name: the individual schema the plugin will use.
  • Username: a database account created for this plugin or server.
  • Password: the password for that account.

You also need permission to create databases and users, or access to the game host’s database panel. The Minecraft server must be able to reach the database host over the network. If the database is on another machine, a firewall and the database service’s bind or access rules must permit the connection from the Minecraft server.

Do not plan to use the database administrator account in a plugin configuration. Create a separate account and grant it access only to the database it needs. This limits the damage if the server configuration is exposed.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

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

Create the database and a dedicated user

Using a managed game-host panel

Panel labels differ, but the process described by host guides is generally the same:

  1. Open the server’s Databases section.
  2. Choose NEW DATABASE or the panel’s equivalent.
  3. Enter a database name and create it.
  4. When the panel asks for connections from, leave that field empty if the Minecraft server itself should be allowed to connect, as described in the host setup guidance.
  5. Record the database host, port, database name, generated username and generated password exactly as displayed.

Some panels create the user automatically; others show a separate user-creation control. Use the account associated with this database rather than an account shared with unrelated applications. If the panel provides an allowlist of source addresses, use the Minecraft server’s address when you know it and understand the panel’s network model; an empty field has a different meaning on some hosts, so follow that panel’s own description.

Creating it on a machine you control

On a self-managed MySQL installation, create one database and one SQL account, then grant that account access to only that database. The MPDB guide uses mpdb as its database name; it is only an example name and can be replaced.

CREATE DATABASE mpdb;
CREATE USER 'minecraft_plugin'@'localhost' IDENTIFIED BY 'replace-with-a-long-password';
GRANT ALL PRIVILEGES ON mpdb.* TO 'minecraft_plugin'@'localhost';
FLUSH PRIVILEGES;

Run these statements with an administrator account in your SQL client. The host part of the user, shown as localhost, must match where the connection originates. If the Minecraft server is on a different machine, the database administrator must create an account whose host restriction permits that server, or use the hosting provider’s documented access mechanism. Do not copy localhost blindly for a remote connection.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
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.

The example grants all privileges on mpdb because many plugins need to create and update their own tables. If a plugin documents a narrower privilege set, use that set instead. Never grant the plugin account privileges on every database when it only needs one.

Confirm that the network path is possible

A correct username and password cannot overcome a blocked route. Before editing the plugin, establish which machine runs MySQL and which machine runs Minecraft:

  • If both services are on the same machine, the host supplied by the database service may be localhost or another local address.
  • If they are on separate machines, use the database host name or address supplied by the provider, not the Minecraft server’s address.
  • Use the database service’s stated port. Do not assume that a panel’s web port is the SQL port.
  • Check that a firewall allows the Minecraft server to reach that port and that MySQL is listening on an address reachable from it.

A timeout usually indicates routing, firewall or source-address restrictions. An “access denied” message usually means the account, password or account-host rule is wrong. Keeping those failure classes separate makes troubleshooting much faster.

Point the plugin at MySQL

Stop the server or use the host panel’s file editor while the server is not rewriting the file. Open the plugin’s configuration directory, commonly from the panel’s Files tab, and locate its configuration file. Many plugins use config.yml, but the exact file and key names are controlled by the plugin and its version.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  1. Make a copy of the original configuration before changing it.
  2. Find the storage or database section.
  3. If the plugin provides a storage toggle, change it from local storage to MySQL.
  4. Enter the hostname, port, database name, username and password in the keys documented for that release.
  5. Preserve YAML indentation and quoting.
  6. Save the file, start or restart the server, and read the console output.

Do not paste a configuration from another plugin merely because both use MySQL. A key such as address in one plugin may be called host and port separately in another. Configuration names also change between plugin versions, so the release-specific documentation takes precedence over examples copied from forums or older tutorials.

Worked example: configuring LuckPerms

LuckPerms uses a file-based H2 database by default, so no database setup is required for a single installation that stays with that default. To use MySQL, open the LuckPerms configuration and change the storage method in the Storage Settings section:

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
storage-method: mysql
data:
  address: "database-host:3306"
  database: "mpdb"
  username: "minecraft_plugin"
  password: "replace-with-your-password"

The official LuckPerms wiki identifies storage-method: mysql and the data values as the relevant settings. Depending on the version, the file may be named config.yml or luckperms.conf. Use the file generated by your installed version rather than creating a second file with a similar name.

A third-party example shows an address such as localhost:3306 and a pool-settings block with maximum-pool-size: 10. Treat that layout and number as illustrative, not as authoritative defaults. Only add pool settings that your installed LuckPerms version documents, and replace every placeholder value.

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

After saving, restart the server and inspect the startup log. A successful start should show the MySQL storage provider loading without connection errors. If the log still reports H2 or another local provider, the file may be in the wrong directory, the storage key may be misspelled, or the server may have regenerated a different configuration file.

Handle YAML and secrets safely

YAML treats punctuation and certain characters specially. Quote text values, especially usernames and passwords, so characters such as :, #, braces or leading symbols are not interpreted as YAML syntax.

username: "minecraft_plugin"
password: "p@ss:word#with-special-characters"
  • Do not add tabs to a YAML file; use the indentation already present.
  • Do not leave a password in a public paste, screenshot or version-control repository.
  • Keep a private backup of the original configuration and the new connection details.
  • If a password must be changed, update the database account and plugin configuration as one planned change, then restart and verify.

If the server refuses to start after an edit, restore the backup, check the console’s line number, and reapply the smallest possible change. A YAML parsing failure is different from a database authentication failure.

What to verify after the restart

Use the console as the authoritative check rather than assuming that a saved file was loaded. Confirm all of the following:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
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.
  • The plugin enables without a configuration or YAML parsing error.
  • The log identifies the MySQL storage provider, where the plugin reports its provider.
  • No timeout, “unknown host,” “access denied,” or “communications link” error appears.
  • The plugin can create, read and update a small piece of normal data.
  • The database account has created or is able to access the plugin’s tables.

Test with a non-destructive action first. For a permissions plugin, inspect an existing group or make a temporary test assignment; for another plugin, use its documented test operation. Then restart once more and confirm that the change persists. Persistence across a restart proves more than a successful connection message alone.

Using MySQL across multiple Minecraft servers

A shared database is useful only when every participating server uses compatible plugin versions, the same database settings and a schema supported by that plugin. Configure each server with the same database name and account when the plugin’s documentation calls for a shared store. Keep separate databases or accounts for unrelated plugins unless the plugin explicitly documents a shared schema.

Plan the network topology before opening database access:

  1. Identify every Minecraft server that needs the data.
  2. Allow only those server addresses through the database firewall or panel access list.
  3. Give the plugin account access only to its own schema.
  4. Apply plugin upgrades consistently rather than upgrading one server while others still use an older schema.
  5. Restart or roll out changes in a controlled order and watch each server’s console.

MySQL does not synchronize arbitrary plugin data. It synchronizes only what the plugin writes to its supported database schema. A plugin that stores some settings in local files may still require those files on every server.

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.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Backups and migrations

Back up both the existing plugin data and the database before switching storage providers or attempting a migration. Keep the backup outside the live server and record the plugin version that created it.

The LuckPerms command lp migrate mysql appears in a third-party excerpt, but it has not been confirmed here against the official documentation. Do not run it solely because it appears in an old guide. Check the migration command and supported source and destination stores in the documentation for your installed version, and retain a tested backup before proceeding.

If a migration fails, stop writes, restore the previous configuration and data, and bring the server back on its original storage. Do not repeatedly rerun a migration against a partially changed database without knowing whether the command is idempotent.

Troubleshoot by the error you see

Symptom Likely area Checks
“Unknown host” or name-resolution error Hostname Compare the hostname character-for-character with the panel’s value. Check DNS or use the provider’s documented address.
Connection timeout or communications error Network path Check the port, firewall, database listener and any “connections from” or source-address restriction.
“Access denied” Credentials or account host rule Re-enter the username and password, confirm the account is allowed from the Minecraft server’s host, and verify that it has privileges on the selected database.
Unknown database Database name Use the exact database name generated by the panel or created in SQL. Names may be case-sensitive depending on the operating system and server settings.
Plugin starts but still uses local storage Configuration selection Check the storage toggle, indentation, file name and plugin version. Look for duplicate configuration files.
Server fails while reading configuration YAML syntax Restore the backup, remove tabs, quote text values and check the line reported by the console.
Data does not appear on another server Topology or plugin compatibility Confirm both servers use the same database and schema, can reach it, and have compatible plugin versions. Check whether the data type is actually stored in MySQL.

Change one variable at a time. For example, first prove that the database host and port are reachable, then correct credentials, then inspect plugin-specific settings. Changing the firewall, account, YAML and plugin version simultaneously makes the original cause difficult to identify.

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

Security and operational practices

  • Use a unique, long password for each plugin account.
  • Grant access to one database rather than using a global administrator account.
  • Restrict database connections to known Minecraft server addresses when your host and topology support it.
  • Keep the database service and plugins updated according to their maintainers’ guidance.
  • Back up before schema changes, migrations and plugin upgrades.
  • Remove old accounts and access rules when a server is retired.
  • Monitor logs for repeated authentication failures or connection attempts from unexpected addresses.

A remote database introduces another service and another failure point. Keep a documented local-storage rollback plan for each plugin, and know where the panel stores database backups before making a production change.

Where EssentialsX fits

Search excerpts commonly describe EssentialsX MySQL settings under an economy section with fields such as enabled, host, port, database, username and password. That layout has not been verified against the EssentialsX documentation for a specific release, so it should not be treated as a confirmed configuration. Use the configuration generated by your installed version and its official documentation before enabling it.

Decision checklist

  • Does the plugin explicitly support MySQL in your installed version?
  • Do you need shared data across servers, or is local storage sufficient?
  • Can you create a dedicated database and restricted user?
  • Do you have the exact host, port, database, username and password?
  • Is the database reachable from the Minecraft server?
  • Did you back up the original data and configuration?
  • Did you use the plugin’s current key names and file name?
  • Did you quote credentials and preserve YAML indentation?
  • Did the console confirm the MySQL provider without errors?
  • Did a test change survive a restart?

Frequently asked questions

Do I need MySQL for one Minecraft server?

No. For a small single server, the plugin’s default file, H2 or SQLite storage is usually sufficient. MySQL becomes more compelling when data must be shared across servers or when a plugin’s documented requirements call for it.

Can every plugin use the same MySQL database?

They can use the same MySQL service, but each plugin should normally have its own database or documented schema and account permissions. Never assume that one plugin’s table layout or configuration can be reused by another.

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

Why does the plugin connect locally but not from another server?

A local connection may use localhost, while a remote connection needs the database machine’s reachable host name, an allowed source address and an open database port. Check those three items separately.

What should I do if I lose the database password?

Reset or rotate the dedicated database account through the panel or an administrator SQL session, update the plugin’s quoted password, restart the server and confirm a successful connection. Do not switch to a global administrator account as a workaround.

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.

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
Crashes, No Sound, or Screen Glitches?Free driver scan
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.