VSCode 中使用 MCP：入门教程 – wiki基地

作者： /

VSCode 中使用 MCP：Minecraft Mod 开发入门详解

前言

Minecraft，这款风靡全球的沙盒游戏，以其无限的创造可能性吸引了无数玩家。而 Mod（Modification，模组）开发，更是将这种创造性推向了极致。通过编写 Mod，玩家可以向游戏中添加新的方块、物品、生物，甚至全新的游戏机制。在 Minecraft Mod 开发的早期历史中，Mod Coder Pack（MCP）扮演了至关重要的角色。它提供了一套工具，允许开发者反编译、修改和重新编译 Minecraft 的源代码。

虽然现代 Minecraft Mod 开发（尤其是 1.13 版本以后）主要转向使用 Forge 或 Fabric 等更高级、更易于维护的 Modding API 和构建工具，但了解 MCP 的工作原理对于理解 Mod 开发的基础、研究旧版本 Mod 或进行特定底层操作仍然具有一定的价值。

Visual Studio Code (VSCode) 是一款功能强大、轻量级且高度可扩展的免费源代码编辑器。它凭借其丰富的插件生态、集成的终端、强大的调试功能和 Git 支持，成为了众多开发者的首选工具，同样也适用于 Minecraft Mod 开发。

本教程将详细介绍如何在 VSCode 环境中设置和使用经典的 Mod Coder Pack (MCP) 来进行 Minecraft（主要针对较旧版本，如 1.12.2 及更早版本，因为这些版本是 MCP 主要活跃的时期）的 Mod 开发。我们将从环境准备开始，一步步引导您完成 MCP 的设置、代码修改、编译和测试的全过程。

重要提示：关于 MCP 的现状

在开始之前，必须强调：对于现代 Minecraft 版本（1.13+），强烈推荐使用 Forge 或 Fabric 进行 Mod 开发。 这些现代框架提供了更稳定、更兼容、更易于协作的开发环境，拥有完善的 API、构建系统（如 Gradle）和庞大的社区支持。MCP 主要适用于研究或维护基于旧版 Minecraft 的 Mod。本教程侧重于 MCP 的使用方法，但请认识到其局限性和过时性。

第一章：环境准备 – 奠定坚实基础

