guilhermeCardosooo/samp-system-lockpick

🔓 (SA-MP/Open.MP) Lockpick System

Documentation in other languages:

🇧🇷 Português | 🇪🇸 Español | 🇫🇷 Français

🎯 Introduction

This project provides a lockpick minigame system for SA-MP / Open.MP servers.

The system allows players to attempt unlocking nearby vehicles using a timing-based mechanic, where the player must press a key at the correct moment to succeed.

It was designed to be simple, lightweight, and easy to integrate into existing gamemodes.

💡 How It Works

When a player uses the lockpick command:

• The system checks for nearby vehicles.
• A UI progress bar appears on the screen.
• A random hit zone is generated.
• The player must press Y when the progress indicator reaches the correct area.

The system includes:

• Random number of attempts
• Random success requirement
• Visual feedback for success or failure
• Vehicle state restoration

📂 Project Structure

samp-system-lockpick
├─ docs
│  ├─ assets             # Visual assets (demo GIF, images)
│  └─ locales            # Localized documentation files
├─ docs
│  ├─ assets
│  └─ locales            # Localized documentation files
├─ omp_lockpick.pwn      # Version for Open.MP servers
├─ README.md             # Primary documentation
└─ samp_lockpick.pwn     # Version for SA-MP servers           

🛠 Dependencies

This system requires the following libraries:

• Pawn.CMD (3.4.0)
• textdraw-streamer (2.0.4)

🚀 Usage

Add the script to your server and compile it normally.

To start the minigame:

    /lockpick

If a vehicle is near the player, the lockpick system will start.

🎮 Gameplay

• Press Y at the correct moment.
• Each attempt is recorded.
• A minimum number of successful hits is required.

If the player reaches the required amount of successful attempts, the vehicle will be unlocked.

🔔 Callbacks

The system provides the following callbacks:

forward OnPlayerLockPickStart(const playerid);
forward OnPlayerLockPickFinish(const playerid, const status);
forward OnPlayerLockPickUpdate(const playerid);

Status values:

    LOCK_STATUS_SUCCESS
    LOCK_STATUS_FAIL

📜 License

This project is licensed under the MIT License.