🧑‍🌾
MG Minecraft

用户7419

用户4723

用户9241

用户988

2024年7月25日修改

背景介绍

1.
技术设计​

1.1
术语及定义​

术语	定义
玩家/Player	Minecraft游戏中的玩家，可在Minecraft中进行资源采集，地图探索、房屋搭建以及执行和产生自定义任务
任务/Task	指Minecraft玩家在游戏中具体完成的事项，如工具制作、资源采集等具体事项。
事件/Event	指Minecraft中游戏环境的信息，包括玩家的库存信息、位置信息、游戏时间等信息，通过游戏引擎的接口获取后转为结构化数据，参考1.2.2.2.2 Events 示例
技能/Skills	Minecraft玩家完成任务所需的执行代码
问题对/QA context	指在MetaGPT运行中通过LLM生成的问题-答案对
轮次/Round	在MetaGPT中控制一次全部agent完成发布任务-执行任务-学习任务的过程称为一个轮次

1.2
整体设计​

1.2.1
整体设计图​

画板

1.2.2
MetaGPT-MineCraft 智能体整体设计​

画板

1.2.2.1
游戏引擎与MetaGPT控制端交互​

1.2.2.2
GameEnvironment设计​

GameEnvironment是独立于agents通信环境的一个游戏环境的对象，主要是用于和真实的游戏引擎或者游戏引擎的控制端（Minecraft/Mineflayer）交互，以及将真实游戏环境中获取的结果进行解析和缓存，便于MetaGPT中的agents进行游戏环境中相关变量的数据获取和游戏控制需求的处理（如游戏任务执行的写入）​

1.2.2.2.1
GameEnvironment和游戏引擎交互​

1.
获取事件：on_event_retrieve() 将Minecraft游戏中的玩家观察结果及时在 GameEnvironment 中更新， 将事件中的部分信息（"observe"字段为主），提取作为 LLM 输入的关键组成部分。​

2.
更新代码执行：on_event_execute()​
从 ActionDeveloper 生成的异步执行代码经过规范化后，与作为引用使用的基础库和技能库代码组合，发送给mf_instance ，在physicsTick监听时执行，实现Minecraft游戏玩家的复杂行为控制。​

3.
设置游戏恢复：set_mc_resume​
游戏恢复具体操作：需要在key.yaml(优于config.yaml）文件下将RESUME字段修改为true。游戏恢复操作类似于游戏存档操作，恢复后MetaGPT的智能体将加载已积累的历史经验、已完成的任务、最后的游戏状态等信息，用于从前一状态进行后续流程/任务学习。​

1.2.2.2.2
Events 示例​

代码块

    events = [​
        [​
            "...", {​
                ...​
            },​
            "observe",​
            {​
                "voxels": ["grass_block", "dirt", "grass"],​
                "status": {​
                    "health": 20,​
                    "food": 20,​
                    "saturation": 5,​
                    "oxygen": 20,​
                    "position": {"x": 0.5, "y": 84, "z": -207.5},​
                    "velocity": {"x": 0, "y": -0.0784000015258789, "z": 0},​
                    "yaw": 3.141592653589793,​
                    "pitch": 0,​
                    "onGround": True,​
                    "equipment": [None, None, None, None, None, None],​
                    "name": "bot",​
                    "isInWater": False,​
                    "isInLava": False,​
                    "isCollidedHorizontally": False,​
                    "isCollidedVertically": True,​
                    "biome": "plains",​
                    "entities": {​
                        "chicken": 29.071822119730644,​
                        "sheep": 20.361212992763768,​
                    },​
                    "timeOfDay": "day",​
                    "inventoryUsed": 0,​
                    "elapsedTime": 41,​
                },​
                "inventory": {},​
                "nearbyChests": {"(1344, 64, 1381)": "Unknown"},​
                "blockRecords": ["grass_block", "dirt", "grass"],​
            },​
        ]​
    ]​