Minecraft Guide

探索方块世界
从入门到精通

《我的世界》是一款开放世界沙盒游戏。采集资源、合成工具、建造家园、挑战 Boss—— 这份指南将带你了解核心玩法，并提供实用生存与进阶攻略。

开始冒险 查看攻略

游戏介绍

在由方块构成的无限世界中，创造属于你的故事

🌍

开放世界

每次生成的世界都是独一无二的。平原、沙漠、雪原、丛林、深暗之域……生物群系丰富多样，等待你探索。

⛏️

采集与合成

用手破坏方块获取资源，在工作台中合成工具、武器与建筑材料。从木镐到下界合金装备，逐步升级你的能力。

🏠

自由创造

建造从小屋到城堡、从自动农场到红石计算机，几乎没有限制。单人沉浸或多人联机，玩法由你定义。

游戏模式

四种模式，满足不同玩家的需求

生存模式 Survival

最核心的玩法。你需要管理生命值与饥饿值，采集资源、合成物品、躲避或战斗怪物。死亡会掉落物品（除非设置了 keepInventory）。

  • 有限资源，需要规划与探索
  • 昼夜交替，夜晚怪物出没
  • 可挑战下界与末影龙
  • 支持成就/进度系统

创造模式 Creative

拥有无限资源，可飞行，不会受到伤害。适合建筑创作、红石实验和地图设计，无需担心生存压力。

  • 物品栏中所有方块与物品无限
  • 双击空格键飞行
  • 瞬间破坏方块
  • 无法获得成就

冒险模式 Adventure

专为自定义地图设计。玩家不能随意破坏方块，只能使用特定工具破坏特定方块，适合剧情类地图与解谜地图。

  • 方块破坏受 NBT 标签限制
  • 可与命令方块配合使用
  • 常用于服务器小游戏

旁观模式 Spectator

以幽灵形态观察世界，可穿墙飞行，无法与方块或实体交互。常用于观战或地图调试。

  • 可穿墙自由移动
  • 点击实体可附身观察
  • 无法影响游戏世界

新手入门

第一天的生存步骤，按顺序完成即可安全过夜

1

收集木头

找到树木，用手或快速破坏树叶与原木。至少收集 6~10 个原木，这是所有起步工具的基础。

2

制作工作台与木镐

将原木放入背包合成面板变为木板，4 木板做工作台。制作木镐后，挖 3 圆石 升级石镐。

3

搭建临时庇护所

在日落前用泥土或圆石围一个 3×3 空间，封顶并留门。放置 火把（煤炭+木棍）照明，防止怪物生成。

4

解决食物问题

击杀牛、猪、羊获得生肉；或寻找村庄拿面包。优先制作 熔炉 烤肉，熟肉回复更多饥饿值。

5

第二天：下矿找铁

携带火把、石镐、食物，在 Y=-16 到 Y=32 层寻找铁矿石。挖到 16+ 铁锭 后制作铁镐、铁剑、盾牌。

生存攻略

核心系统的实用技巧与注意事项

挖矿

矿物分布与挖矿技巧

矿物推荐层级 (Y)工具
煤矿0 ~ 256木镐+
铁矿-64 ~ 72（低处）/ 112 ~ 256（高处）石镐+
金矿-64 ~ 32铁镐+
钻石-64 ~ -4铁镐+
远古残骸8 ~ 22 (下界)钻石镐+

💡 推荐采用分支挖矿法：主隧道每 2 格开一条 1×2 支道，效率高且安全。携带水桶防岩浆，听到怪声立即后退。

战斗

常见怪物应对

  • 僵尸：普通近战，注意小僵尸速度快。用盾牌格挡后反击。
  • 骷髅：远程攻击，之字形靠近或使用盾牌。白天可在阴影下攻击。
  • 苦力怕：靠近会嘶嘶作响并爆炸。听到声音后立即后退 4 格以上，或用水流阻挡。
  • 末影人：不要直视眼睛。戴南瓜头可安全观察，或站在 2 格高空间下单挑。
  • 凋灵：后期 Boss，需准备药水与大量金苹果，击败后掉落下界之星。
附魔

附魔系统入门

使用经验等级在附魔台为装备附加特殊能力。附魔台需要周围放置书架（最多 15 个，间隔 1 格）来提升等级上限。

  • 保护 IV：通用防御附魔，优先给胸甲
  • 效率 V：加速挖掘，给镐子
  • 锋利 V：增加近战伤害
  • 时运 III：增加矿物掉落（钻石矿必附）
  • 经验修补：消耗经验修复耐久，后期神器

💡 村民交易是获取特定附魔书的捷径，搭建村民繁殖与交易大厅可大幅节省时间。

农业

食物与农场

用锄头耕地，附近要有水源，种植小麦、胡萝卜、马铃薯。骨粉可加速生长。

  • 动物繁殖：用对应食物（小麦/胡萝卜/种子）让动物进入爱心状态
  • 自动农场：利用活塞、观察者、漏斗实现自动收割
  • 村民农场：农民村民可自动种植与收获作物
  • 下界疣：在下界用灵魂沙种植，用于酿造药水
