跳到主要内容

使用 flag 自定义地皮

地皮 flag​

这个广泛的 flag 系统允许你执行各种操作，比如设置地皮的天气。

设置 flag 很容易，只需使用 /plot flag set <flag> <value>。对于布尔 flag ，值可以是 'true' 或 'false'。

flag 列表​

方块​

名称描述默认值
break定义玩家应该能够在地皮中破坏的材料列表，即使它们没有被添加到地皮中。无
place定义玩家应该能够在地皮中放置的材料列表，即使它们没有被添加到地皮中。无
use定义玩家应该能够在地皮中与之交互的材料列表，即使它们没有被添加到地皮中。无

选项​

名称描述默认值
animal-attack设置为 true 允许在地皮中攻击动物。False
animal-interact设置为 true 允许在地皮中与动物互动。False
beacon-effects设置为 false 禁用地皮上的信标效果。True
block-burn设置为 true 允许地皮内的方块燃烧。False
block-ignition设置为 false 禁止地皮内的方块点燃。True
chat设置为 false 阻止地皮内的聊天。False
concrete-harden设置为 false 禁用混凝土粉末在水中形成混凝土。True
coral-dry设置为 true 允许珊瑚在地皮中变干。False
crop-grow设置为 false 禁用地皮中的作物生长。True
copper-oxide设置为 true 允许铜在地皮中氧化。False
deny-exit设置为 true 禁止玩家离开地皮。False
deny-portal-travel阻止玩家通过使用传送门在维度之间旅行。False
deny-portals阻止玩家创建任何类型的传送门。False
device-interact设置为 true 允许在地皮中与设备互动。False
disable-physics设置为 true 禁用地皮中的方块物理效应。False
drop-protection设置为 true 防止非地皮成员拾取掉落的物品。False
entity-change-block设置为 true 允许实体在地皮内改变方块，如果没有其他标志覆盖。False
explosion设置为 true 允许地皮内的爆炸。False
fly设置为 true 允许在地皮中飞行。False
forcefield设置为 true 在地皮中启用成员力场。False
grass-grow设置为 false 禁用地皮中的草生长。True
hanging-break设置为 true 允许游客破坏悬挂物体。适用于以下实体类别：悬挂。False
hanging-place设置为 true 允许游客在地皮中悬挂物体。False
hide-info设置为 true 隐藏地皮信息。False
hostile-attack设置为 true 允许玩家在地皮中攻击敌对生物。False
hostile-interact设置为 true 允许玩家与地皮中的敌对生物互动。False
ice-form设置为 true 允许地皮中冰的形成。False
ice-melt设置为 true 允许地皮中冰的融化。False
instabreak设置为 true 允许在生存模式中瞬间破坏方块。False
invincible设置为 true 防止玩家在地皮内受到伤害。False
item-drop设置为 false 防止物品在地皮中掉落。True
keep-inventory防止玩家在死亡时在地皮内丢弃物品。False
kelp-grow设置为 false 禁用地皮中的海带生长。True
leaf-decay设置为 false 防止树叶腐烂。True
lectern-read-book防止玩家从讲台上取走书籍。False
misc-break设置为 true 允许游客破坏杂项物品。适用于以下实体类别：盔甲架。False
misc-place设置为 true 允许游客放置杂项物品。False
misc-interact设置为 true 允许游客与杂项物品互动。适用于以下实体。
mob-break设置为 true 允许生物在地皮内破坏方块。False
mob-place设置为 true 允许生物在地皮内放置方块。False
mycel-grow设置为 false 禁用地皮中菌丝生长。True
no-worldedit设置为 true 禁用地皮内（FastAsync）WorldEdit 的使用。False
notify-enter设置为 true 在有人进入地皮时通知地皮所有者。False
notify-leave设置为 true 在有人离开地皮时通知地皮所有者。False
player-interact设置为 true 允许游客在地皮中与玩家互动。False
pve设置为 true 在地皮内启用PVE。False
pvp设置为 true 在地皮内启用PVP。False
prevent-creative-copy防止在地皮中复制物品NBT数据，除非它们被添加为成员。False
projectiles当设置为 false 时阻止游客在地皮上射击抛射物。False
projectile-change-block设置为 true 允许抛射物在地皮上改变方块（TNT等）。False
redstone设置为 false 禁用地皮中的红石。True
server-plot设置为 true 将地皮变成服务器地皮。这相当于将服务器设置为地皮所有者。False
snow-form设置为 false 禁止地皮中的雪形成。False
snow-melt设置为 true 允许地皮中的雪融化。True
soil-dry设置为 true 允许地皮中的土壤干燥。False
tamed-attack设置为 true 允许游客攻击地皮中的驯养动物。False
tamed-interact设置为 true 允许游客与地皮中的驯养动物互动。False
untrusted-visit设置为 false 禁止不受信任的玩家访问地皮。True
vehicle-break设置为 true 允许游客破坏地皮中的载具。False
vehicle-place设置为 true 允许游客在地皮中放置载具。False
vehicle-use设置为 true 允许游客在地皮中使用载具。适用于以下实体类别：载具。False
villager-interact设置为 true 允许游客与地皮中的村民互动。False
vine-grow设置为 false 禁用地皮中的藤蔓生长。True

