⛏️ ADVANCED MINING SYSTEM V3.0.0

💎 100% Open Source - No Escrow - No Obfuscation - No IP Lock - No Backdoor

The most comprehensive mining job script for FiveM. Fully open source, fully customizable, production-ready.

🆕 WHAT'S NEW IN V3.0.0

✨ 9 World Events (was 4) 🎯 Target System Support (ox_target & qb-target) 🛡️ Anti-Exploit Protection 🎛️ Full Admin Panel (ox_lib menu) 🏆 Leaderboard System (Daily/Weekly/Monthly) 😷 Gas Mask System (with toxic gas event) 🌍 Earthquake, Rich Vein, Mining Frenzy & Black Market events 📡 Multi-category Discord Webhooks 🔧 Improved code architecture (modular bridge system)

🪨 MINING SYSTEM

Unlimited configurable mining areas
Automatic rock spawning with ground detection
Pickaxe prop visible on player hand
Realistic mining animation
Particle effects on rock break
ox_lib skill check system
Configurable rock respawn timer
Distance-based interaction
NEW: Target system support (ox_target & qb-target)
NEW: Server-side distance validation
NEW: Anti-spam cooldown system

📊 XP AND LEVEL SYSTEM

SQL-based persistent XP tracking
50 levels (configurable)
Higher level = better drop rates
Rare ore gives bonus XP
Weekend XP multiplier
/mininglevel command to check progress
NEW: Customizable XP formulas
NEW: Rarity-based bonuses (Common/Uncommon/Rare/Legendary)

🏆 LEADERBOARD SYSTEM (NEW)

Persistent NPC with map blip
Daily top miners
Weekly top miners
Monthly top miners
ox_lib menu interface
Real-time data tracking
Configurable top count (default 10)
Visual rank system (Gold/Silver/Bronze)

🏭 PROCESSING SYSTEM

Convert raw ores into refined bars
5 processing recipes included
ox_lib context menu with item count
Processing animation
Fully configurable recipes
NEW: Location validation
NEW: Server-side recipe verification

💰 SELLING SYSTEM

Persistent NPC ore buyer
Dynamic time-based pricing
Peak hours bonus (14:00-22:00): +10%
Night penalty (00:00-06:00): -10%
Bulk sell bonus system
- 25+ items = +5% bonus
- 50+ items = +10% bonus
- 100+ items = +15% bonus
NEW: Black Market event (2x prices)
NEW: Configurable market hours

🛒 PICKAXE SHOP

Separate shop NPC with blip
4 items available:
- 🔨 Basic Pickaxe ($500)
- 🔨 Iron Pickaxe ($1,500)
- 🔨 Diamond Pickaxe ($5,000)
- 😷 Gas Mask ($2,000)
Purchase confirmation dialog
Buy animation
NEW: Inventory capacity check
NEW: Cash/Bank payment options

🎮 9 SPECIAL EVENTS

🌠 Meteor Event

Rare ore chances increase by 200%
Configurable interval and duration
Server-wide notification

⚡ Happy Hour

Double ore drops
Configurable active hours
Automatic activation

🎉 Weekend Bonus

+50% XP on weekends
+25% more ore on weekends
Automatic detection

🎁 Treasure Chest

Random chest spawns in mining area
Blip visible on map for all players
First player to open gets the reward
Rare loot inside
NEW: Server-side reward validation

🌍 Earthquake Event (NEW)

Camera shake effect
2x ore drops during quake
1.5x XP bonus
Only affects mining areas

💎 Rich Vein Event (NEW)

Bonus rare ores on every mine
30% chance per mining action
Custom reward table

☠️ Toxic Gas Event (NEW)

Dangerous gas in mining areas
Damage without gas mask
1.5x bonus for surviving
Gas mask must be equipped (use item)

🔥 Mining Frenzy (NEW)

3x XP multiplier
2.5x ore multiplier
50% faster mining
Most powerful event!

🌃 Black Market (NEW)

2x sell prices
Limited time offer
Configurable duration