村民

村民与交易系统

村民是生存模式获取稀有物资的最佳途径。每个村民有职业（由工作站方块决定）和交易等级（绿宝石→学徒→熟练→专家→大师，共 5 级）。

  • 常见职业：图书管理员（附魔书、书架）、盔甲匠（钻石装备）、武器匠（钻石剑/附魔）、牧师（红石粉、末影珍珠）
  • 繁殖：两个村民 + 足够食物（面包/胡萝卜/马铃薯）+ 床上方有 3 格空气 → 产生小村民
  • 折扣：治愈僵尸村民获得永久折扣；击败袭击获得村庄英雄效果
  • 交易大厅：搭建村民集中管理区，每个村民锁定有用交易后不要再升级，防止解锁高价交易

💡 推荐优先找图书管理员刷经验修补附魔书，这是生存模式最强附魔之一。

酿造

酿造药水指南

酿造台制作各种效果药水。基本流程：玻璃瓶装水 → 加入下界疣制成粗制的药水（基础）→ 加入效果材料 → 可选加入红石粉/萤石粉延长或强化。

药水材料用途
力量药水烈焰粉增加近战伤害 3 点（8:00）
迅捷药水糖提升移动速度（8:00）
再生药水恶魂之泪持续恢复生命（0:45）
防火药水岩浆膏免疫火焰与熔岩伤害（8:00）
夜视药水金胡萝卜水下/黑暗全亮视野（8:00）
水肺药水河豚增加水下呼吸时间（8:00）
隐身药水发酵蛛眼完全隐形（8:00）
缓降药水幻翼膜缓慢下落，免疫摔落伤害（4:00）

加入红石粉延长持续时间，萤石粉增强效果等级（部分药水）。火药制成喷溅药水可投掷，龙息制成滞留药水留下效果区域。

铁砧

铁砧机制与附魔合并

铁砧用于修复装备、合并附魔和重命名。使用需要消耗经验等级，操作次数越多消耗越大。

  • 修复：两件相同装备合成，耐久相加 + 5%，保留较高附魔
  • 附魔合并：将附魔书的附魔转移到装备上，或合并两件装备的不同附魔
  • 冲突规则：保护/火焰保护/爆炸保护/弹射物保护互斥；锋利/亡灵杀手/节肢杀手互斥；时运/精准采集互斥
  • 重命名：仅花费 1 级经验，不增加后续操作惩罚
  • 节约策略：优先用附魔台获得基础附魔，再用铁砧补关键附魔；同名书先合并再附到装备上

💡 每次铁砧操作会产生累积惩罚（先前工作次数越多消耗越大），规划好附魔顺序可以节省大量经验。

经验农场

经验农场与刷怪塔基础

刷怪塔利用游戏刷怪机制收集经验与掉落物。核心原理：黑暗环境 + 玩家距离 24~128 格以内。

  • 简单刷怪塔：搭建多层黑暗平台，水流将怪物集中到击杀室，适合早期获取经验
  • 刷怪笼改造：地下的刷怪笼（僵尸/骷髅/蜘蛛）可改造成简易经验农场：周围铺满火把后用 8 格水流集中，玩家近距离击杀
  • 经验 vs 物品：玩家击杀获得 100% 经验；摔死/岩浆/火焰死亡仅掉落物品
  • 末影人农场：末地建造，效率最高的经验农场之一，大量掉落末影珍珠
  • 猪灵金农场：下界建造，利用僵尸猪灵互相仇恨机制，获取金粒与经验

💡 建议先找到地下的刷怪笼做第一个简易经验农场，再投资建造大型刷怪塔。

合成指南

按游戏阶段整理的核心配方与基础材料，覆盖生存到通关的关键合成

基础材料

木板

1 原木 → 4 木板（合成栏任意格）

木棍

2 木板（竖排）→ 4 木棍

圆石

挖掘石头掉落（需木镐以上，非合成）

煤炭

挖掘煤矿石掉落（或用木炭代替，作火把/燃料）

线

击杀蜘蛛或破坏蜘蛛网获得（非合成）

羊毛

4 线 → 1 白色羊毛（或剪羊获取）

皮革

击杀牛、马、驴、骡等掉落（非合成，用于造书）

→

木炭

熔炉：1 原木 + 燃料 → 1 木炭（早期火把燃料）

→

铁锭

熔炉：1 铁矿石 + 燃料 → 1 铁锭

→

金锭

熔炉：1 金矿石 + 燃料 → 1 金锭

→

玻璃

熔炉：1 沙子 + 燃料 → 1 玻璃

骨粉

1 骨头 → 3 骨粉（加速作物生长）

烈焰粉

1 烈焰棒 → 2 烈焰粉

→

下界合金碎片

熔炉：1 远古残骸 + 燃料 → 1 下界合金碎片

铁块

9 铁锭（3×3）→ 1 铁块

火药

击杀苦力怕/恶魂掉落（非合成，TNT 原料）

红石粉

挖掘红石矿掉落（需铁镐以上，非合成）

苹果

