PeachLib

🍑 PeachLib

PeachLib is a lightweight and efficient utility library specifically designed for PaperMC developers. It provides a centralized API to simplify common tasks like GUI creation, item management, and player utilities, allowing you to focus on your plugin's core features.

🚀 Key Features

• Centralized API Access: Access all library features through a single API entry point.

• Modern GUI System: Create row-based inventory GUIs with ease and page support. Supports MiniMessage titles, automated item protection, and custom click actions .

• Advanced Item Management:

  • ItemBuilder: A fluid API to create and modify ItemStacks quickly.

  • CustomHeads: Easily fetch player heads using Base64 strings.

• Developer Utilities:

  • Scheduler Manager: Simplified task handling with a dedicated library scheduler.

  • Player Manager: Utility methods for handling player-related data and actions.

• Built-in Essentials:

  • Update Checker: Automatic checks every 12 hours to keep your server updated (notifies OPs on join).

  • bStats Integration: Anonymous telemetry to help understand how the library is being used.

🛠 For Developers

Quick Example: Creating a Custom Head:

// Creates an ItemStack of a head via Base64 string
ItemStack head = API.getItemsManager().getCustomHeadsAPI().getCustomHead("eyJ0ZXh0dXJlcyI6...");

or

CustomHeadsAPI customHeadsAPI = API.getItemsManager().getCustomHeadsAPI();
ItemStack head = customHeadsAPI.getCustomHead("eyJ0ZXh0dXJlcyI6...");

📌 Technical Details

• Java Version: 21 or higher.

• Platform: PaperMC (and forks like Purpur).

💡 Support & Contribution

• Project Status: PeachLib is a hobby project. Development happens in my free time, and I cannot guarantee immediate fixes or 100% correctness of all features.

• Disclaimer: Please note that this page description may not always be up-to-date or complete. For the most accurate, technical, and latest information, please always refer to the GitHub README/WIKI/Discussions.

• Report Bugs: Open an issue on GitHub.

• Request Features: Have an idea? Suggest it using the enhancement label.

• Contribute: Pull Requests are always welcome!

⚖️ Legal & Privacy

• License: Licensed under the MIT License.

• Transparency: This project follows modern transparency standards. Parts of the code and documentation were developed with the assistance of AI and refined by the author.

• Privacy: Uses bStats for anonymous data collection and connects to GitHub/JitPack for update checks.