在开始使用 MCP 和 VSCode 之前，我们需要确保开发环境已经配置妥当。

  1. 安装 Java Development Kit (JDK)

    • 核心要求： Minecraft 和 MCP 都基于 Java 运行。你需要安装 JDK，而不仅仅是 JRE（Java Runtime Environment）。
    • 版本选择： MCP 的不同版本对应不同的 Minecraft 版本，而这些 Minecraft 版本通常需要特定版本的 JDK。对于较旧的 Minecraft 版本（如 1.7.10, 1.12.2），JDK 8 (或称为 1.8) 是最常用且兼容性最好的选择。请务必确认你打算使用的 MCP 版本推荐的 JDK 版本。
    • 下载与安装：
      • 访问 Oracle JDK Archive (需要 Oracle 账户) 或 Adoptium (提供 OpenJDK 的免费发行版，推荐) 等官方或受信任的来源下载适合你操作系统的 JDK 8 安装包。
      • 按照安装向导完成安装。请记住你的 JDK 安装路径，后续配置可能会用到。
    • 配置环境变量 (重要)：
      • JAVA_HOME: 创建一个新的环境变量 JAVA_HOME，其值指向你的 JDK 安装目录 (例如 C:\Program Files\Java\jdk1.8.0_XXX)。
      • Path: 编辑系统的 Path 环境变量，在其中添加 %JAVA_HOME%\bin (Windows) 或 $JAVA_HOME/bin (Linux/macOS)。这使得你可以在命令行中直接运行 java 和 javac 命令。
    • 验证安装： 打开命令行或终端，输入以下命令：
      bash
      java -version
      javac -version
      如果能正确显示 Java 和 Javac 的版本信息（应为 1.8.x），则表示 JDK 安装和配置成功。

  2. 安装 Visual Studio Code (VSCode)

    • 访问 VSCode 官方网站 (https://code.visualstudio.com/)。
    • 下载适用于你操作系统的安装包（Windows, macOS, Linux）。
    • 运行安装程序，按照提示完成安装。过程非常简单直接。

  3. 安装 VSCode 扩展 (提升效率)

    • 打开 VSCode。
    • 点击左侧活动栏中的“扩展”图标 (看起来像四个方块，其中一个分离)。
    • 搜索并安装以下核心扩展：
      • Extension Pack for Java (Microsoft): 这是一个扩展包，包含了进行 Java 开发所需的大部分基础功能，如：
        • Language Support for Java™ by Red Hat: 提供代码补全、语法高亮、错误检查、重构等核心语言支持。
        • Debugger for Java: 提供强大的 Java 调试功能。
        • Test Runner for Java: 支持 JUnit 等测试框架。
        • Maven for Java: (虽然经典 MCP 不直接用 Maven，但包含在包内，对后续可能接触的 Java 项目有用)。
        • Project Manager for Java: 帮助管理 Java 项目。
      • (可选但推荐) GitLens — Git supercharged: 极大地增强了 VSCode 的 Git 功能，方便查看代码历史、作者信息等。
      • (可选) 其他主题、图标、代码片段扩展： 根据个人喜好安装，优化视觉体验和编码效率。

完成以上步骤后，你的基础开发环境就搭建好了。

第二章：获取与设置 Mod Coder Pack (MCP)

现在，我们需要获取 MCP 本身并进行初步设置。

  1. 下载 MCP

    • 寻找来源： MCP 的官方分发随着时间的推移已经变得不那么集中。你需要找到与你想要 Mod 的 Minecraft 版本相对应的 MCP 版本。
      • 历史存档： 可以在一些 Minecraft Modding 历史网站、论坛（如 Minecraft Forum 的旧版块）或社区存档（如 MCArchive）中找到。请务必从可信赖的来源下载，警惕潜在的恶意软件。 搜索时使用类似 “MCP download for Minecraft X.Y.Z” 的关键词。
      • 版本对应： 确保下载的 MCP 版本明确支持你目标 Minecraft 版本。例如，MCP 9.40 通常用于 Minecraft 1.12.x，而 MCP 9.18 用于 1.8.9 等。
    • 文件类型： 下载的文件通常是一个 .zip 或 .7z 压缩包。

  2. 解压 MCP

    • 选择一个合适的、路径不含中文或特殊字符的工作目录（例如 D:\MinecraftModding\MyMCPProject）。
    • 将下载的 MCP 压缩包解压到这个目录下。你会看到一系列的文件和文件夹。

  3. 理解 MCP 目录结构 (典型)

    • jars/: 存放原始的 Minecraft 客户端 (client.jar) 和服务端 (server.jar) 文件，以及所需的库文件。你需要手动将对应版本的 client.jar 和 server.jar 放入此目录（通常从官方启动器的 .minecraft/versions/X.Y.Z/ 目录下复制 X.Y.Z.jar 并重命名）。
    • src/: 这是最重要的目录，MCP 的反编译过程会将 Minecraft 的源代码（或经过映射的源代码）放在这里。你的 Mod 代码也将主要放在这个目录下。
    • conf/: 包含 MCP 的配置文件，如混淆映射 (mappings) 文件 (client.srg, server.srg, joined.srg)，这些文件定义了混淆后的代码（如 a.b.c）与可读名称（如 net.minecraft.block.BlockDirt）之间的对应关系。
    • scripts/ 或 commands/ 或根目录下的批处理/Shell 脚本: 包含用于执行 MCP 各个步骤的脚本文件，如 decompile.bat / decompile.sh, recompile.bat / recompile.sh, reobfuscate.bat / reobfuscate.sh, startclient.bat / startclient.sh 等。文件名可能因 MCP 版本略有不同。
    • logs/: 存放 MCP 工具运行时的日志文件，排查问题时非常有用。
    • temp/: 存放反编译和重编译过程中的临时文件。

  4. 执行反编译 (Decompilation)

    • 目的： 将 Minecraft 的 .class 文件转换为可读的 .java 源代码文件，并应用映射，使其具有一定的可读性。这是 Mod 开发的第一步。
    • 操作：
      • 确保你已经将对应版本的 client.jar 和 server.jar 放入了 jars/ 目录。
      • 打开命令行或终端，cd 到你的 MCP 工作目录。
      • 运行反编译脚本：
        • Windows: decompile.bat
        • Linux/macOS: sh decompile.sh (可能需要先 chmod +x decompile.sh)
    • 过程与预期：
      • 此过程会连接网络下载所需的库和反编译器（如 Fernflower）。
      • 它会处理 jars/ 中的文件，并将反编译后的源代码（通常是客户端和服务端合并后的）放入 src/minecraft/ 目录下。
      • 这个过程可能需要几分钟到十几分钟，具体取决于你的网络速度和计算机性能。
      • 仔细观察输出： 留意命令行中是否有错误信息。常见的错误包括：
        • 找不到 java 命令 (检查 JDK 安装和 Path 环境变量)。
        • 网络连接问题 (检查防火墙或代理设置)。
        • 内存不足 (可以尝试编辑脚本，增加 JVM 的内存分配 -Xmx)。
        • jars/ 目录下缺少必要的 .jar 文件。
    • 成功标志： 脚本执行完毕，没有报告严重错误，并且 src/minecraft/ 目录下出现了大量的 .java 文件 (如 net/minecraft/client/Minecraft.java, net/minecraft/block/Block.java 等)。

至此，MCP 的基本设置完成，Minecraft 的源代码已经准备好供我们查阅和修改。

第三章：在 VSCode 中使用 MCP 项目

现在，我们将 MCP 项目导入 VSCode，并利用 VSCode 的功能进行开发。

  1. 打开 MCP 文件夹

    • 启动 VSCode。
    • 选择 File > Open Folder... (文件 > 打开文件夹…)。
    • 导航到你之前解压并设置好的 MCP 工作目录，选中该文件夹，然后点击“打开”或“选择文件夹”。

  2. 信任工作区

    • VSCode 出于安全考虑，可能会询问你是否信任此文件夹中的文件的作者。由于这是你自己的项目，选择“是，我信任此文件夹”。

  3. Java 项目识别与配置

    • 自动检测： 安装了 “Extension Pack for Java” 后，VSCode 会尝试自动检测项目结构。由于经典 MCP 项目没有使用标准的构建工具（如 Maven 或 Gradle），Java 扩展可能不会将其识别为一个完整的“Java 项目”。但它仍然能提供基本的 Java 语言支持。
    • 源代码识别： Java 语言服务器（来自 Red Hat 扩展）应该能够识别 src/minecraft/ 目录下的 .java 文件，并开始提供语法高亮、代码补全和错误检查。这可能需要一些时间进行初始化和索引。你可以在 VSCode 底部状态栏看到 Java 语言服务器的运行状态。
    • 配置 JDK (如果需要)：
      • 如果 VSCode 没有自动找到你的 JDK 8，或者你安装了多个 JDK 版本，可能需要手动指定。
      • 按 Ctrl+Shift+P 打开命令面板，输入 Java: Configure Java Runtime。
      • 在打开的界面中，检查 “Java Tooling Runtime” 下的 “JDK for Language Server” 是否指向了正确的 JDK 8 路径。如果没有，可以点击修改并指定。同时检查 “Project JDKs” 部分。
    • 处理错误和警告：
      • 初次打开项目时，VSCode 的 “问题” 面板 (通常在底部) 可能会显示大量的错误或警告。这通常是因为：
        • 库文件未完全识别： 经典 MCP 的依赖库位于 jars/ 或其他特定位置，VSCode 的 Java 扩展可能没有自动将其全部加入项目的 classpath。对于基础的代码浏览和修改，这通常影响不大，但高级的代码导航和编译检查可能会受限。对于非常旧的 MCP，可能需要手动配置 .vscode/settings.json 中的 java.project.referencedLibraries 来指向 jars 目录下的库文件，但这比较繁琐且容易出错。
        • 反编译不完美： 反编译器（如 Fernflower）并非万能，有时生成的 Java 代码可能存在一些语法问题或无法完全还原原始逻辑，导致 Java 扩展报告错误。

  4. 浏览和导航代码

    • 文件浏览器 (Explorer)： 使用 VSCode 左侧的文件浏览器可以方便地浏览 src/minecraft/ 下的目录和文件结构。例如，你可以找到 net.minecraft.block 包来查看方块相关的代码，或者 net.minecraft.item 包来查看物品代码。
    • 搜索功能：
      • 文件内搜索: 按 Ctrl+F 在当前打开的文件中搜索。
      • 全局搜索: 按 Ctrl+Shift+F 在整个项目（所有 src 下的文件）中搜索文本、类名、方法名等。例如，搜索 “BlockDirt” 可以快速定位到泥土方块的类。
    • 代码智能提示 (IntelliSense)： 当你输入代码时，VSCode 的 Java 扩展会提供基于上下文的建议，包括类名、方法名、变量名等。这极大地提高了编码效率。其准确性依赖于项目 classpath 的正确配置。
    • 跳转与引用：
      • 转到定义 (Go to Definition): 将光标放在类名、方法名或变量上，按 F12 或右键选择 “Go to Definition”，可以快速跳转到其定义的位置。
      • 查找所有引用 (Find All References): 将光标放在类名、方法名或变量上，按 Shift+F12 或右键选择 “Find All References”，可以在整个项目中查找所有使用到该元素的地方。

第四章：编写你的第一个简单 Mod

理论讲解完毕，现在我们来实践一下，做一个简单的修改。假设我们的目标是修改游戏中“泥土”方块掉落物——让它掉落钻石而不是它自身。

  1. 定位目标代码

    • 我们知道要修改泥土方块 (Dirt Block) 的掉落物。
    • 使用全局搜索 (Ctrl+Shift+F) 搜索 “BlockDirt” 或直接在文件浏览器中导航到 src/minecraft/net/minecraft/block/BlockDirt.java 文件并打开它。

  2. 分析与修改代码

    • 在 BlockDirt.java 文件中，寻找决定方块掉落物的方法。在较旧的 Minecraft 版本中，这通常是 getItemDropped 或类似名称的方法。可能会像这样：
      java
      // 示例代码 (不同 Minecraft/MCP 版本可能不同)
      @Override
      public Item getItemDropped(IBlockState state, Random rand, int fortune) {
      // 默认返回泥土物品自身
      return Item.getItemFromBlock(Blocks.DIRT);
      }
    • 进行修改： 我们想让它掉落钻石。首先需要找到钻石物品的引用。钻石物品通常在 net.minecraft.init.Items 类中定义（注意：类名和包名可能因版本而异，需要根据实际代码确定）。将返回语句修改为：
      java
      // 示例代码 (不同 Minecraft/MCP 版本可能不同)
      @Override
      public Item getItemDropped(IBlockState state, Random rand, int fortune) {
      // 修改为返回钻石物品
      return net.minecraft.init.Items.DIAMOND; // 确保 Items.DIAMOND 是正确的引用
      }
    • 导入 (Import)： 如果 Items 类没有自动导入，VSCode 可能会在 Items.DIAMOND 下显示红色波浪线。将光标放在上面，按 Ctrl+. (或点击旁边的小灯泡图标)，选择 “Import ‘Items’ from ‘net.minecraft.init'” (或类似的选项) 来自动添加 import net.minecraft.init.Items; 语句到文件顶部。

  3. 保存文件

    • 按 Ctrl+S 保存你对 BlockDirt.java 文件的修改。

第五章：编译、混淆与测试

代码修改完成后，我们需要将其编译成 Minecraft 可以加载的 .class 文件，并进行必要的混淆处理，最后在游戏中测试效果。

  1. 重新编译 (Recompilation)

    • 目的： 将修改后的 .java 源代码编译回 .class 字节码文件。
    • 操作：
      • 回到之前打开的命令行或终端 (确保当前目录是 MCP 工作目录)。
      • 运行重新编译脚本：
        • Windows: recompile.bat
        • Linux/macOS: sh recompile.sh
    • 过程与预期：
      • MCP 会调用 javac 编译器来编译 src/minecraft/ 目录下的所有 Java 文件。
      • 编译后的 .class 文件通常会输出到 bin/minecraft/ 或类似目录下 (具体位置看 MCP 版本和配置)。
      • 检查错误： 如果你的代码存在语法错误（比如拼写错误、缺少分号、类型不匹配等），编译过程会失败，并在命令行中输出详细的错误信息，包括出错的文件名、行号和错误描述。你需要根据这些信息回到 VSCode 中修正错误，然后重新运行 recompile 脚本。

  2. 重新混淆 (Reobfuscation)

    • 目的： Minecraft 的原始 .jar 文件中的类名和方法名是经过混淆的（变成了简短无意义的名称，如 a.b.c()）。我们在可读源代码（如 net.minecraft.block.BlockDirt）中进行的修改，需要被转换回使用混淆名称，这样才能被未经修改的 Minecraft 客户端或服务端正确加载和识别。这一步就是将我们编译好的、使用可读名称的 .class 文件，根据 conf/ 目录下的映射文件 (.srg 文件)，重新转换成使用混淆名称的 .class 文件。
    • 操作：
      • 在命令行或终端中，运行重新混淆脚本：
        • Windows: reobfuscate.bat
        • Linux/macOS: sh reobfuscate.sh
    • 过程与预期：
      • MCP 会读取编译好的 .class 文件和映射文件，进行名称替换。
      • 处理后的、使用混淆名称的 .class 文件通常会输出到 reobf/minecraft/ 或类似目录下。
      • 这一步至关重要！ 如果跳过此步骤，直接将 bin/ 目录下的 class 文件打包成 Mod，游戏很可能会因为找不到对应的类或方法而崩溃。
      • 同样，留意命令行输出，检查是否有错误。

  3. 运行与测试

    • 启动测试客户端： MCP 通常提供一个方便的脚本来启动一个使用了你修改后代码的测试 Minecraft 客户端。
      • 在命令行或终端中，运行启动脚本：
        • Windows: startclient.bat
        • Linux/macOS: sh startclient.sh
    • 游戏内测试：
      • 等待 Minecraft 客户端启动（这可能需要一些时间，因为它会加载所有修改后的类）。
      • 进入一个世界（或创建一个新世界）。
      • 找到一个泥土方块。
      • 用手或工具将其破坏。
      • 观察掉落物： 如果一切顺利，泥土方块现在应该掉落一个钻石，而不是泥土块本身！
    • 调试与排错：
      • 游戏崩溃： 如果游戏启动失败或在测试过程中崩溃，检查命令行窗口（启动脚本运行时所在的窗口）或 Minecraft 的日志文件 (.minecraft/logs/latest.log 或 MCP 工作目录下的 logs/ 文件夹中的日志) 以获取错误信息。常见的崩溃原因包括：
        • 忘记运行 reobfuscate。
        • 代码逻辑错误（例如，空指针异常）。
        • 修改了核心机制导致不兼容。
      • 效果不符： 如果游戏没崩溃，但修改效果没有出现（泥土仍然掉落泥土），请：
        • 确认你修改了正确的文件和方法。
        • 确认 recompile 和 reobfuscate 都成功执行且没有错误。
        • 确认你运行的是 startclient 脚本启动的测试客户端，而不是普通的 Minecraft 启动器。

第六章：进阶技巧与注意事项

掌握了基本流程后，以下是一些能提升你使用 VSCode 和 MCP 效率的建议：

  1. 集成终端 (Integrated Terminal)

    • VSCode 内置了终端功能 (Terminal > New Terminal 或 Ctrl+ (反引号))。你可以在 VSCode 界面内直接运行decompile,recompile,reobfuscate,startclient` 等命令，无需切换窗口，非常方便。

  2. 版本控制 (Git)

    • 强烈推荐！ 即使是个人项目，也应该使用 Git 进行版本控制。
    • 初始化仓库： 在 MCP 工作目录打开集成终端，运行 git init。
    • 配置 .gitignore: 创建一个 .gitignore 文件，将不需要纳入版本控制的文件和目录（如 bin/, reobf/, temp/, logs/, jars/ 内的原始 jar 文件等）添加进去。这可以保持仓库的整洁。网上可以找到适用于 MCP 项目的 .gitignore 模板。
    • 提交更改： 在 VSCode 的源代码管理视图 (Source Control，左侧类似分叉的图标) 中，可以方便地查看更改、暂存文件 (Stage Changes) 并提交 (Commit) 你的修改。写清楚的提交信息有助于追踪开发历史。
    • 分支： 使用分支 (git branch, git checkout) 来开发新功能或进行实验性修改，避免污染主线代码。

  3. 调试 (Debugging)

    • 使用 VSCode 的 Java 调试器 (Debugger for Java 扩展) 可以设置断点、单步执行代码、检查变量值，是排查复杂问题的利器。
    • 配置 launch.json: 对于经典的 MCP 项目，直接使用 VSCode 的调试功能可能需要手动配置 launch.json 文件（在 .vscode 目录下创建）。你需要创建一个 Java Launch 配置，指定主类 (通常是 net.minecraft.client.main.Main 或类似启动类)，并设置正确的 classpath (需要包含 bin/minecraft, jars/ 下的库文件等) 和 VM 参数 (如内存设置，可能还需要指向 natives 库的路径 -Djava.library.path=...)。这个配置过程相对复杂，可能需要参考特定 MCP 版本的文档或社区经验。
    • 对比现代工具： Forge 和 Fabric 的 Gradle 构建系统通常会自动生成可直接用于 VSCode 调试的 launch.json 配置，大大简化了调试设置。

  4. 理解混淆

    • 再次强调，混淆是 MCP 工作流中的关键环节。你需要理解为什么需要它（保护代码、减小体积，以及与原版兼容），并且总是记得在修改代码后执行 recompile 和 reobfuscate。
    • 有时你需要查找混淆名称对应的可读名称，或者反过来。conf/ 目录下的 .srg 文件就是这种映射。虽然直接阅读 .srg 文件不太方便，但有些社区工具或 MCP 版本可能提供查询功能。

  5. 代码组织

    • 虽然 MCP 允许你直接修改 Minecraft 的源代码 (src/minecraft/)，但这通常不是一个好的实践，容易导致冲突和维护困难。
    • 推荐做法 (如果 MCP 版本支持或可以手动实现)： 创建一个新的源代码目录（例如 src/mymod/），将你的新类或修改后的类的副本放在这里。然后，通过某种方式（如修改编译脚本或使用特定的 MCP 注入机制，但这超出了基础教程范围）让 MCP 在编译和运行时优先使用你目录下的代码。这更接近现代 Modding 的方式，但对于纯粹的经典 MCP 可能难以完美实现。

第七章：从 MCP 到现代 Modding

当你通过 MCP 熟悉了 Minecraft 的内部结构和 Mod 开发的基本概念后，强烈建议你转向现代的 Modding 工具链：

  • Forge: 一个历史悠久、功能强大、社区庞大的 Modding API 和平台，支持广泛的 Minecraft 版本。它提供了丰富的 API 来与游戏交互，避免了直接修改 Minecraft 源代码，并使用 Gradle 作为构建系统，极大地方便了开发、打包和依赖管理。
  • Fabric: 一个更轻量级、更新迅速的 Modding API 和工具链，特别是在新版本 Minecraft 发布时能更快跟进。它也使用 Gradle，并拥有活跃的社区和独特的 Mod 生态。

为什么转向 Forge/Fabric？

  • 稳定性与兼容性： 它们提供了稳定的 API，减少了因 Minecraft 版本更新导致 Mod 失效的可能性。Mod 之间也更容易兼容。
  • 开发效率： Gradle 构建系统自动化了编译、混淆、打包、依赖管理等繁琐任务。IDE (如 VSCode, IntelliJ IDEA) 集成更好，调试更简单。
  • 社区支持： 拥有庞大而活跃的社区，提供了大量的教程、文档、示例代码和问题解答。
  • 避免修改基础代码： 你编写的代码是独立的 Mod，而不是直接修改游戏本体，更易于维护、分发和协作。

结语

Mod Coder Pack (MCP) 是 Minecraft Modding 历史上的一个重要里程碑。通过本教程，你应该已经了解了如何在 VSCode 环境中设置 MCP，进行代码的查阅、修改、编译、混淆和测试。虽然 MCP 本身对于现代 Mod 开发来说已经有些过时，但学习它的过程能让你深入理解 Minecraft 的底层机制和 Mod 开发的基本原理。

VSCode 作为一个强大的代码编辑器，为 MCP 开发提供了良好的支持，其代码编辑、导航、搜索、终端集成和 Git 支持等功能都能有效提升开发体验。

当你准备好进行更复杂、更现代化的 Minecraft Mod 开发时，请务必研究并转向使用 Forge 或 Fabric。它们将为你打开一个更广阔、更高效、更具协作性的 Modding 世界。祝你在 Minecraft 的创造之旅中玩得开心，编码愉快！

发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注

滚动至顶部