破坏橡树树叶概率掉落（非合成，金苹果原料）

基础工具

木镐

3 木板 + 2 木棍

石镐

3 圆石 + 2 木棍

铁镐

3 铁锭 + 2 木棍

火把

1 煤炭 + 1 木棍 → 4 火把

铁锄

2 铁锭 + 2 木棍（耕地、加速作物采集）

木锹

1 木板 + 2 木棍（快速挖土、沙、沙砾）

石锹

1 圆石 + 2 木棍

铁锹

1 铁锭 + 2 木棍

生存必备

工作台

4 木板 → 1 工作台

熔炉

8 圆石 → 1 熔炉

箱子

8 木板 → 1 箱子

床

3 羊毛 + 3 木板（设置重生点）

桶

3 铁锭 → 1 桶（可装水/熔岩）

栓绳

4 线 + 1 黏液球 → 2 栓绳（拴被动生物，或系在栅栏上；1.21.6 起改为 5 线，布局不变）

木船

5 同种木板（U 形）→ 1 木船（水面快速移动）

+

运输木船

两步合成：① 5 同种木板（U 形）→ 木船 → ② 1 木船 + 1 箱子（无序合成，任意摆放）→ 1 运输木船（1.19 起，27 格储物）

纸

3 甘蔗（横排）→ 3 纸

战斗与防御

铁剑

2 铁锭 + 1 木棍

盾牌

6 木板 + 1 铁锭

弓

3 木棍 + 3 线

箭

1 燧石 + 1 木棍 + 1 羽毛 → 4 箭

铁胸甲

8 铁锭

铁头盔

5 铁锭

铁护腿

7 铁锭

铁靴子

4 铁锭

钻石剑

2 钻石 + 1 木棍

钻石胸甲

8 钻石

钻石头盔

5 钻石

钻石护腿

7 钻石

钻石靴子

4 钻石

进阶装备

书

3 纸 + 1 皮革（无序合成）

钻石镐

3 钻石 + 2 木棍（可挖黑曜石）

附魔台

4 黑曜石 + 2 钻石 + 1 书

书架

6 木板 + 3 书（提升附魔等级）

酿造台

1 烈焰棒 + 3 圆石

铁砧

3 铁块 + 4 铁锭（修复/合并/命名装备）

信标

1 下界之星 + 3 黑曜石 + 5 玻璃（提供区域增益效果）

潮涌核心

8 鹦鹉螺壳 + 1 海洋之心（水下呼吸/速掘/照明）

下界与末地

+

打火石

1 燧石 + 1 铁锭（无序合成，激活下界门）

+

末影之眼

1 末影珍珠 + 1 烈焰粉（无序合成）

+

下界合金锭

4 金锭 + 4 下界合金碎片（无序合成）

锻造台

2 铁锭 + 4 木板（升级下界合金装备）

+

下界合金升级

锻造台：钻石装备 + 1 下界合金锭 → 下界合金装备

金胸甲

8 金锭（下界防猪灵，全套金盔甲效果更佳）

金头盔

5 金锭

金护腿

7 金锭

金靴子

4 金锭

潜影盒

1 箱子 + 2 潜影壳（末地城战利品，可携带的存储箱）

TNT

5 火药 + 4 沙子（下界炸远古残骸常用）

传送门

+

黑曜石

水与熔岩源方块接触生成（需钻石镐采集）

下界传送门

最少 10 黑曜石搭 4×5 框（角可空），内部 2×3 开口；打火石点燃

末地传送门

要塞中找到 5×5 框架，向 12 个槽位放入末影之眼激活（末影之眼可指引方向）

红石与自动化

漏斗

5 铁锭 + 1 箱子（物品收集与传输）

红石火把

1 红石粉 + 1 木棍（基础红石信号源）

红石中继器

3 石头 + 2 红石火把 + 1 红石粉（延长/延迟信号）

活塞

3 木板 + 4 圆石 + 1 铁锭 + 1 红石粉

食物与酿造

面包

3 小麦（横排）→ 1 面包

金苹果

8 金锭 + 1 苹果（打龙/危急时回血）

玻璃瓶

3 玻璃 → 3 玻璃瓶（酿造必备）

交通运输

矿车

5 铁锭（U 形）→ 1 矿车

铁轨

6 铁锭 + 1 木棍 → 16 铁轨

建设工具

梯子

6 木棍（两列）→ 3 梯子

木门

6 木板（两列）→ 3 木门

剪刀

2 铁锭（斜排）→ 1 剪刀（剪羊毛/叶子）

建造技巧

让建筑更美观、更实用的设计原则

🎨 材质搭配

避免单一材质。组合使用不同木材、石头、陶瓦与混凝土，增加层次感。参考真实建筑的比例，窗户不要过大。

💡 照明与细节

使用灯笼、火把、海晶灯、发光浆果等不同光源。添加楼梯、台阶、活板门、花盆等装饰方块打破大平面的单调感。

🏔️ 地形融合

建筑应顺应地形而非强行平整。在 hillside 采用分层结构，在水边加入码头与栈桥，让作品"长"在环境里。

