Sun Potion System

🧪 Sun Potion System

📖 Plugin Overview

Introducing a brand-new modular potion system built for FiveM servers. This system features 8 pre-configured potions with unique effects, ranging from basic health restoration to powerful supernatural enhancements. With an advanced effect stacking mechanism, modern UI, and comprehensive administrative controls, it delivers a balanced yet rich RPG experience to your server.

💰 Pricing & Purchase

• Official Escrow Price: 750 TWD
• Purchase Link: 👉 Click here to visit the store

✨ Key Features

• 🧪 Diverse Potion System (Expandable)
• • 8 Default Potions: Includes Health, Speed, Strength, Jump, Swimming, Hunger, Thirst, and Armor.
  • Persistent Effects: Base effects last 5 minutes, providing a stable buff experience.
  • Smart Stacking: Supports continuous consumption of the same potion type, stacking up to a maximum of 30 minutes.
  • Anti-Abuse Cooldown: Built-in 5-second usage cooldown to ensure combat balance.
• 🌐 Full Multi-Language Support
• • Bilingual Toggle: Default support for Traditional Chinese and English.
  • Independent Modules: Framework-independent translation system for easy modification.
  • Auto-Fallback: Automatically reverts to default language if translation entries are missing.
• 🛠️ Advanced Administrative Tools
• • Command Suite: 8 built-in admin commands for bulk distribution and system diagnostics.
  • Self-Diagnosis: Use /superdiag to instantly check system status and Webhook connectivity.
  • Discord Integration: Real-time logging of administrative actions via Webhook.
• 📱 Premium User Interface (UI)
• • Modern Design: Features gradient tones and smooth animations for a high-quality feel.
  • Real-time HUD: Displays remaining time and stack counts directly on screen.
  • Responsive Layout: Automatically scales to fit any screen resolution.

🧪 Potion Effect List

Potion Type

Effect Description

Max Stack

❤️ Healing

Restores 5 HP per second

30 Mins

⚡ Adrenaline

Movement Speed +49% & Infinite Stamina

30 Mins

💪 Strength

Weapon Damage +50%

15 Mins

🦘 Jump

Enables Super Jump ability

10 Mins

🏊 Swimming

Speed +80% & Extended breath underwater

20 Mins

🍖 Satiety

Continuously restores Hunger levels

30 Mins

💧 Hydration

Continuously restores Thirst levels

30 Mins

🛡️ Armor

Restores 5 Armor points every 2 seconds

20 Mins

⌨️ Administrative Commands

• /givepotion [ID] [Type] [Amount] – Give specific potion to a player.
• /giveallpotions [ID] [Amount] – Distribute a full set of all potions.
• /clearpotion [ID] – Forcefully remove all active effects from a player.
• /reloadpotion – Hot-reload configuration files.
• /superdiag – Run a full system diagnostic.
• /testwebhook – Verify Discord connection.
• /potioninfo – Allows players to check their own active buffs.

⚙️ Technical Specifications & Installation

• Framework: ESX Legacy
• Requirements: esx_status (Required for Hunger/Thirst restoration)
• Installation:
• 1. Place the sun_potion folder into your server's resources directory.
  2. Add ensure sun_potion to your server.cfg.
  3. Ensure esx_status is started beforehand.
  4. Adjust multipliers and durations in config.lua as needed.
  5. Restart the server or refresh and start the resource.