> For the complete documentation index, see [llms.txt](https://hardi-1.gitbook.io/wikivaltryx/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hardi-1.gitbook.io/wikivaltryx/mekhaniki/plaginy/regiony.md).

# Регионы

## **🏛️ СИСТЕМА РЕГИОНОВ**

Добро пожаловать в систему управления территориями! Наш плагин регионов позволяет игрокам обозначать свои территории и создавать именованные области для лучшей организации пространства на сервере.

{% hint style="warning" %}
**⚠️ ВАЖНОЕ ПРЕДУПРЕЖДЕНИЕ:**\
Регионы на нашем сервере служат **ТОЛЬКО для обозначения территории**. Они НЕ защищают от разрушения блоков, кражи или PvP. Это исключительно система маркировки земель для удобства игроков.
{% endhint %}

### **🎯 ЧТО ТАКОЕ РЕГИОНЫ?**

Регионы — это именованные области, которые игроки могут создавать для обозначения своих территорий. Система позволяет:

* 📍 **Обозначить границы** своих построек и территорий
* 🏷️ **Дать название** своим землям
* 👥 **Показать другим игрокам** владельца территории
* 🗺️ **Организовать пространство** на сервере

{% hint style="info" %}
**💡 Назначение регионов:**\
Регионы созданы для того, чтобы игроки могли четко обозначить свои территории и избежать конфликтов при строительстве. Это помогает создать более организованное игровое пространство.
{% endhint %}

### **📋 ПОЛНЫЙ СПИСОК КОМАНД**

| Команда                        | Описание                             | Пример использования       |
| ------------------------------ | ------------------------------------ | -------------------------- |
| `/territory pos1`              | Установить первую точку выделения    | `/territory pos1`          |
| `/territory pos2`              | Установить вторую точку выделения    | `/territory pos2`          |
| `/territory create <название>` | Создать регион с указанным названием | `/territory create МойДом` |
| `/territory delete <название>` | Удалить свой регион                  | `/territory delete МойДом` |
| `/territory clear`             | Очистить текущее выделение           | `/territory clear`         |
| `/territory list`              | Показать список всех регионов        | `/territory list`          |
| `/territory info`              | Информация о текущем регионе         | `/territory info`          |

{% hint style="success" %}
**🎮 Быстрый старт:**\
Новичкам рекомендуется начать с команд `pos1`, `pos2` и `create` — это основа работы с регионами!
{% endhint %}

### **🛠️ КАК СОЗДАТЬ РЕГИОН**

#### **Шаг 1: Выделение территории**

1. **Встаньте в первый угол** будущего региона
2. **Выполните команду** `/territory pos1`
3. **Перейдите во второй угол** (по диагонали)
4. **Выполните команду** `/territory pos2`

{% hint style="success" %}
**✨ Визуализация выделения:**\
После установки обеих точек вы увидите красивые частицы кораллово-розового цвета, показывающие границы выделенной области. Частицы обновляются в реальном времени!
{% endhint %}

#### **Шаг 2: Создание региона**

После выделения территории выполните:

```
/territory create НазваниеВашегоРегиона
```

{% hint style="info" %}
**📝 Правила названий:**

* Используйте понятные названия (МойДом, Ферма, Магазин)
* Избегайте слишком длинных названий
* Каждое название должно быть уникальным
  {% endhint %}

#### **Шаг 3: Проверка**

Используйте `/territory info`, находясь в своем регионе, чтобы убедиться, что он создан правильно.

{% hint style="warning" %}
**⚠️ Частая ошибка:**\
Убедитесь, что вы находитесь в том же мире, где устанавливали точки pos1 и pos2. Регионы не могут создаваться между разными мирами!
{% endhint %}

### **🎨 ВИЗУАЛЬНЫЕ ЭФФЕКТЫ**

#### **🌟 Частицы выделения**

* **Основные частицы:** Кораллово-розовый цвет (RGB: 251, 153, 154)
* **Дополнительные частицы:** Темно-розовый цвет (RGB: 201, 106, 108)
* **Обновление:** Каждые 0.4 секунды для плавной анимации
* **Дальность видимости:** До 50 блоков

#### **📱 Уведомления в Action Bar**

При входе в регион вы увидите стильное уведомление:

```
◆ НазваниеРегиона ◇ ВладелецРегиона ◆
```

{% hint style="info" %}
**🎨 Дизайн системы:**\
Все визуальные элементы выполнены в едином стиле с использованием кораллово-розовой цветовой гаммы для создания современного и приятного интерфейса.
{% endhint %}

### **🏠 УПРАВЛЕНИЕ РЕГИОНАМИ**

#### **📊 Просмотр списка регионов**

```
/territory list
```

Показывает все созданные регионы с их владельцами.

#### **ℹ️ Информация о регионе**

```
/territory info
```

Находясь в регионе, вы получите подробную информацию:

* 🏷️ **Название региона**
* 👤 **Владелец**
* 🌍 **Мир**
* 📏 **Размер в блоках**

#### **🗑️ Удаление региона**

```
/territory delete НазваниеРегиона
```

{% hint style="warning" %}
**⚠️ Права на удаление:**

* Вы можете удалять только **свои собственные** регионы
* Администраторы могут удалять любые регионы
* Удаление **необратимо** — будьте осторожны!
  {% endhint %}

### **🎯 ПРАКТИЧЕСКИЕ СОВЕТЫ**

#### **🏗️ Для строителей**

1. **Создавайте регионы до начала строительства** — это поможет избежать конфликтов
2. **Используйте описательные названия** — "Замок", "Ферма", "Торговый район"
3. **Оставляйте небольшой запас** по границам для будущего расширения

{% hint style="success" %}
**💡 Совет профессионала:**\
Создавайте регион немного больше, чем планируете строить. Это даст вам пространство для маневра и будущих улучшений!
{% endhint %}

#### **🤝 Для сообщества**

1. **Уважайте чужие регионы** — не стройте слишком близко к границам
2. **Общайтесь с соседями** — обсуждайте планы строительства
3. **Используйте `/territory list`** для поиска свободных мест

{% hint style="info" %}
**🤝 Этикет сообщества:**\
Хорошим тоном считается оставлять минимум 10-20 блоков между своими постройками и чужими регионами, если владелец не разрешил строить ближе.
{% endhint %}

#### **⚡ Оптимизация**

1. **Очищайте выделение** командой `/territory clear` после создания региона
2. **Не создавайте слишком большие регионы** без необходимости
3. **Удаляйте неиспользуемые регионы** для порядка

{% hint style="warning" %}
**⚠️ Производительность:**\
Слишком большие регионы могут влиять на производительность сервера. Создавайте регионы разумного размера!
{% endhint %}

### **🔧 ТЕХНИЧЕСКИЕ ОСОБЕННОСТИ**

#### **💾 Автосохранение**

* Регионы автоматически сохраняются каждые **5 минут**
* Данные сохраняются при выключении сервера
* Все регионы загружаются при запуске сервера

#### **🎮 Производительность**

* Частицы показываются только в радиусе **50 блоков**
* Система оптимизирована для работы с большим количеством регионов
* Минимальное влияние на производительность сервера

{% hint style="info" %}
**🔧 Техническая информация:**\
Система использует асинхронное сохранение данных, что означает отсутствие лагов при автосохранении регионов каждые 5 минут.
{% endhint %}

### **❓ ЧАСТО ЗАДАВАЕМЫЕ ВОПРОСЫ**

#### **Q: Защищают ли регионы от гриферов?**

**A:** НЕТ! Регионы служат только для обозначения территории. Они не предотвращают разрушение блоков или кражу предметов.

{% hint style="danger" %}
**🚨 Важно понимать:**\
Регионы — это НЕ система защиты! Они только показывают, что территория принадлежит определенному игроку. Для защиты используйте другие методы.
{% endhint %}

#### **Q: Сколько регионов можно создать?**

**A:** Ограничений по количеству регионов на игрока нет, но используйте их разумно.

#### **Q: Можно ли изменить размер региона?**

**A:** Нет, для изменения размера нужно удалить старый регион и создать новый.

#### **Q: Что делать, если регион не создается?**

**A:** Проверьте:

* Установлены ли обе точки (pos1 и pos2)
* Уникально ли название региона
* Находитесь ли вы в том же мире, где установили точки

{% hint style="success" %}
**🎉 Совет для новичков:**\
Начните с создания небольшого региона вокруг своего дома. Это поможет вам освоить систему и показать другим игрокам, что территория занята!
{% endhint %}

### **🚨 ПРАВИЛА ИСПОЛЬЗОВАНИЯ**

#### **✅ Разрешено:**

* Создавать регионы на свободных территориях
* Давать регионам любые названия (в рамках правил сервера)
* Удалять свои собственные регионы
* Создавать несколько регионов

#### **❌ Запрещено:**

* Создавать регионы на чужих постройках без разрешения
* Использовать оскорбительные названия регионов
* Создавать огромные регионы без цели
* Злоупотреблять системой для спама

{% hint style="danger" %}
**⚠️ Нарушение правил:**\
За нарушение правил использования системы регионов могут быть применены санкции вплоть до удаления всех ваших регионов и временного ограничения доступа к системе.
{% endhint %}

{% hint style="info" %}
**📋 Дополнительные правила:**

* Не создавайте регионы с целью "захвата" больших территорий без планов их использования
* Уважайте права других игроков на свободное строительство
* При спорах обращайтесь к администрации сервера
  {% endhint %}

***

### **📢 ПОДДЕРЖКА И ОБРАТНАЯ СВЯЗЬ**

Если у вас возникли вопросы, предложения или вы обнаружили баг — пожалуйста, сообщите нам:

🌐 **valtryx.fun/feedback**\
💬 **Discord** — канал поддержки

Не нашли ответ на свой вопрос? Обратитесь к администрации сервера!

{% hint style="info" %}
**🛠️ Техническая поддержка:**

* Регион не отображается в списке
* Частицы выделения не показываются
* Команды не работают
* Ошибки при создании/удалении регионов
* Проблемы с уведомлениями в Action Bar
  {% endhint %}

{% hint style="success" %}
**💬 Обратная связь приветствуется:**\
Ваши предложения по улучшению системы регионов помогают делать сервер лучше! Не стесняйтесь делиться идеями.
{% endhint %}