📐 功能分区

生存基地建议分区：存储区（大量箱子+分类）、农牧区、挖矿入口、附魔室、下界传送门。用铁路或冰道连接各区域。

进阶内容

下界、末地、红石、探索结构与功能性方块

🔥

下界攻略

  1. 用 10+ 黑曜石搭建传送门（4×5 框架），打火石激活
  2. 穿戴金盔甲防止猪灵攻击（不要挖他们的金块）
  3. 寻找下界要塞获取烈焰棒，用于酿造与末地之眼
  4. 在 Y=8~22 用 TNT 或床爆破法寻找远古残骸
  5. 远古残骸熔炼为下界合金碎片，4 金锭 + 4 下界合金碎片 → 下界合金锭，用于升级钻石装备
  6. 下界交通枢纽：主世界 1 格 ≈ 下界 8 格，搭建下界冰道/铁路可大幅缩短地表旅行距离。在 Y=120+ 或 Y=8 以下开凿主干道，每 128 格预留标记与传送门
🐉

末地 · 击败末影龙

  1. 收集 12 个末影之眼，找到要塞并激活传送门
  2. 准备：钻石/下界合金装备、弓箭、大量箭、金苹果、缓降药水
  3. 先摧毁所有末地水晶（塔顶），防止龙回血
  4. 用弓箭射击或等待龙俯冲时用剑攻击
  5. 击败后探索末地城，获取鞘翅与潜影盒
⚡

红石基础

  • 红石粉：传递 15 格信号，需中继器延长
  • 比较器/中继器：延迟、比较、锁存信号
  • 活塞/观察者：自动农场与隐藏门核心
  • 漏斗：物品传输与自动分类系统
  • T _flip_flop：用按钮实现开关切换，入门必学
🗺️

主要探索结构

  • 远古城市（Y=-51 深暗之域）：避开幽匿感测体，寻找战利品房间，可获得迅捷潜行附魔与回响碎片
  • 海底神殿（深海群系）：守卫者守护，挖掘金块与海绵，需水肺药水
  • 林地府邸（黑森林）：唤魔者掉落不死图腾，灾厄旗帜，大型战利品
  • 试炼密室（1.21，地下）：试炼刷怪笼 + 宝库，获得试炼钥匙、不祥试炼钥匙、重锤
  • 下界要塞：烈焰棒（酿造）、下界疣、凋灵骷髅头颅
  • 堡垒遗迹（下界）：猪灵蛮兵守护，金块、下界合金升级锻造模板
  • 末地城：鞘翅、潜影壳、龙首
💎

信标与潮涌核心

  • 信标：1 下界之星 + 3 黑曜石 + 5 玻璃 → 信标。放置于矿物块搭建的金字塔顶部激活，提供区域增益（速度/急迫/抗性/跳跃提升/力量）。4 级金字塔（9×9→7×7→5×5→3×3，共 164 个矿物块）解锁双效果
  • 潮涌核心：8 鹦鹉螺壳 + 1 海洋之心 → 潮涌核心。在水中用海晶石框架激活，提供水下呼吸、水下速掘与夜视效果，并攻击附近敌对生物

AI 助手 · Steve

用自然语言指挥 AI 代理在 Minecraft 中挖矿、建造、战斗——「Cursor for Minecraft」

开源项目

Steve — 自主 AI 代理模组

Steve 由 Yuvraj Dwivedi 与 Pravin Lohani 开发，将大语言模型（LLM）接入 Minecraft， 让 AI 代理像真实玩家一样在世界中执行指令。你描述需求，Steve 理解上下文、制定计划并逐 tick 执行—— 不是写代码的 AI，而是在游戏里帮你干活的 AI。

GitHub 仓库 Modrinth 下载

版本对应关系

以下信息整理自 Modrinth 版本页（2026-05 更新）。Steve 全系列均为 Forge 模组，不支持 Fabric、NeoForge 与基岩版。

Steve 模组发布版本

Steve 版本 发布日期 下载文件名 下载 说明
1.4.1 2026-05-14 steve-ai-mod-1.4.1.jar Modrinth 当前最新，Bug 修复
1.4.0 2026-04-04 steve-ai-mod-1.0.0.jar* Modrinth 大更新：合成、插件系统、异步 LLM 等
1.2.0 2026-02-21 steve-ai-mod-1.0.0.jar* Modrinth Bug 修复
1.1.0 2026-01-05 steve-ai-mod-1.1.0.jar Modrinth 改进挖矿深度、建造与 GUI
1.0.0 2025-11-07 steve-ai-mod-1.0.0.jar Modrinth 首个正式版

* Modrinth 上 1.4.0 / 1.2.0 的文件名仍为 1.0.0，请按页面 version_number 区分版本。各版均标注支持 MC 1.20.1 – 1.20.6。

Minecraft 与 Forge / Java 对应

