Minecraft MongoDB Driver

MongoDB Java Driver for Minecraft

The official MongoDB Java sync driver (mongodb-driver-sync plus its core and BSON dependencies) repackaged as a Bukkit/Spigot/Paper plugin and a Fabric/Forge/NeoForge mod.

The mod does nothing on its own. Other plugins/mods that want to talk to MongoDB pick this up via softdepend (or just by being on the same classloader) and use the driver via the standard MongoClients.create(...) API.

What’s in the jar

The full sync-driver bundle:

• org.mongodb:mongodb-driver-sync:5.3.1 — the API surface (MongoClient, MongoCollection, etc.)
• org.mongodb:mongodb-driver-core:5.3.1 — wire-protocol implementation, connection pooling, server discovery
• org.mongodb:bson:5.3.1 — BSON codecs and document model
• org.mongodb:bson-record-codec:5.3.1 — Java record support

Plus minimal loader stubs for Spigot, Forge 1.12, Forge 1.13–1.16, Forge 1.17–1.20, NeoForge 1.21+, and Fabric. Classes stay at canonical com.mongodb.* and org.bson.* paths — no relocation — so consumers find them with plain Class.forName.

Service files for BSON codecs are merged via Shadow’s mergeServiceFiles() so codec auto-discovery works.

Compatibility

| Loader | MC versions | Notes |
|—|—|—|
| Bukkit / Spigot / Paper / Folia / Purpur | 1.8 → current | drop into plugins/ |
| Fabric | 1.16.1 → current | needs Fabric Loader 0.14+ |
| Forge | 1.12 → 1.20 | universal jar, no Mixins |
| NeoForge | 1.21 → current | drop into mods/ |

Java 8+ required (driver 5.x baseline).

Using it from a plugin or mod

compileOnly("org.mongodb:mongodb-driver-sync:5.3.1")

Probe and connect:

try {
    Class.forName("com.mongodb.client.MongoClients");
} catch (ClassNotFoundException e) {
    getLogger().warning("MongoDB backend disabled — install minecraft-mongodb-driver");
    return;
}
MongoClient client = MongoClients.create("mongodb://user:pass@host:27017/?authSource=admin");

On Paper 1.17+ add softdepend: [minecraft-mongodb-driver] to your plugin.yml so the classes are visible to your plugin’s classloader.

Connection strings carry everything — auth source, replica set members, read preference, write concern. Put it all in the URI; don’t try to set them via MongoClientOptions unless you’re doing something unusual.

Versioning

The jar version tracks the upstream sync driver. 5.3.1+2026-04-25 ships driver-sync 5.3.1 plus matching core/bson; the suffix is the build date. Auto-bump runs daily against Maven Central.

License

Apache 2.0 (MongoDB, Inc.). The repackage adds no functional changes. Full text in LICENSE.

Issues, source: GitHub.