Creating a database and pointing a plugin at it

Panel & Files Reviewed September 6, 2026 2 min read

Most plugins store data in a file and never ask you for anything. A few — the ones handling permissions, economy, or data shared between servers — want a real database, and setting one up is four fields long.

What to do

  1. Databases → New Database

    You give it a name. The panel generates the username, the password and the host.

  2. Copy all four values

    Host, database name, username, password. The password is shown when you create it — copy it now rather than resetting it later.

  3. Open the plugin's config

    Look for a mysql: or storage: section. Set enabled: true and fill in the four values you copied.

  4. Restart the server

    Not reload. Database connections are established at startup, and a reload leaves the plugin holding a connection to nothing.

The four values and where they go

Plugin asks forYou paste
host or addressThe host shown in the panel — not localhost
databaseThe database name, including its prefix
usernameThe generated user, prefix included
passwordThe generated password
localhost is the single most common mistake

Plugin configs ship with localhost as the default host, and it is wrong here. Your database does not live inside your game server's container, so localhost points at nothing. Use the host the panel gives you, exactly as written.

Only switch to MySQL if the plugin benefits

A single server with one permissions plugin runs perfectly well on the file storage it ships with. MySQL earns its keep when several servers share data, or when a plugin's own documentation says its file backend does not scale. Otherwise it is one more thing to configure and back up.

How to confirm it worked

The console shows the plugin connecting to the database on startup, with no Communications link failure or access-denied line.