Minecraft PostgreSQL JDBC

PostgreSQL JDBC

Официальный JDBC-драйвер PostgreSQL (pgjdbc), переупакованный как плагин для Bukkit/Spigot/Paper и мод для Fabric/Forge/NeoForge. Один универсальный jar покрывает все поддерживаемые загрузчики и версии MC.

Сам по себе мод ничего не делает — он существует, чтобы плагины или моды, которым нужно общаться с базой данных 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.

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

Требуется Java 8+ (базовая версия pgjdbc 42.x).

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

Объяви pgjdbc как compileOnly той же версии, что идёт в этом jar:

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+ у каждого плагина изолированный загрузчик классов. Добавь этот мод в softdepend своего plugin.yml, чтобы классы драйвера были видны твоему плагину:

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.

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