Minecraft Forge 版本 Java 适用 Steve
1.20.1 47.2.0（47.x 系列） 17 1.0.0 – 1.4.1
1.20.2 48.x 17 1.0.0 – 1.4.1
1.20.3 – 1.20.4 49.x 17 1.0.0 – 1.4.1
1.20.5 – 1.20.6 50.x 21 1.0.0 – 1.4.1
  • 推荐组合：Steve 1.4.1 + Minecraft 1.20.1 + Forge 47.2.0 + Java 17（社区教程与整合包最多）
  • 版本匹配：Forge 必须与 MC 大版本一致；Steve JAR 放入对应版本的 mods 文件夹
  • 不支持：Minecraft 1.21+、Fabric、NeoForge、基岩版
  • 1.4.0 新能力：引入 CraftItemAction（合成动作），但智能程度仍依赖 LLM 规划

💡 推荐下载最新版 steve-ai-mod-1.4.1.jar，或在 Modrinth 版本页 / GitHub Releases 获取；启动器中 Forge 请选择与 MC 版本匹配的安装包。

核心能力

⛏️

智能采集

说「挖一些铁」，代理会推理铁矿分布层级、寻路到合适深度、定位矿脉并开采，无需手写脚本。

🏗️

自主建造

根据可用材料生成结构方案，逐方块搭建房屋、平台、城堡等，支持程序化生成与 NBT 模板加载。

🤝

多代理协作

多个 Steve 可并行施工：自动划分区域、分配任务、避免冲突，例如三人同时建一座城堡。

安装与配置

环境要求

  • 游戏：Minecraft Java 版 1.20.1（推荐）+ Forge 47.2.0
  • 模组：Steve 1.4.1（Modrinth 下载）
  • Java：17（1.20.1–1.20.4）；1.20.5+ 需 21
  • API Key：OpenAI / Groq / Gemini 任选其一（Groq 有免费额度，适合试玩）
  • 不支持：基岩版、Fabric、NeoForge、Minecraft 1.21+

快速开始（已有 Forge 环境）

  1. 下载 steve-ai-mod-1.4.1.jar，放入 Forge 实例的 mods 文件夹
  2. 启动游戏一次，生成 config 目录后退出
  3. 复制 config/steve-common.toml.example 为 config/steve-common.toml
  4. 填入 API Key 与 [llm] provider，保存后重启游戏
  5. 进入世界，执行 /steve spawn Bob 召唤代理
  6. 按 K 打开指令面板，输入自然语言命令（如 "mine some iron"）

完整安装教程

Steve 是 Forge 模组，需先准备 Java 与 Forge 环境，再将模组 JAR 放入 mods 目录并配置 LLM API。以下以推荐组合 MC 1.20.1 + Forge 47.2.0 + Java 17 + Steve 1.4.1 为例。

1 安装 Java
  • MC 1.20.1 需要 Java 17（Temurin / Oracle JDK 均可）
  • 下载：Eclipse Temurin 17
  • 安装后在终端执行 java -version，确认输出含 17
  • 使用 HMCL、PCL 等启动器时，可在启动器设置中指定 Java 17 路径，避免混用 Java 8 或 21
2 安装 Minecraft 与 Forge

方式 A：第三方启动器（推荐国内用户）

  • HMCL：新建实例 → 选择 1.20.1 → 版本管理 → 安装 Forge 47.2.0（或 47.x 最新）
  • PCL2：下载游戏 → 版本选择 1.20.1 → 模组加载器选 Forge → 自动安装
  • Prism Launcher / MultiMC：创建实例 → 安装 Forge → 选择 47.2.0

方式 B：官方启动器

  1. 先安装并运行一次 Minecraft 1.20.1 原版
  2. 从 Forge 官网 下载 47.2.0 安装器（Installer）
  3. 运行安装器，选择 Install client，确认游戏目录后安装
  4. 官方启动器中选择 forge-1.20.1-47.2.0 配置文件启动
3 下载 Steve 模组
4 放入 mods 文件夹

将 JAR 复制到当前 Forge 实例的 mods 目录（不是 resourcepacks 或 shaderpacks）：

环境mods 路径
Windows（官方）%appdata%\.minecraft\mods\
macOS~/Library/Application Support/minecraft/mods/
Linux~/.minecraft/mods/
HMCL / PCL 独立目录启动器 → 版本设置 → 打开游戏目录 → mods

💡 启动器会为每个版本创建独立文件夹，务必把 JAR 放进正在使用的 1.20.1 Forge 实例的 mods，而非全局或其他版本目录。

5 首次启动与 API 配置
  1. 用 Forge 配置启动游戏，主菜单 → Mods 列表中应能看到 Steve AI
  2. 进入任意单人世界（或服务器），玩几秒后退出，以生成配置文件
  3. 在游戏目录下找到 config/steve-common.toml.example
  4. 复制并重命名为 config/steve-common.toml
  5. 编辑配置：设置 [llm] provider，并在对应段落填入 API Key（见下方示例）
  6. 保存后完全重启游戏（仅退出世界不够，需关闭客户端）

API Key 获取

6 验证安装
  1. 进入生存世界，打开聊天栏，执行 /steve spawn Bob
  2. 若成功，附近会出现名为 Bob 的 Steve 代理实体
  3. 按 K 打开指令面板，输入 "follow me" 或 "mine 10 cobblestone"
  4. 代理开始移动或执行动作，即表示 LLM 与模组均工作正常

