Minecraft Jedis (Redis Driver)

Jedis Redis Client for Minecraft

Jedis, the most widely used Java Redis client, repackaged as a Bukkit/Spigot/Paper plugin and a Fabric/Forge/NeoForge mod.

The mod does nothing on its own — it ships Jedis (and its runtime dependencies) onto the server's classpath so other plugins/mods can use it without each bundling their own copy.

What's in the jar

Jedis plus the four runtime deps it needs:

• redis.clients:jedis:5.2.0 — the client itself
• org.apache.commons:commons-pool2 — connection pool (Jedis uses this for JedisPool)
• com.google.code.gson:gson — JSON serialization
• org.json:json — JSON parsing
• org.slf4j:slf4j-api — logging facade

slf4j-api is shaded into this jar because Spigot 1.8 doesn't ship it on the classpath. On platforms that already have slf4j (modern Paper, Fabric, NeoForge), the duplicate is harmless — slf4j-api is interface-only, no binding clash.

Loader stubs for Spigot, Forge 1.12, Forge 1.13–1.16, Forge 1.17–1.20, NeoForge 1.21+, and Fabric. No relocation — redis.clients.jedis.*, org.apache.commons.pool2.*, etc. stay at canonical paths.

Compatibility

Java 8+ required (Jedis 5.x baseline).

Using it from a plugin or mod

compileOnly("redis.clients:jedis:5.2.0")

Probe at startup:

try {
    Class.forName("redis.clients.jedis.Jedis");
} catch (ClassNotFoundException e) {
    getLogger().warning("Redis backend disabled — install minecraft-jedis");
    return;
}
try (JedisPool pool = new JedisPool(host, port);
     Jedis jedis = pool.getResource()) {
    jedis.set("hello", "world");
}

On Paper 1.17+ add softdepend: [minecraft-jedis] to your plugin.yml. Fabric and NeoForge don't need anything similar.

For Redis 6+ ACL auth pass user and password; for older Redis just password. TLS is on JedisClientConfig if you need it (not wired into the basic JedisPool constructor).

Versioning

The jar version tracks Jedis one-to-one. 5.2.0+2026-04-25 ships Jedis 5.2.0 plus current commons-pool2/gson/json/slf4j-api at the time of build. Auto-bump runs daily — when Jedis releases, the dep tree moves with it.

License

MIT (Jedis contributors). The repackage adds no functional changes. Full text in LICENSE.

Issues, source: GitHub.