PaperActions

PaperActions is a lightweight API for Paper that allows plugins to expose and execute actions without depending directly on each other.

Instead of checking whether another plugin is installed and calling its API, plugins can simply register named actions that any other plugin can invoke.

Features

• Annotation-based action registration
• Cross-plugin communication
• Named parameters
• Optional parameters
• Automatic type validation
• Lightweight with no configuration
• Designed for plugin interoperability

How it works

Plugins register actions during startup. Other plugins can execute those actions using the action's unique identifier.

Every action is identified by:

PluginName:ActionName

This makes it easy for plugins to communicate without creating hard dependencies.

Example Use Cases

• NPC interaction systems
• Custom event callbacks
• Minigame integrations
• Cross-plugin compatibility
• Placeholder or command callbacks
• Generic plugin APIs

Requirements

• Paper
• Java 21 or newer

Why PaperActions?

PaperActions provides a simple, standardized way for plugins to communicate. Rather than exposing large APIs or depending on implementation details, plugins can offer small, reusable actions that are easy to discover and execute.

The result is cleaner integrations, fewer hard dependencies, and a more modular plugin ecosystem.