# alpha-KnifeTire

Slash tires, spark chaos — deflate any vehicle's tires with a melee weapon and watch the ride fall apart in real time.

### 🎉 Overview

**alpha-KnifeTire** lets players use knives, machetes, and other bladed melee weapons to slash a nearby vehicle's tires. A progress bar enforces a satisfying commitment time, the vehicle's alarm can fire on a configurable chance, and police can be dispatched to the scene — all gated by job whitelists, vehicle blacklists, and per-player cooldowns so the system fits cleanly into roleplay servers.

### ✨ Features

* 🔪 **Melee-Only Slashing** — Restrict the action to a configurable list of bladed weapons (knife, machete, dagger, hatchet, bottle…)
* 🎯 **Progress Bar Commitment** — Players must hold the action for a configurable duration before the tire deflates
* 🚨 **Vehicle Alarm Trigger** — Configurable chance and duration for the target vehicle's alarm to fire on slash
* 👮 **Police Dispatch** — Optional alert to police jobs with a fully configurable blip (sprite, scale, colour, flash, time, radius)
* ⏱️ **Per-Player Cooldown** — Throttle how often a player can slash to prevent spam
* 📏 **Distance Check** — Rejects the action if the nearest vehicle is farther than the configured range
* 🔒 **Job Whitelist & Blacklist** — `"Everyone"` mode or per-job allow list, plus a blocked list that overrides everything (great for blocking police/EMS)
* 🚫 **Vehicle Blacklist** — Forbid specific models and entire vehicle classes (helicopters/planes blocked by default)
* 📢 **Discord Logging** — Webhook embeds with configurable color and custom vehicle images
* 🌍 **Localization** — English and Turkish included; add more by creating files in `Locales/`


---

# 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.alpha-scripts.net/documentation/scripts/alpha-knifetire.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.
