Class StubGuard

java.lang.Object
net.fateuhc.plugin.api.StubGuard

public final class StubGuard extends Object
Detects the classic misconfiguration: a third-party plugin shading the FateUHC-API stub jar instead of depending on it with provided (Maven) / compileOnly (Gradle) scope. The stub classes share fully-qualified names with the real classes inside the FateUHC plugin. When the API jar is correctly provided-scope, these stub classes never load on a server — the plugin supplies the real ones. If a stub class DOES load while FateUHC is installed, it was shaded into another plugin's jar and will shadow the real implementation for that plugin, breaking its FateUHC integration. Every stub class calls warnIfShaded(String) from a static initializer so the mistake is loudly reported the moment it can be detected. This class exists only in the API jar; it has no counterpart in the plugin.
  • Method Details

    • warnIfShaded

      public static void warnIfShaded(String stubClassName)