Hello Minecraft Mod

老爸AI：今天尝试0基础用Claude Code 来开发一个 MC 的模组。

Fabric 新手入门模组 - 实现计划

 项目概述

 使用 Fabric 模组加载器 为 Minecraft 1.21.1 开发一个新手入门模组，包含：
 - 自定义物品（Ruby Gem 红宝石）
 - 自定义方块（Ruby Block 红石块）
 - 自定义合成配方
 - 自定义创造模式物品栏标签

 前置准备

 1. 安装 JDK 21（推荐 Azul Zulu 或 Eclipse Temurin）
 2. 安装 IntelliJ IDEA Community Edition
 3. 安装 Git（可选）
 4. 拥有正版 Minecraft Java Edition

 技术选型

 ┌───────────────┬────────────────┬───────────────────────┐
 │     组件      │      版本      │         说明          │
 ├───────────────┼────────────────┼───────────────────────┤
 │ Minecraft     │ 1.21.1         │ 稳定版，资源丰富      │
 ├───────────────┼────────────────┼───────────────────────┤
 │ Fabric Loader │ 0.16.10        │ Fabric 加载器         │
 ├───────────────┼────────────────┼───────────────────────┤
 │ Fabric Loom   │ 1.9.x          │ Gradle 构建插件       │
 ├───────────────┼────────────────┼───────────────────────┤
 │ Fabric API    │ 0.114.0+1.21.1 │ Fabric API            │
 ├───────────────┼────────────────┼───────────────────────┤
 │ Gradle        │ 8.11 (Wrapper) │ 构建工具              │
 ├───────────────┼────────────────┼───────────────────────┤
 │ Java          │ 21             │ JDK                   │
 ├───────────────┼────────────────┼───────────────────────┤
 │ Mapping       │ Yarn           │ Fabric 默认，社区维护 │
 └───────────────┴────────────────┴───────────────────────┘

 实现步骤

 Step 1: 项目骨架搭建

 - 使用 Fabric 官方模板生成器（https://fabricmc.net/develop/）下载 ZIP
 - 或直接基于模板仓库生成
 - 配置 gradle.properties 和 build.gradle

 Step 2: Mod 元数据配置

 - 编辑 fabric.mod.json，设置 mod ID、名称、入口点

 Step 3: 创建资源文件（assets）

 - 语言文件 lang/en_us.json（物品/方块显示名称）
 - 纹理文件 textures/item/ruby_gem.png（16x16 PNG）
 - 纹理文件 textures/block/ruby_block.png（16x16 PNG）
 - 模型文件 models/item/ruby_gem.json
 - 模型文件 models/block/ruby_block.json
 - 方块状态 blockstates/ruby_block.json

 Step 4: 创建数据文件（data）

 - 合成配方 recipe/ruby_block.json（9个红宝石 → 1个红石块）
 - 解包配方 recipe/ruby_from_ruby_block.json（1个红石块 → 9个红宝石）
 - 战利品表 loot_table/blocks/ruby_block.json

 Step 5: 编写主模组类

 - src/main/java/com/ruby/tutorial/RubyTutorialMod.java
 - 注册物品、方块、BlockItem、创造模式标签
 - 所有代码带中文注释

 Step 6: 构建与测试

 - ./gradlew runClient 直接启动测试
 - ./gradlew build 打包 JAR
 - JAR 输出位置：build/libs/ruby-tutorial-mod-1.0.0.jar

 关键文件清单

 ┌─────────────────────────────────────────────────────────────────────────┬──────────────────────┐
 │                                  文件                                   │         用途         │
 ├─────────────────────────────────────────────────────────────────────────┼──────────────────────┤
 │ build.gradle                                                            │ Gradle 构建配置      │
 ├─────────────────────────────────────────────────────────────────────────┼──────────────────────┤
 │ gradle.properties                                                       │ 版本号配置           │
 ├─────────────────────────────────────────────────────────────────────────┼──────────────────────┤
 │ src/main/resources/fabric.mod.json                                      │ Mod 元数据           │
 ├─────────────────────────────────────────────────────────────────────────┼──────────────────────┤
 │ src/main/java/com/ruby/tutorial/RubyTutorialMod.java                    │ 主模组类（核心代码） │
 ├─────────────────────────────────────────────────────────────────────────┼──────────────────────┤
 │ src/main/resources/assets/ruby-tutorial/lang/en_us.json                 │ 翻译/显示名称        │
 ├─────────────────────────────────────────────────────────────────────────┼──────────────────────┤
 │ src/main/resources/assets/ruby-tutorial/textures/item/ruby_gem.png      │ 红宝石纹理           │
 ├─────────────────────────────────────────────────────────────────────────┼──────────────────────┤
 │ src/main/resources/assets/ruby-tutorial/textures/block/ruby_block.png   │ 红石块纹理           │
 ├─────────────────────────────────────────────────────────────────────────┼──────────────────────┤
 │ src/main/resources/assets/ruby-tutorial/models/item/ruby_gem.json       │ 物品模型             │
 ├─────────────────────────────────────────────────────────────────────────┼──────────────────────┤
 │ src/main/resources/assets/ruby-tutorial/models/block/ruby_block.json    │ 方块模型             │
 ├─────────────────────────────────────────────────────────────────────────┼──────────────────────┤
 │ src/main/resources/assets/ruby-tutorial/blockstates/ruby_block.json     │ 方块状态             │
 ├─────────────────────────────────────────────────────────────────────────┼──────────────────────┤
 │ src/main/resources/data/ruby-tutorial/recipe/ruby_block.json            │ 合成配方             │
 ├─────────────────────────────────────────────────────────────────────────┼──────────────────────┤
 │ src/main/resources/data/ruby-tutorial/recipe/ruby_from_ruby_block.json  │ 解包配方             │
 ├─────────────────────────────────────────────────────────────────────────┼──────────────────────┤
 │ src/main/resources/data/ruby-tutorial/loot_table/blocks/ruby_block.json │ 方块掉落             │
 └─────────────────────────────────────────────────────────────────────────┴──────────────────────┘

 验证方法

 1. 运行 ./gradlew build —— 编译成功且生成 JAR
 2. 运行 ./gradlew runClient —— 启动带模组的 Minecraft
 3. 在创造模式中检查"Ruby Tutorial"标签页，确认红宝石和红石块存在
 4. 在工作台测试合成配方（9红宝石→红石块，红石块→9红宝石）
 5. 放置和破坏红石块，确认掉落自身