OraxenOreDrops

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

• 🎯 Custom Block Drops - Configure any block to drop custom Oraxen items
• 📊 Smart Fortune Scaling - Three different methods to balance rare drops
• 🔧 VeinMiner Support - Automatic detection and reduced drops during VeinMiner usage
• 💎 AdvancedEnchantments Integration - Support for custom Fortune/Looting enchantments
• 🚫 Silk Touch Prevention - No custom drops when using Silk Touch
• ⚡ Performance Optimized - Async cleanup tasks and efficient caching
• 🐛 Debug Mode - Detailed logging for testing drop rates

📋 Requirements

• Server: Paper/Purpur/Pufferfish 1.21+
• Dependencies:
  • Oraxen (required)
  • AdvancedEnchantments (optional)
• Java: 21+

📥 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:

• Common drops (>50%): Mainly chance increase
• Rare drops (<1%): Mainly bonus rolls
• Best overall balance for mixed drop tables

DIMINISHING

Uses logarithmic scaling for rare items:

• Fortune I on 0.1% drop: ~0.13% (+0.03%)
• Fortune III on 0.1% drop: ~0.117% (+0.017%)
• Best for ultra-rare drops that should stay rare

BONUS_ROLLS

Additional drop attempts instead of increasing chance:

• Fortune I on 0.1% drop: 2 rolls = ~0.2%
• Fortune III on 0.1% drop: 4 rolls = ~0.4%
• Most predictable and balanced

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:

• Custom Fortune/Luck enchantments
• Custom Looting enchantments
• Custom Silk Touch enchantments

Smart Fortune Scaling

Drop chances scale intelligently based on rarity:

• Common items get full Fortune bonus
• Rare items get reduced Fortune bonus
• Ultra-rare items stay rare even with Fortune X

Example Calculations

Common Drop (50% chance)

• Fortune 0: 50%
• Fortune III: 53%
• Fortune X: 60%

Rare Drop (1% chance)

• Fortune 0: 1%
• Fortune III: 1.12%
• Fortune X: 1.35%

Ultra-Rare Drop (0.1% chance)

• Fortune 0: 0.1%
• Fortune III: 0.117%
• Fortune X: 0.133%

🏗️ 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

• Oraxen by Th0rgal
• AdvancedEnchantments by N1KN

---

Made with ❤️ for the Minecraft community