Charity | Give Generously, Earn Karma

Charity is a unique Minecraft plugin that encourages players to donate excess items to a community cause. In return, they earn Karma — a new currency system that can be used in the Charity Shop, rankings, or for rewards!

---

✨ Features

• /charity give to donate items from your inventory
• Players earn Karma based on donated item value
• Custom Charity Shop GUI for spending Karma
• Track top donors with /charity leaderboard
• Configurable rewards, prices, and item values
• Compatible with Vault for economy-based karma
• Fully configurable GUI layouts and messages

---

📦 Download

Grab the latest release from:
👉 SpigotMC Resource Page
👉 ker35.com

---

🧪 How It Works

1. Player runs /charity give
2. GUI opens to donate items from their inventory
3. Donated items are recorded and points are calculated
4. Karma is awarded based on each item’s value
5. Players can spend Karma in the /charity shop

---

⚙️ Installation

1. Drop the .jar into your /plugins folder
2. Restart your server to generate default configs
3. Edit:
   • config.yml (karma values, rules)
   • shop.yml (GUI layout and items)
   • messages.yml (language and formatting)
4. Use /charity reload after making changes

---

🔧 Commands & Permissions

Command	Description	Permission
/charity	Opens the main GUI	charity.use
/charity give	Opens the donation interface	charity.give
/charity shop	Opens the Karma reward shop	charity.shop
/charity karma <user>	Check someone's Karma balance	charity.karma
/charity leaderboard	View top Karma donors	charity.leaderboard
/charity reload	Reload plugin files	charity.reload
/charity admin ...	Admin commands (add/remove/set karma)	charity.admin

---

🛍️ Example Shop Configuration (shop.yml)

shop:
  0:
    material: GOLDEN_APPLE
    name: "&6Golden Apple"
    lore:
      - "&7Heals you fully"
      - "&eCost: 10 Karma"
    cost: 10
    command: "give %player% golden_apple 1"
  1:
    material: DIAMOND_SWORD
    name: "&bDiamond Sword"
    lore:
      - "&7Sharp and shiny"
      - "&eCost: 50 Karma"
    cost: 50
    command: "give %player% diamond_sword 1"

---

🧮 Karma System

• Karma is earned by donating items
• You set the values of each item in config.yml
• Karma can be used in the shop or tracked via leaderboard

Example (config.yml):

item-values:
  DIAMOND: 10
  IRON_INGOT: 5
  GOLD_INGOT: 7
  COBBLESTONE: 0.1

---

📊 Compatibility

• Java 17+
• Paper / Purpur / Folia (1.17+)
• Vault (optional, for economy integration)

---

💬 Support

Main support is via Discord
Alternative support available at ker35.com

---

📌 Notes

• Players cannot donate damaged or unstackable items by default
• Admins can use /charity admin to adjust Karma manually
• Karma is stored per-player in flat files (YAML) or database (future support)

---

🔒 Licensing & Usage

• Redistribution, resale, or re-uploading is not allowed
• All purchases are final unless required by local law
• Chargebacks result in a global ban from Ker35.com services
  See full Terms of Service

---

© 2025 Ker35