Plugin-API v1.1.5— Docs refresh, Menus API example, Inventory & Event-bridge improvements

Plugin-API 1.1.5

A new release of Plugin-API for Paper/Spigot 1.21+ plugins, consolidating the event bridge, public API, config/database helpers, and adding a simple Menus API example for plugin authors.

Changes

• Updated project docs and README (typo fixes, changelog, example usage).
• Java 21 / Paper 1.21.1+ support and Maven/JitPack guidance.
• Public API: org.abbas.PluginAPI.API entry point and helpers for calling/firing custom events.
• Event bridge extended: movement, interaction, kills, inventory flows, teleport support, and cancellation/message propagation fixes.
• Menus API added and improved:
  • Exposes MenusAPI, IMenu, and IMenuItem interfaces.
  • Menu creation helpers: createMenu(...), createItem(...), setItem(...), and open(...).
  • Editable flag to lock menus, per-item click actions, and simple inventory layout helpers.
  • Includes a simple com.example.exampleplugin example demonstrating menu creation, items, click handlers, and opening on player join.
• README: bumped Maven example to 1.1.5 and added a Changelog section.

Requirements

• Java 21
• Paper or Spigot 1.21.1+
• Maven (for building)

Installation

Place Plugin-API-1.1.5.jar in the server's plugins/ directory, or add the dependency through JitPack as shown in the README.

SHA-256

ede828fca4fe718e91c412b77fb47bb9cb0548ba4f0cd38b3bf26f1b2a3bc369

Plugin-API 1.1.4

Plugin-API 1.1.4

A new release of Plugin-API for Paper/Spigot 1.21 plugins, featuring major improvements to the project structure, event bridge, public API, configuration management, inventory events, and database integration support.

Changes

• Renamed the project and artifact from SimpleEvents to Plugin-API.
• Reorganized the plugin entry point under org.abbas.PluginAPI.API.
• Reorganized packages and internal source paths to match the new Plugin-API structure.
• Added ConfigManager and ConfigType for configuration and message file management.
• Added DatabaseAPI and ResultMapper interfaces for database integration support.
• Added custom inventory events:
  • CustomInventoryClickEvent
  • CustomInventoryCloseEvent
  • CustomInventoryDragEvent
  • CustomInventoryMoveItemEvent
  • CustomInventoryOpenEvent
  • CustomInventoryPickupItemEvent
• Added CustomPlayerTeleportEvent with destination modification and cancellation support.
• Improved CustomPlayerInteractEvent and added support for additional interaction types.
• Improved CustomPlayerKillEvent and propagated its cancellation state to the original event.
• Fixed Join and Quit event bridging so original messages are passed through and modified messages are applied back to Bukkit/Paper.
• Fixed propagation of message changes and cancellation states across custom events.
• Simplified CustomProcessCommandEvent to correctly support command message modification and cancellation.
• Improved compatibility with Paper API 1.21.
• Updated CI to use Java 21 and Maven with mvn clean verify.
• Added Qodana configuration for code quality analysis.
• Updated documentation, project files, and module paths.
• Updated the Maven project version to 1.1.4-SNAPSHOT.

Requirements

• Java 21
• Paper or Spigot 1.21+
• Maven when building from source

Installation

Place Plugin-API-1.1.4-SNAPSHOT.jar in the server's plugins/ directory.

SHA-256

e895c17378b166e8a990a47b1ae6e7ce30325adb5b4653bab1b8f67305974130

Note: The attached JAR was built with the Maven version 1.1.4-SNAPSHOT, while this GitHub release is published under the v1.1.4 tag.

SimpleEvents 1.1.3 add new Events and api improve

Full Changelog: v1.1.2.3...v1.1.3

SimpleEvents 1.1.2.3 Add new api

Full Changelog: v1.1.2.2...v1.1.2.3

SimpleEvents 1.1.2.2 — API Improvements

SimpleEvents 1.1.2.2-SNAPSHOT

Updated the SimpleEvents API with several improvements:

• Added proper Cancellable support for PlayerLevelUpEvent.
• Added callCustomPlayerLevelUpEvent(...) to inspect the event after dispatch.
• Added plugin-owned listener registration through registerListener(Plugin, Listener).
• Improved API documentation and Javadocs.
• Maintained backward compatibility with the existing API.
• Improved the overall API structure and usability for external plugins.

This update focuses on making SimpleEvents more reliable, extensible, and easier for other plugins to integrate with.

SimpleEvents v1.1.2.1 refine command event handling

Full Changelog: v1.1.2...v1.1.2.1

SimpleEvents 1.1

Full Changelog: v1.0...v1.1

SimpleEvents 1.0.0

simpleEvents 1.0-SNAPSHOT

Initial build of simpleEvents — a lightweight Spigot/Paper plugin that exposes a small API for firing custom Bukkit-style events from Java code, so plugins can trigger gameplay events without coupling tightly to the Bukkit event system.

Plugin info

• Main class: org.abbas.simpleEvents.SimpleEvents
• Bukkit API version: 1.21
• Requires Java 21

API

• SimpleEvents.getInstance() / getPluginManager() — plugin/event-manager accessors
• SimpleEvents.registerListener(Listener) — register a Bukkit listener
• SimpleEvents.registerEvents(...) — bulk event registration

Available custom events

• CustomPlayerJoinEvent — getMessage() / setMessage()
• CustomPlayerQuitEvent — getMessage() / setMessage()
• PlayerLevelUpEvent — getNewLevel()
• CustomPlayerChatEvent — getMessage() / setMessage(), getChannelName() / setChannelName(), cancellable
• CustomPlayerDeathEvent — getDeathMessage() / setDeathMessage(), getDeathMessageType()
• CustomBlockPlaceEvent — getBlock(), getItemInHand(), getReplacedBlockState(), setCanBuild(), cancellable
• CustomBlockBreakEvent — getBlock(), getMessage() / setMessage(), cancellable
• CustomProcessCommandEvent — getCommands() / addCommand(), getMessage() / setMessage(), cancellable

Corresponding callCustom... trigger methods exist on SimpleEvents for each event above (e.g. callCustomPlayerJoin, callCustomBlockBreak, callCustomPlayerChat, etc.).

Installation

1. Drop simpleevents-1.0-SNAPSHOT.jar into your server's plugins/ folder
2. Restart the server

Notes

• This is a -SNAPSHOT build — not yet a stable/tagged release version internally, so treat it as a pre-release.
• No license is currently declared in the repository.