# Overview

## zcf\_antitank

**zcf\_antitank** is a lightweight FiveM resource created to make firearm headshots more reliable on roleplay servers.

In some combat situations, players can survive headshots because of armor, health values, sync behavior or server-side balancing. This resource checks valid firearm headshot conditions and, when the configured rules are met, forces a clean kill.

It is designed for serious FiveM roleplay servers that want more consistent combat behavior without adding heavy systems or unnecessary logic.

### Main purpose

The goal of this resource is simple:

> If a player receives a valid firearm headshot within the configured rules, the result should be reliable.

zcf\_antitank does not try to replace your combat system. It only adds a controlled validation layer for firearm headshots.

### What it does

zcf\_antitank can:

* Detect firearm headshots on configured head bones.
* Ignore melee weapons by default.
* Use custom weapon range limits.
* Apply a validation delay before forcing the final kill.
* Prevent duplicate triggers with an internal cooldown.
* Ignore victims inside vehicles, if enabled.
* Ignore shooters inside vehicles, if enabled.
* Support optional debug logs for testing.
* Log forced kills server-side.

### What it is useful for

This resource is useful when your server has situations where headshots do not always behave as expected.

Common examples:

* Players surviving clear headshots.
* Armor or health values making firearm headshots inconsistent.
* Combat feeling unreliable during roleplay situations.
* Server owners wanting configurable weapon range limits.
* Staff needing debug logs while testing combat behavior.

### What it does not do

zcf\_antitank does not:

* Add a full combat system.
* Replace your weapon damage configuration.
* Modify weapon meta files.
* Manage armor values.
* Add custom death screens.
* Add medical or revive logic.
* Change melee weapon behavior.
* Guarantee custom compatibility with heavily modified combat scripts.

It is focused only on firearm headshot validation.

### Framework compatibility

The resource is designed for FiveM roleplay servers and is especially useful for ESX-based environments.

It does not require ESX events to run, because the logic works directly with FiveM damage events.

This keeps the resource lightweight and easier to install.

### Asset Escrow

zcf\_antitank uses the official Cfx Asset Escrow system.

The core logic is protected, while the configuration file remains editable.

You can edit:

* Weapon ranges
* Accepted head bones
* Debug mode
* Validation delay
* Hit cooldown
* Vehicle behavior
* Unknown firearm behavior

Protected files cannot be edited. This is normal for escrowed resources.

### Support

Support is provided for installation issues, bug fixes and product-related problems.

Custom edits are not generally included.

Before opening a support request, please read the Installation and Configuration pages carefully.


---

# 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://zcf-development.gitbook.io/zcf_dev/resources/zcf_antitank/overview.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.