📚 RTP-Custom

### Основные возможности:
- 🎯 Три режима телепортации (обычная, возле игроков, безопасная)
- 🛡️ Расширенная система безопасности
- ⏱️ Настраиваемая задержка и откат
- 🎨 Поддержка HEX цветов в сообщениях
- 🔊 Звуковые и визуальные эффекты
- 💰 Интеграция с экономикой (Vault)

---

## Команды

### Основные команды:

| Команда | Описание | Право доступа |
|---------|----------|---------------|
| /rtp | Обычная случайная телепортация | customrtp.use |
| /rtp player | Телепортация возле других игроков | customrtp.player |
| /rtp safe | Безопасная телепортация с доп. проверками | customrtp.safe |
| /rtp [игрок] | Телепортировать другого игрока | customrtp.others |
| /rtp reload | Перезагрузить конфигурацию | customrtp.reload |

### Алиасы команд:
- /randomtp
- /randomteleport

---

## Права доступа (Permissions)

### Базовые права:

#### customrtp.use
- Описание: Разрешает использовать команду /rtp (обычная телепортация)
- По умолчанию: true (все игроки)
- Использование: Базовая случайная телепортация

#### customrtp.player
- Описание: Разрешает использовать команду /rtp player (телепортация возле игроков)
- По умолчанию: true (все игроки)
- Использование: Телепортация на расстояние 10-100 блоков от других игроков

#### customrtp.safe
- Описание: Разрешает использовать команду /rtp safe (безопасная телепортация)
- По умолчанию: true (все игроки)
- Использование: Телепортация с максимальными проверками безопасности

#### customrtp.others
- Описание: Разрешает телепортировать других игроков
- По умолчанию: op (только операторы)
- Использование: /rtp [игрок]

### Права на обход ограничений:

#### customrtp.bypass.cooldown
- Описание: Обход времени отката между телепортациями
- По умолчанию: op (только операторы)
- Эффект: Игрок может телепортироваться без ожидания

#### customrtp.bypass.cost
- Описание: Обход оплаты за телепортацию
- По умолчанию: op (только операторы)
- Эффект: Бесплатная телепортация (требует Vault)

### Административные права:

#### customrtp.reload
- Описание: Перезагрузка конфигурации плагина
- По умолчанию: op (только операторы)
- Использование: /rtp reload

### Групповое право:

#### customrtp.*
- Описание: Все права плагина
- По умолчанию: op (только операторы)
- Включает:
- customrtp.use
- customrtp.player
- customrtp.safe
- customrtp.others
- customrtp.bypass.cooldown
- customrtp.bypass.cost
- customrtp.reload

---

## PlaceholderAPI

### Доступные плейсхолдеры:

> ⚠️ Примечание: PlaceholderAPI интеграция будет добавлена в следующей версии плагина.

### Планируемые плейсхолдеры:

| Плейсхолдер | Описание | Пример вывода |
|-------------|----------|---------------|
| %customrtp_cooldown% | Оставшееся время отката в секундах | 45 |
| %customrtp_cooldown_formatted% | Отформатированное время отката | 0м 45с |
| %customrtp_has_cooldown% | Есть ли откат (true/false) | true |
| %customrtp_teleports_total% | Общее количество телепортаций игрока | 127 |
| %customrtp_last_x% | X координата последней телепортации | 1250 |
| %customrtp_last_y% | Y координата последней телепортации | 64 |
| %customrtp_last_z% | Z координата последней телепортации | -3400 |
| %customrtp_last_world% | Мир последней телепортации | world |
| %customrtp_nearby_players% | Количество игроков рядом | 3 |

### Примеры использования плейсхолдеров (после реализации):

В табе (TAB-плагин):


В скорборде (Scoreboard плагин):


В чате (DeluxeChat/ChatControl):


---

## Конфигурация

### Пример настройки прав в LuckPerms:



### Пример настройки в PermissionsEx:



---

## Примеры использования

### Сценарий 1: Обычный игрок


### Сценарий 2: VIP игрок


### Сценарий 3: Модератор


---

## Режимы телепортации

### 🎯 Обычный режим (/rtp)
- Дистанция: 100-5000 блоков
- Проверки: Базовые (лава, огонь, опасные блоки)
- Право: customrtp.use

### 👥 Режим "возле игроков" (/rtp player)
- Дистанция: 10-100 блоков от других игроков
- Проверки: Базовые
- Право: customrtp.player
- Особенности: Показывает список игроков рядом перед телепортацией

### 🛡️ Безопасный режим (/rtp safe)
- Дистанция: 500-3000 блоков
- Проверки: Расширенные
- Блоки вокруг
- Избегание воды
- Избегание высоких мест
- Уровень освещения (мин. 8)
- Право: customrtp.safe

---

## Поддержка

### Требования:
- Minecraft сервер 1.20.4+
- Java 17+
- Paper/Spigot API

### Опциональные зависимости:
- Vault (для экономики)
- PlaceholderAPI (для плейсхолдеров - в разработке)

### Версия плагина: 1.0.0
### Автор: animesao

---

## Дополнительная информация

### Конфигурационный файл
Расположение: plugins/RTP-Custom/config.yml

### Логи
Плагин записывает детальные логи телепортаций в консоль сервера.

### Поддержка HEX цветов
Формат: &#RRGGBB (например: &#FF5555 для красного)

### Tab-подсказки
При вводе /rtp и нажатии TAB появятся доступные варианты:
- player (если есть право customrtp.player)
- safe (если есть право customrtp.safe)
- Список онлайн игроков (если есть право customrtp.others)