OreLoot

OreLoot v1.1 - 2025-10-05

Status: Release Candidate (RC) – Bug reports will be added after going live.

Overview

• Plugin: OreLoot
• Author: Wolfwriter
• Short Description: Allows full customization of block drops and entity drops, including item type, amount, chance, and vanilla drop behavior.

Added

• Define custom drops for mobs/entities
• Multiple items per entity supported
• Commands change:
  • /drop add entity <entity> <item> [chance] [world] – Adds a custom drop to entitys (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 entity <entity> <item> <amount|random> [world] - Sets drop amount for a entity (fixed or random) (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> entity [entity/all] - Enables or disables vanilla drops per world and entity (Permission: drops.use)
  • /drop list entity [world|all] – Shows all configured drops for entitys (Permission: drops.use)

Changed

• /drop add block <block> <item/block> [chance] [world] – Adds a custom drop to blocks (Permission: drops.use)
• /drop remove block <block> [world] – Removes all drops for a block (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 chance block <block> <block/item> <chance> [world] - Changes the drop chance of an existing entry for a block (Permission: drops.use)
• /drop vanilla <on/off> <world> block [block/all] - Enables or disables vanilla drops per world and block (Permission: drops.use)
• /drop list block [world|all] – Shows all configured drops for blocks (Permission: drops.use)

Fixed

• – (Initial release)

Performance

• – (Initial release)

Data & Configuration

• File: OreLoot/oreloot_drops.json
• **Format: **

{
      "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
          }
        ]
      },
    [...]
    }

Compatibility

• MC Version: 1.21.1 - 1.21.8
• Platforms:
  • Paper: 1.21.1 – 1.21.8

Known Issues (Pre-Release)

• None. (Will be updated after reports come in.)