KyvClaims - Система защиты земель

Полный плагин для защиты земли для серверов Hytale, который позволяет игрокам требовать и защищать свои территории с графическим интерфейсом и гранулированными разрешениями на каждый район. Каждая претензия имеет независимый контроль над строительством, удалением блоков и использованием ковша.

Особенности

Основная защита

• Система претензийОпределение прямоугольных областей с использованием координат (GUI или команд)
• Двойной интерфейс: Используйте графический интерфейс или традиционные команды
• Доверенные игроки: Добавьте друзей для совместной работы в ваших заявлениях
• Буферная зонаАвтоматическая защита вокруг заявлений о предотвращении горя
• Тройная защита ковша: Продвинутая система для предотвращения горя воды / лавы

Разрешения и контроль

• Гранульные разрешения14 индивидуальных разрешений с поддержкой wildcard
• Контроль по требованиюКаждая область имеет независимые настройки доступа
• Инструменты Admin: Полный административный контроль над всеми претензиями

Визуальная обратная связь

• Клиентская визуализацияПограничный дисплей только для клиента
  • желтыйДействительная область для новых претензий
  • голубойПросмотр существующей заявленной площади
  • розовыйКонфликт с существующими претензиями

Дополнительные характеристики

• Распространенный крафтРемесло скамейки может получить доступ ко всем сундукам в вашем заявлении (требует разрешения)
• многоязычныйАнглийский и португальский (Бразилия)
• Постоянное хранениеПретензии автоматически сохраняются в формате JSON
• Публичный APIИнтеграция с магазинами, VIP-системами и экономическими плагинами

Как это работает

Два способа использования

1. Графический интерфейс

• Откройте команду /claim
• щелкнуть POS1 и POS2 Кнопки для выбора углов области
• Визуальная обратная связь с цветными границами показывает статус выбора
• Используйте / используйте снова, чтобы открыть экран подтверждения
• щелкнуть Создать претензию доработать

2. Традиционные команды

• Используйте /claim pos1 и /claim pos2 для выбора области
• Выполнять / требовать создать
• Управляйте командами, такими как /claim trust, /claim list и т. Д.

Система визуальной обратной связи

Плагин отображает цветные границы, чтобы помочь вам понять статус претензии:

• Желтые границыДействительная область - вы можете претендовать на это пространство

• Голубые границыСуществующая претензия - просмотр заявленной области

• Розовые границыКонфликт - область пересекается с другим утверждением

Защитный поток

1. Выберите область: Используйте кнопки или команды GUI (/claim pos1, /claim pos2)
2. Визуальная обратная связь: Цветные границы с указанием статуса
3. Создать претензиюПодтвердить в GUI или использовать /claim create
4. Управление: Добавить доверенных игроков, переименовать или удалить претензии
5. Активная защита: Только владелец и доверенные игроки могут создавать / ломать / использовать ведра.

Буферная зона

5-блочный буфер вокруг каждой претензии не позволяет строить слишком близко к чужим территориям. Только владелец претензии и доверенные игроки могут строить в своей буферной зоне.

Распространенный крафт

При включении игроки с разрешения могут использовать крафтовые скамейки, которые извлекают материалы из Все сундуки в их претензии Вместо ближайших. Идеально подходит для больших баз с организованными системами хранения. Требования kyvclaims.use.claimwidecrafting Разрешение.

командование

Пользовательские команды

• /claim - Открытый интерфейс требований
• /claim pos1 - Определение первого углового положения
• /claim pos2 - Определение позиции второго угла
• /claim create - Создание претензии с выбранной областью
• /claim cancel - Отмена текущего выбора
• /claim list - Перечислите свои претензии
• /claim information - Посмотреть информацию о претензии в вашем месте
• /claim trust <player> - Добавить доверенного игрока в текущее требование
• /claim untrust <player> - Удалить доверенного игрока из текущей претензии
• /claim abandon <name> - Удалить претензию по имени

Административные команды

• /claim admin list - Список всех требований сервера
• /claim admin remove <name> - Удалить любые претензии
• /claim admin remove <player> <name> - Удалить требование конкретного игрока
• /claim admin setlimit <player> <blocks> - Настройка лимита блока игрока
• /claim admin addblocks <player> <blocks> - Добавить блоки к лимиту игрока
• /claim admin info <player> - Просмотр информации о претензии игрока
• /claim admin reload - Перезагрузка конфигурации плагина
• /claim admin bypass - режим обхода Toggle (игнорировать все защиты)

