当 MineClawd 在你的世界中创建实体、物品、脚本或游戏机制时,资产追踪系统会自动记录。你可以在覆盖层或命令中浏览、传送、获取、修改或删除任何已追踪资产。
自动追踪内容
MineClawd 的 LLM 工具会把创建内容自动归类为五个类别:
| 类别 | 示例 |
|---|
| 实体 | 召唤的村民、自定义生物、NPC |
| 物品/方块/流体 | 动态物品(支持投掷)、自定义方块(含摩擦属性)、运行时流体(含颜色) |
| 特殊物品 | 带自定义 NBT 数据的物品、附魔工具 |
| 命令 | 注册的自定义命令、命令脚本 |
| 游戏机制 | 定时事件、玩家加入监听、区域效果 |
每条资产记录都会保存名称、摘要、创建它的脚本路径,以及分类专属元数据,例如实体 UUID/位置、内容 ID 或 NBT 数据。
在覆盖层浏览资产
打开覆盖层菜单并点击 Assets,切换到资产库存视图。
这个视图有两部分:
- 顶部的 分类标签:All、Entities、Items/Blocks/Fluids、Special Items、Commands、Game Mechanics。点击标签可过滤。
- 下方的 资产行:每行显示资产名称与摘要。点击资产可选中并显示操作栏。
资产操作
选中资产后,会出现按上下文显示的操作按钮:
| 操作 | 适用范围 | 作用 |
|---|
| Teleport | 存有 UUID 和位置的实体 | 传送到该实体最后一次记录的坐标。 |
| Give | 具有内容 ID 的物品/方块/流体,或具有特殊物品 ID 的特殊物品 | 通过命令把该物品发给你。 |
| Modify | 所有类别 | 新建一个 Session,并自动填入用于修改该资产的提示词。 |
| Delete | 所有类别 | 新建一个 Session,并自动填入用于从世界移除该资产的提示词。 |
Modify 和 Delete 会启动新的对话,不会立刻改动世界。这样 MineClawd 可以先推理依赖关系并正确清理脚本。
使用命令
你也可以不打开覆盖层,直接在聊天里管理资产。
列出全部资产
显示当前拥有者的全部追踪资产记录。
传送到资产
/mineclawd assets teleport <asset>
传送到实体的已记录位置。仅对具有有效 UUID 和维度信息的实体类资产有效。
给自己发放资产
/mineclawd assets give <asset>
把资产对应的物品或方块发给你。支持物品/方块/流体(按内容 ID)和特殊物品(按特殊物品 ID 与 NBT)。
移除资产记录
/mineclawd assets remove-record <asset>
从存储中删除资产记录。此命令不会删除世界中的实体、物品或脚本,只会删除追踪记录。
移除资产记录不会撤销创建结果。如果你希望 MineClawd 同时清理世界,请在覆盖层中使用 Delete 操作。
追踪机制的后台实现
MineClawd 在请求过程中使用三个 LLM 工具管理资产记录:
list-assets — 读取全部资产记录供上下文使用。
upsert-asset-record — 按元数据创建或更新资产记录。
remove-asset-record — 按 ID 删除资产记录。
每次请求的系统提示里都会附带资产追踪附录,因此模型知道要编目它创建的内容。你不需要额外要求 MineClawd 追踪资产,它会在系统启用时自动执行。
资产记录会按拥有者存为 JSON 文件:
mineclawd/
assets/
<owner>.json
每个文件包含 AssetRecord 对象数组,字段包括 id、category、name、summary、scriptPath 以及分类专属字段(entityUuid、entityDimension、entityX/Y/Z、contentId、specialItemId、specialItemNbt、command)。
相关页面