🎯 TARGET SYSTEM SUPPORT (NEW)

ox_target fully supported
qb-target fully supported
DrawText3D fallback option
Toggle via config (no restart needed)
Auto-bound to NPCs and entities

🛡️ ANTI-EXPLOIT PROTECTION (NEW)

Action cooldowns (anti-spam)
Server-side distance validation
Tool verification system
Exploit attempt logging
Auto-kick option (configurable)
Discord webhook alerts
Database query protection

🎛️ ADMIN PANEL (NEW)

Open with /miningadmin command:

🎮 Event Management
- Start/stop any event
- View active events
👥 Player Management
- Set player level
- Set player XP
- Give tools to players
- Reset player data
📊 Server Statistics
- Total miners
- Total ores mined
- Top mined ores
- Active events count

Built with ox_lib menu for clean interface.

🔧 ADMIN COMMANDS

Player Commands:

/mininglevel - Check mining level and XP

Admin Commands:

/miningadmin - Open admin panel (NEW)
/miningevents - View all event statuses
/startmeteor - Start meteor event
/stopmeteor - Stop meteor event
/starthappyhour - Start happy hour
/stophappyhour - Stop happy hour
/starttreasure - Spawn treasure chest
/stoptreasure - Remove treasure chest
/startearthquake - Start earthquake (NEW)
/stopearthquake - Stop earthquake (NEW)
/startrichvein - Start rich vein (NEW)
/stoprichvein - Stop rich vein (NEW)
/starttoxicgas - Start toxic gas (NEW)
/stoptoxicgas - Stop toxic gas (NEW)
/startfrenzy - Start mining frenzy (NEW)
/stopfrenzy - Stop mining frenzy (NEW)
/startblackmarket - Start black market (NEW)
/stopblackmarket - Stop black market (NEW)

📡 DISCORD WEBHOOK SYSTEM

Single webhook OR multi-category webhooks (NEW)
Beautiful embed messages
Color-coded by action type
Customizable footer and avatar
Categories available:
- Mining actions
- Processing actions
- Selling actions
- Event triggers
- Admin actions
- Exploit attempts (NEW)

🔌 COMPATIBILITY

Frameworks:

✅ QBCore (all versions)
✅ ESX Legacy (1.10.0+)

Inventory Systems:

✅ ox_inventory
✅ qb-inventory
✅ ESX default inventory

Target Systems (NEW):

✅ ox_target
✅ qb-target
✅ DrawText3D fallback

Notification Systems:

✅ ox_lib
✅ qb-core
✅ ESX notifications

Languages:

✅ English
✅ Turkish
✅ Easy to add more

⚡ PERFORMANCE

| State | Resource Monitor | |-------|------------------| | 🟢 Idle | 0.00ms | | 🟡 Active mining | 0.01 - 0.02ms | | 🟠 NPC area (200m) | 0.02 - 0.04ms | | 🔴 Heavy event | 0.05ms max |

Optimizations:

Smart rock spawning (only when player nearby)
Distance-based NPC management
Optimized loops with proper sleep times
Entity culling at 200m range
Database query batching
Tested on 200+ player servers

📦 WHAT YOU GET

✅ All source files 100% readable ✅ All client files fully open ✅ All server files fully open ✅ Config files fully editable ✅ Modular bridge system (NEW) ✅ Locale system for easy language switching ✅ SQL file included ✅ Full GitBook documentation ✅ Discord support channel ✅ Free lifetime updates

File Structure:

bridge/ - Framework bridge (client & server)
client/ - Client-side scripts (8 files)
server/ - Server-side scripts (8 files)
shared/ - Shared config & locale system
locales/ - Language files
sql/ - Database installation

🔒 GUARANTEE

❌ No IP lock
❌ No backdoor
❌ No obfuscation
❌ No hidden code
❌ No escrow
✅ 100% transparent
✅ Lifetime updates included
✅ Active support

📋 REQUIREMENTS

ox_lib
oxmysql
QBCore or ESX Legacy
Any supported inventory system
(Optional) ox_target or qb-target

