GUI-API

[1.1.0] - 2026-06-14

⚠️ Breaking Changes

• GUIAPI.get(Plugin) has been deprecated. Use GUILibs.init(Plugin) to create a per-plugin instance, or GUILibs.getDefault() to retrieve the global default instance (available when GUIAPI is installed as a server plugin).

✨ Features

• Dual Distribution Model: GUIAPI can now be used in two ways:
  • Plugin Dependency (guiapi-plugin) — Install GUIAPI as a plugin on the server and use it as a shared library with provided/compileOnly scope.
  • Shade / Bundle (guiapi-core) — Bundle GUIAPI directly into your plugin JAR using Maven Shade or Gradle Shadow with relocation.
• GUILibs.init(Plugin) — New static method to create a dedicated GUILibs instance bound to your plugin.
• GUILibs.getDefault() — New static method to retrieve the global default GUILibs instance (only available when using the plugin dependency approach).
• Expanded Version Support — Added version adapters for Minecraft 1.8, 1.13, 1.16, 1.19, and 1.20, extending backward compatibility to Minecraft 1.8+.
• Folia Support — Added compatibility with Folia servers through dedicated scheduling adapters.

🏗️ Internal

• Project restructured into multi-module Maven layout:
  • api — Core API interfaces and abstractions
  • core — Main implementation (for shading)
  • plugin — Server plugin wrapper
  • v1_8_R3, v1_13_R2, v1_16_R3, v1_19_R3, v1_20_R4 — Version-specific adapters

📋 Migration from 1.0.0

1. Replace GUIAPI.get(this) → GUILibs.init(this) in your onEnable().
2. Update your dependency coordinates:
   • If using as a server plugin: com.github.downnfalls.guiapi:guiapi-plugin
   • If shading: com.github.downnfalls.guiapi:guiapi-core
3. Remove the import io.downn_falls.libs.guiapi.GUIAPI; import (no longer needed).

---