HomeJavaModsOraxen Ore Drops
Oraxen Ore Drops

OraxenOreDrops

License Minecraft Paper

Advanced custom ore drops plugin for Minecraft servers using Oraxen. Features intelligent Fortune/Looting scaling with three different drop mechanics to ensure balanced gameplay.

✨ Features

📋 Requirements

📥 Installation

  1. Download the latest release from Modrinth
  2. Place the JAR file in your plugins/ folder
  3. Install Oraxen if not already installed
  4. Restart your server
  5. Configure drops in plugins/OraxenOreDrops/config.yml

⚙️ Configuration

Basic Example

debug-mode: false

drop-mechanics:
  method: HYBRID  # DIMINISHING, BONUS_ROLLS, or HYBRID

block-drops:
  DIAMOND_ORE:
    drop1:
      oraxen-item: "diamond_shard"
      chance: 25.0        # 25% base chance
      min-amount: 1
      max-amount: 3
    drop2:
      oraxen-item: "rare_gem"
      chance: 0.5         # 0.5% rare drop
      min-amount: 1
      max-amount: 1

Drop Mechanics Methods

HYBRID (Recommended)

Balances both chance increase and bonus rolls based on rarity:

DIMINISHING

Uses logarithmic scaling for rare items:

BONUS_ROLLS

Additional drop attempts instead of increasing chance:

Drop Chance Guidelines

Rarity Chance Range Description Fortune Bonus
Common 50-100% Frequent drops Full (+1% per level)
Uncommon 10-50% Regular drops Reduced (+0.5% per level)
Rare 1-10% Occasional drops Logarithmic
Very Rare 0.1-1% Seldom drops Square root
Legendary <0.1% Extremely rare Minimal

🎮 Commands

Command Permission Description
/oraxenoredrops reload oraxenoredrops.reload Reload configuration
/oraxenoredrops debug <on|off> oraxenoredrops.debug Toggle debug mode
/oraxenoredrops info oraxenoredrops.info Show plugin info

🔧 Permissions

Permission Default Description
oraxenoredrops.use op Use plugin commands
oraxenoredrops.reload op Reload config
oraxenoredrops.debug op Toggle debug mode
oraxenoredrops.info true View plugin info

🎯 Features in Detail

VeinMiner Detection

Automatically detects VeinMiner usage and reduces Fortune level by 5 to prevent excessive drops. Only processes every 5th block in a vein mine session.

AdvancedEnchantments Support

Seamlessly integrates with AdvancedEnchantments custom enchantments:

Smart Fortune Scaling

Drop chances scale intelligently based on rarity:

Example Calculations

Common Drop (50% chance)

Rare Drop (1% chance)

Ultra-Rare Drop (0.1% chance)

🏗️ Building from Source

git clone https://github.com/yourusername/OraxenOreDrops.git
cd OraxenOreDrops
mvn clean package

The compiled JAR will be in target/OraxenOreDrops-1.0.jar

🐛 Bug Reports & Feature Requests

Please use the GitHub Issues page to report bugs or request features.

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

💖 Credits


Made with ❤️ for the Minecraft community

Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

Verified by MCModsHub

These come from our own check of the pack file, not from the source page.

Explore more