helper

helper is a development toolkit / library for Bukkit plugin developers. It provides a number of utilities and extended APIs which help to reduce boilerplate code and offer alternative paradigms for creating content.

History

💡 helper started off as a library to experiment with an alternative paradigm for creating event listeners. Over time, more functionality has been added, usually as a response to a specific development need as I completed freelance work.

🌍 I don't use helper in any of my public projects - it's quite a big library, and I don't like to add bloat unnecessarily!

✅ However, it has been used extensively in a number of private server projects, most notably, in most custom plugins on servers operated by Voldex Games (TheArchon, PrimeMC, etc). I'm also aware of a number of other developers / development teams who still actively use helper, which is awesome!

Status

I'm no longer actively working on further API additions, but the project is still being used frequently by various development teams, and I accept pull requests!

Links

• Download (download links for the standalone helper plugins)
• Wiki (almost-fully-complete documentation for helper)

Modules

helper: The main helper project

Feature Overview

• Events - functional event handling and flexible listener registration
• Scheduler - easy access to the Bukkit scheduler
• Promise - a chain of operations (Futures) executing between both sync and async threads
• Random - make random selections from collections of weighted elements
• Bucket - sets of distributed and uniformly partitioned elements
• Terminables - a family of interfaces to help easily manipulate objects which can be unregistered, stopped, or gracefully halted

Changes

1. Use paperweight
2. Use gradle
3. Debloat stuff we already can do with paper api
4. Folia compatible using CJCrafter's Schedulers library.
5. Do not shade stuff the server already provides