OreLoot
PluginGPL-3.0-or-later

OreLoot

Allows full customization of block drops, including item type, amount, chance, and vanilla drop behavior.

72
Downloads
1
Followers
2 months ago
Updated
📦
11
Versions

📖About OreLoot

✨ What is OreLoot?

OreLoot gives you full control over block and entity drops on your Minecraft server.
Customize what blocks drop when broken — from diamonds dropping emeralds to iron ore dropping custom items. You define the rules, the chances, and the quantities

🎮 Features

  • ✅ Define custom drops per block type
  • ✅ Multiple items can drop from a single block
  • ✅ Configurable drop chances (e.g. 30% diamond, 70% iron ingot)
  • ✅ Fixed or random drop amounts (e.g. always 4, or 1–3)
  • ✅ World-specific configurations
  • ✅ JSON-based storage for persistent rules
  • ✅ Live reload without restarting the server
  • ✅ Simple and intuitive command system

🛠 Commands & permissions

  1. /drop add block <item/block> [chance] [world] – Adds a custom drop to blocks (Permission: drops.use)
  2. /drop add entity [chance] [world] – Adds a custom drop to entitys (Permission: drops.use)
  3. /drop remove block [world] – Removes all drops for a block (Permission: drops.use)
  4. /drop remove entity [world] – Removes all drops for a entity (Permission: drops.use)
  5. /drop remove item <block/entity> [world] - Removes a specific item drop (Permission drops.use)
  6. /drop amount block <item/block> <amount|random> [world] - Sets drop amount for a block (fixed or random) (Permission: drops.use)
  7. /drop amount entity <amount|random> [world] - Sets drop amount for a entity (fixed or random) (Permission: drops.use)
  8. /drop chance block <block/item> [world] - Changes the drop chance of an xisting entry for a block (Permission: drops.use)
  9. /drop chance entity [world] - Changes the drop chance of an existing entry for a entity (Permission: drops.use)
  10. /drop vanilla <on/off> block [block/all] - Enables or disables vanilla drops per world and block (Permission: drops.use)
  11. /drop vanilla <on/off> entity [entity/all] - Enables or disables vanilla drops per world and entity (Permission: drops.use)
  12. /drop list block [world|all] – Shows all configured drops for blocks (Permission: drops.use)
  13. /drop list entity [world|all] – Shows all configured drops for entitys (Permission: drops.use)
  14. /drop reload – Reloads the configuration (Permission: drops.use)
  15. /drop help – Displays the help menu (Permission: drops.use)

 

⚙️ Configuration & storage

Java (persistent – permanently stored)

All drop settings are saved in plugins/OreLoot/oreloot_drops.json.
The file is automatically loaded on server startup and saved when changes are made or the server stops.

Format (JSON structure):

{
  "world_name": {
    "block": [
      {
        "item": "item/block",
        "chance": chance,
        "amount": amount / random,
        "randomAmount": true / false,
        "isBlockDrop": true/false
      }
    ]
  },
  "world_name": {
    "entity": [
      {
        "item": "item",
        "chance": chance,
        "amount": amount / random,
        "randomAmount": true / false,
        "isBlockDrop": true/false
      }
    ]
  },
[...]
}

📸 Showcase

📂 Installation

  1. Download OreLoot--.jar.
  2. Place it in your server's plugins folder.
  3. Restart the server.

 

📜 Terms of Use – OreLoot

✅ You may

  • Use OreLoot free of charge on private and public servers.
  • Modify or extend the code as long as the credits remain intact.
  • Include the plugin in server packs if “wolfwriter” is named as the author.

❌ You may not

  • Sell OreLoot or distribute it for money.
  • Pretend to be the author of the plugin.
  • Upload manipulated versions as “official.”

⚠️ Disclaimer

  • OreLoot is provided without warranty.
  • Use at your own risk.
  • No liability for data loss or server problems.

ℹ️ License

License: GNU General Public License version 3 (GPLv3)

💬 Support & Contact

Do you have questions, feedback, or want to report bugs?
Join my Discord and chat directly with the author:
👉 Join Discord server: https://discord.gg/TJgzq9aCxN