Minecraft MongoDB Driver

MongoDB Java Driver для Minecraft

Официальный MongoDB Java sync driver (mongodb-driver-sync вместе с core и BSON-зависимостями), переупакованный как плагин для Bukkit/Spigot/Paper и мод для Fabric/Forge/NeoForge.

Сам по себе мод ничего не делает. Другие плагины/моды, которым нужно общаться с MongoDB, подхватывают его через softdepend (или просто находясь в том же classloader) и используют драйвер через стандартный API MongoClients.create(...).

Что внутри jar

Полный набор sync-driver:

• org.mongodb:mongodb-driver-sync:5.3.1 — поверхность API (MongoClient, MongoCollection и т. д.)
• org.mongodb:mongodb-driver-core:5.3.1 — реализация wire-протокола, пул соединений, обнаружение серверов
• org.mongodb:bson:5.3.1 — BSON-кодеки и модель документов
• org.mongodb:bson-record-codec:5.3.1 — поддержка Java record

Плюс минимальные заглушки загрузчиков для Spigot, Forge 1.12, Forge 1.13–1.16, Forge 1.17–1.20, NeoForge 1.21+ и Fabric. Классы остаются по каноническим путям com.mongodb.* и org.bson.* — без relocation — так что потребители находят их обычным Class.forName.

Service-файлы для BSON-кодеков объединяются через Shadow mergeServiceFiles(), чтобы автообнаружение кодеков работало.

Совместимость

Требуется Java 8+ (базовая линия драйвера 5.x).

Использование из плагина или мода

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

Проверка и подключение:

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");

На Paper 1.17+ добавьте softdepend: [minecraft-mongodb-driver] в свой plugin.yml, чтобы классы были видны classloader'у вашего плагина.

Строки подключения несут в себе всё — auth source, участников replica set, read preference, write concern. Указывайте всё в URI; не пытайтесь задавать это через MongoClientOptions, если только не делаете что-то необычное.

Версионирование

Версия jar повторяет версию upstream sync driver. 5.3.1+2026-04-25 включает driver-sync 5.3.1 плюс соответствующие core/bson; суффикс — дата сборки. Автообновление запускается ежедневно против Maven Central.

Лицензия

Apache 2.0 (MongoDB, Inc.). Переупаковка не вносит функциональных изменений. Полный текст в LICENSE.

Issues, исходники: GitHub.