Bot

English

最好用的地毯模组假人管理器！

依赖

使用方法

!!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 时，执行特定动作而不是全部动作

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

删除保存的假人

删除后会备份假人到数据目录中的 botBin.json 文件。如果发生误删，可以用于手动恢复。

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&gt") 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&gt"] config_name_tags --> config_name_tags_edit["edit <index> <tag>"] config_name_tags --> config_name_tags_clear[clear]

flowchart LR
    start(!!bot)

    start --> list(list)
    list --> list_index["--index &lt;index&gt;"]
    list --> list_online[--online]
    list --> list_saved[--saved]
    list --> list_tag["--tag &lt;tag&gt;"]

    start --> spawn(spawn)
    spawn --> spawn_name("&lt;name&gt;")

    start --> kill(kill)
    kill --> kill_name("&lt;name&gt;")

    start --> action(action)
    action --> action_name("&lt;name&gt;")
    action_name --> action_name_index["&lt;index&gt;"]

    start --> tags(tags)
    tags --> tags_tag["&lt;tag&gt;"]
    tags_tag --> tags_tag_spawn(spawn)
    tags_tag --> tags_tag_kill(kill)

    start --> info(info)
    info --> info_name("&lt;name&gt;")

    start --> save(save)
    save --> save_name("&lt;name&gt;")
    save_name --> save_name_position["&lt;position&gt;"]
    save_name_position --> save_name_position_facing["&lt;facing&gt;"]
    save_name_position_facing --> save_name_position_facing_dimension["&lt;dimension&gt;"]

    start --> del(del)
    del --> del_name("&lt;name&gt;")

    start --> config(config)
    config --> config_name("&lt;name&gt;")
    config_name --> config_name_name("name &lt;newName&gt;")
    config_name --> config_name_position("position &lt;position&gt;")
    config_name --> config_name_facing("facing &lt;facing&gt;")
    config_name --> config_name_dimension("dimension &lt;dimension&gt;")
    config_name --> config_name_comment("comment &lt;comment&gt;")
    config_name --> config_name_actions(actions)
    config_name --> config_name_tags(tags)
    config_name --> config_name_autoLogin("autoLogin &lt;autoLogin&gt;")
    config_name --> config_name_autoRunActions("autoRunActions &lt;autoRunActions&gt;")
    config_name --> config_name_autoUpdate("autoUpdate &lt;autoUpdate&gt;")

    config_name_actions --> config_name_actions_append("append &lt;action&gt;")
    config_name_actions --> config_name_actions_insert("insert &lt;index&gt; &lt;action&gt;")
    config_name_actions --> config_name_actions_delete("delete &lt;index&gt")
    config_name_actions --> config_name_actions_edit("edit &lt;index&gt; &lt;action&gt;")
    config_name_actions --> config_name_actions_clear(clear)

    config_name_tags --> config_name_tags_append["append &lt;tag&gt;"]
    config_name_tags --> config_name_tags_insert["insert &lt;index&gt; &lt;tag&gt;"]
    config_name_tags --> config_name_tags_delete["delete &lt;index&gt"]
    config_name_tags --> config_name_tags_edit["edit &lt;index&gt; &lt;tag&gt;"]
    config_name_tags --> config_name_tags_clear[clear]

配置

gamemode

默认值: survival

生成假人的游戏模式

force_gamemode

默认值: false

是否强制所有假人使用 gamemode 配置的游戏模式，如果为 false，只有已保存的假人会使用 gamemode 配置的游戏模式。

name_prefix

默认值: bot_

假人名称前缀

name_suffix

默认值: 无

假人名称后缀

post_join_delay

默认值: 0

假人上线后延迟处理的时间（秒），如果您使用非原版服务端，可能需要调整该值。

permissions

使用对应指令的最低权限

FastAPI MCDR

该插件支持 FastAPI MCDR 插件（>=2.0.0），当安装 FastAPI MCDR 插件后，该插件会自动注册端点，您可以通过 FastAPI 查看接口定义。

Python 包要求：

pydantic>=2.0

您可以利用该功能实现外部控制，例如一个管理假人的网页：

管理假人的网页