Технический мод для Майнкрафт, добавляющий драйвер MySQL Connector/J для модов и серверных плагинов. Он нужен разработчикам, которым требуется подключение к базам MySQL или MariaDB; особенно полезен для Fabric, NeoForge и сборок Bukkit, где драйвер не поставляется вместе с сервером.
Возможности
- Содержит официальный драйвер MySQL Connector/J с классом
com.mysql.cj.jdbc.Driver. - Работает с Fabric, Forge, NeoForge, Bukkit, Spigot, Paper, Folia и Purpur.
- Поддерживает подключение к MariaDB по протоколу MySQL.
- Предоставляет программный интерфейс
MinecraftMysqlJdbcдля принудительного использования драйвера из этого мода.
Как пользоваться
Для стандартного подключения к базе используется строка JDBC, например:
jdbc:mysql://host:3306/db?useSSL=false&allowPublicKeyRetrieval=true&rewriteBatchedStatements=true
Параметр useSSL=false отключает SSL, если у сервера базы нет сертификата от доверенного центра. Для аутентификации caching_sha2_password по незашифрованному соединению нужен allowPublicKeyRetrieval=true. Параметр rewriteBatchedStatements=true объединяет пакетные INSERT-запросы в многострочные.
Плагины могут обращаться к драйверу через методы MinecraftMysqlJdbc.connect(url), MinecraftMysqlJdbc.connect(url, props), MinecraftMysqlJdbc.driver(), MinecraftMysqlJdbc.driverVersion(), MinecraftMysqlJdbc.eagerInit() и MinecraftMysqlJdbc.shutdown().
Требования и совместимость
Требуется Java 8 или новее. На Bukkit, Spigot и Paper драйвер MySQL обычно уже входит в состав сервера, поэтому при обычном вызове Class.forName("com.mysql.cj.jdbc.Driver") или DriverManager.getConnection будет использован встроенный драйвер. Чтобы подключаться именно через драйвер этого мода, нужен его программный интерфейс.
