# OraxenOreDrops<\/p>\n
\n
\n<\/p>\n
Advanced custom ore drops plugin for Minecraft servers using Oraxen. Features intelligent Fortune\/Looting scaling with three different drop mechanics to ensure balanced gameplay.<\/p>\n
## \u2728 Features<\/p>\n
– \ud83c\udfaf **Custom Block Drops** – Configure any block to drop custom Oraxen items
\n– \ud83d\udcca **Smart Fortune Scaling** – Three different methods to balance rare drops
\n– \ud83d\udd27 **VeinMiner Support** – Automatic detection and reduced drops during VeinMiner usage
\n– \ud83d\udc8e **AdvancedEnchantments Integration** – Support for custom Fortune\/Looting enchantments
\n– \ud83d\udeab **Silk Touch Prevention** – No custom drops when using Silk Touch
\n– \u26a1 **Performance Optimized** – Async cleanup tasks and efficient caching
\n– \ud83d\udc1b **Debug Mode** – Detailed logging for testing drop rates<\/p>\n
## \ud83d\udccb Requirements<\/p>\n
– **Server**: Paper\/Purpur\/Pufferfish 1.21+
\n– **Dependencies**:
\n – Oraxen (required)
\n – AdvancedEnchantments (optional)
\n– **Java**: 21+<\/p>\n
## \ud83d\udce5 Installation<\/p>\n
1. Download the latest release from Modrinth
\n2. Place the JAR file in your `plugins\/` folder
\n3. Install Oraxen if not already installed
\n4. Restart your server
\n5. Configure drops in `plugins\/OraxenOreDrops\/config.yml`<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
### Basic Example<\/p>\n
“`yaml
\ndebug-mode: false<\/p>\n
drop-mechanics:
\n method: HYBRID # DIMINISHING, BONUS_ROLLS, or HYBRID<\/p>\n
block-drops:
\n DIAMOND_ORE:
\n drop1:
\n oraxen-item: “diamond_shard”
\n chance: 25.0 # 25% base chance
\n min-amount: 1
\n max-amount: 3
\n drop2:
\n oraxen-item: “rare_gem”
\n chance: 0.5 # 0.5% rare drop
\n min-amount: 1
\n max-amount: 1
\n“`<\/p>\n
### Drop Mechanics Methods<\/p>\n
#### HYBRID (Recommended) ## \ud83d\udd27 Permissions<\/p>\n | Permission | Default | Description | ## \ud83c\udfaf Features in Detail<\/p>\n ### VeinMiner Detection ### AdvancedEnchantments Support ### Smart Fortune Scaling ### Example Calculations<\/p>\n **Common Drop (50% chance)** **Rare Drop (1% chance)** **Ultra-Rare Drop (0.1% chance)** ## \ud83c\udfd7\ufe0f Building from Source<\/p>\n “`bash The compiled JAR will be in `target\/OraxenOreDrops-1.0.jar`<\/p>\n ## \ud83d\udc1b Bug Reports & Feature Requests<\/p>\n Please use the GitHub Issues page to report bugs or request features.<\/p>\n ## \ud83d\udcdc License<\/p>\n This project is licensed under the MIT License – see the [LICENSE](LICENSE) file for details.<\/p>\n ## \ud83e\udd1d Contributing<\/p>\n Contributions are welcome! Please feel free to submit a Pull Request.<\/p>\n 1. Fork the repository ## \ud83d\udc96 Credits<\/p>\n – **Oraxen** by Th0rgal —<\/p>\n Made with \u2764\ufe0f for the Minecraft community<\/p>\n","protected":false},"excerpt":{"rendered":" Add Oraxen item drops to any type of block with drop chances<\/p>\n","protected":false},"featured_media":117084,"template":"","meta":{"_minecraft_slug":"oraxen-ore-drops","_minecraft_project_id":"RxHteTtW","_minecraft_author":"F02K","_minecraft_license":"MIT","_minecraft_downloads":161,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"oraxen-ore-drops.zip","_minecraft_size_bytes":33061,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T13:16:03.657815Z","_minecraft_date_created":"2025-12-21T05:15:18.080620Z","_minecraft_date_modified":"2025-12-19T15:24:37.912604Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/oraxen-ore-drops","_minecraft_icon_attachment_id":117084,"_minecraft_imported_at":"2026-06-06T21:18:47+00:00","_minecraft_import_hash":"f6bc3ab17f2c54be7681326aee1cac50","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,89,127,128],"mod_loader":[132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-117083","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\nBalances both chance increase and bonus rolls based on rarity:
\n– **Common drops (>50%)**: Mainly chance increase
\n– **Rare drops (<1%)**: Mainly bonus rolls\n- Best overall balance for mixed drop tables\n\n#### DIMINISHING\nUses logarithmic scaling for rare items:\n- Fortune I on 0.1% drop: ~0.13% (+0.03%)\n- Fortune III on 0.1% drop: ~0.117% (+0.017%)\n- Best for ultra-rare drops that should stay rare\n\n#### BONUS_ROLLS\nAdditional drop attempts instead of increasing chance:\n- Fortune I on 0.1% drop: 2 rolls = ~0.2%\n- Fortune III on 0.1% drop: 4 rolls = ~0.4%\n- Most predictable and balanced\n\n### Drop Chance Guidelines\n\n| Rarity | Chance Range | Description | Fortune Bonus |\n|--------|-------------|-------------|---------------|\n| Common | 50-100% | Frequent drops | Full (+1% per level) |\n| Uncommon | 10-50% | Regular drops | Reduced (+0.5% per level) |\n| Rare | 1-10% | Occasional drops | Logarithmic |\n| Very Rare | 0.1-1% | Seldom drops | Square root |\n| Legendary | <0.1% | Extremely rare | Minimal |\n\n## \ud83c\udfae Commands\n\n| Command | Permission | Description |\n|---------|-----------|-------------|\n| `\/oraxenoredrops reload` | `oraxenoredrops.reload` | Reload configuration |\n| `\/oraxenoredrops debug
\n| `\/oraxenoredrops info` | `oraxenoredrops.info` | Show plugin info |<\/p>\n
\n|———–|———|————-|
\n| `oraxenoredrops.use` | op | Use plugin commands |
\n| `oraxenoredrops.reload` | op | Reload config |
\n| `oraxenoredrops.debug` | op | Toggle debug mode |
\n| `oraxenoredrops.info` | true | View plugin info |<\/p>\n
\nAutomatically detects VeinMiner usage and reduces Fortune level by 5 to prevent excessive drops. Only processes every 5th block in a vein mine session.<\/p>\n
\nSeamlessly integrates with AdvancedEnchantments custom enchantments:
\n– Custom Fortune\/Luck enchantments
\n– Custom Looting enchantments
\n– Custom Silk Touch enchantments<\/p>\n
\nDrop chances scale intelligently based on rarity:
\n– Common items get full Fortune bonus
\n– Rare items get reduced Fortune bonus
\n– Ultra-rare items stay rare even with Fortune X<\/p>\n
\n– Fortune 0: 50%
\n– Fortune III: 53%
\n– Fortune X: 60%<\/p>\n
\n– Fortune 0: 1%
\n– Fortune III: 1.12%
\n– Fortune X: 1.35%<\/p>\n
\n– Fortune 0: 0.1%
\n– Fortune III: 0.117%
\n– Fortune X: 0.133%<\/p>\n
\ngit clone https:\/\/github.com\/yourusername\/OraxenOreDrops.git
\ncd OraxenOreDrops
\nmvn clean package
\n“`<\/p>\n
\n2. Create your feature branch (`git checkout -b feature\/AmazingFeature`)
\n3. Commit your changes (`git commit -m ‘Add some AmazingFeature’`)
\n4. Push to the branch (`git push origin feature\/AmazingFeature`)
\n5. Open a Pull Request<\/p>\n
\n– **AdvancedEnchantments** by N1KN<\/p>\n