Godot MariaDB Connector Plugin

A GDExtension-based MariaDB connector for Godot 4, allowing direct database access from Godot without relying on third-party middleware.

Features

• Connect to MariaDB databases directly from Godot.
• Perform queries, insert/update/delete operations, and handle results.
• Secure authentication with SHA-1 and Ed25519 password hashing.
• Cross-platform support (Linux, Windows, ARM64).
• Uses GDExtension, requiring no custom engine builds.

Installation

1. Download the Addon

Clone or download the repository:

git clone https://github.com/sigrudds1/Godot-MariaDB-Connector-Plugin.git

Or download the latest release from Releases or the Godot Asset Library (when available).

2. Add to Your Godot Project

Move the addons/mariadb_connector/ folder into your project's addons/ directory.

3. GDExtension Auto-Detection

Since this is a GDExtension, it does not require enabling in the Godot plugin settings. Once the files are in place, Godot will automatically detect and load the extension.

(Note: Behavior may be different when downloading from the Asset Library inside the editor.)

Usage

For detailed usage examples, please refer to the Demo Project included in the repository.

You can find the demo inside the demo/ folder, which demonstrates how to:

• Connect to a MariaDB database.
• Execute queries (SELECT, INSERT, UPDATE, DELETE).
• Handle results properly.

License

Unlike many other database connectors, this plugin is licensed under MIT, not GPL. Although MariaDB itself is GPL, this connector only communicates with MariaDB servers via standard network protocols—meaning it does not fall under GPL’s derivative work restrictions. This ensures no licensing conflicts when using this plugin in closed-source or commercial Godot projects.

Contributing

1. Fork the repository.
2. Create a feature branch.
3. Commit your changes.
4. Submit a Pull Request.

You can find the build instructions at Godot Docs.

Support

For issues, open a ticket on GitHub Issues.

Donations

If you find this project useful and would like to support development, consider donating:

• Buy Me a Coffee
• Ko-fi