конфигурация

Плагин создает два файла в mods/kyvclaims/:

config.json

Настройка параметров по умолчанию:

• По умолчанию BlockLimitКоличество блоков по умолчанию, на которые может претендовать каждый игрок
• Обсуждение Buffer DistanceМинимальное расстояние между блоками
• Скачать ClaimWideCrafting: Включить функцию крафта в целом
• языкЯзык интерфейса - en_US (английский) или pt_BR (португальский)

Пример конфигурации:

{
"defaultBlockLimit": 10000,
"требование Буферное расстояние": 5,
«EnableClaimWideCrafting»: правда
«Язык»: «en_US»
?

Расстояние буфера объясняется: Буферное расстояние не позволяет создавать претензии слишком близко друг к другу. Например, с Расстояние между ними: 5Игроки не могут создавать претензии в пределах 5 блоков существующих претензий (если они не владеют существующими претензиями). Это помогает предотвратить горе и поддерживает расстояние между территориями игроков.

claim.json

Все претензии автоматически сохраняются в формате JSON. Этот файл управляется плагином и не должен редактироваться вручную.

Разрешения

Управление разрешениями

Вы можете управлять разрешениями двумя способами:

1. Использование плагина разрешений (рекомендуется для сложных установок)
2. непосредственно в разрешениях сервера. Джонсон (простая настройка)

Добавляйте разрешения в группы в разрешениях вашего сервера. json файл, расположенный в корневой директории сервера.

Пример permissions.json:

{
"пользователи": {
"Игрок-уид-здесь": {
"группы": ["по умолчанию"]
?
?
"группы": {
"По умолчанию":
"kyvclaims.use.create",
"kyvclaims.use.remove",
"kyvclaims.use.trust",
"kyvclaims.use.untrust",
"kyvclaims.use.info",
"kyvclaims.use.list",
"kyvclaims.use.rename",
"kyvclaims.use.claimwidecrafting"
]
"ОП": ["*"]
?
?

Дикие карточки

• Кивгеймс. * - Все разрешения
• kyvclaims.use. * - Все разрешения пользователей
• kyvclaims.admin.* - Все разрешения администратора

Пользовательские разрешения

• kyvclaims.use.create Создавать претензии
• kyvclaims.use.remove - Удалить собственные претензии
• kyvclaims.use.trust Добавить надежных игроков
• kyvclaims.use.untrust Удалить доверенных игроков
• kyvclaims.use.info - Посмотреть информацию о претензиях
• kyvclaims.use.list Перечислить собственные претензии
• kyvclaims.use.rename - Претензии на имя
• kyvclaims.use.claimwidecrafting - Используйте крафт в масштабе претензии (по умолчанию: ОТКАЗАНО)

Разрешения администратора

• kyvclaims.admin - Неограниченные блоки претензий
• kyvclaims.admin.create Создавать претензии к другим
• kyvclaims.admin.remove - Удалить любые претензии
• kyvclaims.admin.bypass Игнорировать любую защиту
• kyvclaims.admin.setlimit Установите ограничения на блокировку игроков
• kyvclaims.admin.reload - Конфигурация перезагрузки

ПримечаниеИгроки со статусом OP или kyvclaims. Разрешение администратора имеет неограниченные блоки претензий и полный доступ автоматически.

установка

1. Скачать последнюю версию
2. Поместите kyv-claims-x.x.x. jar в папке модов вашего сервера
3. Перезагрузить сервер
4. Настройка разрешений в разрешениях вашего сервера. Джонсон
5. Редактировать mods/kyvclaims/config.json при необходимости

Многоязычная поддержка

Плагин автоматически загружает сообщения на основе вашей конфигурации:

• Английский: Установите «язык»: «en_US» в конфигурации. Джонсон
• Португальский: Установите «язык»: «pt_BR» в конфигурации. Джонсон

Все элементы пользовательского интерфейса, команды и сообщения полностью переведены.

Разработчик API

KyvClaims предоставляет общедоступный API для интеграции с магазинами, VIP-системами и экономическими плагинами. См. раздел API ниже для деталей.

Поддержка

По вопросам, предложениям или вкладам:

• Report Bugs on the Issue Tracker (недоступная ссылка)

Присоединяйтесь к нашему сообществу Discord

Разработчик: ItaloSixx — KYV Верхний мир !

API Документация

KyvClaims предоставляет общедоступный API для интеграции с магазинами, VIP-системами и экономическими плагинами.

Настройка

Добавьте «kyvclaims» в Зависимости плагина в манифесте. Джейсон, затем импортируй com.claims. Заявка в вашем коде.

Основные методы

Управление блоками:

• AddClaimBlocks (UUID, int) Добавить блоки к лимиту игрока
• Удалить ClaimBlocks (UUID, int) Удалить блоки из лимита игрока
• setClaimBlocks (UUID, int) Установить полный лимит блока
• ResetToDefault (UUID) - Перезагрузить до предела по умолчанию

Методы запросов:

• Доступные блоки (UUID) - Получить доступные блоки (общий - используется)
• GetUsedBlocks (UUID) Получить блоки, используемые в претензиях
• GetTotalBlocks (UUID) Полный лимит блока
• canClaim (UUID, int) Проверьте, может ли игрок претендовать на область

Информация по претензиям:

• GetPlayerClaims (UUID) - Получить список требований игрока
• CanBuild (UUID, местоположение) Проверьте, может ли игрок строить на месте

Случаи общего использования

• Плагины магазинов: Продажа блоков претензий с использованием addClaimBlocks()
• VIP Системы: Предоставить дополнительные блоки с помощью setClaimBlocks()
• Интеграция экономики: Проверьте доступные блоки перед покупкой
• Ранговые системы: Различные лимиты блоков для ранга
• Вознаграждение за события: Блоки претензий в качестве вознаграждения

Примечание: Игроки со статусом OP или kyvclaims. Разрешение администратора имеет неограниченные блоки автоматически.

Методы запросов

GetAvailableBlocks (UUID PlayerUUID)

Возвращает, сколько блоков игрок может использовать.

• Возвращение: инт - Доступные блоки (общий - используется)

GetUsedBlocks (UUID PlayerUUID)

Возвращает, сколько блоков игрок использовал в претензиях.

• Возвращение: инт - Используемые блоки

GetTotalBlocks (UUID PlayerUUID)

Возвращает общий лимит блокировки игрока.

• Возвращение: инт Общий лимит

canClaim (UUID playerUUID, int blockCount)

Проверьте, есть ли у игрока достаточно блоков, чтобы претендовать на область.

• Возвращение: булевый - истинный Если можно претендовать

Информация о претензиях

getPlayerClaims (UUID PlayerUUID)

Возвращает список всех претензий, принадлежащих игроку.

• Возвращение: Список <Claim> - Претензии игрока

canBuild (UUID playerUUID, Местоположение)

Проверьте, может ли игрок построить игру в определенном месте.

• Возвращение: булевый - истинный Если разрешено, ложный Если охраняется

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

Плагин магазина - Продавайте блоки претензий:

• Звони: ClaimAPI.addClaimBlocks (playerUUID, 1000)
• Возвращение: истинный Если успешно

VIP Система - Установите пользовательский лимит:

• Звони: ClaimAPI.setClaimBlocks (плеерUUID, 50000)

Информация о Display Player:

• Звони: ClaimAPI.getAvailableBlocks (playerUUID)
• Возврат: количество блоков, которые игрок может использовать

Проверьте, прежде чем утверждать:

• Звони: ClaimAPI.canClaim (playerUUID, blockCount)
• Возвращение: истинный Если у игрока достаточно блоков

Важные заметки

• ОП/администраторы: Игроки со статусом ОП или kyvclaims.admin Неограниченные блоки автоматически
• Настойчивость: Все ограничения автоматически сохраняются в mods/kyvclaims/claims.json
• Безопасность потока: Все методы API являются безвредными
• Ограничение по умолчанию: Настроенный в config.json с По умолчанию BlockLimit

Случаи общего использования

• Плагины магазинов: Продажа блоков претензий с использованием AddClaimBlocks()
• VIP Системы: Грант дополнительные блоки с SetClaimBlocks()
• Интеграция экономики: Проверьте доступные блоки перед покупкой
• Ранговые системы: Различные лимиты блоков для ранга
• Вознаграждение: Дайте блоки претензий в качестве награды за событие