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

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

📋 Requirements

- Java: Paper/Purpur/Pufferfish 1.21+ - Java: - Java (required) - %%MD1%% (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

```yaml 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: - Rare drops (<1%): 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

```bash 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

- AdvancedEnchantments by AdvancedEnchantments - AdvancedEnchantments by %%MD1%%

---

Made with ❤️ for the Minecraft community