October 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 ScanOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
World desk9 min

How to Configure Minecraft Plugins That Need a MySQL Database

A practical guide to configuring MySQL for Minecraft plugins, including database creation, YAML connection settings, plugin-specific file paths, verification and troubleshooting.

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.

To connect a Minecraft plugin to MySQL, create a database and dedicated user, change the plugin’s storage mode to MySQL, enter the database host, port, name and credentials in the correct configuration file, restart the server, and confirm the connection in the console. The exact setting names and file locations differ between plugins, so treat the examples below as a pattern and follow the target plugin’s current documentation for its keys.

What using MySQL changes

Many Paper and Spigot plugins can store data in a local flat file, SQLite database or MySQL-compatible server. MySQL moves that data into a separate database service instead of keeping it only in the plugin folder. This is especially useful when several Minecraft servers need to read and write the same player data through a BungeeCord or Velocity network. A single server may be perfectly adequate with the plugin’s default flat-file option, so switching databases is an operational choice rather than a requirement for every installation.

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.

MySQL is not a universal setting that can be pasted into every plugin. One plugin may call the option storage-method; another may use storage, a driver selector, or a completely separate configuration file. A correct database and incorrect key name still produce a failed connection or leave the plugin using its old storage method.

Prepare the server and database first

Check the server software and plugin version

These instructions apply to plugins loaded by Paper or Spigot. Confirm that the plugin version supports MySQL or MariaDB before changing anything. Keep a copy of the plugin’s current data directory and configuration file so you can restore the previous state if the migration fails.

#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.
  • Stop the server before making structural configuration changes, unless the plugin’s documentation explicitly supports a live reload.
  • Back up the entire plugin folder, including its existing YAML files and data files.
  • Record whether the plugin currently uses flat files, SQLite or another storage type; this helps you identify the correct migration or import procedure.
  • Have database host, port, database name, username and password ready before editing the YAML file.

Create a database and a dedicated user

Most game-server control panels can create a database and user together. Use that panel workflow when it is available, then copy the generated host, port, database name, username and password exactly. Do not use the database administrator account for a plugin.

On a VPS where you administer MySQL yourself, the following is an illustrative setup. Replace the example names and password with values you create; the exact account-host syntax depends on whether the Minecraft server and database run on the same machine.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
CREATE DATABASE minecraft_plugin
  CHARACTER SET utf8mb4
  COLLATE utf8mb4_unicode_ci;

CREATE USER 'plugin_user'@'localhost'
  IDENTIFIED BY 'replace_with_a_long_password';

GRANT ALL PRIVILEGES ON minecraft_plugin.*
  TO 'plugin_user'@'localhost';

FLUSH PRIVILEGES;

A plugin account normally needs access only to its own schema. If the plugin’s documentation lists narrower permissions, use those instead. When the database is on another host, the account’s allowed host and the database firewall must permit the Minecraft server’s address; do not expose MySQL broadly just to make a connection work.

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.

Know which connection values you are entering

  • Host: the database server address. For a database on the same machine, this is often 127.0.0.1; a hosting panel may provide a different hostname.
  • Port: the port on which the database listens. MySQL installations commonly use 3306, but use the value supplied by your host.
  • Database: the schema created for this plugin or group of plugins.
  • Username: the dedicated account granted access to that schema.
  • Password: the exact password for that account, including punctuation and letter case.

Some plugins ask for host and port separately. Others expect them together in one address field. Do not assume that a field named address accepts only a hostname: the plugin’s configuration reference determines the required format.

Find the plugin’s actual configuration file

The usual location

After the plugin has started once, look in plugins/<PluginName>/. The main file is often config.yml. Open it with a text editor that preserves spaces and UTF-8 text. YAML is indentation-sensitive: use spaces, not tabs, and keep child keys aligned with the existing file.

Separate database files are common

Do not edit a guessed filename if the plugin documents another one. MySqlPlayerBridge, for example, keeps its database settings in plugins/MySqlPlayerBridge/mysql.yml rather than the usual config.yml. PlayerPoints publishes a plugin-specific configuration reference on dev.bukkit.org; use that page to identify its current keys. The Spigot wiki also has a general “Connecting to databases – MySQL” page, but the plugin’s own documentation takes priority when the formats differ.

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

Examples of plugin-specific differences

Plugin Where to look Distinct requirement
LiteBans Its database section in the plugin configuration Select the MariaDB driver, then provide address, database, username and password.
MySqlPlayerBridge plugins/MySqlPlayerBridge/mysql.yml Database settings are in mysql.yml, not the standard config.yml.
PlayerPoints The plugin’s own configuration reference on dev.bukkit.org Use the documented key names for the installed version.

Switch the storage mode to MySQL

Find the setting that currently selects flat-file, YAML or SQLite storage. Change only that value and leave unrelated options untouched. A generic configuration may look like this:

storage-method: mysql
data:
  address: "127.0.0.1:3306"
  database: "your_db_name"
  username: "your_db_user"
  password: "your_db_password"

This block is illustrative, not a universal schema. If your plugin uses storage: MySQL, separate host and port keys, or a driver field, preserve those names and capitalization exactly. Some plugins distinguish between mysql, MySQL and MariaDB; enter the value shown in that plugin’s documentation.

Quote values that contain punctuation

Quote the complete host-and-port value, as in "127.0.0.1:3306", when the plugin expects a combined address. Quote the password as well. Characters such as #, :, braces and leading punctuation can be interpreted by YAML instead of being treated as password text. Quoting does not change the password sent to MySQL; it prevents the YAML parser from changing or truncating it.

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.

