Minecraft MongoDB Driver

插件

· 作者 Axionize

作为 Grim 等插件的通用 Forge/Fabric/Bukkit 库,封装了最新的 MongoDB Java 同步驱动程序。

0 本站下载 0 关注 更新于 1 个月前

最新 5.13.0+2026-09-26 · 26.3 · Bukkit / Fabric

一键开服(送7天)

Minecraft 用 MongoDB Java 驱动

本仓库将官方 MongoDB Java 同步驱动(包含 mongodb-driver-sync 及其核心和 BSON 依赖)重新打包为 Bukkit/Spigot/Paper 插件以及 Fabric/Forge/NeoForge 模组。

该模组本身不执行任何操作。希望与 MongoDB 通信的其他插件或模组会通过软依赖(softdepend,或仅通过处于同一个类加载器)引入此模组,并通过标准的 MongoClients.create(...) API 使用驱动程序。

Jar 包内容

完整的同步驱动包:

  • org.mongodb:mongodb-driver-sync:5.3.1 — API 接口(MongoClient、MongoCollection 等)
  • org.mongodb:mongodb-driver-core:5.3.1 — 协议实现、连接池、服务器发现
  • 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 找到它们。

BSON 编解码器的服务文件通过 Shadow 的 mergeServiceFiles() 进行合并,以确保编解码器的自动发现功能正常工作。

兼容性

加载器 MC 版本 备注
Bukkit / Spigot / Paper / Folia / Purpur 1.8 → 当前最新版 放入 plugins/ 目录
Fabric 1.16.1 → 当前最新版 需要 Fabric Loader 0.14+
Forge 1.12 → 1.20 通用 jar,无 Mixins
NeoForge 1.21 → 当前最新版 放入 mods/ 目录

需要 Java 8+(driver 5.x 基线要求)。

在插件或模组中使用

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

探测并连接:

try {
    Class.forName("com.mongodb.client.MongoClients");
} catch (ClassNotFoundException e) {
    getLogger().warning("MongoDB 后端已禁用 —— 请安装 minecraft-mongodb-driver");
    return;
}
MongoClient client = MongoClients.create("mongodb://user:pass@host:27017/?authSource=admin");

在 Paper 1.17+ 中,请在你的 plugin.yml 中添加 softdepend: [minecraft-mongodb-driver],以便你的插件的类加载器能够看到这些类。

连接字符串包含了所有配置项——认证源、副本集成员、读取偏好、写入关注点。将所有设置放在 URI 中;除非你有特殊需求,否则不要尝试通过 MongoClientOptions 单独设置它们。

版本说明

Jar 包的版本号跟随上游同步驱动的版本。5.3.1+2026-04-25 表示包含 driver-sync 5.3.1 以及匹配的核心/BSON 版本;后缀部分是构建日期。自动更新每天针对 Maven Central 运行。

许可证

Apache 2.0 (MongoDB, Inc.)。重新打包未添加任何功能性更改。完整文本见 LICENSE。


问题反馈及源代码:GitHub。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源