PostgreSQL JDBC
官方 PostgreSQL JDBC 驱动(pgjdbc)重新打包为 Bukkit/Spigot/Paper 插件以及 Fabric/Forge/NeoForge 模组。一个通用 JAR 文件涵盖所有支持的加载器和 Minecraft 版本。
该模组本身并不执行任何操作——它的存在是为了让那些需要连接 PostgreSQL 数据库的插件或模组不必各自捆绑一份自己的驱动副本。
JAR 包内容
org.postgresql:postgresql:42.7.5 加上针对 Spigot、Forge 1.12、Forge 1.13–1.16、Forge 1.17–1.20、NeoForge 1.21+ 和 Fabric 的最小加载器存根。驱动类保持其标准的 org.postgresql.* 路径——不进行重定位——因此使用者可以通过普通的 Class.forName("org.postgresql.Driver") 找到它们。META-INF/services/java.sql.Driver 得以保留,以便驱动能够自动向 DriverManager 注册。
兼容性
| 加载器 | Minecraft 版本 | 备注 |
|---|---|---|
| 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+(pgjdbc 42.x 基线)。
从插件或模组中使用它
将 pgjdbc 声明为与分发此 JAR 的版本相同的 compileOnly 依赖:
compileOnly("org.postgresql:postgresql:42.7.5")
在启动时探测。如果操作员未安装此模组,则优雅地降级处理:
try {
Class.forName("org.postgresql.Driver");
} catch (ClassNotFoundException e) {
getLogger().warning("PostgreSQL backend disabled — install minecraft-postgresql-jdbc");
return;
}
try (Connection c = DriverManager.getConnection(url, user, password)) {
// ...
}
在 Paper 1.17+ 中,每个插件的类加载器都是隔离的。将此模组添加到你的 plugin.yml 的 softdepend 中,以便使驱动类对插件可见:
softdepend: [minecraft-postgresql-jdbc]
Fabric 和 NeoForge 将所有模组统一在一个类加载器上,因此那里不需要等效的声明。
版本控制
JAR 版本号与 pgjdbc 一对一跟踪。42.7.5+2026-04-25 分发的是 pgjdbc 42.7.5;后缀是构建日期。计划的 GitHub Action 每天检查 Maven Central ——当 pgjdbc 发布新版本时,它会打开一个自动合并的 PR,并且 Modrinth 发行版也会自动发布。
许可证
驱动程序采用 BSD-2-Clause 许可证(PostgreSQL Global Development Group)。重新打包没有添加任何功能更改,并继承该许可证。全文见 LICENSE。
问题反馈、源代码:GitHub。
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
一个在游戏内运行的 Minecraft 地图编辑器! 支持选区、蓝图、复制粘贴、笔刷和脚本。 可在创造模式中使用,也可在生存模式中临时使用。
一个强大的 API,用于为你的 Minecraft 服务器创建自定义进度。
SkyBlock、OneBlock、Boxed、SkyGrid、AcidIsland、CaveBlock、Poseidon、StrangerRealms——以及更多!这些只是由 BentoBox 支持的基于岛屿的游戏模式之一。来自原版 ASkyBlock 的作者。
评论 0
登录后参与评分
还没有评论,来抢沙发吧