Orbis

Современный многоплатформенный плагин для защиты регионов.

Orbis всё ещё на ранней стадии разработки.

Вероятны обходы защиты и другие баги. Пожалуйста, сообщайте обо всех багах и проблемах на GitHub. Если вы хотите увидеть какую-то функцию, откройте issue.

Orbis — это современный плагин для защиты регионов в Minecraft, поддерживающий последнюю версию и большинство платформ: Paper, Fabric, NeoForge и Sponge. Он не совместим со Spigot; используйте Paper.

Чем Orbis отличается?

Вот ключевые особенности, которые выделяют Orbis среди других похожих плагинов:

• Современный, удобный интерфейс и команды.
• Поддержка типов регионов: кубоиды, полигоны, полиэдры и сферы.
• Визуализация регионов и выделения с помощью частиц для всех типов регионов.
• Мультиплатформенность: Paper, Fabric, NeoForge и Sponge.
• Продвинутый API, позволяющий выполнять набор запросов к миру или региону.
• Никаких внешних зависимостей.

Переезжаете с другого плагина?

В Orbis встроен инструмент миграции, который позволяет перенести ваши регионы из других плагинов.

Просто выполните `/orbis migrate ` на сервере с установленными Orbis и другим плагином, и ваши регионы будут перенесены в Orbis (насколько это возможно).

Для получения дополнительной информации загляните на страницу вики о миграции и найдите раздел для плагина, с которого хотите переехать.

📆 Поддерживаемые версии

Orbis стремится всегда поддерживать последнюю версию Minecraft.

Для модифицированных версий мы всегда ориентируемся на последнюю версию, которая сейчас — 1.21.10.

Для Paper и Sponge мы ориентируемся на 1.21.4-1.21.11 (Sponge API 14-18).

Более новые или старые версии могут работать, но не тестировались.

🚀 Начало работы

1. ⬇️ Скачайте плагин для вашей платформы.
2. 📂 Поместите .jar файл в папку plugins или mods вашего сервера.
3. 🔄 Перезапустите сервер. Orbis создаст свой конфиг и будет готов к использованию!

Создание региона

Смотрите пошаговое руководство на странице вики.

Настройка флагов

Список всех доступных на данный момент флагов смотрите на странице вики: https://github.com/EmpireWar/Orbis/wiki/Flags.

• Запретить ломать блоки в регионе:

  • /rg flag set spawn orbis:can_break false

• Разрешить наносить урон только зомби и хаскам:

  • /rg flag set arena orbis:damageable_entities ["minecraft:zombie","minecraft:husk"]

• Свои сообщения при входе/выходе:

  • `/rg flag set plaza orbis:entry_message "Welcome to the Plaza!"`
  • `/rg flag set plaza orbis:exit_message "Leaving Plaza..."`

• Сделать игроков неуязвимыми в области:

  • /rg flag set lobby orbis:invulnerability true

• Зафиксировать время на полдне:

  • /rg flag set museum orbis:time 6000

Дальнейшая настройка

Для получения дополнительной информации загляните в содержимое вики: https://github.com/EmpireWar/Orbis/wiki.

📚 API и интеграция

Замените PLATFORM на тип вашего сервера (например, paper, fabric, sponge).

Замените VERSION на последнюю версию Orbis. Для снапшотов используйте репозиторий /snapshots и добавьте -SNAPSHOT.

repositories {
    maven("https://repo.empirewar.org/releases")
}

dependencies {
    compileOnly("org.empirewar.orbis:PLATFORM-api:VERSION")
}

### Использование API
Чтобы узнать, как использовать API, загляните на страницу вики: https://github.com/EmpireWar/Orbis/wiki/API.

### События
Orbis вызывает события для каждой платформы:
- **RegionEnterEvent**
- **RegionLeaveEvent**

### 📖 Javadocs
Полная документация доступна здесь:
[Orbis Javadocs](https://repo.empirewar.org/javadoc/releases/org/empirewar/orbis/common/latest)