💡 若按 K 无反应，检查是否处于创造/生存模式（非旁观）；若代理不动，优先检查 API Key 与 logs/latest.log 中的 LLM 报错。

7 多人服务器安装（可选）
  1. 下载 Forge 1.20.1 服务端（47.2.0），生成 run.sh / run.bat 并首次启动
  2. 将 steve-ai-mod-1.4.1.jar 放入服务端 mods 文件夹
  3. 首次启动后，在服务端目录配置 config/steve-common.toml（与客户端相同）
  4. 客户端也需安装相同版本的 Forge + Steve，否则无法连接
  5. 服务器上所有有权限的玩家均可 /steve spawn；API 费用由服务端配置承担，注意用量

config/steve-common.toml 示例

[llm]
provider = "groq"  # openai | groq | gemini

[openai]
apiKey = "sk-..."
model = "gpt-3.5-turbo"
maxTokens = 1000
temperature = 0.7

[groq]
apiKey = "gsk_..."
model = "llama3-70b-8192"
maxTokens = 1000

[gemini]
apiKey = "AI..."
model = "gemini-1.5-flash"
maxTokens = 1000

💡 游戏内推荐用 Groq（响应快）；复杂规划可试 GPT-4。temperature 建议 0.5~0.7，行为更稳定。

指令与实践

基础指令

自然语言示例

"mine 20 iron ore"
"build a house near me"
"follow me"
"gather wood from that forest"
"defend me from zombies"
"make a cobblestone platform here"
"attack that creeper"
"help Alex with the tower"

无需精确语法，代理会自行理解意图并拆解为移动、挖矿、放置、战斗等动作序列。

游戏命令

常用 /steve 命令

命令说明
/steve spawn <名字>召唤一名 Steve 代理
/steve list列出当前世界所有代理
/steve kill <名字>移除指定代理
K打开指令面板，输入任务

每个 Steve 拥有独立记忆与任务上下文，可给不同代理分配不同工作。代理在生存模式下拥有生命值，可能被怪物击杀或摔落死亡，死亡后需重新召唤。

结合本攻略的实战场景

🌱 生存初期

  • "gather 20 oak logs" — 替代手动砍树，快速完成第一天物资准备
  • "build a small shelter near me with a door" — 日落前自动搭临时庇护所
  • "place torches around this area" — 批量照明，防止怪物生成

⛏️ 资源采集

  • "mine iron ore until you have 32" — 配合上文「分支挖矿法」，专注探索与基地规划
  • "dig down to Y -54 and mine diamonds" — 代理按层级寻找钻石（需铁镐以上工具，见合成指南）
  • "collect cobblestone and fill this chest" — 自动化收集建材

🏠 基地建造

  • "build a storage room with 10 chests" — 快速搭建存储区
  • "build a 9x9 wheat farm" — 配合农牧攻略，解放重复劳动
  • 召唤 2~3 个 Steve："build a castle together" — 体验多代理并行施工

⚔️ 战斗与探索

  • "defend me from zombies tonight" — 夜间守家，你专注合成与附魔
  • "follow me and attack hostile mobs" — 下界/洞穴探索时的护卫
  • "light up this cave" — 探索前让代理先行铺设火把

工作原理（简述）

1

按 K 输入自然语言

→
2

TaskPlanner 调用 LLM 生成动作计划

→
3

ActionExecutor 逐 tick 执行（挖矿/建造/移动/战斗）

→
4

结果写入记忆，支持后续对话上下文

采用「直接动作执行」而非传统 ReAct 循环，减少 API 调用与延迟，保证游戏不卡顿。多代理协作由服务端 CollaborativeBuildManager 做空间分区与冲突避免。

注意事项

Steve 可以在哪些游戏模式下使用？

Steve 主要为生存模式设计——挖矿需要真实消耗工具耐久、建造需要消耗材料、战斗会受到伤害。这些限制在生存模式下让 AI 代理的自动化价值最大化。创造模式下虽然可以正常召唤，但无限资源与飞行能力使 AI 的优势不明显；冒险模式与旁观模式下代理无法正常执行方块操作。Steve 支持多人游戏：服务端安装后所有玩家均可召唤代理，但多人环境需注意 API 调用费用。

当前有哪些局限？

1.4.0 之前版本无法合成工具；1.4.0+ 虽引入合成功能（CraftItemAction），但仍处于早期阶段，成功率取决于 LLM。单任务同步执行，挖矿时无法并行其他操作；重启后记忆会重置。智能程度取决于所选 LLM，GPT-3.5 偶有不合理决策，GPT-4 规划更好但更慢。

如何从源码构建？

克隆仓库后执行 ./gradlew build，产物在 build/libs/。开发调试可用 ./gradlew runClient。项目结构包含 llm/、action/、structure/、memory/ 等模块，MIT 开源，欢迎提交 Issue 与 PR。

API 费用如何控制？

