Skip to content

[COMPATIBILITY] Plugin bundles unrelocated HikariCP, causes LibertyBans warning/conflict #74

@RapahelS

Description

@RapahelS

Summary
When running SimpleClaimSystem v1.12.3.2 alongside LibertyBans, a warning appears about 'unrelocated library classes' because both plugins bundle HikariCP. This can cause classpath conflicts or instability.

LibertyBans warning:

Plugin 'SimpleClaimSystem 1.12.3.2' | HikariCP | com.zaxxer.hikari.HikariConfig
We detected bugs on your server which threaten its stability. LibertyBans will continue to operate unaffected, but we strongly suggest you fix these bugs.

Root cause:

  • Both plugins bundle HikariCP under its original package (com.zaxxer.hikari), leading to possible classloader and version mismatches.

How to reproduce:

  1. Start server with SimpleClaimSystem (v1.12.3.2) and LibertyBans enabled
  2. Observe startup warnings

Expected behavior:

  • No warnings regarding library class conflicts
  • No unpredictable SQL pool behavior

Suggested fix:

  • Relocate the shaded HikariCP dependency using Maven Shade or Gradle Shadow plugin, e.g.:
    <relocation>
      <pattern>com.zaxxer.hikari</pattern>
      <shadedPattern>fr.xyness.scs.libs.hikari</shadedPattern>
    </relocation>
  • Alternatively, use a single instance/library via provided dependencies if possible.
  • After relocation, verify LibertyBans warning is gone.

References:


Label: bug
Version: 1.12.3.2
Server: Folia 1.21.8
API: 1.21.8-R0.1-SNAPSHOT

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions