📦Installation

🔧 1. Requirements

Before installing, ensure you have the following dependencies:

• TMC Core https://store.tmc.bj/category/frameworks

---

📥 2. Download & Extract

1. Download the latest release from your keymaster.

2. Place the folder:

gunchi-metaldetecting

into your server’s resources directory.

---

🗄️ 3. Core Item

Add the following item to your core > shared.gta5.lua > Shared.Weapons

[`weapon_metaldetector`] = {
        ["name"] = "weapon_metaldetector",
        ["label"] = "Metal Detector",
        ["weight"] = 250,
        ["type"] = "weapon",
        ["ammotype"] = "AMMO_MD",
        ["image"] = "placeholder.webp",
        ["unique"] = true,
        ["stackable"] = true,
        ["useable"] = false,
        ["description"] = "For fining lost treasures buried underground.",
        ["decay"] = 1,
        ["decayRate"] = 201
    },

---

⚙️ 4. Configuration

config.lua

Use this file to configure:

• Loot Table

• Diggable Surfaces

• Permitted Zones

---

▶️ 5. Add to Server / Resources Config

Ensure the resource is started by adding the following to your server.cfg or resources.cfg:

ensure gunchi-metaldetecting

---

🔐 6. Escrow & Customization

This script uses escrow protection, however the following file remains editable:

• config.lua

This file allows you to customize gameplay without breaking escrow protection.

---

🎮 7. Usage

Once installed:

• Equip the metal detector

• Locate a signal

• Head to the signal location

• Action the prompt

• Receive loot from the loot table

• Wait configured cooldown period

• Re-do

---

🆘 8. Support

If you need help:

• Join my Discord server for support and updates