# Coin Pinching

Add a unique and entertaining activity to your FiveM server with the **Coin Pinching Script**. This resource allows players to scavenge parking meters, phone booths, gumball machines, or any configurable object for loose change, cash, or even rare items.

⚡ **Key Features**:

* **Interactive Searching System**: Players can interact with various objects like parking meters, phone booths, and gumball machines to search for rewards.
* **Customizable Rewards**: Configure cash rewards and item probabilities for each type of object, allowing tailored experiences for your server.
* **Dynamic Target Interaction**: Players can easily identify and search objects using an intuitive targeting system.
* **Cooldown Management**: Prevent excessive searching by setting cooldowns for each object, maintaining balance and fairness.
* **Realistic Progress Bars**: Engage players with a time-based progress bar while they search, enhancing immersion.
* **Fully Configurable**: Adjust models, rewards, cooldowns, and interaction text to fit your server’s theme and style.

📋 **Requirements**:

* **QBCore Framework**: Seamlessly integrates with QBCore for handling rewards and items.

🔧 **Setup & Configuration**:

1. **Installation**: Place the script in your server's resources folder and add the start command to your server.cfg.
2. **Customize Models & Rewards**: Use the `config.lua` file to specify the objects players can search and define the rewards they can receive.
3. **Set Cooldowns & Timing**: Adjust cooldowns and progress bar durations to control gameplay flow.

Whether you're enhancing your roleplay scenarios or creating a fun scavenging mini-game, the **Coin Pinching Script** brings an engaging and rewarding mechanic to your FiveM server.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tzmc.dev/docs/qb-core/coin-pinching.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.