✅ Documentation (Beta)
# MoneyFromOres – Complete Documentation

---

## Installation

1. Download the `.jar` file and place it in your `/plugins` folder
2. Install [Vault]( https://www.spigotmc.org/resources/vault.34315/)
3. Make sure you have a compatible economy plugin installed (e.g., EssentialsX)
4. Restart the server (or use a plugin manager reload)
5. Edit the `config.yml` file to customize rewards, messages, sounds, and more
6. Use `/mfo reload` to apply configuration changes without restarting

---

## ⚙️ Configuration Overview (`config.yml`)

```yaml
chance: 0.3 # 30% chance to get money on each ore block

rewards:
DIAMOND_ORE: 20.0
IRON_ORE: 10.0
# Add more ores as needed

messages:
reward: "§aYou earned {amount} money by mining {ore}! (x{multiplier})"
anti_farm: "§cNo reward: this block was placed manually."
no_reward: "§7No reward this time."

effects:
enabled: true
sound: ENTITY_EXPERIENCE_ORB_PICKUP
particle: VILLAGER_HAPPY

Placeholders

• {amount} → The amount of money rewarded
  
  
• {ore} → The type of ore mined
  
  
• {multiplier} → Multiplier applied (based on permission)
  

Commands

Command Description Permission
/mfo toggle Enable/disable reward messages moneyfromores.toggle
/mfo stats View your own mining stats moneyfromores.stats
/mfo top Leaderboard of top mining players moneyfromores.top
/mfo reload Reload plugin configuration moneyfromores.reload
Permissions

Permission Description
moneyfromores.toggle Allows player to toggle reward messages
moneyfromores.stats Allows access to /mfo stats
moneyfromores.top Allows access to /mfo top
moneyfromores.reload Allows reloading the plugin
moneyfromores.multiplier.X Applies reward multiplier (e.g., X = 2, 3, 5, 10)
ℹ️ The plugin automatically uses the highest multiplier the player has permission for.

⛏️ Anti-Farm System
MoneyFromOres includes a simple anti-exploit system:

• ✅ Blocks mined naturally generated in the world give rewards
  
  
• ❌ Blocks placed by players do not give rewards
  

This is done using metadata + BlockPlaceEvent tracking.

Stats System
Player stats are stored in stats.yml and track:

• Total number of ores mined
  
  
• Total money earned
  

More detailed stats and GUI leaderboard will be added in future versions.

Planned Features (Roadmap)

• GUI interface for player stats
  
  
• ✨ Rare mining events / lootbox effects
  
  
• PlaceholderAPI integration
  
  
• Multi-language support (lang.yml)
  
  
• BungeeCord support
  

❓ FAQ
Q: Can I disable sound or particles?
A: Yes, set effects.enabled: false in the config.

Q: My players don't get money!
A: Make sure Vault + a compatible economy plugin is installed and working properly.

Q: Can I change the chance per ore?
A: Not yet. The current chance is global (per block break). Per-ore chance coming soon.

Support & Contact
Need help? Want to report a bug or request a feature?

Contact: [email protected]
Website: https://quantumcraft-studios.com

Made with ❤️ by QuantumCraft-Studio