Server documentation

BetterClaim

Active

Hytale • Version 1.5.1

Полное руководство для владельцев сервера: команды, иерархические права, справочник конфигурации и админ-сценарии.

Mod overview CurseForge

Команды, права, конфигурация и типовые админ-сценарии BetterClaim для владельцев серверов Hytale.

Отказ от ответственности: мод вдохновлён SimpleClaims.

Установка

Скачайте BetterClaim-x.x.x.jar на вкладке Files CurseForge
Положите JAR в mods/ сервера (или в папку модов Hytale для одиночной игры)
Запустите сервер — конфиг создаётся в plugins/BetterClaim/config.json
Выдайте права группам игроков (см. Права ниже)
В игре откройте хаб BetterClaim: /bc (или карту привата напрямую, если useBcHubUi = false)

Опционально: установите LuckPerms, чтобы динамические узлы (betterclaim.limit.N, betterclaim.playtime.N, betterclaim.admin.max-add-limit.N) учитывали наследуемые права групп. Без LuckPerms BetterClaim использует встроенные провайдеры Hytale (как в 1.2.x).

Одиночная игра: /perm group add OP betterclaim.gui (и другие узлы по необходимости), чтобы выдать себе доступ.

Админ-команды

Основная команда: /bc (алиас: /betterclaim)

Команды игрока — на странице обзора мода.

Command	Описание
`/bc admin`	Открывает GUI списка игроков для админа
`/bc admin players`	Выбор целевого игрока для админ-действий
`/bc admin chunk`	Карта привата в админ-режиме для выбранной цели
`/bc admin party`	Редактирование любой группы как админ
`/bc admin claim`	Приват текущего чанка для выбранного игрока
`/bc admin unclaim`	Снятие привата с текущего чанка для выбранного игрока
`/bc admin override`	Переключение обхода лимитов привата и полной защиты привата при админ-инструментах
`/bc admin denyzone pos1`	Сохраняет угол 1 прямоугольника без привата (текущий чанк)
`/bc admin denyzone pos2`	Сохраняет угол 2 прямоугольника без привата (текущий чанк)
`/bc admin denyzone create <name>`	Создаёт сохранённую запретную зону из pos1 + pos2
`/bc admin denyzone list`	Список всех запретных регионов
`/bc admin denyzone remove <name>`	Удаляет запретный регион
`/bc admin set-limit <player> <limit>`	Постоянное переопределение лимита привата
`/bc admin add-limit <player> <amount>`	Добавляет бонусные чанки привата игроку
`/bc admin create-party <player> [name]`	Создаёт группу для игрока

Админ-режим чанка: сначала /bc admin players для выбора цели, затем /bc admin chunk или админ claim/unclaim.

Права

BetterClaim использует иерархические права. Родительский узел выдаёт все дочерние.

Права на команды

Permission	Grants access to
`betterclaim.gui`	`/bc`: GUI карты территории
`betterclaim.claim`	`/bc claim` и приват кликом в GUI
`betterclaim.unclaim`	`/bc unclaim` и снятие привата кликом в GUI
`betterclaim.home`	`/bc sethome`, `/bc home`, `/bc delhome`, `/bc homes`
`betterclaim.party`	Все подкоманды группы (родительский узел)
`betterclaim.party.edit`	`/bc party`: GUI группы
`betterclaim.party.create`	`/bc party create`
`betterclaim.party.invite`	`/bc party invite`
`betterclaim.party.accept`	`/bc party accept`
`betterclaim.party.decline`	`/bc party decline`
`betterclaim.party.leave`	`/bc party leave`
`betterclaim.party.kick`	`/bc party kick`
`betterclaim.party.transfer`	`/bc party transfer`
`betterclaim.party.disband`	`/bc party disband`
`betterclaim.admin`	Все админ-подкоманды (родительский узел)
`betterclaim.admin.players`	`/bc admin`, `/bc admin players`
`betterclaim.admin.chunk`	`/bc admin chunk`
`betterclaim.admin.party`	`/bc admin party`
`betterclaim.admin.claim`	`/bc admin claim`
`betterclaim.admin.unclaim`	`/bc admin unclaim`
`betterclaim.admin.override`	`/bc admin override`
`betterclaim.admin.set-limit`	`/bc admin set-limit`
`betterclaim.admin.add-limit`	`/bc admin add-limit`
`betterclaim.admin.create-party`	`/bc admin create-party`

Динамические права

При нескольких подходящих узлах побеждает наибольшее значение.

Permission	Описание
`betterclaim.limit.N`	Базовый лимит привата на игрока (напр. `betterclaim.limit.10` = 10 чанков). Побеждает наибольшее совпадение.
`betterclaim.playtime.N`	Минут игры на бонусный чанк (напр. `betterclaim.playtime.120`). Побеждает наибольшее значение; перекрывает конфиг, если > 0.
`betterclaim.admin.max-add-limit.N`	Максимальный суммарный лимит привата через `/bc admin add-limit` для этого админа.

