Документация по Варпам Omicron

Добро пожаловать в всестороннее руководство по Системе Варпов Omicron! Эта мощная функция позволяет игрокам создавать, управлять и телепортироваться к пользовательским точкам варпов по вашим Minecraft-реалмам. Независимо от того, строите ли вы хаб, отмечаете места исследования или создаете ярлыки, варпы делают навигацию плавной и веселой.

🌟 Обзор

Система варпов построена на надежной архитектуре с использованием MongoDB для постоянного хранения и глубоко интегрируется с Omicron Core Engine. Варпы хранят не только позиции, но и данные о реалме, измерении и ориентации, обеспечивая точную телепортацию между разными мирами.

Ключевые особенности:

• Постоянное Хранение: Варпы переживают перезапуски сервера
• Поддержка Кросс-Реалм: Телепортация между разными реалмами
• Динамические Команды: Опциональные прямые ярлыки команд
• На Основе Разрешений: Гранулярный контроль над управлением варпами
• Регистрация в Реальном Времени: Команды обновляются автоматически

📋 Команды Варпов

Все команды варпов начинаются с /warp. Вот полное дерево команд:

Создать Варп

/warp create <имя>

Создает варп на вашем текущем местоположении. Имя должно быть уникальным во всех реалмах.

• Разрешение: warp.create
• Пример: /warp create home
• Сообщение Успеха: "Warp 'home' created"
• Неудача: "Warp 'home' already exists"

Телепортация к Варпу

/warp tp <имя>

Телепортирует вас к указанному местоположению варпа.

• Разрешение: warp.tp
• Подсказки: Автодополнение существующими именами варпов
• Пример: /warp tp spawn
• Сообщение Успеха: Сообщение о телепортации
• Неудача: "Warp 'spawn' not found"

Удалить Варп

/warp delete <имя>

Удаляет варп. Только создатель может удалить свои варпы.

• Разрешение: warp.delete
• Пример: /warp delete oldbase
• Сообщение Успеха: "Warp 'oldbase' deleted"
• Неудача: "You can't delete this warp"

Переключить Динамическую Команду

/warp needwarpcommand <имя> <true|false>

Включает или отключает прямую команду для этого варпа (например, /mywarp).

• Разрешение: warp.needwarpcommand
• Пример: /warp needwarpcommand shop true
• Сообщение Успеха: "Warp 'shop' needWarpCommand = true"
• Неудача: "Warp not found or not yours"

Список Всех Варпов

/warp list

Отображает все доступные варпы в списке через запятую.

• Разрешение: warp.list
• Пример: /warp list
• Вывод: "Warps: home, shop, spawn, mine"

⚡ Динамические Команды Варпов

Когда needWarpCommand установлено в true для варпа, становится доступна прямая команда:

/<имяварпа>

Это позволяет игрокам телепортироваться, используя только имя варпа, без префикса /warp tp.

Как Это Работает

• Команды регистрируются динамически при запуске сервера и перестройке дерева команд (после /reload)
• Только варпы с needWarpCommand = true получают прямые команды
• Логируется для целей отладки
• Предотвращает дублирование регистраций

Пример

Если у вас есть варп с именем "shop" и needWarpCommand = true:

/shop

Телепортирует вас прямо к варпу shop.

🔐 Разрешения

Система варпов использует контроль доступа на основе разрешений. Каждое действие требует соответствующего разрешения:

Разрешение	Описание
warp.create	Создавать новые варпы
warp.tp	Телепортироваться к варпам
warp.delete	Удалять собственные варпы
warp.needwarpcommand	Переключать прямые команды
warp.list	Список всех варпов

Примечание: Удаление варпов и переключение команд ограничено создателем варпа. Разрешения должны быть выданы администратором сервера.

🚀 Советы по Использованию

1. Соглашения об Именовании: Используйте описательные имена вроде "spawn", "shop", "mine_entrance"
2. Организация: Создавайте варпы для ключевых мест, чтобы улучшить опыт игроков
3. Динамические Команды: Включайте для часто используемых варпов, чтобы уменьшить набор текста
4. Кросс-Реалм: Варпы работают между реалмами, но обеспечивайте специфичное для реалма именование
5. Разрешения: Предоставляйте разрешения на создание/удаление осторожно, чтобы предотвратить злоупотребления

🔧 Устранение Неисправностей

• Варп не найден: Проверьте орфографию и убедитесь, что варп существует
• Не могу удалить: Только создатель может удалить свои варпы
• Команда не работает: Убедитесь, что needWarpCommand включено и сервер перезапущен
• Телепортация не удалась: Проверьте, загружено ли целевое измерение

---

Эта документация сгенерирована из кодовой базы Omicron Core Engine. Для технической поддержки обратитесь к команде разработчиков.