Enum​

名称描述默认值
deny-teleport阻止特定组别传送到地皮。可用组别：members、nonmembers、trusted、nontrusted、nonowners无
liquid-flow设置为 false 禁用液体流动。无
titles设置为 true 允许在有人进入地皮时显示地皮标题。无
weather指定地皮内的模拟天气。这对于与天气相关的游戏机制没有影响。无

数值类​

名称描述默认值
animal-cap设置为整数值以限制地皮上动物的数量。适用于以下实体类别：animal、villager、tamable。无穷大
entity-cap设置为整数值以限制地皮上实体的数量。无穷大
hostile-cap设置为整数值以限制地皮上敌对实体的数量。适用于以下实体类别：hostile。无穷大
misc-cap设置为整数值以限制地皮上杂项实体的数量。适用于以下实体类别：projectile、other、hanging。无穷大
mob-cap设置为整数值以限制地皮上生物的数量。适用于以下实体类别：animal、villager、tamable、hostile。无穷大
vehicle-cap设置为整数值以限制地皮上载具的数量。适用于以下实体类别：vehicle。无穷大
time指定地皮内的模拟时间。这对于与时间相关的游戏机制没有影响。禁用

内部​

名称描述默认值
analysis用于多用途调试分析的标志。Null
done将地皮标记为已完成。Null

杂项​

名称描述默认值
blocked-cmds在地皮中阻止的命令的列表。无
gamemode确定地皮中的游戏模式。无
guest-gamemode确定地皮中访客的游戏模式。无
music设置为音乐唱片ID（物品名称），以播放音乐唱片。无

自动消息​

名称描述默认值
description地皮描述。无
farewell离开地皮时向玩家发送的消息。无
greeting地皮进入时向玩家发送的消息。无
plot-title设置弹出窗口标题的标题和副标题。格式：/plot flag set title "A title" "The subtitle"无

定时​

名称描述默认值
feed指定以秒为单位的间隔，并可选指定玩家将受到的喂养量（默认为0 = 原版再生）。无
heal指定以秒为单位的间隔，并可选指定玩家将受到的治疗量（默认为0 = 原版再生）。无

默认地皮和道路 flag​

您可以在 plugins/PlotSquared/config/worlds.yml 中为每个世界设置默认 flag 。默认 flag 将存在于每个认领的地皮中，除非为该地皮手动设置了不同的值。

以下是设置 use flag 的示例，以允许与门、活板门、杠杆、栅栏门、轻质压力板、按钮和绊线互动：

worlds:
  <world>:
    [...]
    flags:
      use: "oak_door,iron_trapdoor,lever,acacia_fence_gate,light_weighted_pressure_plate,oak_button,tripwire"
      pvp: true
```bash

_`<world>` 表示该地皮世界的名称。_

您还可以使用 [Vanilla 方块标签](https://zh.minecraft.wiki/w/%E6%A0%87%E7%AD%BE#%E6%96%B9%E5%9D%97)。

对于道路 flag ，同样适用。

**示例：**

```yaml
worlds:
  <world>:
    [...]
    road:
      [...]
      flags:
        use: "oak_door,iron_trapdoor,lever,acacia_fence_gate,light_weighted_pressure_plate,oak_button,tripwire"
        pvp: true