Порядок расчёта лимита

Переопределение /bc admin set-limit (БД): наивысший приоритет
Право betterclaim.limit.<N> (наибольшее значение)
Конфиг defaultClaimLimit
Бонусные чанки за время игры (если включено)
Бонус /bc admin add-limit
Ограничение maxClaimLimit в конфиге (кроме режима админ override)

Быстрая настройка через Hytale /perm

Обычные игроки (пример группы Adventure):

/perm group add Adventure betterclaim.gui
/perm group add Adventure betterclaim.claim
/perm group add Adventure betterclaim.unclaim
/perm group add Adventure betterclaim.home
/perm group add Adventure betterclaim.party
/perm group add Adventure betterclaim.limit.10

Персонал / админы (пример группы OP):

/perm group add OP betterclaim.admin

LuckPerms

BetterClaim объявляет LuckPerms опциональной зависимостью. Проверки команд идут через PermissionsModule Hytale (LuckPerms регистрируется как провайдер). Динамические числовые узлы (betterclaim.limit.N, betterclaim.playtime.N, betterclaim.admin.max-add-limit.N) при активном LuckPerms используют наследуемые права — VIP-группы и наследование работают как ожидается.

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

/lp group default permission set betterclaim.gui true
/lp group default permission set betterclaim.party true
/lp group default permission set betterclaim.limit.10 true
/lp group vip permission set betterclaim.limit.20 true
/lp group admin permission set betterclaim.admin true
/lp user <player> permission set betterclaim.playtime.120 true

После изменений в LuckPerms выполните /lp sync (или вашу перезагрузку) и проверьте лимиты в /bc.

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

Файл конфига: plugins/BetterClaim/config.json (создаётся при первом запуске)

Лимиты привата

Option	Default	Описание
`defaultClaimLimit`	`5`	Стартовый лимит привата на игрока
`maxClaimLimit`	`50`	Жёсткий потолок привата (кроме админ override)
`enablePlaytimeClaimGain`	`true`	Бонусные чанки за время игры
`claimGainMinutes`	`600`	Минут игры на один бонусный чанк
`enableAdjacentClaims`	`false`	Новый приват должен граничить с существующим (первый свободен)
`creativeBypassProtection`	`true`	Игроки в Creative игнорируют защиту привата
`worldNameBlacklistForClaiming`	`[]`	Миры, где приват запрещён (точное совпадение имени)
`scaleClaimLimitByPartyMembers`	`false`	(не используется) Устаревший флаг
`showPartyTotalClaims`	`false`	В GUI показывать сумму группы вместо личного счёта

Группа

Option	Default	Описание
`maxPartyMembers`	`10`	Максимум участников в группе
`maxPartyAllies`	`-1`	Максимум союзников (-1 = без лимита)
`enableAllySystem`	`true`	Союзники игроков/групп
`enablePartyInactivityDisband`	`false`	Роспуск группы при превышении порога неактивности владельца
`partyInactivityDisbandDays`	`30`	Дней неактивности владельца до авто-роспуска
`partyInactivityCheckIntervalMinutes`	`60`	Как часто сервер проверяет неактивность (минимум 5)

Заголовки зон и звуки

Option	Default	Описание
`wildernessName`	`Wilderness`	Имя для незанятых зон
`titleTopText`	(пусто)	Опциональный текст над заголовками зон
`personalClaimSubtitle`	`Personal Claim`	Подзаголовок личного привата
`enableZoneTitles`	`true`	Заголовок зоны при входе
`showWildernessZoneTitle`	`true`	Заголовок при входе в дикую местность
`enableClaimEntrySound`	`true`	Звук при входе в приват
`claimEntrySoundOncePerZone`	`true`	Только раз за посещение зоны
`claimEntrySoundId`	`SFX_Discovery_Z1_Short`	ID звука

Карта и визуал

Option	Default	Описание
`enableCustomMap`	`true`	Карта рельефа в GUI /bc
`mapOverlayAlpha`	`0.5`	Прозрачность оверлея привата на карте мира
`guiMapResolutionScale`	`0.75`	Разрешение карты в GUI (0.1–1.0)
`guiMapCacheTtlSeconds`	`120`	TTL кэша изображения карты (секунды)
`enableParticleBorders`	`true`	Частицы на границах чанков
`useBcHubUi`	`true`	`/bc` открывает хаб (карта / party / создать) вместо только карты привата

Дома

Option	Default	Описание
`maxHomes`	`5`	Максимум домов на игрока
`homeCooldownSeconds`	`5`	Кулдаун телепорта

Глобальная защита