🎨 CUSTOMIZATION

Everything is configurable:

⚙️ Framework & inventory selection
🪨 Mining areas (unlimited)
⛏️ Tools and durability
💎 Ore types and rarity
🏭 Processing recipes
💰 Sell prices and market hours
🎮 Event timings and rewards
🌍 Language and translations
🛡️ Anti-cheat settings
📡 Webhook URLs
🎯 Target icons and labels
🔔 Notification preferences

💼 PROFESSIONAL SUPPORT

💬 Active Discord community
🎫 Ticket system for support
📚 GitBook documentation
🆕 Regular updates
🐛 Bug fixes included
💡 Feature suggestions welcomed

📊 STATS AT A GLANCE

| Feature | Count | |---------|-------| | 🌍 World Events | 9 | | 🪨 Default Mining Areas | 1 (unlimited supported) | | ⛏️ Pickaxe Tiers | 3 + Gas Mask | | 💎 Ore Types | 5 | | 🏭 Recipes | 5 | | 🌐 Languages | 2 (EN/TR) | | 🎛️ Admin Commands | 17 | | 📦 Total Items | 14 | | 🛡️ Anti-Exploit Layers | 5 |

🆚 ESCROW VS OPEN SOURCE

| Feature | Escrow Version | Open Source (THIS) | |---------|---------------|-------------------| | Source Code | Hidden | 100% Open | | Customization | Limited | Unlimited | | Bridge System | Locked | Editable | | Updates | Yes | Yes + Modify | | Support | Yes | Yes | | Resell | No | No | | Price | Lower | Higher |

💡 Looking for a budget option? Check our Escrow version for a lower price with same features (but locked code).

🎁 BONUS FEATURES

🎬 Custom animations
✨ Particle effects
🎨 Pickaxe prop attachment
🔔 Smart notifications
📊 Statistics tracking
🏆 Achievement-style rewards
🌅 Day/night system aware
📅 Weekend detection
⏰ Hour-based events

🚀 INSTALLATION

✅ Drag & drop into resources folder
✅ Import SQL file
✅ Add items to inventory
✅ Configure framework in config.lua
✅ Add to server.cfg
✅ Restart server
✅ Done! Start mining!

Setup time: ~5 minutes

📖 DOCUMENTATION

Full GitBook documentation available: 👉 https://elena-scripts.gitbook.io/elenascripts/jobs-and-activities/mining-job

Documentation Includes:

📥 Installation guide
⚙️ Configuration reference
📦 Items setup
🌍 Events documentation
🎮 Commands list
🆘 Troubleshooting
💡 Pro tips

💬 SUPPORT

Need help? Join our Discord: 👉 https://discord.gg/elena

💬 Active community
🎫 Support tickets
💡 Feature requests
🐛 Bug reports
🆕 Update announcements

🌟 WHY CHOOSE THIS SCRIPT?

✨ Production Ready - Tested on live servers with 200+ players 🛡️ Anti-Exploit - Built-in security measures 🌍 Multi-Language - English & Turkish included ⚡ Optimized - 0.00ms idle performance 📚 Documented - Comprehensive GitBook 🔧 Configurable - Every feature customizable 💎 Premium Quality - Professional code standards 🆕 Active Updates - Regular improvements 💬 Real Support - Not bot replies

📈 ROADMAP

Upcoming features (free updates):

🎯 Mission system
🛠️ Crafting bench
🏆 Achievement system
📱 Phone app integration
🤝 Co-op mining
🏭 Custom processing recipes per area
🎨 More language support

🎉 GET STARTED TODAY!

Transform your server's mining experience with the most advanced mining script on the market.

✅ 100% Open Source ✅ Production Ready ✅ Active Support ✅ Lifetime Updates ✅ No Hidden Costs

Made with ❤️ by Elena Scripts

📖 Documentation: https://elena-scripts.gitbook.io/elenascripts/jobs-and-activities/mining-job 💬 Support: https://discord.gg/elena