# 指令 ## 一、通用内容 本插件所有的指令都是以 `/plot` 开头的. 例如当我们想使用 `help` 指令时，我们需要输入 `/plot help`. 你也可以使用变样形式，有 `plots，p，plotsquared，p2，ps，2，plotme`. {% hint style="info" %} 本节中，指令用法等中包含的 \[输入内容1] 指的是可选输入内容，<输入内容2> 指的是必须输入内容. 您在服务器输入指令时请勿将 \[] 和 <> 符号一并输入，否则会导致指令使用错误. 在输入内容中可能会出现子输入内容，如\[\[输入内容1]输入内容2]，这代表输入内容2本身是可选的，如果您要在指令中添加输入内容2，那么您在添加输入内容2的同时也可以无需添加输入内容2中的输入内容1. 例如： \[\[地皮世界名称;]X;Z] 我们可以输入 PlotWorld;100;100，代表 PlotWorld 地皮世界下的 X=100，Z=100 的地皮ID位置，也可以只输入 100;100，代表当前世界下的 X=100，Z=100 的地皮ID位置，或者完全不输入该内容. {% endhint %} ## 二、基础类指令 {% hint style="info" %} 以下指令介绍中，括号前面为指令，括号内为对应指令的权限节点. {% endhint %} ### HELP（plots.use） 获取总指令帮助信息. #### 变样：? ### CONFIRM（plots.confirm） 确认某个操作. 例如清除地皮时需要再次输入该指令以确认. ## 三、查询类指令 ### INFO 展示地皮信息. 在输入指令时添加 `-f` 后缀可以无视 `hide-info` 标签的影响. 即 `/plot info -f`. #### 用法： 主要用法： * `/plot [[地皮世界名称;]X;Z] info [-f]` * `/plot info [[地皮世界名称;]X;Z] [-f]` 次要用法： * `/plot [[地皮世界名称;]X;Z] info [-f] <信息分类: members, alias, biome, seen, denied, flags, id, size, trusted, owner, rating>` - 其中，members 为成员信息，alias 为变样信息，biome 为生物群系信息，seen 为访客信息，denied 为黑名单信息，flags 为标签信息，id 为 ID 信息，size 为大小信息，trusted 为信任玩家信息，owner 为主人信息，rating 为评价信息. * `/plot info [[地皮世界名称;]X;Z] [-f] <信息分类: members, alias, biome, seen, denied, flags, id, size, trusted, owner, rating>` #### 变样：i #### 权限节点： 主要权限节点：plots.info 次要权限节点：plots.admin.info.force - 当使用 `-f` 后缀时需要. ### LIST 展示地皮列表. #### 用法： 主要用法： * `/plot list [#]` - 其中，forsale 为当前正在出售的地皮，mine 为自己的地皮，shared 为正在共享的地皮，world 为对应地皮世界的地皮，top 为排行榜，all 为全部地皮，unowned 为无主地皮，unknown 为未知地皮，player 为对应玩家的地皮，done 为已完成建筑的地皮. # 后接地皮编号. 次要用法： * `/plot list fuzzy [#]` - 同上，不再赘述，fuzzy 为模糊搜索. #### 变样：l，find，search #### 权限节点： 主要权限节点：plots.list 次要权限节点： * `plots.list.world.<地皮世界名称>` - 在指令中的第一个输入内容中使用 `world` 时，第二个输入内容中使用该权限节点中的地皮世界名称时需要. 即输入 `/plot list world PlotWorld` 时需要 `plot.list.world.PlotWorld` 权限节点. * `plots.list.top` - 在指令中的第一个输入内容中使用 `top` 时需要. 即输入 `/plot list top` 时需要. 以此类推，不再赘述. * `plots.list.mine` * `plots.list.world` * `plots.list.done` * `plots.list.all` * `plots.list.shared` * `plots.list.expired` * `plots.list.unowned` * `plots.list.player` * `plots.list.forsale` * `plots.list.unknown` * `plots.list.area` * `plots.list.fuzzy` - 使用次要用法时也需要，即使用 `/plot list fuzzy #`. ### TARGET（plots.target） 将指南针指向对应地皮. #### 用法： * `/plot target <[地皮世界名称] | nearest>` - 其中第二个输入内容的 nearest 为离你最近的地皮. ### CAPS 展示地皮的生物和实体上限. #### 用法： * `/plot [[地皮世界名称;]X;Z] caps` #### 权限节点： 主要权限节点：plots.caps 次要权限节点： * plots.admin.caps.other - 管理员在其他玩家地皮时需要. ## 四、传送类指令 ### HOME 传送到你的地皮. #### 用法： 常规用法： * `/plot home` * `/plot home <#>` - 其中 # 后接地皮编号. * `/plot home <地皮区域名称/地皮世界名称> <#>` 简单用法： * `/plot home <地皮名称>` 坐标用法： * `/plot home ;` * `/plot home <地皮区域名称/地皮世界名称> ;` * `/plot home <地皮区域名称/地皮世界名称>;;` #### 变样：h #### 权限节点： 主要权限节点：plots.home 次要权限节点： * `plots.visit.owned` - 访问自己的地皮. ### VISIT 访问其他玩家的地皮. #### 用法： 常规用法： * `/plot visit <玩家名称>` * `/plot visit <玩家名称> <#>` - 其中 # 后接地皮编号. * `/plot visit <玩家名称> <地皮区域名称/地皮世界名称>` * `/plot visit <玩家名称> <地皮区域名称/地皮世界名称> <#>` 简单用法： * `/plot visit <地皮名称>` 坐标用法： * `/plot visit ;` * `/plot visit <地皮区域名称/地皮世界名称>;;` #### 变样：v，tp，teleport，goto，warp #### 权限节点： 主要权限节点： * `plots.visit` * `plots.visit.other` - 访问其他玩家的地皮时需要 次要权限节点： * `plots.visit.unowned` - 访问无主地皮时需要 * `plots.visit.owned` - 访问有主地皮时需要 * `plots.visit.shared` - 访问正在共享时地皮需要 * `plots.admin.visit.untrusted` - 管理员访问未受信任的地皮时需要 ### MIDDLE（plots.middle） 将你传送到当前地皮的中央位置. #### 用法： * /plot \[\[地皮世界名称;]X;Z] middle #### 变样：center，cantre ## 五、聊天类指令 ### COMMENT（plots.comment） 给指定地皮发布邮件. #### 用法： * `/plot [[地皮世界名称;]X;Z] comment <消息类型: owner | public | report>` - 其中消息类型的 owner 代表发布给主人，public 代表公开发布，report 代表举报，发布给服务器管理员. ### INBOX（plots.inbox） 查看当前地皮的邮件或者删除邮件. #### **用法：** 主要用法: * `/plot [[地皮世界名称;]X;Z] inbox` 次要用法： * `/plot [[地皮世界名称;]X;Z] inbox <消息类型: owner | public | report> [delete <页数> | clear | page]` - 其中 clear 为删除. ### CHAT 打开或者关闭地皮内部聊天功能. #### 权限节点： 主要权限节点： * `plots.chat` 次要权限节点： * `plots.chat.color` - 在聊天中使用颜色. ## 六、认领类指令 ### BUY（plots.buy） 购买地皮. 你必须在 `worlds.yml` 中启用相关功能才能使用该指令的经济功能. 你可以在让玩家在认领、合并、出售地皮时必须消耗金币. #### 用法： * /plot \[\[地皮世界名称;]X;Z] buy ### CLAIM 认领脚下的无主地皮. 你必须在 `worlds.yml` 中启用相关功能才能使用该指令的经济功能. 你可以在让玩家在认领、合并、出售地皮时必须消耗金币. 你如果在 `worlds.yml` 中启用了 `specify_on_claim` 选项，那么可以在使用指令时添加结构图输入内容. #### 用法： 主要用法： * `/plot [[地皮世界名称;]X;Z] claim` 次要用法： * `/plot [[地皮世界名称;]X;Z] claim <结构图名称>` #### 变样：c #### 权限节点： 主要权限节点： * `plots.claim` * `plots.plot.<最多地皮数量>` - 限制玩家可以认领的地皮数量. 次要权限节点: * `plots.claim.<结构图名称>` - 在指令中使用某个地皮结构图时需要. * `plots.admin.command.schematic` - 管理员在指令中使用地皮结构图无视上个权限节点时需要. ### AUTO 自动认领当前地皮世界离你最近的无主地皮. #### 用法： * `/plot auto [长度, 宽度]` #### 变样：a #### 权限节点： 主要权限节点： * `plots.claim` * `plots.plot.<最多地皮数量>` - 限制玩家可以认领的地皮数量. 次要权限节点: * `plots.claim.<结构图名称>` - 在指令中使用某个地皮结构图时需要. * `plots.auto.mega` - 使用长度和宽度输入内容时需要. * `plots.admin.command.schematic` - 管理员在指令中使用地皮结构图无视上个.权限节点时需要. ## 七、设置类指令 ### SETOWNER 设置地皮的主人. #### 用法： * `/plot [[地皮世界名称;]X;Z] setowner <玩家名称>` #### 变样：owner，so，seto #### 权限节点： * `plots.admin.command.setowner` ### ADD 将指定玩家“添加”到地皮的白名单中，被添加的玩家在主人在线时可以在地皮中建筑. #### 用法： * `/plot [[world;]X;Z] add ` - 其中第二个输入内容中的 \* 代表全部玩家. #### 权限节点： 主要权限节点： * `plots.add` * `plots.add.<数量>` - 主人可以添加的玩家数量. 次要权限节点： * `plots.admin.command.add` - 管理员无视上个权限节点或者给其他玩家的地皮使用时需要. * `plots.add.everyone` - 添加所有玩家时需要. ### TRUST 将指定玩家“添加”到地皮的白名单中，不同于 add 指令，通过该指令添加的玩家在主人不在线时也可以在地皮中建筑，同时也可以使用 WorldEdit 功能. #### 用法： * `/plot [[world;]X;Z] trust ` - 其中第二个输入内容中的 \* 代表全部玩家. #### 变样：t #### 权限节点： 主要权限节点： * `plots.trust` * `plots.trust.<数量>` - 主人可以信任的玩家数量. 次要权限节点： * `plots.admin.command.trust` - 管理员无视上个权限节点或者给其他玩家的地皮使用时需要. * `plots.trust.everyone` - 添加所有玩家时需要. ### REMOVE 将玩家从地皮的白名单或者黑名单移除. #### 用法： * `/plot [[world;]X;Z] remove ` - 其中第二个输入内容中的 \* 代表全部玩家. #### 变样：r，untrust，ut，undeny，ud，unban #### 权限节点： 主要权限节点： * `plots.remove` 次要权限节点： * `plots.admin.command.remove` - 管理员给其他玩家的地皮使用时需要. ### DENY 将一个玩家“添加”到黑名单中，这样改玩家就无法进入你的地皮. #### 用法： * `/plot [[地皮世界名称;]X;Z] deny <玩家名称 | *>` #### 变样：d，ban #### 权限节点： 主要权限节点： * `plots.deny` * `plots.deny.<数量>` - 主人可以拒绝的玩家数量. 次要权限节点： * `plots.admin.command.deny` - 管理员无视上个权限节点或者给其他玩家的地皮使用时需要. * `plots.admin.entry.denied` - 管理员无视被加入黑名单限制时需要. * `plots.trust.everyone` - 拒绝所有玩家时需要. ### GRANT 管理地皮授权. #### 用法： * `/plots grant [玩家名称]` - 其中第一个输入内容中的 check 代表检查，add 代表添加. #### 权限节点： * `plots.grant` * `plots.grant.add` - 第一个输入内容为 add 时需要，即输入 `/plot grant add`. * `plots.grant.check` - 第一个输入内容为 check 时需要，即输入 `/plot grant check`. ### KICK 将一名玩家从你的地皮中踢出. #### 用法： * `/plot [[地皮世界名称;]X;Z] kick <玩家名称 | *>` #### 变样：k #### 权限节点： 主要权限节点： * `plots.kick` 次要权限节点： * `plots.admin.command.kick` - 管理员给其他玩家的地皮使用时需要. ### MERGE 将脚下的地皮与其他地皮合并. #### 用法： * `/plot [[地皮世界名称;]X;Z] merge [removeroads]` - 其中第二个输入内容中的 all 代表东西南北四个方向全部合并，n为北，e为东，s 为南，w为西. 第三个输入内容中的 removeroads 代表是否移除两个地皮之间的路. #### 变样：m #### 权限节点： 主要权限节点： * `plots.merge` 次要权限节点： * `plots.merge.<数量>` - 限制玩家可合并的地皮数量 * `plots.admin.command.merge` - 管理员给其他玩家使用时或者无视权限限制时使用 * `plots.merge.other` - 与其他玩家的地皮合并时需要 * `plots.merge.keeproad` - 使用第三个输入内容时需要 ### UNLINK 撤销合并地皮. #### 用法： * `/plot [[地皮世界名称;]X;Z] unlink [createroads]` #### 变样：u，unmerge #### 权限节点： 主要权限节点： * `plots.unlink` 次要权限节点： * `plots.admin.command.unlink` - 管理员给其他玩家使用时需要 ### SETHOME（plots.set.home） 将脚下位置作为地皮的家. 家的位置即玩家在输入 `/plot home` 或者 `/plot visit` 指令时传送的位置. #### 用法： * /plot \[\[地皮世界名称;]X;Z] set home \[none] - 其中，第二个输入内容中的 none 为可选，如果添加即为重置家位置. #### 变样：sh，seth，sethome ### ALIAS 给地皮设置名称. #### 用法： * `/plot [[world;]X;Z] alias set <名称>` - 设置名称. * `/plot [[world;]X;Z] alias remove <名称>` - 移除名称. #### 变样：setalias，sa，name，rename，setname，seta，nameplot #### 权限节点： 主要权限节点： * `plots.alias.set` - 使用指令 `/plot alias set` 时需要. * `plots.alias.remove` - 使用指令 `/plot alias remove` 时需要. 次要权限节点： * `plots.admin.alias.set` - 管理员给其他玩家的地皮设置名称时需要. * `plots.admin.alias.remove` - 管理员给其他玩家的地皮移除名称时需要. ### SETDESCRIPTION（plots.set.desc） 给地皮设置描述. #### 用法： * `/plot [[地皮世界名称;]X;Z] desc <描述>` #### 变样：setdescription，setdesc，setd，description ### MUSIC（plots.music） 给地皮设置播放的音乐. #### 用法： * `/plot [[地皮世界名称;]X;Z] music` ### SETBIOME（plots.set.biome） 查看所有地皮可以设置的生物群系列表或者给地皮设置生物群系. 你也可以通过 WorldEdit 设置生物群系. 清除地皮将会导致你的生物群系设置同样被清空，将会使用 `worlds.yml` 中设置的默认的地皮生物群系. #### 用法： * `/plot [[world;]X;Z] biome [生物群系]` #### 变样：biome，sb，setb，b ### SETFLAG 给地皮设置标签. 有关地皮标签的相关信息，详见 [这里](https://docs.superiormc.cn/plotsquared-wiki/ji-chu/biao-qian). #### 用法： 主要用法： * `/plot [[地皮世界名称;]X;Z] flag` 次要用法： * `/plot [[地皮世界名称;]X;Z] flag info <标签>` - 查看指定标签的信息. * `/plot [[地皮世界名称;]X;Z] flag set <标签> <值>` - 设置某个标签的值. * `/plot [[地皮世界名称;]X;Z] flag add <标签> <值>` - 给某个标签添加值. * `/plot [[地皮世界名称;]X;Z] flag remove <标签> [值]` - 给某个标签移除值. #### 变样：f，flag #### 权限节点： 主要权限节点： * `plots.flag` 次要权限节点： * `plots.set.flag` - 使用指令 `/plot set flag` 时需要. * `plots.flag.remove` - 使用指令 `/plot flag remove` 时需要. * `plots.flag.add` - 使用指令 `/plot flag add` 时需要. * `plots.set.flag.other` - 设置其他玩家的地皮时需要. * `plots.set.flag.` - 使用指令 `/plot set flag ` 时需要. * `plots.flag.list` - 使用指令 `/plot flag list` 时需要. ### DONE 标记地皮为已完成状态. #### 用法： * `/plot [[地皮世界名称;]X;Z] done` #### 变样：submit #### 权限节点： 主要权限节点： * `plots.done` 次要权限节点： * `plots.admin.command.done` - 管理员给其他玩家的地皮使用时需要. ### CONTINUE 取消标记地皮为已完成状态. #### 用法： * `/plot [[地皮世界名称;]X;Z] continue` #### 权限节点： 主要权限节点： * `plots.continue` 次要权限节点： * `plots.admin.command.continue` - 管理员给其他玩家的地皮使用时需要. ### TOGGLE 开启或者关闭地皮的某些功能. #### 用法： * `/plot [[地皮世界名称;]X;Z] toggle ` #### 权限节点： 主要权限节点： * `plots.use` 次要权限节点： * `plots.admin.command.chat` - 管理员使用指令 `/plot toggle chat-spy` 时需要. * `plots.worldedit.bypass` - 管理员使用指令 `/plot wea` 时需要. * `plots.toggle.chat` - 管理员使用指令 `/plot chat` 时需要. * `plots.admin.command.autoclear` - 管理员使用指令 `/plot toggle clear-confirmation` 时需要. * `plots.toggle.titles` - 管理员使用指令 `/plot toggle titles` 时需要. * `plots.toggle.time` - 管理员使用指令 `/plots toggle time` 时需要. * `plots.toggle.debug` - 管理员使用指令 `/plots toggle debug` 时需要. * `plots.admin.debug.other` - 管理员给其他玩家的地皮使用时需要. ### SET 设置地皮的参数. 有关地皮参数的具体信息，请见 [地皮参数](https://docs.superiormc.cn/plotsquared-wiki/gao-ji/di-pi-can-shu) 一节. #### 用法： * `/plot [[地皮世界名称;]X;Z] set <值...>` #### 变样：s #### 权限节点： 主要权限节点： * `plots.set` 次要权限节点： * `plots.set.<参数>` - 在输入指令时使用对应的第二个输入内容（即地皮参数）时需要. ### COPY（plots.copy） 复制脚下的地皮建筑到别的地皮的位置. #### 用法： * /plot \[\[地皮世界名称;]X;Z] copy \ #### 变样：copypaste ### MOVE（plots.move） 剪贴脚下的地皮建筑到别的地皮的位置. #### 用法： * /plot \[\[地皮世界名称;]X;Z] copy \ ### SWAP（plots.swap） 将脚下的地皮建筑和别的地皮建筑进行互换. #### 用法： * /plot \[\[地皮世界名称;]X;Z] copy \ #### 变样：switch ### BACKUP 备份你的地皮. #### 用法： * /plot \[\[地皮世界名称;]X;Z] backup \ #### 权限节点： 见 [这里](https://docs.superiormc.cn/plotsquared-wiki/bu-chong/di-pi-bei-fen). ### CLEAR 清理地皮上的建筑，不会清理地皮除生物群系外的设置. #### 用法： * /plot \[\[地皮世界名称;]X;Z] clear #### 变样：reset #### 权限节点： 主要权限节点： * `plots.clear` 次要权限节点： * `plots.admin.command.clear` - 管理员给其他玩家的地皮使用时需要. ### DELETE 彻底删除地皮. #### 用法： * /plot \[\[地皮世界名称;]X;Z] delete #### 变样：dispose，del #### 权限节点： 主要权限节点： * `plots.delete` 次要权限节点： * `plots.admin.command.delete` - 管理员给其他玩家的地皮使用时需要. ## 八、结构图类指令 ### COMPONENT（plots.component） 打开地皮参数预设 GUI. 有关该 GUI 的具体信息，请 [点击此处](https://docs.superiormc.cn/plotsquared-wiki/gao-ji/di-pi-can-shu-yu-she) 查看. ### SAVE 保存你的地皮. #### 用法： * `/plot [[地皮世界名称;]X;Z] save` #### 权限节点： 主要权限节点： * `plots.save` 次要权限节点： * `plots.admin.command.save` - 管理员给其他玩家的地皮使用时需要. ### LOAD 查看使用 `/plot save` 保存的地皮快照列表，或者加载一个地皮快照. #### 用法： * `/plot [[地皮世界名称;]X;Z] load` * `/plot [[地皮世界名称;]X;Z] load ` #### 变样：restore #### 权限节点： 主要权限节点： * `plots.load` 次要权限节点： * `plots.admin.command.load` - 管理员给其他玩家的地皮使用时需要. ### DOWNLOAD 下载你的地皮. #### 用法： * `/plot [[地皮世界名称;]X;Z] download [结构图名称 | 地皮世界名称]` #### 变样：dl #### 权限节点： 主要权限节点： * `plots.download` * `plots.download.world` - 第二个输入内容使用地皮世界名称时需要. 次要权限节点： * `plots.admin.command.download` - 管理员给其他玩家的地皮使用时需要. ### SCHEMATIC 结构图指令. #### 用法： * /plot \[\[地皮世界名称;]X;Z] schematic \ - 其中第二个输入内容中，save 为保存，saveall 为全部保存，paste 为粘贴. #### 变样：sch，schem #### 权限节点： 主要权限节点： * `plots.schematic` 次要权限节点： * `plots.admin.command.schematic.paste` - 管理员在给其他玩家的地皮粘贴结构图时需要. * `plots.admin.command.schematic.save` - 管理员在给其他玩家的地皮保存结构图时需要. * `plots.schematic.save` - 使用指令 `/plot schematic save` 时需要. * `plots.schematic.paste` - 使用指令 `/plot schematic paste` 时需要. ## 九、评价类指令 ### LIKE 给一个地皮点赞. #### 用法： * `/plot [[地皮世界名称;]X;Z] like [next | purge]` #### 权限节点： 主要权限节点： * `plots.like` 次要权限节点： * `plots.admin.command.rate` - 管理员给其他玩家使用时需要. ### DISLIKE 给一个地皮点踩. #### 用法： * `/plot [[地皮世界名称;]X;Z] dislike [next | purge]` #### 权限节点： 主要权限节点： * `plots.dislike` 次要权限节点： * `plots.admin.command.rate` - 管理员给其他玩家使用时需要. ### RATE 给一个地皮评价. #### 用法： * `/plot [[地皮世界名称;]X;Z] rate [# | next | purge]` #### 权限节点： 主要权限节点： * `plots.rate` 次要权限节点： * `plots.comment` - 使用 `/plots comment` 时需要. * `plots.admin.command.rate` - 管理员给其他玩家使用时需要. ## 十、管理类指令 ### PLUGIN（plots.use） 查看插件信息. #### 变样：version ### TEMPLATE（plots.admin） 地皮模板指令. #### 用法： 主要用法： * `/plot template [import | export] <地皮世界名称> <模板名称>` - 其中第一个输入内容的 import 为导入，export 为导出. 次要用法： * `/plot template <地皮世界名称> [模板名称]` * `/plot template export <地皮世界名称>` * `/plot template import