🌟 tuncion_xp

A complete XP & Level system for FiveM with rich features and full customization.

📖 Documentation: docs.tuncion.de/scripts/tuncion-xp

---

🚀 Installation

1. Download the latest release from here
2. Upload to your server
3. Add ensure tuncion_xp to your server.cfg
4. Import the SQL file into your database
5. Restart your server (or start the resource)

---

✨ Features

• Complete XP handler with Level System
• Multiple exports for developers
• Built-in XP log system
• Discord Webhooks for every export
• Clean NUI notifications

---

🖼️ Images

🪙 Gain XP

📈 Remove XP

🚀 Reach new Level

👀 Webhooks for each export

Example for addXP

---

🔌 Scripts with Built-In Integration

The following FiveM Scripts already include automatic XP integration out of the box:

• 🚔 Dream Police Impound (dream_policeimpound) (🆓 Free)
• 🪙 Dream Cryptomining (dream_cryptomining)
• 🚙 Dream Fakeplates (dream_fakeplates)
• ♻️ Dream Junkyard (dream_junkyard)
• 🔌 Dream Solarjob (dream_solarjob)
• ⚡ Dream Solarsystem (dream_solarsystems)
• 🚗 Dream Used Cardealer (dream_usedcardealer)
• 🎰 Dream Vending (dream_vending)
• 💨 Dream Wind Turbines (dream_windturbines)
• 💼 Dream Secret Dealer (dream_secretdealer)

💡 Community-made integrations are also welcome!
If you’ve created an integration, feel free to contact us to have it added to this list.

---

🛠️ Exports

Getter

• getGlobalXP
• getGlobalRank
• getTotalXP
• getXP
• getNeededXP
• getRank
• getRankStage
• getXPLog

Setter

• addXP
• removeXP
• setXP
• addRank
• removeRank
• setRank
• resetPlayer
• resetPlayerXP

---

📡 Events

Event	Type	Description	Parameter
tuncion_xp:log:addXP	Server	Triggered when a player gains XP	source, { newRank: Bool, change: Integer }
tuncion_xp:log:removeXP	Server	Triggered when a player loses XP	source, { newRank: Bool, change: Integer }
tuncion_xp:log:setXP	Server	Triggered when a player's XP is set	source, { newRank: Bool, totalXP: Integer }
tuncion_xp:log:addRank	Server	Triggered when a player's rank is added	source, { rank: Integer, totalXP: Integer }
tuncion_xp:log:removeRank	Server	Triggered when a player's rank is removed	source, { rank: Integer, totalXP: Integer }
tuncion_xp:log:setRank	Server	Triggered when a player's rank is set	source, { rank: Integer, totalXP: Integer }
tuncion_xp:log:resetPlayer	Server	Triggered when a player is reset	source
tuncion_xp:log:resetPlayerXP	Server	Triggered when a player's XP is reset	source, { rank: Integer, totalXP: Integer }
tuncion_xp:log:addXP	Client	Triggered when a player gains XP	{ newRank: Bool, change: Integer }
tuncion_xp:log:removeXP	Client	Triggered when a player loses XP	{ newRank: Bool, change: Integer }
tuncion_xp:log:setXP	Client	Triggered when a player's XP is set	{ newRank: Bool, totalXP: Integer }
tuncion_xp:log:addRank	Client	Triggered when a player's rank is added	{ rank: Integer, totalXP: Integer }
tuncion_xp:log:removeRank	Client	Triggered when a player's rank is removed	{ rank: Integer, totalXP: Integer }
tuncion_xp:log:setRank	Client	Triggered when a player's rank is set	{ rank: Integer, totalXP: Integer }
tuncion_xp:log:resetPlayer	Client	Triggered when a player is reset	/
tuncion_xp:log:resetPlayerXP	Client	Triggered when a player's XP is reset	{ rank: Integer, totalXP: Integer }

---

📌 To Do

• Add Events
• Export: neededXP
• Level Multiplier
• Level Stages
• Command: View own Level
• XP Categories
• XP Categories Front-End