> For the complete documentation index, see [llms.txt](https://docs.tzmc.dev/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tzmc.dev/docs/qb-core/coin-pinching.md).

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