zh_cn:tutorial:setup
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
zh_cn:tutorial:setup [2021/08/25 09:04] – [手动步骤] solidblock | zh_cn:tutorial:setup [2024/10/29 14:34] (current) – [前置] solidblock | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ~~REDIRECT> | ||
+ | |||
====== 配置模组开发环境 ====== | ====== 配置模组开发环境 ====== | ||
===== 前置 ===== | ===== 前置 ===== | ||
- | + | * Java 21(推荐用于 1.20.5)的 | |
- | * JDK(即用于开发 Java 的工具,推荐使用由 AdoptOpenJDK 提供的 Java 8 及以上版本的 JDK [[https://adoptopenjdk.net/]]) | + | * 专业用户可以从 [[http:// |
* 任意 IDE(集成开发环境):如 [[https:// | * 任意 IDE(集成开发环境):如 [[https:// | ||
+ | * 如果对这些不熟悉,推荐使用 Intellij IDEA,绝大多数开发者都用这个编写模组。 | ||
===== 配置步骤 ===== | ===== 配置步骤 ===== | ||
Line 10: | Line 13: | ||
部分地区的用户可能会发现,由于网速原因,构建 Gradle 速度可能比较慢。对于中国内地用户,可参考[[https:// | 部分地区的用户可能会发现,由于网速原因,构建 Gradle 速度可能比较慢。对于中国内地用户,可参考[[https:// | ||
+ | 如果你已经打开代理,但是下载速度仍然比较慢,可以检查一下 IDE 的网络代理设置是否处于关闭状态。对于 IntelliJ IDEA ,你可以在 File -> Settings -> Appearance & Behavior -> System Settings -> HTTP Proxy 找到该设置选项卡,如果勾选的是 "No proxy" ,要切换至 " | ||
==== 手动步骤 ==== | ==== 手动步骤 ==== | ||
- | - 复制 [[https:// | + | - 复制 [[https:// |
- 编辑 '' | - 编辑 '' | ||
- | | + | |
- | | + | |
- | - 在 '' | + | * 添加你需要在 '' |
- 将 '' | - 将 '' | ||
- 配置完成!祝武运昌隆(bushi | - 配置完成!祝武运昌隆(bushi | ||
- | 你也可以生成MC的源文件来作为参考(不过 IDEA 已经自带反编译功能,所以生成不生成都随意): | + | 如有需要,可以在 '' |
- | 运行 Gradle 任务 | + | |
+ | <code properties> | ||
+ | loom_libraries_base=https:// | ||
+ | loom_resources_base=https:// | ||
+ | loom_version_manifests=https:// | ||
+ | loom_experimental_versions=https:// | ||
+ | loom_fabric_repository=https:// | ||
+ | </ | ||
+ | |||
+ | === Fabric 模组ID变化 === | ||
+ | 从 1.19.2 开始,Fabric API 的模组ID由 | ||
=== IntelliJ IDEA === | === IntelliJ IDEA === | ||
- | 如果你使用的是 IntelliJ IDEA,请遵循以下步骤:(注:中文文本可能会因为 IDEA 或中文插件的版本不同而不同) | + | 如果你使用的是 |
- | - 在 IDEA 的主菜单里选择“打开或导入...(Import Project)”(如果已经打开了一个项目,选择位于顶端的“文件-> | + | - 在 IDEA 的主菜单里选择“打开或导入...(Import Project)”(如果已经打开了一个项目,选择位于顶端的“文件-> |
- | - 选择项目的 '' | + | - 选择项目的 '' |
- 在 Gradle 配置完成后,关闭并重新加载项目,否则有些运行配置可能无法正常显示。 | - 在 Gradle 配置完成后,关闭并重新加载项目,否则有些运行配置可能无法正常显示。 | ||
- (如果运行配置还没有出现,试试在 Gradle 页面里重新导入项目。) | - (如果运行配置还没有出现,试试在 Gradle 页面里重新导入项目。) | ||
// | // | ||
- | IDEA 默认使用 Gradle 来构建你的项目,而这在 Fabric 是不必要的,而且它会导致构建时间变长以及热替换(hotswapping)相关的种种问题。以下是让 IDEA 使用默认编译器的步骤: | + | IDEA 默认使用 Gradle 来构建你的项目,而这在 Fabric 是不必要的,而且会导致构建时间变长以及热交换(hotswapping)相关的种种问题。以下是让 IDEA 使用默认编译器的步骤: |
- 在 Gradle 页面里打开“Gradle 设置(Gradle Settings)” | - 在 Gradle 页面里打开“Gradle 设置(Gradle Settings)” | ||
- 将“使用此工具构建和运行(Build and run using)”和“使用此工具运行测试(Run tests using)”选项改成“IntelliJ IDEA”。 | - 将“使用此工具构建和运行(Build and run using)”和“使用此工具运行测试(Run tests using)”选项改成“IntelliJ IDEA”。 | ||
- | - 进入 文件(File)-> | ||
- | 不幸的是目前还不能给“使用此工具构建和运行”和“使用此工具运行测试”设置一个全 IDE 内的默认值,所以这些每创建一个新项目都得重复上述步骤。 | + | 不幸的是,目前还不能给“使用此工具构建和运行”和“使用此工具运行测试”设置一个全 IDE 内的默认值,所以这些每创建一个新项目都得重复上述步骤。 |
- | **注:*千万* | + | **注**:不要运行 '' |
+ | |||
+ | 如果你使用 IntelliJ IDEA,你可以使用 [[https:// | ||
+ | |||
+ | **注**:MCDev 插件中的模板会直接使用 loom 的最新不稳定版本,请小心使用。 | ||
=== Eclipse === | === Eclipse === | ||
- | 如果你使用的是 Eclipse,并且想要生成IDE的运行设置,请运行 '' | + | 如果你使用的是 Eclipse,并且想要生成 IDE 的运行设置,请运行 '' |
=== Visual Studio Code === | === Visual Studio Code === | ||
如果你使用的是 Visual Studio Code,请参照[[zh_cn: | 如果你使用的是 Visual Studio Code,请参照[[zh_cn: | ||
- | ==== MinecraftDev IntelliJ IDEA插件 | + | ===== 生成 Minecraft 源代码 ===== |
- | IntelliJ IDEA 用户可以使用 MinecraftDev 插件来自动生成 Fabric | + | 阅读 Minecraft 源代码是编写模组时的重要一部分。但是,我们不能发布 Minecraft 的源代码,因为这违反了 Minecraft 的最终用户许可协议(EULA)。你需要自己生成 |
- | 这个插件可以在[[https:// | + | |
- | ==== 代码生成器 ==== | + | 要生成 Minecrat 源代码,运行 gradle 任务 '' |
- | 如果你没法使用 MinecraftDev 插件或 [[https:// | + | |
- | - 在[[https:// | + | 如何阅读源代码,可参考[[zh_cn: |
- | - 创建一个新目录,并打开一个新的终端/命令提示符窗口并输入 | + | |
- | - 在它获取完所有的前置项后,按照屏幕上的指示输入所需的信息。 | + | |
- | - 完成之后用你的 IDE 打开即可完成安装。 | + | |
===== 新手入门 ===== | ===== 新手入门 ===== | ||
- | 入门可以先尝试[[zh_cn: | + | 入门可以先尝试[[zh_cn: |
===== 建议 ===== | ===== 建议 ===== | ||
- | * 虽然 Fabric API 并不是必需的,但其最首要的目标是提供MC游戏引擎所不提供的跨模组兼容性和 | + | * 虽然 Fabric API 并不是必需的,但其最首要的目标是提供游戏引擎所不提供的跨模组兼容性和接口,所以我们**强烈**推荐多使用 Fabric API。本 wiki 上的许多教程也会默认使用 Fabric API。 |
* 随着 fabric-loom(我们的Gradle构建插件)的开发和改动,有些时候你可能会遇上一些通过重置 Gradle 缓存才能解决的问题。使用 '' | * 随着 fabric-loom(我们的Gradle构建插件)的开发和改动,有些时候你可能会遇上一些通过重置 Gradle 缓存才能解决的问题。使用 '' | ||
+ | * 保持跟进到最新的 Loom 版本(Loom 版本是在 '' | ||
+ | * 保持跟进到最新的 Gradle 版本,这是在 '' | ||
+ | * 不同的 Gradle 版本依赖不同的 Java 版本。 | ||
+ | * 如果你在为旧版本开发 Minecraft,除了修改 '' | ||
* 问问题不要犹豫,有问题就问,总有人会帮你解决的。(笑 | * 问问题不要犹豫,有问题就问,总有人会帮你解决的。(笑 | ||
===== 故障诊断 ===== | ===== 故障诊断 ===== | ||
+ | |||
+ | ==== "no usages" | ||
+ | 在运行 Intellij IDEA 的 '' | ||
==== 缺少声音 ==== | ==== 缺少声音 ==== | ||
有时当 IDE 在导入 Gradle 项目的时候有些游戏素材不会正常下载。如果遇到这种情况则要手动运行 '' | 有时当 IDE 在导入 Gradle 项目的时候有些游戏素材不会正常下载。如果遇到这种情况则要手动运行 '' | ||
+ | ==== 错误: 找不到或无法加载主类 net.fabricmc.devlaunchinjector.Main / 启动配置中“没有指定 SDK” ==== | ||
+ | 这可能是 Intellij IDEA 自近期更新 2023.2 后的一个 bug。要修复这个问题,删除整个 `.idea` 文件夹然后重启 Intellij IDEA 即可。模块会重新构建。你可能需要再次指定 Java 版本。如果重启之后没有运行配置,你可以运行 `gradle ideaSyncTask` 然后再检查一下。 | ||
+ | |||
+ | ==== java.lang.ClassNotFoundException: | ||
+ | 这可能是因为项目路径有中文字符或其他可能造成编码不兼容的字符造成的。可以尝试将项目移到不含中文的路径中,或者在启动参数中(编辑配置),将“Minecraft Client”和“Minecraft Server”启动配置的“缩短命令行”(Shorten command line)由“@argfile (Java 9+)”设为“无”。 | ||
+ | |||
+ | 另一个可能的解决办法,是在 Windows 的设置或控制面板中找到“区域设置”,并勾选“Beta 版:使用 Unicode UTF-8 提供全球语言支持”,然后重启。 | ||
+ | ==== Gradle 无法下载 ==== | ||
+ | 部分地区的用户在下载 Gradle 时,可能遇到 Connection Reset 的问题。这种情况下可以使用镜像源下载 Gradle。例如,在 '' | ||
+ | <code properties> | ||
+ | # 修改前 | ||
+ | distributionUrl=https:// | ||
+ | |||
+ | # 修改后 | ||
+ | distributionUrl=https:// | ||
+ | </ | ||
+ | 注:Gradle 的镜像不止腾讯。 | ||
+ | ===== 接下来? ===== | ||
+ | 创建你的第一个[[items|物品]]。 |
zh_cn/tutorial/setup.1629882247.txt.gz · Last modified: 2021/08/25 09:04 by solidblock