#🪙 FX-GOLDSEARCH

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

---

#📦 INSTALLATION

bashensure 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

luadependencies {
    'PolyZone'
}

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

---

#📦 VORP ITEM INSTALL

sqlINSERT 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

luabucket        = { 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

luaConfig.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

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

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

---

#🧱 TABLE SYSTEM

luaConfig.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

luaConfig.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

luaConfig.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

luaConfig.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

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

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

---

#⚙️ TABLE PERMISSIONS

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

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

---

#🔔 NOTIFY SYSTEM

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

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

---

#⚙️ SERVER CONFIG

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

• Used for logging system
• Optional webhook integration

---

#📁 DATA SYSTEM

jsonspawnProp.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