Bot
最好用的地毯模组假人管理器！
依赖
使用方法
!!bot 查看帮助
!!bot list [--index <index>] [filters] 显示假人列表
!!bot spawn <name> 上线假人
!!bot kill <name> 下线假人
!!bot action <name> [index] 执行假人动作
!!bot tags 查看可用标签
!!bot tags <tag> spawn/kill 上线/下线带有标签的假人
!!bot info <name> 查看假人信息
!!bot save <name> [position] [facing] [dimension] 保存假人
!!bot del <name> 删除保存的假人
!!bot config <name> <option> <value> 配置假人
工作流
sequenceDiagram
participant Player/Console
participant Online Bots
participant Saved Bots
Player/Console-->>Online Bots: !!bot spawn (player)
Saved Bots-->>Online Bots: !!bot spawn
Online Bots-->>Online Bots: !!bot kill
Online Bots-->>Saved Bots: !!bot save
Player/Console-->>Saved Bots: !!bot save [location]
Saved Bots-->>Saved Bots: !!bot del
list
--index <index>：页码，例如 --index 1，默认为 0
--online：显示在线假人
--saved：显示保存的假人
--tag <tag>：按标签过滤
spawn
上线假人
flowchart TD
start([spawn])
is_saved{Saved?}
is_player{Running by Player?}
start --> is_saved
is_saved -->|Yes| spawn1(Spawn at Saved Location)
is_saved -->|No| is_player
is_player -->|Yes| spawn2(Spawn at player's Location)
is_player -->|No| error1([Not Saved Error])
kill
下线假人
action
执行假人动作
当指定 index 时，执行特定动作而不是全部动作
tags
查看可用标签和上线/下线带有标签的假人
!!bot tags 查看可用标签
!!bot tags <tag> spawn 上线带有标签的假人
!!bot tags <tag> kill 下线带有标签的假人
info
查看假人信息
save
保存假人
flowchart TD
start([save])
with_location{Has Location?}
online{Online or Saved?}
is_player{Running by Player?}
start --> with_location
with_location -->|Yes| save3(Save at Input Location)
with_location -->|No| online
online -->|Yes| save1(Save at Bot's Location)
online -->|No| is_player
is_player -->|Yes| save2(Save at player's location)
is_player -->|No| error1([Bot Not Exists])
del
删除保存的假人
config
配置假人
完整指令树
flowchart LR
start(!!bot)
start --> list(list)
list --> list_index["--index <index>"]
list --> list_online[--online]
list --> list_saved[--saved]
list --> list_tag["--tag <tag>"]
start --> spawn(spawn)
spawn --> spawn_name("<name>")
start --> kill(kill)
kill --> kill_name("<name>")
start --> action(action)
action --> action_name("<name>")
action_name --> action_name_index["<index>"]
start --> tags(tags)
tags --> tags_tag["<tag>"]
tags_tag --> tags_tag_spawn(spawn)
tags_tag --> tags_tag_kill(kill)
start --> info(info)
info --> info_name("<name>")
start --> save(save)
save --> save_name("<name>")
save_name --> save_name_position["<position>"]
save_name_position --> save_name_position_facing["<facing>"]
save_name_position_facing --> save_name_position_facing_dimension["<dimension>"]
start --> del(del)
del --> del_name("<name>")
start --> config(config)
config --> config_name("<name>")
config_name --> config_name_name("name <newName>")
config_name --> config_name_position("position <position>")
config_name --> config_name_facing("facing <facing>")
config_name --> config_name_dimension("dimension <dimension>")
config_name --> config_name_comment("comment <comment>")
config_name --> config_name_actions(actions)
config_name --> config_name_tags(tags)
config_name --> config_name_autoLogin("autoLogin <autoLogin>")
config_name --> config_name_autoRunActions("autoRunActions <autoRunActions>")
config_name --> config_name_autoUpdate("autoUpdate <autoUpdate>")
config_name_actions --> config_name_actions_append("append <action>")
config_name_actions --> config_name_actions_insert("insert <index> <action>")
config_name_actions --> config_name_actions_delete("delete <index>")
config_name_actions --> config_name_actions_edit("edit <index> <action>")
config_name_actions --> config_name_actions_clear(clear)
config_name_tags --> config_name_tags_append["append <tag>"]
config_name_tags --> config_name_tags_insert["insert <index> <tag>"]
config_name_tags --> config_name_tags_delete["delete <index>"]
config_name_tags --> config_name_tags_edit["edit <index> <tag>"]
config_name_tags --> config_name_tags_clear[clear]
配置
gamemode
默认值: survival
生成假人的游戏模式
force_gamemode
默认值: false
是否强制所有假人使用 gamemode 配置的游戏模式，如果为 false，只有已保存的假人会使用 gamemode 配置的游戏模式。
name_prefix
默认值: bot_
假人名称前缀
name_suffix
默认值: 无
假人名称后缀
permissions
使用对应指令的最低权限
FastAPI MCDR
该插件支持 FastAPI MCDR 插件（>=2.0.0），当安转 FastAPI MCDR 插件后，该插件会自动注册端点，您可以通过 FastAPI 查看接口定义。
Python 包要求：
pydantic>=2.0
您可以利用该功能实现外部控制，例如一个管理假人的网页：