每次指令会调用 LLM，频繁下达复杂任务会产生 API 费用。建议先用 Groq 免费额度测试；简单任务用短句；多代理协作时注意同时发起的请求数量。勿将含 API Key 的配置文件上传到公开仓库。

安装后游戏崩溃或 Mod 列表看不到 Steve？

常见原因：Forge 与 MC 版本不匹配（如 1.20.1 用了 1.20.4 的 Forge）；Java 版本错误（1.20.1 需 Java 17）；JAR 放错目录（应在 Forge 实例的 mods，不是 versions）；与其他 Mod 冲突。查看 logs/latest.log 末尾报错，或暂时移出其他 Mod 仅保留 Steve 测试。

代理召唤成功但不执行任务？

多为 API 配置问题：确认 steve-common.toml 已从 example 复制、provider 与填 Key 的段落一致、Key 有效且有余额。修改配置后需重启整个游戏。网络需能访问对应 API（Groq/OpenAI/Google）；国内用户若 OpenAI 不可用，可改用 Groq 或 Gemini。

Java 编程 · 模组开发

Java 版模组、插件与工具均用 Java 编写——从语法入门到 Forge 第一个 Mod

开发指南

用 Java 扩展 Minecraft

Minecraft Java 版的核心与模组（Mod）生态都基于 Java。 想自制物品、生物、维度，或像本站介绍的 Steve AI 那样接入 LLM， 都需要掌握 Java 与 Forge（或 Fabric）开发流程。本模块提供零基础语法与Forge 1.20.1 实战路径，与上文 Steve 安装教程中的 Java 17 环境一致。

Forge 官方文档 下载 JDK

学 Java 能做什么

🧩

Forge / Fabric 模组

添加新物品、方块、生物、维度与游戏机制。社区绝大多数 Java 版 Mod 均由此实现。

🖥️

服务器插件

Bukkit / Spigot / Paper 插件用 Java 编写，适合小游戏、经济、权限等不改客户端的服务端玩法。

🔧

工具与自动化

地图生成器、存档分析、资源包批处理等周边工具；复杂逻辑也可配合数据包，但 Mod 级能力仍需 Java。

开发环境搭建

推荐工具链

  • JDK 17：开发 MC 1.20.1 Mod 的标准版本（与 Steve 模组一致）
  • IntelliJ IDEA：Community 版免费，Forge 社区最常用 IDE
  • Gradle：构建工具，Forge MDK 已内置 Wrapper，无需单独安装
  • Git：版本管理（可选但强烈推荐）

环境检查清单

  1. 安装 Temurin JDK 17
  2. 终端执行 java -version 与 javac -version，均应显示 17
  3. 安装 IntelliJ IDEA（Community 即可）
  4. 设置 JAVA_HOME 指向 JDK 17 安装目录（Windows 可在系统环境变量中配置）

创建第一个 Forge 模组项目

以下以 Minecraft 1.20.1 + Forge 47.2.0 为例，与本站 Steve AI 模组版本线一致。完整文档见 Forge 1.20.1 Getting Started。

1 下载 Forge MDK
  • 打开 Forge 1.20.1 下载页，选择 47.2.0 → Mdk
  • 解压到不含中文与空格的目录，例如 D:\Dev\MyFirstMod
  • 删除 MDK 自带的 .git 文件夹（若有），再执行 git init 建立自己的仓库
2 修改模组标识

编辑 gradle.properties，将 mod_id、mod_name 等改为你自己的模组名（小写英文，如 myfirstmod）。同步修改 src/main/resources/META-INF/mods.toml 中的 modId 与描述。

3 生成 IDE 配置并导入
  1. Windows：在项目根目录打开终端，执行 gradlew.bat genIntellijRuns
  2. macOS / Linux：./gradlew genIntellijRuns
  3. 用 IntelliJ 打开项目文件夹，选择 Import Gradle Project
  4. 等待 Gradle 同步完成（首次会下载 MC 与 Forge 依赖，耗时较长）
4 运行测试客户端
  1. 在 IntelliJ 右上角运行配置中选择 runClient
  2. 点击运行，首次启动会再次下载资源，成功后进入带 Mod 的 Minecraft 主菜单
  3. 主菜单 → Mods 中应能看到你的模组名称
  4. 调试时用 runServer 可启动本地专用服务器

💡 若 Gradle 同步失败，检查网络与 JDK 版本；国内用户可在 gradle.properties 配置镜像，或使用 VPN 完成首次依赖下载。

5 打包发布
  • 执行 gradlew build，产物位于 build/libs/你的模组名-版本.jar
  • 将 JAR 放入游戏 mods 文件夹即可加载（需对应 Forge 版本）
  • 发布到 Modrinth 或 CurseForge 需遵守各平台规则与开源协议

Java 基础语法（MC 向）

入门

变量与类型

String playerName = "Alex";
int diamondCount = 12;
boolean isCreative = false;
double health = 19.5;

System.out.println(playerName + " 有 " + diamondCount + " 颗钻石");

常用类型：int 整数、double 小数、boolean 布尔、String 文本。Mod 里方块 ID、数量、坐标大量使用 int。

