> For the complete documentation index, see [llms.txt](https://docs.alpha-scripts.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.alpha-scripts.net/documentation/scripts/alpha-knifetire.md).

# 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/`