Features Guide

The Wizard’s Junk Trade script is a magical and immersive system that encourages exploration, item collection, and rewarding interactions. Below is a comprehensive overview of its features:

🔮 1. Mystical Trade System

Players can trade mysterious junk items with a mystical wizard to receive tiered rewards. The outcome is based on hidden item values, offering an engaging and mysterious experience rather than a simple recipe exchange.

  • 🧩 No Recipe Matching: Items are valued secretly, adding a layer of mystery.

  • 🎲 Random Rewards: Rewards are randomized from rarity-based loot pools.

📈 2. Tiered Reward System

The more valuable and numerous the trade items, the higher the reward tier.

Rarity
Item Count
Total Value
Sample Reward

Common

2

0+

Bandages, Plastics

Uncommon

3

60+

Copper, Armor

Rare

4

120+

Advanced Lockpicks, Ammo

Epic

5

200+

Drill, Electronic Kits

Legendary

6

300+

MK2 Weapons, VPN

Each tier has its own reward pool defined in config.lua.

🕯️ 3. Dynamic Night-Time Prop Spawning

Wizard tables only appear at night, enhancing immersion and roleplay.

  • 🌙 Appears from 8:00 PM to 5:00 AM

  • 🗺️ Multiple prop support for mystical scenes

  • 🧪 Particle effects: swirling magic, smoke, and glyphs

  • ❄️ Objects are frozen and persistent while active

🧙‍♂️ 4. Target-Based Interaction

Fully supports qb-target and ox_target frameworks.

  • 🧠 Intelligent auto-detection via Config.Target = "auto"

  • 🎯 Configurable zones and labels (e.g., "Investigate the Table")

  • 👻 Invisible zones disappear with the table at daybreak

🛠️ 5. Framework & Inventory Auto-Detection

Supports both QBCore and ESX frameworks with:

  • 🔍 Auto-detection or manual override (Config.Framework)

  • 🧰 Inventory integration with qb-inventory or ox_inventory

  • 🖼️ Uses your item image path via Config.InventoryLink

🛑 6. Trade Fatigue System

To prevent abuse or mindless low-value trades, a fatigue lockout is enforced:

  • 🔁 After Config.MaxConsecutiveLowTrades, the wizard will reject further trades until reset

📦 7. Configurable Items and Effects

All values, effects, and visuals are configurable:

  • 🎁 Trade item values (Config.TradeItems)

  • 🎇 Particle FX per prop (Config.Props)

  • ⏲️ Active hours (Config.NightStartHour, Config.NightEndHour)

  • 💡 Easily expandable with more props, rewards, or rules

📦 8. No SQL Setup Required

  • 🧙 Fully functional with drag & drop

  • ✅ Just add the required items to your inventory system

PreviousConfigurationNextWhy Choose This Script?

Last updated