Option	Default	Описание
`protectBuckets`	`true`	Блокировать чужим установку жидкости и пополнение контейнеров в защищённых приватах
`protectBenches`	`true`	Защита верстаков
`isolateCraftBenchMaterials`	`true`	Крафт на верстаке использует только инвентарь игрока и доступные сундуки рядом
`protectTamedEntities`	`true`	Блокировать чужой урон по приручённым NPC в привате (флаг группы)
`tamedEntityRoleIdentifiers`	`Tamed_`	Префиксы имён ролей NPC как приручённые компаньоны
`blocksThatIgnoreInteractRestrictions`	`gravestone, tombstone, corpse, loot_chest`	Блоки, с которыми всегда можно взаимодействовать

Защита группы по умолчанию (новые группы)

Option	Default	Описание
`defaultPartyBlockPlaceEnabled`	`false`	Разрешить не-участникам ставить блоки
`defaultPartyBlockBreakEnabled`	`false`	Разрешить не-участникам ломать блоки
`defaultPartyBlockInteractEnabled`	`false`	Разрешить не-участникам взаимодействовать с блоками
`defaultPartyPVPEnabled`	`false`	Разрешить PVP в приватах группы
`defaultPartyFriendlyFireEnabled`	`false`	Дружественный огонь между участниками
`defaultPartyInteractChest`	`false`	Разрешить не-участникам открывать сундуки
`defaultPartyInteractDoor`	`false`	Разрешить не-участникам использовать двери
`defaultPartyInteractBench`	`false`	Разрешить не-участникам использовать верстаки
`defaultPartyInteractChair`	`false`	Разрешить не-участникам использовать стулья
`defaultPartyInteractPortal`	`false`	Разрешить не-участникам использовать порталы
`defaultPartyTamedDamageEnabled`	`false`	Разрешить не-участникам бить приручённых

Переключатели владельца группы

Option	Default	Описание
`allowPartyPlaceBlockSetting`	`true`	Владелец может переключать установку блоков для чужих
`allowPartyBreakBlockSetting`	`true`	Владелец может переключать ломание блоков для чужих
`allowPartyInteractBlockSetting`	`true`	Владелец может переключать взаимодействие с блоками для чужих
`allowPartyPVPSetting`	`true`	Владелец может переключать PVP
`allowPartyFriendlyFireSetting`	`true`	Владелец может переключать дружественный огонь
`allowPartyInteractChestSetting`	`true`	Владелец может переключать доступ к сундукам
`allowPartyInteractDoorSetting`	`true`	Владелец может переключать доступ к дверям
`allowPartyInteractBenchSetting`	`true`	Владелец может переключать доступ к верстакам
`allowPartyInteractChairSetting`	`true`	Владелец может переключать доступ к стульям
`allowPartyInteractPortalSetting`	`true`	Владелец может переключать доступ к порталам
`allowPartyTamedDamageSetting`	`true`	Владелец может переключать урон по приручённым

Пример config.json

{
  "configVersion": 28,
  "useBcHubUi": true,
  "worldNameBlacklistForClaiming": [],
  "tamedEntityRoleIdentifiers": ["Tamed_"],
  "defaultClaimLimit": 5,
  "maxClaimLimit": 50,
  "enablePlaytimeClaimGain": true,
  "claimGainMinutes": 600,
  "enableAdjacentClaims": false,
  "creativeBypassProtection": true,
  "enablePartyInactivityDisband": false,
  "partyInactivityDisbandDays": 30,
  "partyInactivityCheckIntervalMinutes": 60,
  "maxPartyMembers": 10,
  "maxPartyAllies": -1,
  "enableAllySystem": true,
  "enableCustomMap": true,
  "enableParticleBorders": true,
  "maxHomes": 5,
  "homeCooldownSeconds": 5
}

Полный конфиг по умолчанию — в plugins/BetterClaim/config.json после первого запуска.

Заметки

Приват/снятие в GUI требует betterclaim.claim / betterclaim.unclaim. Участники группы всегда приватят личные чанки: отдельного права «приват группы» нет.
Админ-режим чанка: сначала выберите цель через /bc admin players.
Админ override требует betterclaim.admin.override и обходит лимиты и защиту.
Запретные регионы хранятся в SQLite и блокируют приват в отмеченном прямоугольнике.
Deny zones не блокируют проход игроков; только новый приват в зоне.
Установите useBcHubUi в false, если /bc должен открывать карту привата напрямую (старое поведение).
Сохранённые deny zones видны только на карте привата, не на обычной карте (M) после Save.
Миры из worldNameBlacklistForClaiming отклоняют новый приват с сообщением в игре.
С LuckPerms при старте в логе ищите LuckPerms detected, если динамические лимиты должны учитывать наследование групп.
При роспуске группы приваты остаются у игроков (включая авто-роспуск из-за неактивности владельца).
Роспуск при неактивности выключен по умолчанию; включите enablePartyInactivityDisband и задайте partyInactivityDisbandDays.
База данных: universe/BetterClaim/BetterClaim.db (внутри сохранения мира)