Charity - From Inventory to Impact v2.4.9

CHANGES IN v2.4.9

• Fixed item duplication exploit - once an item has been claimed, it can no longer be re-donated to Charity.
• Auto-stacking system - identical items now merge automatically to save space in the Charity GUI.
• Permission system cleanup - all commands now respect proper permission checks (charity.use, charity.admin, etc.) and use consistent messages from messages.yml.
• Reload & Points Command updates - both now prevent unauthorized access and only display usage to permitted players.
• New /ch stats command - shows total stacks, total items, unique owners, top donor, most common material, total worth (Karma), and file info (admin only).
• Help command rework - dynamically lists available commands based on player permissions (user vs admin view).
• General cleanup & polish - improved in-game messages, safer file handling, and better command structure for maintainability.
  
  

CHANGES IN 2.4.6

• Added support for a drag-and-drop chest GUI to donate items easily.
• Added a central chest button to the main GUI for quick access to the drop-off chest.
• Improved GUI: page arrows and stats display are more robust.
• Karma (points) are now only awarded to the donator when their item is claimed, not when given.
• Added PlaceholderAPI expansion for player data (Karma and more).
• Messages and sounds improved for item donations and claims.
• Refined item blacklist handling and feedback.
• General code and stability improvements.
• New command /ch chest

Please check here for the latest config.yml
Also here for the latest messages.yml

Please Note:
Only the .jar file is useful, the .zip and .tar.gz are useless so no point in downloading them

CHANGES IN 2.4.5

• Fixed a bug where players could give something to charity, re-claim it then re-give to charity, as the re-claim price was only a value of 1, effectively "duping" points!
  
  It now matches the value in the worthlist
  
  
• Added a re-claim fee of 5, this cannot be changed for now but will impliment your own custom value in the next update!

CHANGES IN 2.4.4

• Added an announcer which broadcasts a customizable message to all players when an item is donated to Charity.
  
  The announcer supports placeholders for player and item name, and respects custom item names
  
  The announcer can be toggled in messages.yml and set announce_item_given to empty "" to disable
  
  When custom names are unavailable, material names are used
  
  
• All major GUI labels, lores & togglee options are now loaded from messages.yml, making them fully customizable.
• How-to book and stats items in the GUI are now optional, you can enable/disable them in messages.yml!
• Minor code cleanup, removed unused constants, improved variable scope handling.

Please update your messages.yml file!

YAML:

# Plugin Prefix
prefix: "&6&lCharity &r&l&8»&r &b"

# Item/Shop Messages
claim_success: "&aYou claimed %item%!"
not_your_item: "&cYou cannot claim your own item."
item_given: "&aYour item was given to Charity!"
item_reclaim: "&aYour item was reclaimed from Charity!"
item_expired: "&cA Charity item expired."
announce_item_given: "&6&lCharity &8» &e%player% &7just added &b%item% &7to Charity!" # Change to "" to disable!

# Permission Messages
no_permission: "&cYou do not have permission."
unknownCommand: '&cUnknown command. Type /ch help for a list of commands.'
reload_success: "&aCharity config reloaded."
item_blacklisted: "&cYou cannot give this item to Charity!"

# Cooldowns and Limits
cooldown: "&cPlease wait {seconds} seconds before giving again."
claim_limit_reached: "&cYou have reached your daily claim limit for today!"
wait_action_cooldown: "&cPlease wait before performing this action again!"

# Console Messages
plugin_loaded: "[Charity] Plugin loaded successfully!"
bStats_enabled: "[Charity] bStats Telemetry is Enabled!"
bStats_disabled: "[Charity] bStats Telemetry is Disabled!"
ker35api_enabled: "[Charity] Ker35 API Telemetry is Enabled!"
ker35api_disabled: "[Charity] Ker35 API Telemetry is Disabled!"

# GUI Titles
gui:
  title: "&3&lCharity Items"
  previous_page: "&ePrevious Page"
  next_page: "&eNext Page"
  show_how_to_book: true
  show_stats: true
  how_to_book_name: "&dHow to Use"
  how_to_book_lore:
   - "&7Left-click an item to claim it"
    - "&7Right-click to re-claim"
    - "&eEarn points for each donation!"
  stats_item_name: "&6Stats"
  stats_item_lore:
    - "&fPoints Donated: &a{pointsGiven}"
    - "&fPoints Claimed: &c{pointsTaken}"
    - "&fItems Donated: &a{itemsGiven}"
    - "&fItems Claimed: &c{itemsTaken}"
    - "&7Page &e{page}&7/&e{maxPage}"