Skip to content

Repository files navigation

Reedwork Examples

Small, focused example projects demonstrating how to use Reedwork to build PaperMC plugins.

Each example is a standalone project focused on a specific Reedwork feature or concept.

Examples

Example Description
Event Listener Automatic Bukkit/Paper event listener discovery and registration.
Command Annotation-based command discovery and registration with subcommands, aliases, permissions, cooldown, automatic usage generation, and automatic parameter resolution.
Custom Enchantment Automatic custom enchantment discovery and registration using Paper's experimental enchantment registry API.
Dependency Injection Constructor-based dependency injection with transient, singleton, and factory bindings, including external class bindings.
Quickstart A complete example demonstrating command registration, event discovery, custom enchantments, and dependency injection working together.

Learn Reedwork in 5 Minutes

Tutorial Example Description
Create a PaperMC Brigadier Command Five Minute Command Create your first Reedwork command using @Command and @CommandHandler, with automatic package scanning and command registration.
Create a PaperMC Event Listener Five Minute Event Listener Create a PaperMC event listener and let Reedwork automatically discover and register it through package scanning.
Create a PaperMC Custom Enchantment Five Minute Enchantment Create a custom PaperMC enchantment and let Reedwork automatically discover and register it using its annotation-based API.

More examples will be added over time.

Installation

See the official Reedwork Installation Guide for instructions on installing Reedwork and configuring your development environment.

Running an Example

Choose an example and follow its README for the specific details.

In general, examples can be built with Maven:

mvn clean package

The resulting plugin JAR can then be copied into the plugins/ directory of a Paper server.

Reedwork Documentation

For the complete Reedwork documentation, visit:

https://reedworkmc.github.io/

Contributing

Contributions are welcome.

If you want to add a new example, keep it:

  • small and focused on a single concept
  • independently buildable
  • easy to understand
  • documented with a short README

License

The examples in this repository are licensed under the MIT License.

Reedwork itself is licensed separately under the GNU Lesser General Public License v3.0.