ProtectionStones - 领地保护插件

💡重要维护公告

有关本插件的最新维护状态，请访问：espi.dev/posts/2024/06/state-of-protectionstones/

🎮简介

ProtectionStones 是一款强大而简便的土地保护插件。玩家只需放置一个特定的方块，即可在方块周围（半径可配置）创建一个 WorldGuard 区域，从而防止他人破坏或盗窃。玩家可以管理区域的成员、设置各种保护标志。

💡警告与版本支持

ProtectionStones 仅支持 Minecraft 1.21.10+ 的服务器。对于旧版本，请使用以下对应版本：

• 1.20.6 - 1.21.9 (不再维护): 请使用 v2.10.5
• 1.17 - 1.20.5 (不再维护): 请使用 v2.10.4
• 1.13 - 1.16 (不再维护): 请使用 v2.8.5
• 1.8 - 1.12 (不再维护): 可使用向后移植版本，但不提供支持或更新：

https://github.com/espidev/ProtectionStones/releases/tag/2.7.6-pre1.13

✨前置需求

• WorldGuard 7+
• WorldEdit 7+
• Vault (可选，用于经济功能)
• PlaceholderAPI (可选，用于变量支持)
• Spigot 1.21.10+ (或对应上述旧版本的服务器核心)

🔧安装与配置

基础安装

• 确保已安装上述所有前置插件。
• 将 ProtectionStones 插件文件放入服务器的 plugins 文件夹。
• 重启服务器，插件将自动生成默认配置文件。

权限设置

默认情况下，不会给予玩家任何权限。您需要根据权限列表手动为玩家配置权限。

添加新的保护方块

• 进入 plugins/ProtectionStones/blocks 目录。
• 复制并粘贴默认的 block1.toml 文件，然后重命名（例如 block2.toml）。
• 在新的方块配置文件中，必须修改 type 和 alias 字段的值，确保它们唯一。

配置区域标志 (Flags)

ProtectionStones 使用 WorldGuard 的标志系统来实现保护功能。这意味着实际的保护工作由 WorldGuard 完成。

• 您可以在此查看所有可用的 WorldGuard 标志。
• 您也可以使用其他插件（如 WorldGuard Extra Flags）添加的标志，并在 ProtectionStones 中配置使用。

⭐其他建议

• 漏斗问题：WorldGuard 默认会阻止漏斗在区域间传输物品，并阻止漏斗矿车工作。建议在 WorldGuard 配置中将 ignore-hopper-item-move-events 设置为 true 来解决。
• 液体流动：若想防止水或岩浆流入保护区域，可在 WorldGuard 配置中将 high-frequency-flags 和 protect-against-liquid-flow 设置为 true。
• 查看 WorldGuard 配置指南。

🎮使用方式

• 使用指令 /ps get 获取一个保护方块。
• 将其放置在世界中，插件会立即以该方块为中心创建保护区域。
• 破坏该方块即可移除对应的保护区域。

❓更多资源与链接

• 新文档站点：espidev.gitbook.io/protectionstones
• 获取支持：请加入 M.O.S.S. Discord：https://discord.gg/cqM96tcJRx
• 默认配置文件：查看默认配置
• 权限列表：查看完整权限
• 推荐权限组：查看命令推荐权限
• 指令列表：查看所有指令
• PlaceholderAPI 变量：查看支持的变量
• 翻译文件：查看社区贡献的翻译。如果您想贡献翻译，请在 Discord 联系我或提交 GitHub Issue！
• 常见问题解答 (FAQ)：查看 FAQ
• 使用统计：https://bstats.org/plugin/bukkit/ProtectionStones/4071

🔧迁移与致谢

• 从旧版 (<2.x.x) 迁移：迁移过程应该是无缝的。只需将新版本插件放入 plugins 文件夹即可。插件会自动更新您的配置和区域。
• 原始插件：本插件基于原始 ProtectionStones 开发。您可以在 SpigotMC 或 BukkitDev 找到原始项目。
• 特别感谢：图形由 Seshpenguin 制作，非常感谢！

💡简介

ProtectionStones 是一款功能强大的领地保护插件，允许玩家在世界中创建受保护的私人区域。它通过放置特定的方块（即“保护石”）来标记领地边界，并提供了丰富的权限管理和配置选项，非常适合生存、城镇或 RPG 服务器。

🎮主要特性

• 易于使用：放置一个配置好的方块即可创建领地。
• 高度可配置：可设置不同方块提供不同大小和形状的保护区域。
• 权限系统：支持为其他玩家设置详细的领地内权限（如建造、使用、破坏等）。
• 合并与划分：领地可以相互合并以扩大范围，也可以被划分成更小的部分。
• 租赁系统：领地可以设置租期，到期后自动移除保护。
• 经济支持：支持与 Vault 经济插件联动，创建领地需要金钱。
• 多世界支持：可在不同世界独立配置。
• 事件与 API：提供开发者 API，方便与其他插件集成。

🔧快速开始

基础命令

• /ps create - 在你面前放置一个保护石来创建领地。
• /ps add - 允许一名玩家在你的领地内建造。
• /ps remove - 禁止一名玩家在你的领地内建造。
• /ps info - 查看你所在领地的信息。
• /ps flag - 管理你的领地标志（权限）。
• /ps list - 列出你所有的领地。
• /ps menu - 打开领地管理图形界面（需要 ProtocolLib）。

创建领地

• 确保你拥有创建领地所需的权限和金钱（如果已配置）。
• 手持一个被配置为保护石的物品（例如金块）。
• 使用命令 /ps create。
• 在你面前放置该方块。一个以该方块为中心的保护区将立即生成。

✨权限与命令

玩家常用权限

• protectionstones.create - 允许创建保护石。
• protectionstones.bypass - 允许绕过所有保护石的保护（管理员权限）。
• protectionstones.use. - 允许使用特定区域 ID 的保护石（用于不同大小/类型的领地）。

管理员常用命令

• /ps admin list - 列出指定玩家的所有领地。
• /ps admin delete - 移除你所在的领地。
• /ps admin add [领地ID] - 将指定玩家添加到一个领地。
• /ps admin tp - 传送到指定领地。
• /ps admin reload - 重载插件配置。
• /ps admin version - 检查插件版本。

❓常见问题

• 如何更改领地大小？

领地大小和形状由你放置的保护石方块类型决定。每种方块都在 config.yml 中预先配置好了半径和形状（立方体或圆柱体）。放置不同的方块会创建不同大小的领地。

• 如何允许朋友在我的领地里建造？

站在你的领地内，使用命令 /ps add 。

• 领地可以重叠吗？

默认情况下，新的领地不能与其他玩家的领地重叠。但你可以通过配置允许领地重叠，或者通过合并命令将相邻的自己的领地合并。

• 支持哪些经济插件？

支持所有与 Vault 兼容的经济插件，例如 EssentialsX Econ、CMI、PlayerPoints 等。

• 如何移除一个领地？

破坏保护石方块即可移除该领地。如果启用了“破坏返还”配置，破坏时会返还保护石物品。

⭐依赖与兼容性

• 必需插件：ProtectionStones 需要安装 Vault 以支持经济与权限功能。
• 推荐插件：安装 ProtocolLib 以使用图形界面 (/ps menu)。
• 兼容性：支持 Minecraft 1.13 至最新版本。与大多数领地、经济、权限插件兼容。