PreciousStones - 灵活领地保护系统

💡PreciousStones 简介

PreciousStones 是一款功能极其灵活的领地保护插件。它允许你通过配置“力场方块”来创建各种功能的保护区域。默认配置提供了一系列预设的力场类型，但你完全可以自由修改、删除它们，或利用插件提供的超过 180 种功能标志（Flag）来创建独一无二的、完全符合你服务器需求的保护方案。从基础的保护、药水效果、物品没收、回滚到传送，可能性是无限的。

🎮核心概念

PreciousStones 提供两种保护机制：不可破坏方块和力场方块。

不可破坏方块

• 这些方块本身受到保护，类似于 OwnBlocks 插件。
• 配置文件中 unbreakable-blocks 列表内的方块，只有放置者（所有者）可以破坏。
• 可用作建筑材料，例如无法被破坏的城市城墙、坚不可摧的保险库，或保护特定方块（如音符盒、栅栏）免遭盗窃。
• 手持工具右键点击方块可以查看所有者。
• 注意：列入此列表的方块类型不能同时用于力场方块列表。

力场方块

• 力场方块会向其周围环境投射一个具有特定属性的力场。
• 力场的半径从方块本身向外延伸（例如，半径为 3 将产生一个 7x7x7 的力场）。
• 可以通过添加 height 标志来覆盖由半径计算出的默认高度。

🔧力场信息与操作

查看力场信息

• 手持配置文件中 tool-items 列表内的工具，右键点击你自己的力场方块，可以查看该力场的详细信息。
• 右键点击不属于你的力场，只会显示所有者信息。
• 将配置文件中的 public-block-details 设置为 true，可使所有力场都显示完整信息。
• 手持工具右键点击地面上的方块，可以判断该方块是否受到保护。

可视化力场

• 站在你的力场范围内，输入 /ps visualize。
• 此命令会用玻璃方块（仅客户端可见）勾勒出该力场的边界，帮助你直观地了解保护范围。
• 一旦玩家移动，可视化效果就会消失。

✨立方体力场

立方体力场是力场的进阶形态。通过给力场添加 cuboid 标志，即可将其变为立方体力场。

重定义立方体 / 绘图模式

• 进入绘图模式：潜行状态下用工具左键点击力场方块。
• 扩展保护区域：

- 左键点击周围的方块，将其纳入保护范围。

- 右键点击任意方向，将立方体向该方向扩展一格。

- 潜行状态下右键点击任意位置，可以撤销上一次选择。

• 完成定义：再次潜行状态下左键点击任意位置，或直接点击力场方块本身。
• 你只需选择立方体两个对角的方块即可定义，但绘图模式允许你通过点击想要保护的具体方块来自由定义形状，插件会自动生成能包裹所有选中方块的最小立方体。

立方体体积

• 进入绘图模式时，力场配置的半径和高度会被转换为总体积（例如半径5的力场体积为 11x11x11 = 1331 个方块）。
• 你可以在可用体积内任意重定义立方体的形状。
• 如果力场设置了 custom-volume 标志，则将使用该指定的体积，而非由半径/高度计算出的体积。这适用于创建小方块放置、大体积定义的“地皮”系统。

立方体群组

• 在绘图模式下，可以放置更多同类型的力场方块，每个方块的体积都会累加到父力场中，从而创建巨大的保护区域。
• 完成定义后，所有放置的方块将成为一个群组。右键点击其中任何一个都会显示相同信息，破坏其中一个会破坏整个群组。

立方体混合

• 在绘图模式下，可以放置不同类型的力场方块，它们的标志会被导入到正在绘制的立方体中，从而实现多种效果的混合。
• 通过 mixing-group 标志将力场分配到“混合组”中，只有同组的力场才能互相混合。
• 注意：没有混合组的力场不可混合。混合时只导入标志，不增加额外体积。

力场与立方体的区别

• 立方体力场保存在独立的数据库表（pstone_cuboids）中，而普通力场保存在 pstone_fields 表中。因此，不建议将玩家已在使用的现有力场类型改为立方体力场，反之亦然。

⭐特殊力场类型

破坏回滚力场

• 功能类似个人版的 BigBrother，可以回滚力场范围内的破坏行为。
• 会记录非允许玩家的方块破坏和爆炸破坏（被破坏的方块不会掉落，直接消失）。
• 有两种模式：

- 右键点击方块时手动回滚。

- 通过 `grief-revert-interval` 标志设置自动回滚的间隔时间。

• 可通过配置文件中的 grief-revert.black-list 列表，指定哪些方块被破坏时可以掉落（即可被偷取）且不可回滚。

proximity 告密者力场

• 任何带有 snitch 标志的方块都会创建一个记录场内玩家活动的力场。
• 记录内容包括：进入、方块破坏与放置、方块使用。
• 查看记录：右键点击方块或输入 /ps snitch。
• 清除记录：输入 /ps snitch clear。

森林生成器力场

• 允许玩家放置一个方块后，在其周围瞬间生成整片森林（树木和草地）。
• 方块必须放置在“肥沃”的方块上才能激活。可通过 fertile-blocks 标志指定哪些方块属于肥沃方块（会被转换为草地）。
• 森林生成完成后，激活方块本身会变成一棵树。
• 可配置项：

- `tree-count`：可生长的树木数量。

- `tree-types`：生成的树木种类。

- `shrub-types`：生成的灌木种类。

- `grow-time`：整个森林的生长所需时间。

🔧权限管理与交互

允许他人进入

你可以使用以下命令管理力场的允许列表

