# 标签

## 一、介绍

地皮标签可以允许您管理各个身份的玩家在地皮内执行各个事务时的权限以及地皮自身的相关设置等.

设置地皮的标签非常简单，只需要输入指令 `/plot flag set <标签> <值>` 即可.

关于其中的值是与标签挂钩的，例如，对于布尔类型的标签，值即为 true（真）或者 false（假）.

## 二、标签列表

你可以使用指令 `/plot flag list` 查看插件提供的所有标签. 你将会得到如下图所示的标签列表：

![](https://3211214227-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7dgwciADYLC6Q8fPGTLE%2Fuploads%2FNXIadOjVcpwPgbQ4bAEP%2Fimage.png?alt=media\&token=523ba895-4b79-4b24-a738-6d62fab0a683)

这些标签名称都是可点击的，你可以点击对于标签查看其介绍. 同时如果你已经知道了某个功能的对应标签，那么你也可以输入指令 `/plot flag info <标签>` 以查看其介绍.

## 三、默认的“路”和地皮区域标签

您可以在 `plugins/PlotSquared/config/worlds.yml` 文件中通过设置 `flags` 选项以实现修改各个地皮世界的默认的“路”和地皮区域标签.

玩家认领地皮后将自动使用默认标签值，如果玩家对默认的值不满意，那么玩家也可以通过修改地皮标签的指令来更改对应标签.

一个示例如下：

```
worlds:
  <地皮世界名称>:
    [其他配置选项...]
    flags:
      use: "oak_door,iron_trapdoor,lever,acacia_fence_gate,light_weighted_pressure_plate,oak_button,tripwire"
      pvp: true
```

## 四、标签类型

### BlockTypeList（方块类型列表） <a href="#blocktypelist" id="blocktypelist"></a>

该类型的标签的值往往是一列表的方块ID. 例如：

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

支持填写 [原版标签](https://docs.superiormc.cn/plotsquared-wiki/bu-chong/yuan-ban-biao-qian)，例如：

* `#signs` 代表所有的告示牌
* `#buttons` 代表所有的按钮

### Boolean（布尔值）

该类型的标签的值往往是 true（真）或者 false（假）.

### Double（双精度浮点数）

该类型的标签的值往往是数字，并且支持所有实数.

### Enum（枚举）

该类型的标签的值往往是在若干预设值中选择其一.

### Integer（整数） <a href="#integer" id="integer"></a>

该类型的标签的值往往是数字，但只能是整数.

### Internal（内部） <a href="#internal" id="internal"></a>

内部使用的标签.

### Miscellaneous（杂项） <a href="#miscellaneous" id="miscellaneous"></a>

该类型的标签的值往往是指令（并且支持多个参数. 例如 `/gamemode creative`）等杂项内容.

### String（文本）

该类型的标签的值往往是文本. 例如 `Welcome to my plot!`.

### TeleportDeny（拒绝传送） <a href="#teleportdeny" id="teleportdeny"></a>

该类型的标签的值往往是成员身份. 例如 `trusted，members，nonmembers，nontrusted，nonowners`. 具体详见 [地皮成员身份](https://docs.superiormc.cn/plotsquared-wiki/bu-chong/di-pi-cheng-yuan-shen-fen) 一节.

### TIMED

该类型的标签的值往往是一串数字. 例如 `53 6` 和  `7 93`.

## 五、标签权限节点

### 主要权限节点

想要让玩家使用地皮标签系统，你需要给予玩家以下权限节点：

* `plots.set.flag`
* `plots.flag`
* `plots.flag.add`
* `plots.flag.remove`

这些权限节点的具体作用可以在 [指令](https://docs.superiormc.cn/plotsquared-wiki/ji-chu/zhi-ling) 一节参考.

### 次要权限节点

各个标签另有自己的权限节点，您还需要给予玩家对应的标签的权限节点才能让玩家设置对应标签的值.

这些标签单独的权限节点的格式是：`plots.set.flag.<标签名称>.*`. 其中 `*` 符号代表该标签可以设置为任意的值.

例如拥有 `plots.set.flag.fly.*` 权限节点的玩家可以设置自己地皮的 `fly` 标签为任意值（即 true 或者 false）. 您也可以将 `*` 替换为自己只需要让玩家只能设置的值.

## 六、术语

除非单独说明，否则本节下面所述的对应术语即符合其对应的解释：

* 玩家：服务器内的玩家.
* 游客：没有被添加到地皮的白名单内的玩家.（详见 [这里](https://docs.superiormc.cn/plotsquared-wiki/bu-chong/di-pi-cheng-yuan-shen-fen)）
* False：在默认情况下不会启用对应标签的行为.
* True: 在默认情况下启用对应标签的行为.
* None: 在默认情况下不设置对应标签的值.
* Infinity：在默认情况下对应标签的值是一个正无穷数字.
* Null: 在默认情况下对应标签不启用.
* Empty: 在默认情况下对应标签的值是空的.
* Not Buyable: 在默认情况下对应标签的值是空的，这意味着对应的地皮不可被购买.
* Disabled: 在默认情况下对应标签的值是空的，这意味着对应的标签不会被启用.

## 七、实体分类

您可以在部分标签内使用实体分类以指代对应的生物种类，无需一个个设置.

* **animal（被动攻击生物）：**&#x63;od 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（玩家）：**&#x70;layer
* **projectile（弹射物，例如箭）：**&#x65;nder\_pearl dragon\_fireball fireball wither\_skull llama\_spit fishing\_bobber experience\_bottle egg arrow small\_fireball
* **vehicle（载具，例如矿车）：**&#x73;pawner\_minecart donkey pig llama furnace\_minecart skeleton\_horse mule hopper\_minecart trader\_llama zombie\_horse tnt\_minecart boat chest\_minecart horse command\_block\_minecart minecart
* **villager（村民）：**&#x76;illager wandering\_trader snowball spectral\_arrow shulker\_bullet potion trident
* **hanging（画、物品展示框等）：**&#x69;tem\_frame leash\_knot painting
* **other（其他）：**&#x64;ragon\_fireball tnt experience\_orb lightning\_bolt fireball wither\_skull area\_effect\_cloud evoker\_fangs eye\_of\_ender armor\_stand small\_fireball firework\_rocket falling\_block item
* **teamable（可驯服）：**&#x63;at trader\_llama parrot zombie\_horse donkey wolf llama horse skeleton\_horse mule

## 八、标签

### BlockTypeList <a href="#blocktypelist_2" id="blocktypelist_2"></a>

| 名称    | 描述                                    | 默认值  |
| ----- | ------------------------------------- | ---- |
| break | 决定所有玩家（包括未被加入白名单的玩家）可以在该地皮破坏的方块列表.    | None |
| place | 决定所有玩家（包括未被加入白名单的玩家）可以在该地放置的方块列表.     | None |
| use   | 决定所有玩家（包括未被加入白名单的玩家）可以在该地交互（使用）的方块列表. | None |

### Boolean <a href="#boolean_2" id="boolean_2"></a>

| 名称                    | 描述                                | 默认值   |
| --------------------- | --------------------------------- | ----- |
| animal-attack         | 是否允许在地皮内攻击被动攻击生物                  | False |
| animal-interact       | 是否允许在地皮内与被动攻击生物交互                 | False |
| beacon-effects        | 是否启用地皮内信标给予玩家药水效果                 | True  |
| block-burn            | 是否启用地皮内方块燃烧（例如木板靠近熔岩被燃烧）          | False |
| block-ignition        | 是否允许地皮内方块点燃                       | True  |
| chat                  | 是否启用地皮聊天                          | False |
| coral-dry             | 珊瑚在地皮内是否干燥                        | False |
| crop-grow             | 农作物在地皮内是否成长                       | True  |
| copper-oxide          | 铜方块在地皮内是否氧化                       | False |
| deny-exit             | 是否禁止玩家离开地皮                        | False |
| deny-portal-travel    | 是否禁止玩家使用传送门进行传送                   | False |
| deny-portals          | 是否禁止玩家搭建传送门                       | False |
| device-interact       | 是否允许在地皮内与设备进行交互                   | False |
| disable-physics       | 是否在地皮内禁用方块重力                      | False |
| drop-protections      | 是否启用地皮内非成员无法捡起掉落物机制               | False |
| entity-change-block   | 是否允许生物更改地皮内方块                     | False |
| explosion             | 是否允许在地皮内爆炸                        | False |
| fly                   | 是否允许在地皮内飞行                        | False |
| forcefield            | 耕地在地皮内是否不会被践踏                     | False |
| grass-grow            | 泥土在地皮内是否会转化为草方块                   | True  |
| hanging-break         | 是否允许游客破坏地皮内的画、物品展示框等              | False |
| hanging-place         | 是否允许游客在地皮内放置画、物品展示框等              | False |
| hide-info             | 是否对其他玩家隐藏地皮信息（/plot info）         | False |
| hostile-attack        | 是否允许在地皮内攻击主动攻击生物                  | False |
| hostile-interact      | 是否允许在地皮内与主动攻击生物交互                 | False |
| ice-form              | 是否允许地皮内水化成冰                       | False |
| ice-melt              | 是否允许地皮内冰化成水                       | False |
| instabreak            | 在地皮内生存模式下是否开启立即破坏方块的机制（类似创造模式的速度） | False |
| invincible            | 玩家在地皮内是否不会受到任何伤害                  | False |
| item-drop             | 是否允许在地皮内丢弃物品                      | True  |
| keep-inventory        | 在地皮内是否死亡不掉落                       | False |
| kelp-grow             | 农作物在地皮内是否会生长                      | True  |
| leaf-decay            | 树叶在地皮内是否会消失                       | True  |
| lectern-read-book     | 玩家是否可以从讲台中取书                      | False |
| misc-break            | 是否允许游客破坏地皮内盔甲架等                   | False |
| misc-place            | 是否允许游客在地皮内放置盔甲架等                  | False |
| misc-interact         | 是否允许游客在地皮内与盔甲架等交互                 |       |
| mob-break             | 是否允许生物破坏地皮内方块                     | False |
| mob-place             | 是否允许生物在地皮内放置方块                    | False |
| mycel-grow            | 是否允许蘑菇在地皮内上长                      | True  |
| no-worldedit          | 是否在地皮内禁止使用创世神功能                   | False |
| notify-enter          | 当有人进入地皮时是否向主人发送提示                 | False |
| notify-leave          | 当有人离开地皮时是否向主人发送提示                 | False |
| player-interact       | 是否允许游客与地皮内其他玩家交互                  | False |
| pve                   | 是否在地皮内开启 PVE                      | False |
| pvp                   | 是否在地皮内开启 PVP                      | False |
| prevent-creative-copy | 非地皮成员是否法通过创造模式复制 NBT 信息           | False |
| projectiles           | 是否允许游客在地皮内使用弹射物                   | False |
| redstone              | 是否允许在地皮内使用红石                      | True  |
| server-plot           | 是否将地皮转换为服务器公用地皮，这样服务器自身将成为这个地皮的主人 | False |
| snow-form             | 是否允许在地皮内自然生成雪                     | False |
| snow-melt             | 是否允许地皮内雪融化                        | True  |
| soil-dry              | 是否允许地皮内耕地干枯成泥土                    | False |
| tamed-attack          | 是否允许游客攻击地皮内已驯服生物                  | False |
| tamed-interact        | 是否允许游客在地皮内与已驯服生物交互                | False |
| untrusted-visit       | 是否允许非信任玩家访问地皮（/plot visit）        | True  |
| vehicle-break         | 是否允许游客破坏地皮内载具                     | False |
| vehicle-place         | 是否允许游客在地皮内放置载具                    | False |
| vehicle-use           | 是否允许游客在地皮内使用载具                    | False |
| villager-interact     | 是否允许游客在地皮与村民交互                    | False |
| vine-grow             | 是否允许藤蔓在地皮内生长                      | True  |

### Double <a href="#double_2" id="double_2"></a>

| 名称    | 描述                                                                                  | 默认值         |
| ----- | ----------------------------------------------------------------------------------- | ----------- |
| price | 地皮出售的价格.  其他玩家可以通过`/plot buy` 指令购买你的地皮. 你也可以使用指令 `/plots list forsale` 查看正在出售的地皮列表. | Not Buyable |

### Enum <a href="#enum_2" id="enum_2"></a>

| Name          | Description                                                                            | Default Value |
| ------------- | -------------------------------------------------------------------------------------- | ------------- |
| deny-teleport | <p>拒绝某个身份的玩家传送到地皮.</p><p>可用的身份：members, nonmembers, trusted, nontrusted, nonowners</p> | None          |
| liquid-flow   | 设置为 `false` 以禁止液体流动.                                                                   | None          |
| titles        | 设置为 `true` 以在其他玩家进入地皮时发送 Title                                                         | None          |
| weather       | 设置地皮内的天气.                                                                              | None          |

### Integer <a href="#integer_2" id="integer_2"></a>

| Name        | Description                                     | Default Value |
| ----------- | ----------------------------------------------- | ------------- |
| animal-cap  | 设置地皮内 animal，villager，tamable 实体种类的上限值.         | Infinity      |
| entity-cap  | 设置地皮内总实体上限值.                                    | Infinity      |
| hostile-cap | 设置地皮内 hostile 实体种类的上限值.                         | Infinity      |
| misc-cap    | 设置地皮内 projectile，other，hanging 实体种类的上限值.        | Infinity      |
| mob-cap     | 设置地皮内 animal，villager，tamable，hostile 实体种类的上限值. | Infinity      |
| vehicle-cap | 设置地皮内 vehicle 实体种类的上限值.                         | Infinity      |
| time        | 地皮内的时间.                                         | Disabled      |

### Internal <a href="#internal_2" id="internal_2"></a>

| 名称       | 描述           | 默认值  |
| -------- | ------------ | ---- |
| analysis | debug 测试时使用. | Null |
| done     | 标记地皮为已完成状态.  | Null |

### Miscellaneous <a href="#miscellaneous_2" id="miscellaneous_2"></a>

| 名称             | 描述           | 默认值  |
| -------------- | ------------ | ---- |
| blocked-cmds   | 地皮内禁止使用的指令.  | None |
| gamemode       | 地皮内的游戏模式.    | None |
| guest-gamemode | 游客在地皮内的游戏模式. | None |
| music          | 地皮内播放的音乐.    | None |

### String <a href="#string_2" id="string_2"></a>

| 名称          | 描述                                                  | 默认值  |
| ----------- | --------------------------------------------------- | ---- |
| description | 地皮的描述.                                              | None |
| farewell    | 玩家离开地皮时的提示信息.                                       | None |
| greeting    | 玩家进入地皮时的提示消息                                        | None |
| plot-title  | 地皮  Title 信息.  格式：`/plot flag set title "标题" "副标题"` | None |

### Timed <a href="#timed_2" id="timed_2"></a>

| 名称   | 描述                                           | 默认值  |
| ---- | -------------------------------------------- | ---- |
| feed | 由2个数字组成. 第一个数字为每秒饱食度回复，第二个数字可选，为地皮内同时回复人数上限. | None |
| heal | 由2个数字组成. 第一个数字为每秒生命值回复，第二个数字可选，为地皮内同时回复人数上限. | None |