```bash

_`<world>` 表示该道路地皮世界的名称。_

## flag 类型

### BlockTypeList（块类型列表）

一个块的列表，支持传统的数字 ID 和新的字符串 ID，例如：

- `grass_block` 代表草方块
- `7` 代表基岩
- `7,3` 代表基岩和泥土
- `35:14,35:15` 代表红色和黑色羊毛

这些 flag 还支持 [Vanilla 标签](https://zh.minecraft.wiki/w/%E6%A0%87%E7%AD%BE#%E6%96%B9%E5%9D%97)，比如：

- `#signs` 代表所有类型的牌子
- `#buttons` 代表所有类型的按钮

| 类型              | 描述                                                                                    | 示例值                                     |
| ----------------- | --------------------------------------------------------------------------------------- | ------------------------------------------ |
| `Boolean        ` | 接受 `true` 或 `false`。                                                                | `true`, `false`                            |
| `Double         ` | 接受任何十进制数（所有实数）。                                                          | `3.14`, `42.0`, `-7.5`                     |
| `Enum           ` | 接受预定义的值集。                                                                      | 预定义的枚举值                             |
| `Integer        ` | 接受所有整数。                                                                          | `1`, `100`, `-5`                           |
| `Internal       ` | 内部使用的 flag 。                                                                      | 内部使用的标志                             |
| `Miscellaneous  ` | 接受具有多个参数的命令，例如 `/gamemode creative`。                                     | `/gamemode creative`, `/say Hello!`        |
| `String         ` | 接受具有多个字符串参数的 flag ，例如 `/plot f set greeting Welcome to my plot!`。       | `/plot f set greeting Welcome to my plot!` |
| `TeleportDeny`    | 接受以下地皮成员身份：`trusted`、`members`、`nonmembers`、`nontrusted` 和 `nonowners`。 | `trusted`, `members`, `nonmembers`         |
| `Timed   `        | 一个包含两个数字的二元组，例如 `53 6` 或 `7 93`。                                       | `53 6`, `7 93`                             |

### 术语

以下表格包含涵盖地皮成员继承和 flag 状态的某些立场的短语。我们将解释下面使用的短语。

| 名称           | 描述                                     |
| -------------- | ---------------------------------------- |
| `player      ` | 服务器的用户。                           |
| `visitor     ` | 未添加到地皮 [层级](./plots/jurisdiction) 的人。 |
| `False       ` | flag 的预期行为默认未启用。              |
| `True        ` | flag 的预期行为默认启用。                |
| `None        ` | flag 的预期行为默认未设置。              |
| `Infinity    ` | flag 未绑定到数量，允许无限类型的 flag。 |
| `Null        ` | flag 的预期行为不能在 API 外部设置。     |
| `Empty       ` | flag 变量为空，不会显示给用户。          |
| `Not Buyable ` | flag 变量未设置，因此地皮不可购买。      |
| `Disabled    ` | flag 变量未设置，因此预期的行为未定义。  |

### 实体类别

例如，`mob caps`、`interaction flags` 等 flag 使用实体类别。PlotSquared 将实体划分为以下类别：

| 类别          | 具体项                                                                                                                                                                                                                                                                                                                                       |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `animal `     | cod, donkey, squid, skeleton_horse, mule, trader_llama, parrot, zombie_horse, cow, horse, bee, polar_bear, pufferfish, cat, bat, salmon, fox, pig, llama, iron_golem, turtle, tropical_fish, sheep, snow_golem, mooshroom, ocelot, dolphin, chicken, wolf, panda, rabbit                                                                     |
| `hostile `    | blaze, pillager, skeleton, giant, elder_guardian, zombie_pigman, end_crystal, ravager, ghast, guardian, vindicator, magma_cube, spider, creeper, wither, evoker, slime, illusioner, phantom, witch, wither_skeleton, husk, ender_dragon, cave_spider, stray, enderman, silverfish, endermite, vex, zombie, drowned, zombie_villager, shulker |
| `player `     | player                                                                                                                                                                                                                                                                                                                                       |
| ` projectile` | ender_pearl, dragon_fireball, fireball, wither_skull, llama_spit, fishing_bobber, experience_bottle, egg, arrow, small_fireball                                                                                                                                                                                                              |
| `vehicle   `  | spawner_minecart, donkey                                                                                                                                                                                                                                                                                                                     |