结构

类与方法

public class PickaxeHelper {
    public static int maxDurability(String tier) {
        if ("diamond".equals(tier)) {
            return 1561;
        }
        return 59; // 木镐
    }
}

Java 是面向对象语言：逻辑写在类（class）里，行为用方法（method）表示。Forge 模组的主类通常带 @Mod 注解。

集合

循环与列表

List<String> ores = List.of("iron", "gold", "diamond");
for (String ore : ores) {
    System.out.println("正在挖掘: " + ore);
}

Mod 开发中常遍历注册表、配方、实体列表。熟悉 for 循环与 List 是阅读 Forge 源码的基础。

Mod 概念

注解与注册

@Mod("examplemod")
public class ExampleMod {
    public ExampleMod() {
        var bus = FMLJavaModLoadingContext.get().getModEventBus();
        ModItems.ITEMS.register(bus);
    }
}

Forge 用注解标记入口与事件；物品、方块通过 DeferredRegister 延迟注册。先理解「主类 + 注册」模式，再深入事件总线。

示例：注册自定义物品

在 MDK 默认结构基础上，增加一个「魔法锭」物品（简化示例，便于理解注册流程）。

ModItems.java — 注册物品

public class ModItems {
    public static final DeferredRegister<Item> ITEMS =
        DeferredRegister.create(ForgeRegistries.ITEMS, ExampleMod.MOD_ID);

    public static final RegistryObject<Item> MAGIC_INGOT = ITEMS.register("magic_ingot",
        () -> new Item(new Item.Properties()));
}

assets/examplemod/lang/en_us.json — 显示名称

{
  "item.examplemod.magic_ingot": "Magic Ingot"
}

💡 中文可新增 zh_cn.json，键名相同，值为「魔法锭」。物品纹理 PNG 放在 assets/examplemod/textures/item/magic_ingot.png（16×16）。

项目结构速查

路径作用
src/main/java/...模组 Java 源码（物品、方块、事件逻辑）
src/main/resources/META-INF/mods.toml模组元数据（ID、版本、依赖）
src/main/resources/assets/<modid>/纹理、模型、语言文件
src/main/resources/data/<modid>/配方、战利品表等数据驱动内容
build.gradle依赖与构建配置
gradle.properties模组 ID、版本号、MC 版本

学习路线建议

1

Java 基础语法
（变量、类、循环）

→
2

跑通 MDK
runClient

→
3

注册物品/方块
+ 纹理

→
4

事件系统
（右键、合成）

→
5

阅读开源 Mod
（如 Steve 源码）

  • 官方：Oracle Java 教程、Forge 文档
  • 视频：B 站搜索「Minecraft 1.20 Forge 模组教程」跟随完整系列
  • 练手：为本站合成指南中的物品做「加强版」Mod 变体，或给 Steve 写小型扩展插件
  • 注意：Mod 开发需遵守 Mojang EULA，勿分发盗版客户端或未授权资产

开发常见问题

Forge 和 Fabric 该选哪个？

Forge 历史久、大型 Mod 多（科技、魔法类整合包常见），API 较重，本指南与 Steve AI 均以 Forge 为例。Fabric 轻量、更新快，适合 1.21+ 新内容与性能向小型 Mod。两者不兼容，选一个生态坚持即可；语法都是 Java，切换时主要是 API 与注册方式不同。

模组（Mod）和插件（Plugin）有什么区别？

Mod 修改客户端与服务器游戏内容，玩家需安装 Forge/Fabric。Plugin 仅运行在 Spigot/Paper 等服务端，玩家用原版客户端即可加入。做新方块/生物用 Mod；做大厅、经济、小游戏用 Plugin。两者都使用 Java，但 API 完全不同。

Gradle 同步或 runClient 一直失败？

常见原因：JDK 不是 17、路径含中文、网络无法访问 Maven 中央仓库。确认 java -version，尝试命令行手动执行 gradlew runClient 查看完整报错。首次构建需下载大量依赖，失败时可删除 .gradle 缓存后重试。

能不能不写 Java，只用命令方块或数据包？

可以。数据包与函数适合地图、冒险地图和规则 tweak，但无法添加全新物品类型或复杂 AI。需要新机制、新渲染或深度改动物品行为时，仍必须写 Mod。建议：简单玩法用数据包，系统级扩展用 Java。

常见问题

新手应该选什么难度？

第一次玩建议选择「普通」难度。若觉得战斗压力大，可暂时设为「和平」（无怪物），专注熟悉采集与建造，之后再调回普通。

如何备份存档？

单人存档位于 .minecraft/saves/ 文件夹，复制整个世界文件夹即可备份。多人服务器需备份 world 目录及 server.properties。

原版和模组有什么区别？

原版是 Mojang 官方内容。模组（Mod）由社区开发，可添加新生物、维度、科技系统等。整合包是预装多个 Mod 的模组组合，玩法变化更大。

怎么和朋友一起玩？

Java 版可通过 LAN 开放、Realms 订阅或自建/租用服务器联机。基岩版支持跨平台，通过好友邀请或 Realms 即可。