Open Parties and Claims — мод для управления территориями и группами на сервере

Мод всё ещё находится на стадии бета-тестирования, но уже предлагает внушительный функционал: возможность закреплять за собой чанки (claim), форсировать их загрузку (forceload), а также создавать и управлять игровыми группами (party). Вдобавок администраторы получают гибкие инструменты для контроля над тем, как игроки пользуются этими возможностями.

По умолчанию каждый участник сервера владеет своими чанками самостоятельно и может настраивать исключения из защиты — например, открывать доступ по принадлежности к группе или по списку конкретных игроков. Если администратор включит party-owned claims, владение чанками будет привязано к группе, а не к отдельному игроку (подробнее об этом — в FAQ).

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

Мод предоставляет API, с которым могут взаимодействовать другие моды и плагины — как на серверной, так и на клиентской стороне. Уже есть готовая интеграция с Xaero's Minimap и World Map. Убедитесь, что у вас установлены их последние версии.

Через API можно подключать системы прав для управления лимитами на количество чанков. Из коробки поддерживаются Prometheus, FTB Ranks, LuckPerms, а также стандартные разрешения Forge и Fabric. Кроме того, API позволяет заменить стандартную систему групп на альтернативную — например, на Argonauts или FTB Teams. Если нужно, стандартные группы или клаймы можно полностью отключить в главном конфигурационном файле.

Команды

• /openpac ... — команды для настроек игрока
• /openpac-claims ... — всё, что связано с чанками
• /openpac-parties ... — всё, что связано с группами
• /opm — быстрая команда для отправки сообщения в групповой чат

Клавиши

По умолчанию интерфейс мода открывается клавишей ' (апостроф). Её можно переназначить в меню управления.

Файлы конфигурации

Основной конфигурационный файл обычно находится по пути:

[директория мира]/serverconfig/openpartiesandclaims-server.toml

На Fabric/Quilt он иногда располагается здесь:

[директория сервера]/config/openpartiesandclaims-server.toml

Важно: перед редактированием файла обязательно выключайте сервер — иначе он может перезаписать ваши изменения.

Глобальные «игровые конфиги» (player configs) хранятся в той же папке с соответствующими именами, но все их настройки можно менять прямо в игре через UI.

Права доступа (Permission Nodes)

Мод не использует жёстко прописанные пути для проверки прав — их можно настроить в главном конфиге. Например, параметр maxPlayerClaimsPermission определяет, какое разрешение отвечает за лимит чанков. А опция permissionSystem позволяет выбрать, какая система прав будет использоваться (FTB Ranks, LuckPerms и т.д.).

Если вы или ваш модпак не меняли эти настройки, то пути к разрешениям выглядят так:

• xaero.pac_max_player_groups — мета-значение, переопределяющее maxPlayerGroups в конфиге
• xaero.pac_player_group_space — мета-значение, переопределяющее playerGroupSpace
• xaero.pac_max_claims — мета-значение, переопределяющее maxPlayerClaims
• xaero.pac_max_forceloads — мета-значение, переопределяющее maxPlayerClaimForceloads. Учтите: это переопределение срабатывает только после того, как игрок хотя бы раз зайдёт на сервер после его (пере)запуска. Рекомендуется, чтобы лимиты на основе прав были не меньше, чем maxPlayerClaimForceloads
• xaero.pac_server_claims — разрешение для не-операторов создавать серверные клаймы и включать режим серверных чанков
• xaero.pac_admin_mode — разрешение для не-операторов включать режим администратора над клаймами

Часто задаваемые вопросы

1) Как настроить мод на сервере?

Основные настройки задаются в главном конфиге openpartiesandclaims-server.toml (см. пути выше). Редактировать его нужно при выключенном сервере. Конфиги серверных чанков, просроченных чанков, «диких» территорий (wilderness) и настройки по умолчанию для игроков могут редактировать операторы прямо в игре через UI. Обычные игроки через тот же UI меняют свои личные настройки. Если мод не установлен на клиенте, можно использовать чат-команды для конфигурации.

2) Как пользоваться модом обычному игроку?

Большинство действий с клаймами доступно через внутриигровой интерфейс (см. назначенную клавишу). Если у вас установлен Xaero's World Map, вы можете просматривать и редактировать свои чанки прямо на карте: кликните правой кнопкой мыши или перетащите область с зажатой ПКМ, чтобы сделать выделение. Также можно использовать чат-команды. Группы пока создаются и управляются только через команды.

3) Почему некоторые опции в моих настройках недоступны?

Администратор сервера может ограничить, какие именно опции игроки могут менять у себя. Для этого используется параметр playerConfigurablePlayerConfigOptions в главном конфиге. Всё остальное берётся из настроек по умолчанию.

