Workling: Agents
仅客户端的 Workling 附属模组,让 AI 智能体能以较少的 token 游玩多人 Minecraft:通过本地桥接传递精简 JSON 状态和简单指令。
截图
介绍
Workling: Agents 是 客户端专用的 Workling附属模组,可让 AI 智能体(LLM)以尽可能少的 token 游玩 Minecraft 多人游戏。模组会通过本地 HTTP 桥接接口,以精简 JSON 暴露游戏状态,并使用简单指令:智能体读取发生变化的内容、做出判断,然后发送一条简短命令。行走、跟随、进食、睡觉和躲避危险都由模组内部处理,因此只有发生重要事件时才需要唤醒智能体。
主要特性
- 仅限客户端:不添加方块、物品、实体或网络数据包。可以加入未安装该模组的服务器。
- 本地桥接接口:仅监听
127.0.0.1(默认端口25590),拒绝浏览器请求(Origin)和非本地Host;命令仅通过POST发送。 - 节省 token 的读取方式:
/state使用since只返回发生变化的内容;/events会长轮询并等待事件发生(imp=1仅用于重要事件,only=chat,die,hp,food用于筛选)。 - 精简的世界视图:显示附近生物和玩家的相对位置与方向、周围地形的俯视字符地图,以及带有提及信息的聊天记录。
- 自带寻路:可走到指定位置或跟随玩家、跳过 1 格宽的间隙、长距离移动时疾跑,并打开木门(不会破坏木门)。
- 箱子:可在智能体的箱子(箱子旁墙上挂着写有名称的告示牌)、按名称记住的箱子,或指定坐标的箱子中存取物品;可读取箱内物品,每条回复都会显示实际移动的数量。
- Workling 傀儡箱子:列出 Workling 傀儡箱子,并且只使用其 Chest标签页(傀儡存放物品的地方),不会动用傀儡自身的物品或工具。
- 合成:
/craft使用配方书(仅限已解锁的配方),可在 2×2 背包合成网格或最近的工作台合成。 - 砍树:
/chop使用背包里最好的斧头,按原版方式砍伐整棵天然树。分类器可以区分树木和建筑:与木板、玻璃、门、持久树叶及其他建筑方块相连的原木不会被砍。智能体唯一会破坏的方块就是树木原木。 - 宏:保存一系列步骤(goto、follow、take、deposit、shelter、chop、say、wait…),并可按名称运行。
- Token 计数器:
/stats统计各路由的请求数和字节数,并估算 token 数量(字节数 / 4)。
内置行为
这些行为在模组内部运行,不消耗 token:
- 聊天:只有优先列表中的玩家会触发事件;其他人的消息仍会保留在聊天记录中。
- 危险:视野内出现敌对生物时会停止行动;危险解除 3 秒后继续行走/跟随。
- 食物与生命值:饥饿时自动进食。没有食物时,会从自己的箱子中取面包,或从名为
food的箱子里取小麦,在最近的工作台合成面包后进食,并把剩余物品存起来。如果无法解决,就会在聊天中求助。生命值较低且附近有敌对生物时,会逃往避难所或远离敌对生物。 - 睡觉:其他玩家睡觉时,会前往附近空闲的床(或者放下随身携带的床);在基地内则睡基地的床。
- 表情动作与闲置:优先列表中的玩家潜行时会跟着潜行;也会做一些闲置动作(看向玩家、四处张望、潜行、跳跃),闲置一段时间后触发闲置事件。
- 记忆:按维度保存基地、床、避难所和命名箱子的位置。
命令
读取命令(GET):/state、/events、/mobs、/players、/terrain、/chat、/chests、/chest、/stats。
命令(POST):/goto、/follow、/look、/jump、/attack、/use、/eat、/slot、/stop、/say、/crouch、/hop、/prio、/deposit、/take、/shelter、/base、/bed、/chest、/craft、/chop、/macro。
需求
- Minecraft 26.3、NeoForge 26.3.0.77+
- Workling 0.2.24+(必需)
- 仅安装在客户端上
- 语言:英语和巴西葡萄牙语
- 只能在
config/workling_agents-client.toml或模组配置界面中设置**Workling 的附属模组,可让 AI 智能体(LLM)以尽可能少的 token 游玩多人 Minecraft。模组通过本地 HTTP 桥接,以精简的 JSON 格式提供游戏状态,并遵循简单的命令流程:智能体读取变化、做出判断,然后发送一条简短指令。行走、跟随、进食、睡觉和逃离危险都由模组内部处理,因此只有发生重要事件时,智能体才会被唤醒。
亮点
- 仅限客户端:不会添加方块、物品、实体或网络载荷。可以加入未安装此模组的服务器。
- 本地桥接:仅监听
127.0.0.1(默认端口25590),拒绝浏览器请求(Origin)和非本地Host;命令仅通过POST发送。 - 节省 token 的读取:
/state使用since时只返回发生变化的内容;/events是长轮询,会等待事件发生后才返回(imp=1仅包含重要事件,使用only=chat,die,hp,food进行筛选)。 - 精简的世界视图:显示附近生物和玩家的相对位置与方向、周边地形的俯视角色地图,以及包含提及内容的聊天记录。
- 自主寻路:可前往指定位置或跟随玩家,跨越 1 格间隙,在长距离路径上疾跑,并打开木门(绝不破坏木门)。
- 箱子:可向智能体的箱子(带有标注其名称的墙上告示牌的箱子)、按名称记忆的箱子或指定位置的箱子存入或取出物品;可读取箱子内容;每次回复都会报告实际移动的物品数量。
- Workling 傀儡箱子:列出 Workling 傀儡箱子,并且只使用其 Chest 标签页(傀儡存放的物品),绝不使用傀儡自己的物品或工具。
- 合成:
/craft使用配方书(仅限已解锁的配方),可在 2×2 物品栏合成网格中合成,或使用最近的工作台。 - 砍树:
/chop使用物品栏中最好的斧头,按原版方式砍倒整棵天然树。分类器会区分树木与建筑:与木板、玻璃、门、不会自然消失的树叶及其他建筑方块相邻的原木绝不会被触碰。智能体唯一会破坏的方块就是树木原木。 - 宏:保存一系列步骤(goto、follow、take、deposit、shelter、chop、say、wait……),并按名称运行。
- Token 计量器:
/stats按路由统计请求数和字节数,并估算 token 数量(字节数 / 4)。
内置例程
这些例程在模组内部运行,不消耗 token:
- 聊天:只有优先名单中的玩家会触发事件;其他人仍只会显示在聊天记录中。
- 危险:视野中出现敌对生物时会停下,危险解除 3 秒后继续行走/跟随。
- 食物与生命值:饥饿时会自动进食。没有食物时,会从箱子里拿面包;或者从名为
food的箱子里拿小麦,在最近的工作台制作面包,吃掉一些并把剩下的存起来。如果这些办法都行不通,就会在聊天中求助。生命值较低且附近有敌对生物时,会逃回避难所或远离危险。 - 睡觉:其他玩家睡觉时,会去附近的空床睡觉(或放下随身携带的床);在基地内则会睡在基地的床上。
- 表情动作与待机:优先名单中的玩家潜行时,它也会跟着蹲下;待机时会做一些小动作(看向玩家、环顾四周、蹲下、跳一下),一段时间后触发待机事件。
- 记忆:基地、床、避难所和命名箱子的位置会按维度分别保存。
命令
读取(GET):/state、/events、/mobs、/players、/terrain、/chat、/chests、/chest、/stats。
命令(POST):/goto、/follow、/look、/jump、/attack、/use、/eat、/slot、/stop、/say、/crouch、/hop、/prio、/deposit、/take、/shelter、/base、/bed、/chest、/craft、/chop、/macro。
需求
- Minecraft 26.3、NeoForge 26.3.0.77+
- 、Workling 0.2.24+(必需)
- 仅需安装在客户端
- 语言:英语和巴西葡萄牙语
- 可在
config/workling_agents-client.toml或模组配置界面中设置
常见问题
Workling: Agents 支持哪些 Minecraft 版本?
Workling: Agents 支持 Minecraft Java 版 26.3,可用的加载器:NeoForge。下载时注意选择和你游戏版本一致的文件。
Workling: Agents 怎么安装?
先用 PCL2 或 HMCL 启动器安装对应版本的 NeoForge,再把下载的 .jar 文件放进游戏目录的 mods 文件夹,重新启动游戏即可。开启了版本隔离的,mods 文件夹在 versions/版本名 下面。
评论
登录后评论和评分