🪙 FX-GOLDSEARCH

Advanced gold panning system for RedM with zone-based rewards, prop placement, water mechanics, and full framework compatibility.

---

📦 INSTALLATION

ensure fx-goldsearch

• Place the script inside resources/fx-goldsearch • Add ensure fx-goldsearch to your server.cfg • Restart your server • Make sure PolyZone is started before this script

---

⚙️ DEPENDENCIES

dependencies {
    'PolyZone'
}

• Required for zone detection system • Handles gold search areas and restrictions • Script will not work without it

---

📦 VORP ITEM INSTALL

INSERT INTO items (...)
VALUES
('bucket', 'Bucket', ...),
('bucketfull', 'Bucket Full', ...),
('goldnugget', 'Gold Nugget', ...),
('goldring', 'Gold Ring', ...),
('goldtable', 'Gold Search Table', ...),
('salt', 'Salt', ...)

• Required items for gold searching • bucket → used to collect water • bucketfull → required to start searching • goldtable → used to place search table • goldnugget / goldring → rewards

---

📦 RSG ITEM INSTALL

bucket        = { name = 'bucket', label = 'Bucket', ... },
goldtable     = { name = 'goldtable', label = 'Gold Search Table', ... },
goldnugget    = { name = 'goldnugget', label = 'Gold Nugget', ... },

• Required if using RSG framework • All items must be usable • Names must match config

---

⚙️ BASIC CONFIG

Config.Language = "en"
Config.UseTarget = false
Config.WaterTime = 60 * 1000
Config.ZoneNotify = true

• Language → system language • UseTarget → enables target system (RSG) • WaterTime → how long water lasts • ZoneNotify → shows enter/exit notifications

---

🎯 ITEM CONFIG

Config.Items = {
    BucketItem = "bucket",
    BucketFull = "bucketfull",
    TableItem = "goldtable"
}

• Defines required items • Must match database item names • Used for all core interactions

---

🧱 TABLE SYSTEM

Config.MaximumCreateTable = 3
Config.PropSpawnDistance = 40
Config.PropInteractionDistance = 1.5

• Limits how many tables a player can place • Controls visibility distance • Controls interaction range

---

⛏️ GOLD SEARCH SYSTEM

Config.ProgressSettings = {
    bucketfill = 5000,
    placing = 5000,
    fillwater = 3000,
    search = 5000,
}

• Controls action durations • bucketfill → filling water • placing → placing table • search → searching for gold

---

🌍 GLOBAL REWARD SYSTEM

Config.Rewards = {
    {
        Rewards = {
            [1] = {
                chance = 45,
                items = {
                    {item = "goldnugget", count = 1}
                }
            }
        }
    }
}

• Defines reward chances • chance → probability percentage • items → rewards list • Supports multiple reward tiers

---

📍 ZONE SYSTEM

Config.SearchLocation = {
    {
        name = "Gold Search Zone",
        zones = {
            vector2(...),
        },
        minz = 72.0,
        maxz = 78.0,
    }
}

• Defines restricted gold search areas • Uses PolyZone system • Only allows table placement inside zones

---

🚫 TOWN RESTRICTION

Config.BlacklistTowns = {
    ["valentine"] = 459833523,
}

• Prevents placing tables near towns • Avoids exploitation in safe zones

---

⚙️ TABLE PERMISSIONS

Config.RemoveTableSetting = 1
Config.RemoveWhitelistJobs = {
    ["sheriff"] = true,
}

• Controls who can remove tables • 0 → everyone • 1 → owner + whitelist jobs • 2 → owner only

---

🔔 NOTIFY SYSTEM

Notify({
  text = "Searching...",
  type = "success"
})

• Framework-based notification system • Supports VORP / RSG / REDEMRP • Fully customizable

---

⚙️ SERVER CONFIG

SV_Config.Webhook = {
    url = "",
    logo = "",
    banner = "",
}

• Used for logging system • Optional webhook integration

---

📁 DATA SYSTEM

spawnProp.json

• Stores placed gold tables • Data is saved per player • Used for persistence after restart

---

⚠️ IMPORTANT NOTES

• PolyZone must be installed • Items must exist in database • spawnProp.json must not be deleted • TableItem must match config • Zones must be defined if PlaceAllMap = false

---

🚨 COMMON MISTAKES

• Missing PolyZone • Wrong item names • Missing items in database • Not defining zones • Table not spawning due to limits

---

🏁 SUMMARY

FX-Goldsearch provides:

• Advanced gold panning system • Zone-based gameplay • Dynamic reward system • Prop placement system • Full framework compatibility

---

© Fixitfy Development