Charity icon

Charity -----

Giving away items to charity shop to earn Karma, Statistics, Customizable GUIs




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!
----------, Jun 8, 2025

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!
Code (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}"
----------, Jun 8, 2025

CHANGES IN 2.4.3

  • Added a version checker to notify those with charity.admin or OP ingame if there is a new release of Charity!
  • Added an infobook inside the /ch GUI, has basic information regarding how to use the plugin.
  • Fixed a typo in /ch info
----------, May 30, 2025

CHANGES IN 2.4.2

  • Updated actionCooldown - now works for giving & claiming
  • Added dailyClaimLimit - total number of items a player can claim in a day
config.yml should update automatically. messages.yml didn't update for me in testing, you will need to add the following to your messages.yml file.

Code (YAML):
claim_limit_reached : "&cYou have reached your daily claim limit for today!"
wait_action_cooldown
: "&cPlease wait before performing this action again!"
----------, May 22, 2025

Added 1.21.5 support, same features as v2.4!
----------, May 21, 2025

I'm excited to announce the release of Charity v2.4, continuing full support for Minecraft 1.21.4, along with a range of improvements and fixes from the previous v2.3.

So, what is new in v2.4?
  • Updated internal dependencies to match latest server versions for better stability and performance (v2.4.1 is 1.21.5 ready)
  • Improved configuration mangement and stability
  • Enhanced reporting and metrics options to better support troubleshooting.
  • Fixed several minor bugs reported by the community since v2.3.
  • Optimized item handling and point calculations for smoother gameplay experience.
  • Updated third-party dependencies for improved security and compatibility
  • Improved safeguards to ensure plugin data integrity.
  • New Command: /ch points

This is a complete re-write of the plugin, from scratch!
You will need to delete any existing Charity plugin folders that exist, including all data files if you would like to use v2.4 - moving forward this will not be the case, this was a massive multi-day upgrade.
----------, May 21, 2025

CHANGES IN 2.3

I did not have 7 hours worth of debugging in mind but here we are, finally fixed the issue from version 2.1 which was released earlier today. I do believe that this may cause some breaking changes, as quite a lot of the code was modified and being updated to support YAML fully & quite a few bug fixes.

If you installed 2.1 or 2.2 you may need to delete your Users folder in /plugins/Charity and data.yml aswell.

  • Migrations - User's .yml files will automatically convert from a properties style config to yaml
  • Cooldown Logic Fixed - Cooldown duration now correctly interpreted in seconds, not minutes
  • Fixed Double-Karma Bug - Left-click no longer allows taking items back from the charity shop. Right-click correctly removes karma once when retrieving donated items
  • System.out Warning - Noted warning from Paper about System.out.println usage. Planning to replace with getLogger() for cleaner console logs.
  • Removed noItems from config.yml - Deleted noItems default line from an internal java file. Code fallback still exists but may need future refactor.
  • YAML Integer Parsing Fix - Handled player stats stored as string values with quotes in data.yml & used some magic before parsing integers to avoid a number format exception. Same method used for user's .yml files!
  • bStats is now added (as mentioned in version 2.2)
----------, May 17, 2025

Version 2.2 is broken - Do not restart server until 2.3
----------, May 17, 2025

Version 2.1 is broken, and has been removed.
----------, May 17, 2025

POTENTIAL BREAKING CHANGES
Previously owned by _ReflexShow_, Charity is now owned by Ker35!

Since the last update, we have added support for 1.21.4 - tested on a PaperMC server. The plugin natively supported 1.15 however there has been quite a few changes since then and versions inbetween have not been tested.

New Changes:
  1. By default, after 90 days any inactive playerdata stored by Charity will auto-purge, this can also be done manually by running the command /ch cleanup
  2. Item data used to be forgotten when added to the Charity Shop, now when you add a custom named item or an enchanted item, they will stay and be available on the Charity Shop!
  3. actionCooldown got reworked, values are now seconds. You can set a value of 0 to disable the actionCooldown function!
  4. Minor changes to the default config.yml - there should be no issues when updating as the new values should auto-add!
    You can find a default version at https://dl.ker35.com/charity-config.yaml - just make sure version: 2.0 is set in the config!
And that pretty much sums up the update!
----------, May 16, 2025

Resource Information
Author:
----------
Total Downloads: 242
First Release: Aug 28, 2020
Last Update: Jun 8, 2025
Category: ---------------
All-Time Rating:
5 ratings
Find more info at ker35.com...
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings