Open Parties and Claims

该模组目前处于 Beta 阶段！

此模组新增了宣称和强制加载世界区块的功能，以及创建和管理玩家队伍的能力。同时，它为服务器所有者提供了对玩家使用模组功能的强大控制。

默认情况下，区块宣称由单个玩家拥有，他们可以根据队伍关系或自定义玩家组设置保护例外。服务器所有者也可以启用队伍拥有的区块宣称，详情请参阅下方常见问题解答。

该模组的 API 允许其他模组或插件在服务器和客户端两侧轻松与队伍和区块宣称系统交互。该模组已与 Xaero 的小地图 和 Xaero 的世界地图 模组集成。请确保将它们更新到最新版本。

该模组的 API 允许集成其他玩家权限系统，用于模组的某些权限节点（例如基于等级的宣称数量限制），并内置支持 Prometheus、FTB Ranks、LuckPerms 以及 Forge/Fabric 权限 API。它还允许集成其他队伍系统，与默认队伍系统协同或替代之，用于区块宣称，并内置支持 Argonauts 和 FTB Teams。可以在主配置文件中完全禁用默认队伍系统或区块宣称系统。

命令：

/openpac … - 玩家配置命令 /openpac-claims … - 所有与区块宣称相关的命令 /openpac-parties … - 所有与队伍相关的命令 /opm - 队伍聊天快捷键

按键绑定：

' - 打开模组 UI。可在控制菜单中更改。

配置文件：

[世界目录]/serverconfig/openpartiesandclaims-server.toml - 主配置文件的通常位置。编辑前确保关闭服务器，否则服务器可能会覆盖你所有的更改。 [服务器目录]/config/openpartiesandclaims-server.toml - 在 Fabric/Quilt 下主配置文件有时会位于此处。 [世界目录]/serverconfig/openpartiesandclaims-… - 一些全局的“玩家配置”，虽然所有配置都可以通过游戏内的 UI 访问

权限节点：

此模组因各种原因查询的权限节点并非静态路径。它们可以在主配置文件中配置，例如选项 "maxPlayerClaimsPermission"。所使用的权限系统（FTB Ranks、LuckPerms 等）可以通过主配置文件中的 "permissionSystem" 选项配置。

如果你或你使用的整合包没有更改权限节点，那么权限节点的路径应该如下：

• "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" - 赋予非 OP 玩家进行服务器宣称和启用服务器宣称模式的权限。
• "xaero.pac_admin_mode" - 赋予非 OP 玩家启用区块宣称管理员模式的权限。

常见问题解答

1) 如何在我的服务器上配置此模组？

该模组主要通过主配置文件进行配置，文件位于 [世界目录]/serverconfig/openpartiesandclaims-server.toml，或者在 Fabric/Quilt 上有时位于 [服务器目录]/config/openpartiesandclaims-server.toml，且需要在服务器未运行时进行编辑。服务器宣称、过期宣称和荒野配置，以及默认玩家配置，可由 OP 在游戏内使用 UI 进行编辑（查看你的按键绑定）。普通玩家可以使用相同的 UI 配置自己的玩家配置。如果客户端没有安装此模组，则可以使用玩家配置聊天命令代替。

2) 作为普通玩家如何使用此模组？

大多数与区块宣称相关的内容都可以通过游戏内 UI（查看你的按键绑定）访问。如果你安装了 Xaero 的世界地图模组，你也可以在地图界面上通过右键点击或按住右键拖拽选中区域来查看和编辑你的宣称。你也可以使用聊天命令来创建/编辑宣称。队伍目前只能通过聊天命令创建和管理。

3) 为什么我的玩家配置中有些选项是灰色的？

服务器管理员/所有者可以在主配置文件中配置 playerConfigurablePlayerConfigOptions 选项，以决定玩家可以访问哪些特定选项。其他所有内容将使用默认玩家配置中的值。

4) 如何禁用我服务器上的所有保护？

在服务器宣称、过期宣称和荒野配置以及默认玩家配置中，禁用主要的保护选项。接下来，在服务器未运行时编辑配置文件 [世界目录]/serverconfig/openpartiesandclaims-server.toml（有时在 [服务器目录]/config 中）。从 playerConfigurablePlayerConfigOptions 中移除主要选项 claims.protectClaimedChunks。

5) 如何为特定方块、实体/怪物的交互/破坏或物品的使用添加区块宣称保护例外？

该模组预配置了一些全局例外，以及一些你可以在单个宣称中切换的默认例外组。强制例外和每个可切换的例外都可以通过主配置文件 [世界目录]/serverconfig/openpartiesandclaims-server.toml（有时在 [服务器目录]/config 中）添加。必须在服务器未运行时编辑/替换该文件，以确保其在服务器重启时不会被覆盖。对于强制应用于每个宣称的例外，你感兴趣的选项是 forcedBlockProtectionExceptionList、forcedEntityProtectionExceptionList、itemUseProtectionExceptionList。对于可切换的例外组，类似于默认组（控制装置、门、商人、牲畜），你感兴趣的选项是 blockProtectionOptionalExceptionGroups、entityProtectionOptionalExceptionGroups、itemUseProtectionOptionalExceptionGroups。你可以添加新组或编辑现有组。请仔细阅读选项上方的注释。它们包含关键信息，此处不便赘述。

6) 如何让特定实体/怪物类型访问方块、实体或掉落物（例如让僵尸攻击村民）？

强制例外和每个可切换的例外都可以通过主配置文件 [世界目录]/serverconfig/openpartiesandclaims-server.toml（有时在 [服务器目录]/config 中）添加。必须在服务器未运行时编辑/替换该文件，以确保其在服务器重启时不会被覆盖。要强制特定实体访问所有宣称，你感兴趣的选项是 entitiesAllowedToGrief、entitiesAllowedToGriefEntities、entitiesAllowedToGriefDroppedItems。对于每个宣称可切换的访问组，类似于默认组（村民、僵尸、猪灵、狐狸），选项是 blockAccessEntityGroups、entityAccessEntityGroups、droppedItemAccessEntityGroups。对于从特定方块位置运行的“假玩家”（通常作为自动化机械的一部分），请查看 staticFakePlayers 选项。请仔细阅读选项上方的注释。它们包含关键信息，此处不便赘述。

7) 如何启用队伍拥有的区块宣称？

将主配置文件 openpartiesandclaims-server.toml 中的 partyOwnedClaims 选项设置为 true，这样如果在技术上拥有这些宣称的玩家同时也是主要队伍系统（主配置文件中的选项 primaryPartySystem）的某个队伍的所有者，那么他们的宣称将被视为由队伍本身拥有。

• 这使得其他队伍成员如果拥有权限（在默认队伍系统中至少为 CLAIMER 等级，在 FTB Teams 中为 Officer，在 Argonauts/Odyssey Allies 中为除 TP_MEMBERS 之外的任何成员权限），则可以使用队伍宣称模式代表队伍进行宣称。如果在队伍所有者的配置中（或由默认玩家配置强制执行）启用了“整个队伍可以宣称”，那么队伍中的每个玩家都可以代表队伍进行宣称/取消宣称。
• 这使得其他队伍成员如果拥有权限（在默认队伍系统中至少为 ADMIN 等级，在 FTB Teams 中仅限所有者，在 Argonauts/Odyssey Allies 中为 MANAGE_SETTINGS），则可以编辑队伍宣称配置（队伍所有者配置中与宣称相关的选项）。
• 这使得其他队伍成员如果拥有权限（在默认队伍系统中至少为 MODERATOR 等级，在 FTB Teams 中为 Officer，在 Argonauts/Odyssey Allies 中为 MANAGE_MEMBERS），则可以管理队伍宣称配置的自定义玩家组中的玩家。
• 这使得其他队伍成员可以编辑队伍宣称配置的自定义玩家组，而不仅仅是管理玩家（在默认队伍系统中为 ADMIN，在 FTB Teams 中仅限所有者，在 Argonauts/Odyssey Allies 中为 MANAGE_SETTINGS）。
• 如果所选的主要队伍系统支持队伍颜色（例如 FTB Teams），那么队伍宣称的默认颜色将是队伍颜色，而不是队伍所有者的随机颜色。
• 服务器所有者可以使用主配置文件中的选项 claimBonusPerPartyMember、forceloadBonusPerPartyMember、claimBonusForPartyOwner 和 forceloadBonusForPartyOwner 来配置可用的宣称/强制加载数量如何随队伍规模和存在情况而变化。请阅读这些选项上方的注释以获取详细解释。

支持的模组：

许多（通常是较小的）模组应该会自动受到宣称区块保护的支持。一些模组在其添加到游戏中或修改的机制方面更为复杂，在这种情况下，无法保证区块保护，需要手动添加到此模组或使用额外的模组。欢迎在 问题追踪器 上留下你希望得到支持的模组建议。请确保通过测试确认它们尚未被支持，并提供可以在该模组下实现区块破坏的示例。

明确支持的模组：

• （自 b0.8.0 版本起）机械动力 (Create) - 在 Forge 版本中内置，但在 b0.25.1 版本之前，在 Fabric/Quilt 上使用时需要 一个扩展模组。受保护的区块应免受所有生存模式机械动力机制的破坏，但如果我遗漏了什么，请通知我（请通过重新登录确认这不仅仅是客户端故障）。尚不确定是否也会添加对创造模式机制的支持，我们将拭目以待。