Keep indentation consistent and do not add tabs. A syntactically valid YAML file can still be semantically wrong if the database block is nested under the wrong parent key. Compare your edited section with the plugin’s freshly generated default file if you are unsure where it belongs.

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

Restart and verify the connection

  1. Save the edited file and ensure the filename and extension have not changed.
  2. Start or restart the Minecraft server. A full restart is safer than relying on a plugin reload command because database pools and drivers are often initialized only during startup.
  3. Watch the console during the plugin’s startup phase. A successful connection message should appear before the plugin enables its commands or listeners.
  4. Run a harmless plugin command or perform a small data change, such as creating a test record, then restart once more to confirm the data persists.
  5. Stop and investigate if the console reports a connection, authentication, driver or schema error. Do not repeatedly restart while the same credentials are wrong.

A successful startup message proves that the plugin reached the database, but it does not prove that an old flat-file dataset was imported. Migration is plugin-specific; check whether the documentation provides an import command or requires a one-time conversion.

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

Troubleshoot by the error you see

“Access denied” or authentication failure

  • Re-enter the username and password from the database panel or SQL account.
  • Check that the account is permitted from the Minecraft server’s host. An account created for localhost may not authenticate when the plugin connects from another machine.
  • Confirm that the plugin is connecting to the intended database host and not an old value left in another configuration file.
  • Check for YAML parsing of special password characters; quote the password and restart.

“Connection refused” or timeout

  • Verify the hostname and port, including whether the plugin expects host:port in one field or two separate fields.
  • Confirm that MySQL or MariaDB is running and listening on that port.
  • For a remote database, check the server firewall, database bind address and hosting-panel allowlist.
  • Do not substitute localhost for a panel-provided database hostname without checking the provider’s instructions.

“Unknown database”

The schema name in the plugin file does not exactly match the one created in MySQL. Database names can differ by spelling, punctuation and letter case depending on the operating system. Copy the name from the database server or panel rather than typing it from memory.

YAML parser errors or the plugin disables itself

  • Restore the backup and reapply the change one line at a time.
  • Replace tabs with spaces and check that every quote is closed.
  • Look for an unquoted colon, hash character or password containing a line break.
  • Compare indentation with the generated default file; a database block at the wrong level may be ignored even when YAML parses.

Driver, table or schema errors

A plugin may require a particular JDBC driver label, such as LiteBans’ MariaDB setting, even when the server is described generally as MySQL. Use the exact driver option documented by that plugin. If the connection succeeds but tables are missing, check whether the plugin is supposed to create its schema automatically, whether the database user has permission to create tables, and whether an import or migration step is required.

The plugin connects but data does not appear on another server

Every server in a BungeeCord or Velocity network must point to the same intended database and compatible plugin schema. Check each server’s plugin file separately; copying a configuration can accidentally copy the wrong database name or credentials. Also verify that the plugin is designed to share data across servers rather than maintaining server-local state.

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

Using MySQL across a server network

Shared storage is most valuable when multiple Minecraft servers need common bans, points, permissions or player records. Configure the same database details on each participating server only when the plugin supports that topology. Keep server-specific settings, such as world names or local message options, separate from the shared database block.

Plan changes in a controlled order: back up the database, stop or drain the affected servers, apply the plugin’s documented schema or migration, then bring servers back online while watching each console. Running different plugin versions against one schema can produce incompatible migrations, so keep versions aligned unless the plugin explicitly supports mixed versions.

Security and maintenance practices

  • Use one database user per plugin or tightly related plugin group instead of sharing an administrator login.
  • Give the account access only to the schema it needs, and rotate the password if it has been exposed in a ticket, screenshot or log.
  • Restrict remote database access to the Minecraft server addresses through the host firewall or panel controls.
  • Keep configuration backups separate from public repositories and do not paste passwords into support requests.
  • Schedule database backups before plugin upgrades, migrations and bulk data changes; test that a backup can actually be restored.
  • Record the database host, port, schema name and plugin version in your server documentation so another administrator can recover the setup.

Should you use MySQL or keep flat-file storage?

Situation Practical choice Reason
One server with modest plugin data Keep the default flat-file or SQLite mode unless you have a specific database requirement. It avoids operating a separate database service and may be sufficient for local storage.
Several servers sharing player data Use MySQL or MariaDB when the plugin supports networked storage. A shared database can provide one data source for a BungeeCord or Velocity network.
Hosting-panel environment Use the panel-generated database and credentials. The panel often creates the schema, user and connection details together.
Self-managed VPS Create a dedicated schema and user manually. You control privileges, network access and backups directly.

The correct choice depends on the plugin’s capabilities and your server layout. MySQL does not automatically improve a plugin that was designed for local files, and changing storage without a migration plan can leave existing data behind.

Final configuration check

  • The database exists and the dedicated user can access it.
  • The plugin’s documented configuration file contains the MySQL storage setting.
  • Host, port, database, username and password match the database server exactly.
  • Combined host-and-port values and passwords are quoted in YAML.
  • The plugin-specific driver name and file path are correct.
  • The server was fully restarted and the console showed a successful connection.
  • A test record survived a restart, and the existing data was migrated if required.

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 *

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.

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
Outdated Drivers Are Slowing You DownFree scan - exact matches
Windows Errors? Fix Them Before They SpreadFree repair 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.