๐ฌ 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
โจ 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
- /drop add block <block> <item/block> [chance] [world] โ Adds a custom drop to blocks (Permission: drops.use)
- /drop add entity <entity> <item> [chance] [world] โ Adds a custom drop to entitys (Permission: drops.use)
- /drop remove block <block> [world] โ Removes all drops for a block (Permission: drops.use)
- /drop remove entity <entity> [world] โ Removes all drops for a entity (Permission: drops.use)
- /drop remove item <block/entity> <item> [world] - Removes a specific item drop (Permission drops.use)
- /drop amount block <block> <item/block> <amount|random> [world] - Sets drop amount for a block (fixed or random) (Permission: drops.use)
- /drop amount entity <entity> <item> <amount|random> [world] - Sets drop amount for a entity (fixed or random) (Permission: drops.use)
- /drop chance block <block> <block/item> <chance> [world] - Changes the drop chance of an existing entry for a block (Permission: drops.use)
- /drop chance entity <entity> <item> <chance> [world] - Changes the drop chance of an existing entry for a entity (Permission: drops.use)
- /drop vanilla <on/off> <world> block [block/all] - Enables or disables vanilla drops per world and block (Permission: drops.use)
- /drop vanilla <on/off> <world> entity [entity/all] - Enables or disables vanilla drops per world and entity (Permission: drops.use)
- /drop list block [world|all] โ Shows all configured drops for blocks (Permission: drops.use)
- /drop list entity [world|all] โ Shows all configured drops for entitys (Permission: drops.use)
- /drop reload โ Reloads the configuration (Permission: drops.use)
- /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
- Download OreLoot-<pluginversion>-<minecraftversion>.jar.
- Place it in your server's plugins folder.
- Restart the server.
๐ Terms of Use โ FootstepsFX
โ
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)