Yet Another World Protector
Yet Another World Protector (YAWP) представляет собой основной инструмент администратора для защиты вашего сервера Minecraft (выделенного, локальной сети, а также одиночной игры!). Он доступен для (Neo-) Forge и Fabric.
YAWP разработан для использования на выделенных серверах, но также может использоваться в одиночных мирах и мирах, открытых для локальной сети. Он позволяет администраторам (и игрокам с назначенными разрешениями) защищать свои творения от различных событий/действий игроков, мобов и окружающей среды.
Создавайте регионы для своих построек и применяйте флаги регионов для их защиты. Назначайте игроков или команды vanilla регионам, чтобы они могли управлять своими собственными регионами.
YAWP был вдохновлен модом для forge WorldProtector и плагином WorldGuard.
Мод в настоящее время находится в бета-стадии, многие функции еще не реализованы, но появятся в будущем. Эти функции будут включать большинство вещей, которые вы знаете из WorldProtector и WorldGuard.
Этот мод будет выпущен для версий Minecraft 1.16.5+. Если вы живете в прошлом и ищете версию для Minecraft 1.12.2, предлагаю рассмотреть возможность использования WorldDefender.
Начиная с Minecraft 1.20.4, YAWP больше не будет доступен для Forge и перейдет на NeoForge.
В YAWP существует три различных типа регионов для защиты вашего сервера:
Глобальный Регион
Глобальный Регион... ну, глобальный. Флаги, установленные в Глобальном Регионе, применяются ко всем измерениям сервера и, следовательно, ко всем Локальным Регионам.
Измерительные Регионы
Измерительные Регионы — это особые регионы, которые привязаны к одному измерению — подобно флагам игровых правил для разных измерений.
Измерительные Регионы не имеют пространственных ограничений в соответствующем измерении. Они работают как обычные регионы, но привязаны к измерению.
Они не могут быть созданы вручную. Фактически, они автоматически генерируются с каждым новым измерением. Первый Измерительный Регион для overworld создается при создании сервера.
Следующие Измерительные Регионы создаются всякий раз, когда игрок перемещается в новое измерение, создавая таким образом новое измерение с соответствующим Измерительным Регионом. Модовые измерения также поддерживаются.
Локальные Регионы
Локальные Регионы — это регионы, которые вы, скорее всего, знаете из WorldGuard или WorldProtector. Они имеют определенную область, в которой действуют и к которой ограничены.
С помощью Локальных Регионов вы можете создавать области в своем мире, которые хотите защитить от определенных действий/событий, вызванных игроками, другими сущностями или окружающей средой.
Для создания Локального Региона вам потребуется разрешение от родительского региона или разрешение из конфигурации.
Локальные Регионы можно создать, отметив область с помощью RegionMarker и выполнив соответствующую команду или просто используя команду без RegionMarker.
Пока область региона может быть определена как кубоид или сфера, но в будущих обновлениях планируется добавить больше форм для областей регионов.
Свойства регионов
Свойства регионов, флагов, групп и т.д. можно управлять через интерактивный CLI.
Цветной текст указывает на интерактивные команды-ярлыки или предложения команд. Весь цветной текст имеет всплывающую подсказку, которая кратко объясняет, что делает соответствующий элемент при нажатии.
Нажатие на них дает игроку предложение выполнить команду или иногда напрямую выполняет команду, на которую указывает текст при наведении.
Регионами могут управлять только их владельцы, или игроки, имеющие требуемый уровень OP или запись в конфигурации. Для получения дополнительной информации посетите вики.
Всякий раз, когда новый Локальный Регион создается без указания родительского региона, родителем устанавливается Измерительный Регион, в котором создается новый Локальный Регион.
Локальные Регионы также могут иметь дочерние регионы. Дочерние элементы Локального Региона должны содержаться в области родительского региона. Иерархия регионов также определяет приоритеты регионов. Дочерние регионы всегда должны иметь более высокий приоритет, чем их родитель.
Измерительные Регионы всегда имеют Глобальный Регион в качестве родителя, и, следовательно, Глобальный Регион имеет все Измерительные Регионы в качестве дочерних регионов.
Регионы имеют владельцев и обычных участников. Владельцам разрешено управлять регионом и обходить флаги, участникам разрешено только обходить флаги, установленные в регионе.
Владельцами и участниками могут быть отдельные игроки или команда.
Группы позволяют назначать определенные разрешения регионов разным игрокам и командам. В настоящее время есть только две группы по умолчанию: владельцы и участники.
Владельцы могут самостоятельно управлять своим регионом и добавлять других игроков/команды в регион. Они также могут создавать свои собственные подрегионы в своем регионе, управлять флагами и т.д., и, конечно, владельцы обходят флаги.
Участники имеют разрешение только на обход флагов.
Планируется добавить интеграцию с LuckPerms в будущем обновлении, чтобы вы могли определять свои собственные группы и разрешения.
Флаги являются ядром системы защиты регионов. Они определяют, какие действия разрешены или запрещены в регионе. Флаги могут быть установлены в:
- Разрешено, чтобы разрешить соответствующее действие,
- Запрещено, чтобы запретить соответствующее действие,
- Отключено, чтобы отключить конкретный флаг для проверок флагов.
Дочерние регионы наследуют флаги от своих родительских регионов. Кроме того, можно переопределить состояние флага для дочерних регионов, соответствующим образом установив свойство override флага родительского региона.
См. страницу Флаги для получения более подробной информации о различных флагах.
Планируется добавить больше флагов в будущем. Список предлагаемых флагов, которые я постепенно добавлю в мод, можно найти здесь: Предложения по флагам
В будущем также появятся более сложные флаги. Например, ListFlag, который позволит вам определить список разрешенных блоков/сущностей/.., которые запрещены в контексте флага.
Команды мода также разработаны для использования консолью сервера и могут выполняться командными блоками.
Это позволяет автоматизировать настройку регионов, добавлять/удалять игроков, включать или отключать регионы и т.д.
YAWP предоставляет растущий API интеграции модов для более легкой интеграции модов и модпаков. В настоящее время API позволяет другим модам прослушивать события создания, изменения и удаления регионов и отменять эти события, чтобы предотвратить их возникновение.
Кроме того, существуют события для проверок флагов и их результатов, которые можно использовать для манипуляции исходом проверки флага.
Установка мода на стороне клиента обеспечивает поддержку языков (I18n) в виде ресурспака. В настоящее время поддерживаются английский, немецкий и русский языки.
Начиная с версии мода 0.0.2.9-beta2 и версии Minecraft 1.19.4, YAWP предоставляет перевод по умолчанию на английский язык.
Конфигурация мода позволяет контролировать, кому разрешено использовать мод, устанавливает флаги по умолчанию для Локальных и Измерительных Регионов, параметры интерфейса командной строки и т.д.
Конфигурация разделена на разные файлы, охватывающие различные темы.
yawp-common.toml- конфигурация для разрешений командyawp-flags.toml- конфигурация для флагов, пользовательских сообщений флагов и т.д.yawp-region-defaults.toml- конфигурация для свойств регионов по умолчанию
Поскольку YAWP является модом для серверной стороны, его конфигурация находится в каталоге /serverconfig в каталоге вашего мира Minecraft.
Документация мода небольшая, но растущая. Я стараюсь успевать за контентом. Вы можете найти документацию << здесь >>.
Документация охватывает
- описания различных регионов
- начало работы и ЧАВО
- доступные команды и флаги
- конфигурацию
- и многое другое ...
План разработки
Предстоит еще много функций. Мод находится в активной разработке! Следующий список не является исчерпывающим.
- Различные типы флагов (List, Effect, ...) для более детального контроля
- Конфигурация флагов на основе дата-паков
- Визуализация границ регионов
- Определение собственных групп регионов для более детального управления регионами (LuckPerms)
- Более детальная система разрешений (в сочетании с функциями более детальных групп)
- Шаблоны регионов для более удобного управления одинаковыми регионами с разными пространственными свойствами
- Триггеры регионов для входа/выхода из региона (для отображения сообщений, выполнения команд и т.д.)*
- Регионы с разными формами (Цилиндр, Призма, 3DPolygon)*
- <ваше предложение здесь>
