# MongoDB Java Driver for Minecraft<\/p>\n
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.<\/p>\n
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.<\/p>\n
## What’s in the jar<\/p>\n
The full sync-driver bundle:<\/p>\n
– `org.mongodb:mongodb-driver-sync:5.3.1` \u2014 the API surface (`MongoClient`, `MongoCollection`, etc.)
\n– `org.mongodb:mongodb-driver-core:5.3.1` \u2014 wire-protocol implementation, connection pooling, server discovery
\n– `org.mongodb:bson:5.3.1` \u2014 BSON codecs and document model
\n– `org.mongodb:bson-record-codec:5.3.1` \u2014 Java record support<\/p>\n
Plus minimal loader stubs for Spigot, Forge 1.12, Forge 1.13\u20131.16, Forge 1.17\u20131.20, NeoForge 1.21+, and Fabric. Classes stay at canonical `com.mongodb.*` and `org.bson.*` paths \u2014 no relocation \u2014 so consumers find them with plain `Class.forName`.<\/p>\n
Service files for BSON codecs are merged via Shadow’s `mergeServiceFiles()` so codec auto-discovery works.<\/p>\n
## Compatibility<\/p>\n
| Loader | MC versions | Notes |
\n|—|—|—|
\n| Bukkit \/ Spigot \/ Paper \/ Folia \/ Purpur | 1.8 \u2192 current | drop into `plugins\/` |
\n| Fabric | 1.16.1 \u2192 current | needs Fabric Loader 0.14+ |
\n| Forge | 1.12 \u2192 1.20 | universal jar, no Mixins |
\n| NeoForge | 1.21 \u2192 current | drop into `mods\/` |<\/p>\n
Java 8+ required (driver 5.x baseline).<\/p>\n
## Using it from a plugin or mod<\/p>\n
“`kotlin
\ncompileOnly(“org.mongodb:mongodb-driver-sync:5.3.1”)
\n“`<\/p>\n
Probe and connect:<\/p>\n
“`java
\ntry {
\n Class.forName(“com.mongodb.client.MongoClients”);
\n} catch (ClassNotFoundException e) {
\n getLogger().warning(“MongoDB backend disabled \u2014 install minecraft-mongodb-driver”);
\n return;
\n}
\nMongoClient client = MongoClients.create(“mongodb:\/\/user:pass@host:27017\/?authSource=admin”);
\n“`<\/p>\n
On Paper 1.17+ add `softdepend: [minecraft-mongodb-driver]` to your `plugin.yml` so the classes are visible to your plugin’s classloader.<\/p>\n
Connection strings carry everything \u2014 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.<\/p>\n
## Versioning<\/p>\n
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.<\/p>\n
## License<\/p>\n
Apache 2.0 (MongoDB, Inc.). The repackage adds no functional changes. Full text in `LICENSE`.<\/p>\n
—<\/p>\n
Issues, source: GitHub.<\/p>\n","protected":false},"excerpt":{"rendered":"
Up-to-date MongoDB Java sync driver wrapped as a universal Forge\/Fabric\/Bukkit library for plugins like Grim.<\/p>\n","protected":false},"featured_media":101949,"template":"","meta":{"_minecraft_slug":"minecraft-mongodb-driver","_minecraft_project_id":"1r1AT64p","_minecraft_author":"Axionize","_minecraft_license":"Apache-2.0","_minecraft_downloads":35,"_minecraft_follows":0,"_minecraft_client_side":"unknown","_minecraft_server_side":"unknown","_minecraft_storage_type":"zip","_minecraft_archive_name":"minecraft-mongodb-driver.zip","_minecraft_size_bytes":4720307,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T22:13:03.034133Z","_minecraft_date_created":"2026-05-02T23:52:38.294447Z","_minecraft_date_modified":"2026-05-02T07:01:28.607206Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/minecraft-mongodb-driver","_minecraft_icon_attachment_id":101949,"_minecraft_imported_at":"2026-06-05T20:36:32+00:00","_minecraft_import_hash":"86c0138597448f0f2225231599c4843a","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,97,125,104,873,158,127,128,98,129],"mod_loader":[130,99,131,106,160,132,133,100,134],"minecraft_version":[385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-101948","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-fabric","mod_category-folia","mod_category-forge","mod_category-library","mod_category-neoforge","mod_category-paper","mod_category-purpur","mod_category-quilt","mod_category-spigot","mod_loader-bukkit","mod_loader-fabric","mod_loader-folia","mod_loader-forge","mod_loader-neoforge","mod_loader-paper","mod_loader-purpur","mod_loader-quilt","mod_loader-spigot","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n