Solar Panel System

Package Description

☀️ Solar Energy System — Dynamic Power, Real Economy, Full Immersion

💡 Overview

Bring clean energy to your RP world with a fully optimized solar power system featuring real-time visuals, live weather simulation, smart economy, and advanced maintenance mechanics.

Players can freely install, manage, and sell solar panels with full ownership, detailed stats, and realistic environmental effects.

🖥️ Manage everything through an interactive control desk and intuitive in-game menus powered by targets or text UI.

🛒 Solar Panel Acquisition

• Purchase panels from a specialized solar shop managed by an NPC vendor.
• 5 unique models: Basic, Standard, Advanced, Expert, and Ultimate — each with different stats (production, storage, price).
• Buy & resell: sell panels or repair kits at 50% of their original value.
• Repair kits available for maintenance and restoration.

⚙️ Installation & Placement

Interactive Placement Mode

• Real-time preview with visual indicators for perfect alignment.

Placement Zones

• Configurable whitelisted and blacklisted zones (e.g. allowed in Mirror Park, restricted in Mission Row).
• Automatic checks for distance, ground validity, and map limits.
• Adjustable placement range (3m–50m).

🔑 Ownership & Management

• Exclusive ownership: each panel belongs to one player only.
• Configurable limit of panels per player (10 by default).
• Management desk accessible via NPC to monitor and manage all panels.
• Full menu via ox_target or textUI:
  • Energy collection
  • Repair
  • Detailed information
  • Change production mode
  • Pick up / move panel
• 
  

⚡ Production Modes

• Eco Mode: 70% output, 0% wear — long life, no maintenance.
• Normal Mode: 100% output, standard wear.
• Overclock Mode: 150% output, 300% wear — high risk, high reward.
• Switch modes instantly through the management menu.

🔋 Energy Production & Dynamic System

• Automatic energy generation every 5 minutes (configurable).
• Output depends on: panel type, active mode, efficiency, weather, and time of day.
• Storage capacity: 100–15,000 kWh depending on model.
• Automatic notification when storage is full.

🕒 Time Simulation

• Fully dynamic day/night impact with configurable multipliers:
  • Night: 30–80%
  • Day: 90–100%
  • Evening: 40–90%
• 
  

🌦️ Weather Simulation

• Production adjusts automatically based on weather:
  • Sunny: 100%
  • Cloudy: 60–80%
  • Rain/Storm: 40–60%
• 
  
• Compatible with cd_easytime, qb-weathersync, or native weather systems.

🧰 Maintenance, Durability & Repairs

• Gradual wear every cycle (-0.1% by default).
• Minimum efficiency: 30% before breakdown.
• Overclock mode triples wear rate.
• Eco mode prevents any degradation.
• Full repair via repair kits with animations and progress bars.
• Automatic alerts when efficiency drops below threshold.

💵 Economy & Energy Sales

Market Price

• Dynamic rate between $30 and $100 per kWh depending on supply and demand.
• Price updates every 10 minutes and syncs across the server.
• Live price display in the shop and sales menu.

Selling & Collecting

• Collect energy directly from the panel with an animated progress bar.
• Automatic conversion: kWh × current price.
• Funds instantly credited to the player’s account.
• Detailed statistics: total production and revenue history.

🔆 Bonuses & Random Events

• Network bonus: +5% production per nearby panel (up to +25%).
• Optional random events:
  • Solar Storm: production ×2 for 1 hour.
  • Malfunction: -30% efficiency temporarily.

🛡️ Security & Zone Control

• Strict ownership verification for all actions.
• Built-in rate limiting to prevent spam or abuse.
• Server-side anti-cheat on all transactions.
• Configurable whitelist/blacklist zones with debug visualization.

📊 Statistics & Monitoring

Per Panel

• Stored energy
• Efficiency (%)
• Active mode
• Total production & revenue

Per Player

• Total number of panels
• Complete list with overall summary
• Centralized management via the control desk

🧩 Compatibility & Technical Integration

Frameworks:

• ESX & QBCore (auto-detection).

Inventories:

• Compatible with: ox_inventory, qb-inventory, qs-inventory, codem-inventory, tgiann-inventory, and native systems (auto-detection).

Notifications & Progress Bars:

• Works with ox_lib (recommended), okokNotify, etc.
• Progress bar support: ox_lib, ESX, QBCore, or standalone.

Targets:

• ox_target (recommended), qb-target, or fallback textUI.

⚙️ Performance

• Fully optimized — Resmon: 0.00ms

🎥 Preview : https://youtu.be/e7Jm8G-KHUU