• /ps allow [player] - 允许一名玩家进入你的力场。
• /ps allow c:[tag] - 允许一个家族进入你的力场（需 SimpleClans 集成）。
• /ps allow g:[group] - 允许一个权限组进入你的力场。
• /ps allow * - 允许所有人进入你的力场。
• /ps allowall [player] - 允许玩家进入你所有的力场。
• /ps remove [player] - 从你指向或所在的力场中移除一名玩家。
• /ps removeall [player] - 从你所有的力场中移除一名玩家。

注意：如果力场重叠，站在其中一个力场内使用 /ps allow 或 /ps remove 会影响所有重叠的力场。

出售与出租

玩家可以通过为力场添加 rentable、shareable、buyable 标志，并结合告示牌来出租或出售力场。

**告示牌格式**

[标签]
价格（物品/经济货币）
租期（仅出租有效）

**标签类型**

• [Rent] - 出租。租客获得指定时长内的使用权（不能修改或移除力场本身）。仅对带有 rentable 标志的力场有效。
• [Shared] - 共享出租。允许多人同时租用同一力场，适用于公共区域。仅对带有 shareable 标志的力场有效。
• [Buy] - 出售。直接变更力场的所有权。仅对带有 buyable 标志的力场有效。

**价格格式**

• 物品：数量 (物品ID)，例如 30 (266) 代表 30 个金锭。
• 经济货币：数量 货币名称，例如 50 credits。需要 Vault 经济支持。

**租期格式**

• 支持周(w)、天(d)、小时(h)、分钟(m)、秒(s)，最多可组合三项，例如 5h 30m。

**操作方法**

• 租客/买家：

- 右键点击：购买一个租期（可多次点击购买更多）或完成购买。

- 左键点击：查看力场详情并可视化其范围。如果已被占用，显示租客信息和剩余时间。

- 潜行+右键点击：放弃当前租约（不退款）。

• 所有者：

- 右键点击：收取租金、收取出售款项或列出当前租客。

✨力场嵌套与规则

力场内的地皮

• 从 v8 版本开始，支持力场嵌套（地皮可以放在更大的城镇力场内）。
• 当某个区域被多个力场重叠覆盖时，发生事件（如破坏、放置）时，体积最小的力场的规则优先生效。
• 如果希望子力场（地皮）完全覆盖父力场的规则，请为子力场添加 plot 标志。
• 可以创建多层嵌套结构（例如：城市 -> 城镇 -> 个人地皮），每层都有自己的欢迎消息和规则，最小范围的规则始终优先。

重叠规则与自动保护

• 默认情况下，你不能放置与他人力场重叠的力场。
• 自动允许：如果你允许了某人进入你的力场，而他在附近放置了一个与你的力场重叠的新力场，PreciousStones 会自动将你允许进他的这个新力场，确保你不会失去对自己土地的控制权。
• 利益冲突保护：在上述情况下，对方无法将你从他的这个重叠力场的允许列表中移除，他只能选择移除整个力场。

维持秩序

• 限制放置位置：使用 allow-only-inside 标志可以限制某些力场只能放置在特定类型的力场内部（例如，地皮只能放在“城镇保护”力场内）。
• 防止父级被移除：一旦有子力场被放置在父力场内，在移除所有子力场之前，父力场不能被移除或重定义。

⭐高级配置与功能

按力场分配权限

• 使用 required-permission 标志可以为力场绑定特定的权限节点（例如 preciousstones.plots.vip）。
• 只有拥有该权限的玩家才能放置这种力场，其他玩家放置的将是普通方块。便于区分普通玩家、会员、VIP 的领地大小。

土地认领模式

• 在配置文件中开启 prevent-place-everywhere 和 prevent-destroy-everywhere 设置。
• 开启后，玩家将只能在他们拥有或被允许的力场内放置和破坏方块。
• 配合使用带有 allow-place 和 allow-destroy 标志的力场，这些力场就成为玩家用来认领土地的“地皮”。

经济支持

• 通过 Vault 提供经济系统支持。
• 使用 price 标志可以为力场设置价格。放置力场时从玩家账户扣款，破坏（移除）力场时退款。

国际化

• 插件文件夹内的 language.yml 文件包含了所有插件文本。
• 你可以通过修改此文件，将插件翻译成任何语言，或自定义英文消息的颜色、甚至命令名称。

标志的灵活性

• 标志本身可以通过前缀修饰符来改变行为：

- `~`（波浪号）：反转标志效果。例如 `~launch` 会将非允许玩家弹向空中，而不是默认的允许玩家。

- `^`（插入符）：使标志全局生效，作用于所有玩家（允许和非允许）。例如 `^prevent-entry` 会弹开所有玩家。

- `?`（问号）：使标志默认为关闭状态，但允许玩家通过 `/ps toggle` 命令针对每个力场手动开启。适用于像 `?welcome-message` 这类不是所有人始终需要的功能。

性能

• PreciousStones 运行速度极快。所有力场数据从完全索引的数据库加载到内存，并存储在 6 个不同的哈希映射中，通过（世界、位置、区块、标志、所有者、方块类型）进行 O(1) 常数时间查找，几乎不会造成服务器延迟。

🔧相关资源

• Wiki/安装/配置/标志参考/权限：请查阅官方资源。
• 源码/开发者 API：适用于开发者。
• Dynmap 集成：由 dandielo 开发的 Dynmap-PreciousStones 插件，可在 Dynmap 上显示力场区域。只需将其与 PreciousStones 一同放入插件文件夹，并使用新的力场标志来选择要在地图上显示哪些力场。
• 标志大全：请访问 Field Flag Reference