> For the complete documentation index, see [llms.txt](https://guide.kyivproject.fun/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.kyivproject.fun/mechanisms/advancedcapturepoints-or-zakhoplennya-teritorii.md).

# AdvancedCapturePoints | Захоплення територій

Система <mark style="color:orange;">**AdvancedCapturePoints**</mark> додає на сервер спеціальні PvP-точки, за які можуть боротися гравці. Контроль над такими зонами дозволяє отримувати <mark style="color:orange;">**нагороди**</mark>, <mark style="color:orange;">**ресурси**</mark> та тимчасове володіння <mark style="color:orange;">**територією**</mark>.

Механіка створена для розвитку PvP-активностей, конкуренції між гравцями та створення динамічних подій у відкритому світі.

***

## Виявлення гравця у зоні

Система використовує <mark style="color:orange;">**спеціальну**</mark> тривимірну область навколо центру точки. Для початку захоплення гравцю необхідно знаходитися біля <mark style="color:orange;">**центру**</mark> та перебувати у межах активної області, а ще не покидати зону захоплення.

### Розміри активної зони:

* <mark style="color:orange;">**3x3**</mark> блоки по горизонталі;
* до <mark style="color:orange;">**3**</mark> блоків у висоту.

Після входу у цю область система автоматично запускає процес захоплення.

Після входу в активну зону запускається <mark style="color:orange;">**таймер**</mark> захоплення території.

## BossBar та візуалізація

Під час захоплення гравець бачить:

* BossBar[^1] із <mark style="color:orange;">**прогресом**</mark>;
* таймер <mark style="color:orange;">**захоплення**</mark>;
* <mark style="color:orange;">**статус**</mark> точки.

***

## Система конкуренції за точку

Плагін підтримує систему боротьби за контроль території.

Якщо:

* один гравець <mark style="color:orange;">**захоплює**</mark> точку;
* інший гравець заходить у ту саму зону, тоді:
  * прогрес захоплення тимчасово <mark style="color:orange;">**заморожується**</mark>.

{% hint style="warning" icon="circle-info" %}
ВАЖЛИВО! Прогрес не скидається миттєво та не передається іншому гравцю.
{% endhint %}

***

### Коли прогрес обнуляється?

<mark style="color:orange;">**Скидання**</mark> відбувається лише тоді, коли поточний захоплювач <mark style="color:orange;">**покидає**</mark> територію точки. Ця система робить <mark style="color:orange;">**PvP-конфлікти**</mark> більш чесними та запобігає випадковому зриву захоплення.&#x20;

Стандартний час володіння - <mark style="color:orange;">**3 години**</mark>.

Протягом цього часу:

* інші гравці <mark style="color:orange;">**не можуть**</mark> перехопити контроль;
* власник отримує <mark style="color:orange;">**нагороди**</mark>;
* система <mark style="color:orange;">**відстежує**</mark> активність точки.

***

## Система нагород

Нагороди поділяються на два основні типи: <mark style="color:orange;">**миттєві**</mark> та <mark style="color:orange;">**інтервальні**</mark>.

{% columns %}
{% column width="41.66666666666667%" %}

#### **Миттєві нагороди:**

* видаються <mark style="color:orange;">**одразу**</mark> після успішного <mark style="color:orange;">**захоплення**</mark> точки.
  {% endcolumn %}

{% column width="58.33333333333333%" %}

#### Інтервальні нагороди:

* Поки гравець володіє точкою, система <mark style="color:orange;">**автоматично**</mark> видає додаткові нагороди через певний <mark style="color:orange;">**час**</mark>.
  {% endcolumn %}
  {% endcolumns %}

### Приклади:

* ресурси;
* валюта;
* спеціальні предмети;

### Особливості:

* нагороди <mark style="color:orange;">**генеруються**</mark> випадково;
* використовується система категорій <mark style="color:orange;">**складності**</mark>;
* ресурси беруться зі <mark style="color:orange;">**спеціального**</mark> пулу предметів.

***

## Контроль лімітів

Система автоматично розраховує <mark style="color:orange;">**максимальну**</mark> кількість нагород, <mark style="color:orange;">**перевіряє**</mark> час володіння точкою та не дозволяє отримати <mark style="color:orange;">**більше**</mark> ресурсів, ніж потрібно.

Якщо:

* точка захоплена на <mark style="color:orange;">**3 години**</mark>;
* нагороди видаються кожну годину, тоді:
  * максимум можна отримати <mark style="color:orange;">**3 інтервальні нагороди**</mark>.

Після закінчення часу:

* точка автоматично <mark style="color:orange;">**звільняється**</mark>;
* статус власника <mark style="color:orange;">**очищується**</mark>;
* лічильники <mark style="color:orange;">**скидаються**</mark>;
* територія стає <mark style="color:orange;">**доступною**</mark> для нового захоплення.

{% hint style="warning" icon="circle-info" %}
Система **AdvancedCapturePoints** продовжує розвиватися та отримувати нові функції й покращення.
{% endhint %}

[^1]: Смуга прогресу у верхній частині екрана, яка показує статус, таймер або прогрес певної події.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://guide.kyivproject.fun/mechanisms/advancedcapturepoints-or-zakhoplennya-teritorii.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.