Understudy 是 Canopy 的一个附属，它允许生成和控制模拟玩家。模拟玩家是可以通过命令控制的实体，但在其他方面几乎完全像普通玩家一样行动。（类似 Carpet 中的 Fake Player）
使用
所有命令都以 ./ 为前缀。./player 命令可以缩写为 ./p。在使用 commandPlayer 规则启用之前，./player 命令默认处于禁用状态。输入 ./help 获取更多信息。
创建玩家
1 | ./player <名字> join |
移除玩家
1 | ./player <名字> leave |
重新加入玩家
1 | ./player <名字> rejoin |
传送玩家
1 | ./player <名字> tp |
重生玩家
1 | ./player <名字> respawn |
控制玩家视角
1 | ./player <名字> look [up/down/north/south/east/west/block/entity/me/x y z/pitch yaw] |
- up、down、north、south、east、west：分别表示向上、向下和朝向不同的方向。
- block 和 entity：让玩家看向你正在观察的方块或实体。
- me：让玩家看向你。
- x y z：让玩家看向指定坐标。
- pitch yaw：让玩家以指定的俯仰角和偏航角（以度为单位）调整视角。
1 | ./player <名字> move [forward/backward/left/right/block/entity/me/x y z] |
- forward、backward、left、right：分别表示前进、后退、左移、右移（相对当前面朝方向）。
- block 和 entity：让玩家移动到你正在观察的方块或实体。
- me：让玩家移动到你的位置。
- x y z：让玩家导航到指定坐标（基于 Minecraft 的寻路系统，导航距离有限）。
1 | ./player <名字> attack [once/continuous/interval] [间隔时间] |
- once（默认）：攻击一次。
- continuous：持续攻击。
- interval：按照指定时间间隔进行攻击。
1 | ./player <名字> interact [once/continuous/interval] [间隔时间] |
- once（默认）：互动一次。
- continuous：持续互动。
- interval：按照指定时间间隔进行互动。
1 | ./player <名字> use [once/continuous/interval] [间隔时间] |
- once（默认）：使用一次。
- continuous：持续使用。
- interval：按照指定时间间隔使用物品。
1 | ./player <名字> build [once/continuous/interval] [间隔时间] |
- once（默认）：放置一次。
- continuous：持续放置。
- interval：按照指定时间间隔放置。
1 | ./player <名字> break [once/continuous/interval] [间隔时间] |
- once（默认）：破坏一次。
- continuous：持续破坏。
- interval：按照指定时间间隔破坏。
1 | ./player <名字> drop [once/continuous/interval] [间隔时间] |
- once（默认）：丢弃一次。
- continuous：持续丢弃。
- interval：按照指定时间间隔丢弃物品。
1 | ./player <名字> dropstack [once/continuous/interval] [间隔时间] |
- once（默认）：丢弃一次。
- continuous：持续丢弃。
- interval：按照指定时间间隔丢弃。
1 | ./player <名字> dropall [once/continuous/interval] [间隔时间] |
- once（默认）：丢弃一次。
- continuous：持续丢弃。
- interval：按照指定时间间隔丢弃。
1 | ./player <名字> jump [once/continuous/interval] [间隔时间] |
- once（默认）：跳跃一次。
- continuous：持续跳跃。
- interval：按照指定时间间隔跳跃。
1 | ./player <名字> select <槽位编号> |
玩家奔跑与停止奔跑
1 | ./player <名字> sprint |
1 | ./player <名字> unsprint |
玩家潜行与停止潜行
1 | ./player <名字> sneak |
1 | ./player <名字> unsneak |
玩家拾取弹射物
1 | ./player <名字> claimprojectiles [范围] |
停止玩家所有动作
1 | ./player <名字> stop |
设置玩家前缀
1 | ./player prefix <前缀/#none> |
脚本事件
所有命令也可以通过原版命令 /scriptevent 执行（可用于命令方块）。
用法：
1 | /scriptevent understudy:<命令> |
1 | /scriptevent understudy:player <名字> join |