4) Как полностью отключить защиту чанков на сервере?

Отключите главную опцию защиты в конфигах серверных чанков, просроченных чанков, «диких» территорий и в настройках игрока по умолчанию. Затем, при выключенном сервере, отредактируйте openpartiesandclaims-server.toml и удалите опцию claims.protectClaimedChunks из playerConfigurablePlayerConfigOptions.

5) Как добавить исключения из защиты для взаимодействия с блоками, существами или предметами?

В моде уже есть несколько глобальных исключений и стандартных групп, которые можно включать или отключать для каждого чанка отдельно. Добавлять новые можно через главный конфиг openpartiesandclaims-server.toml. Редактировать или заменять файл нужно при выключенном сервере, чтобы изменения не сбросились.

• Принудительные исключения для всех чанков задаются параметрами: forcedBlockProtectionExceptionList, forcedEntityProtectionExceptionList, itemUseProtectionExceptionList
• Включаемые группы исключений (по аналогии со стандартными Controls, Doors, Traders, Livestock) задаются параметрами: blockProtectionOptionalExceptionGroups, entityProtectionOptionalExceptionGroups, itemUseProtectionOptionalExceptionGroups

Вы можете добавлять новые группы или редактировать существующие. Обязательно прочитайте комментарии над этими опциями — в них содержится важная информация.

6) Как разрешить мобам взаимодействовать с блоками, существами или выпавшими предметами (например, чтобы зомби атаковали жителей)?

И принудительные, и включаемые исключения для мобов добавляются в тот же конфиг. Для принудительного доступа ко всем чанкам используйте параметры:

• entitiesAllowedToGrief — доступ к блокам
• entitiesAllowedToGriefEntities — доступ к существам
• entitiesAllowedToGriefDroppedItems — доступ к выпавшим предметам

Для групп, которые можно включать для каждого чанка (аналогично стандартным Villagers, Zombies, Piglins, Foxes), используйте:

• blockAccessEntityGroups
• entityAccessEntityGroups
• droppedItemAccessEntityGroups

А для «фейковых игроков», работающих от лица автоматических механизмов, есть опция staticFakePlayers. Не забудьте прочитать комментарии к этим параметрам.

7) Как включить групповое владение чанками (party-owned claims)?

Установите параметр partyOwnedClaims в true в главном конфиге. Если игрок, которому технически принадлежат чанки, является владельцем группы в основной системе групп (параметр primaryPartySystem), то его чанки считаются принадлежащими группе. Вот что это даёт:

• Участники группы с рангом не ниже CLAIMER (в стандартной системе), Officer (в FTB Teams) или любым, кроме TP_MEMBERS (в Argonauts/Odyssey Allies), могут использовать режим группового клайма, чтобы закреплять чанки от имени группы. Если в настройках владельца включено «Whole Party Can Claim» (или это принудительно задано в настройках по умолчанию), то любой участник группы может закреплять и снимать чанки.
• Участники с рангом не ниже ADMIN (стандартная система), только владелец (FTB Teams) или MANAGE_SETTINGS (Argonauts/Odyssey Allies) могут редактировать конфиг групповых чанков.
• Участники с рангом не ниже MODERATOR (стандартная система), Officer (FTB Teams) или MANAGE_MEMBERS (Argonauts/Odyssey Allies) могут управлять пользовательскими группами в конфиге чанков.
• Редактировать сами группы (добавлять/удалять группы, не только игроков) могут только ADMIN (стандартная), владелец (FTB Teams) или MANAGE_SETTINGS (Argonauts/Odyssey Allies).
• Если система групп поддерживает цвета (например, FTB Teams), то цвет чанков группы будет соответствовать цвету группы, а не случайному цвету владельца.
• Администратор может настроить, как количество доступных чанков и форсед-лоадов зависит от размера группы, через параметры claimBonusPerPartyMember, forceloadBonusPerPartyMember, claimBonusForPartyOwner и forceloadBonusForPartyOwner. Подробнее — в комментариях к этим опциям.

Поддержка других модов

Многие (особенно небольшие) моды работают с защитой чанков автоматически. Однако некоторые моды добавляют настолько сложные механики, что защита может не срабатывать. В таких случаях нужно добавлять поддержку вручную — либо в этот мод, либо через дополнительный. Оставляйте предложения на трекере. Перед этим убедитесь, что мод действительно не поддерживается (протестируйте), и приложите пример того, как с его помощью можно навредить чанкам.

Явно поддерживаемые моды:

• Create (начиная с b0.8.0) — встроенная поддержка в Forge-версии. На Fabric/Quilt до версии b0.25.1 требуется дополнительное расширение.