Script [FREE] Giveaway Script - Modern React-based Giveaway System

[zhoraFPS]

[RELEASE] Zhora Giveaway Script v1.0.0 - Modern React-based Giveaway System​

---

Description​

The Zhora Giveaway Script is a complete, modern giveaway system for ESX servers, equipped with an intuitive React-based user interface. Developed as a learning project, it offers a professional solution for server events and community rewards.

Preview​

Admin Panel Overview:

Hidden link for visitors, to see Log in or register now.

Live Demonstration:

Hidden link for visitors, to see Log in or register now.

---

Features​

Versatile Giveaways​

• Items (ox_inventory & standard ESX)
• Cash & Black Money
• Vehicles (automatic garage integration)
• Licenses (ESX License System)

Modern Admin Interface​

• React-based UI with Vite
• 3 Main Sections: Start Giveaway, Manage Items, History
• Responsive Design for all screen sizes
• Real-time Updates and validation

Multi-Language Support​

• German & English by default
• Fallback System for missing translations
• Easily Expandable for additional languages

Flexible Announcements​

• Chat System with HTML templates
• zhora_announce Integration (Script coming soon!)
• Custom Events & Exports for your own systems
• Configurable Message Types

Smart Features​

• Automatic Item Validation
• Vehicle Model Verification
• License Plate Generation
• History Tracking with winner details
• Conflict Detection and error handling

---

System Requirements​

Required:

• ESX Legacy
• oxmysql
• A modern web browser for the admin UI

Optional:

• ox_inventory (for advanced item features)
• Announcement script (or chat fallback)

---

Installation​

1. Download the latest release from GitHub
2. Extract the folder to your resources directory
3. Configure the config.lua according to your needs: Config.Language = 'en' -- or 'de'Config.InventorySystem = 'ox_inventory' -- or 'esx'Config.AdminGroups = {'admin', 'superadmin'}Config.AnnouncementSystem = 'chat' -- until zhora_announce is available
   
   
4. Add ensure zhora_giveaway to your server.cfg
5. Restart the server
6. Use /giveaway in-game

---

Usage​

For Admins:​

• /giveaway - Opens the admin panel
• /cancelgiveaway - Cancels current giveaway

For Players:​

• /enter - Joins the active giveaway

Admin Panel Sections:​

1. Start Giveaway - Configure new event
2. Manage Items - Predefine prizes for quick reuse
3. History - View past giveaways and winners

---

Important Notice​

Currently please use the chat system or implement your own announcement solution until I release zhora_announce (coming soon!).

The script already contains full integration for zhora_announce, however the announcement script itself is not yet available.

---

Configuration​

<details> <summary><strong>Advanced Configuration Options</strong></summary> -- Language and Fallback
Config.Language = 'en'
Config.UseFallbackLanguage = true
Config.FallbackLanguage = 'en'

-- Admin Permissions
Config.AdminGroups = {'superadmin', 'admin'}
Config.AdminCommand = 'giveaway'

-- Giveaway Settings
Config.DefaultGiveawayDurationMinutes = 5
Config.MinGiveawayDurationMinutes = 1
Config.MaxGiveawayDurationMinutes = 120
Config.DefaultMaxWinners = 1
Config.MaxPossibleWinners = 10

-- Vehicle License Plates
Config.Prefix = 'NS'
Config.PlateLetters = 0
Config.PlateNumbers = 4
Config.PlateUseSpace = false

-- Announcement System
Config.AnnouncementSystem = 'chat'
-- Other options: 'zhora_announce', 'custom_event', 'custom_export'

</details>

---

Technical Details​

Frontend:

• React 18 with modern hooks
• Vite build system
• Responsive CSS design
• NUI integration

Backend:

• Lua server/client scripts
• MySQL integration via oxmysql
• JSON file system for configuration
• Event-based architecture

Security:

• Admin group validation
• Input sanitization
• Error handling
• Anti-exploit measures

---

Known Issues & Roadmap​

Known Issues:

• Currently no known critical bugs

Roadmap:

• [ ] zhora_announce script release
• [ ] Additional announcement systems
• [ ] Discord bot integration
• [ ] Statistics dashboard
• [ ] API for external tools

---

Support & Feedback​

GitHub:

Hidden link for visitors, to see Log in or register now.

Issues:

Hidden link for visitors, to see Log in or register now.

Releases:

Hidden link for visitors, to see Log in or register now.

Feedback, suggestions, and contributions are warmly welcome! As a learning project, I appreciate any input from the community.

---

License​

This project is licensed under the MIT License - see

Hidden link for visitors, to see Log in or register now.

for details.

---

Screenshots and additional details available in the GitHub repository!

Developed for the FiveM Community with

 

[Trojan1c]

i rly like your script would love to have the react project to implement it into my hud but its a nice idea so i wrote my own