Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for Petar_mc

A simple utility library plugin.

Report PetarLib?

PetarLib

A simple utility library plugin.

⚠️ Early Development Notice

PetarLib is currently in early development. While fully functional, you may encounter bugs and keep in mind the API may change!

Please do NOT leave negative reviews for bugs. Instead: • Open an issue on GitHub • Or join the Discord Server

Your feedback helps improve the plugin ❤️

Features

  • In-game notifications via chat or action bar
  • HTTP client wrapper with retries + async
  • Task scheduling with built-in exception handling
  • PlaceholderAPI expansion
  • Simple commands to get plugin info

Requirements

  • Paper or Spigot 1.16.5+
  • Java 17+ (match your server)
  • Optional: PlaceholderAPI (auto-registers expansion)

Download & Install

  • Download the plugin JAR
  • Place the correct JAR file into your plugins/ folder
  • Restart your server

Commands

  • /petarlib send <type> <player> <message> - type: chat or actionbar (MiniMessage if enabled)
  • /petarlib debug - toggle debug mode
  • /petarlib reload - reload config/messages
  • /petarlib version - show plugin version
  • /petarlib help - help menu
  • /petarlib info - plugin info

Permissions

  • petarlib.send - use /petarlib send
  • petarlib.admin - debug + reload (and general admin)

Config (config.yml)

config.yml

##########################################################################################################
#
#
#                                 ____      _             _     _ _
#                                |  _ \ ___| |_ __ _ _ __| |   (_) |__
#                                | |_) / _ \ __/ _` | '__| |   | | '_ \
#                                |  __/  __/ || (_| | |  | |___| | |_) |
#                                |_|   \___|\__\__,_|_|  |_____|_|_.__/
#
#
# Website: https://petarmc.com
# GitHub: https://github.com/PetarMc1/PetarLib-Bukkit
# License: MIT
# Made with ❤️ by Petar_mc
##########################################################################################################
config_version: 1

# debug: false Whether to enable debug mode for the plugin, which may provide additional logging and information for troubleshooting.

# If you added this plugin as a dependency of another plugin, you dont have to chnage these settings.
# However, if you are using things like the /petarlib send command you might need to check these settings.
# defaultMaxRetries: 3 Default maximum number of retries for failed operations for the HTTP client.
# use-minimessage: true Whether to use MiniMessage format for messages sent using the /petarlib send <player> <message> and for messages in messages.yml.
# Warrning: Enabling this will disable legacy color codes (e.g., &c) in favor of MiniMessage tags (e.g., <red>).

Messages (messages.yml)

messages.yml

# All messages use the MiniMessage format. Currently no legacy color codes are supported.
# There are some placeholders available for messages:
# {version} - The current version of PetarLib.
# {author} - The author of PetarLib (Petar_mc).

usage-send: "<yellow>Usage: /petarlib send <type> <player> <message>"
info-version: "<green>PetarLib version v{version}"
reload: "<green>PetarLib configuration reloaded."
debug-enabled: "<green>Debug mode set to <green>true"
debug-disabled: "<green>Debug mode set to <red>false"
no-permission: "<red>You don't have permission to use this command."
player-not-found: "<red>Player not found."
invalid-type: "<red>Invalid type. Use 'actionbar' or 'chat'."
unknown-subcommand: "<red>Unknown subcommand. Use /petarlib help"

Placeholders (PlaceholderAPI)

  • %petarlib_version% - current version
  • %petarlib_debug% - debug mode (enabled/disabled)
  • %petarlib_debug_boolean% - debug mode (true/false)

For Developers To use PetarLib as a dependency and check usage, go to the docs

Issues https://github.com/PetarMc1/PetarLib-Bukkit/issues

Made with ❤️ by Petar_mc

Information

CategoryDeveloper Tools
Published onApril 12, 2026
LicenseMIT
Download1
Stars0
Watchers0
Library

Pinned Versions

Members