마스터 트랙 #1: 도구 모드 프로젝트 셋업

# examplemod-master-projects/tools/gradle.properties
minecraft_version=26.1.2
minecraft_version_range=[26.1.2]
neo_version=26.1.2.64-beta
 
mod_id=master_tools
mod_name=Master Tools
mod_license=All Rights Reserved
mod_version=1.0.0
mod_group_id=com.example.master.tools

// examplemod-master-projects/tools/src/main/java/com/example/master/tools/MasterToolsMod.java
package com.example.master.tools;
 
import com.mojang.logging.LogUtils;
import com.mojang.serialization.Codec;
import net.minecraft.core.component.DataComponentType;
import net.minecraft.core.registries.Registries;
import net.minecraft.network.codec.ByteBufCodecs;
import net.minecraft.tags.BlockTags;
import net.minecraft.world.item.*;
import net.neoforged.bus.api.IEventBus;
import net.neoforged.fml.ModContainer;
import net.neoforged.fml.common.Mod;
import net.neoforged.neoforge.registries.DeferredRegister;
import org.slf4j.Logger;
import java.util.function.Supplier;
 
@Mod(MasterToolsMod.MOD_ID)
public class MasterToolsMod {
 
  public static final String MOD_ID = "master_tools";
  public static final Logger LOGGER = LogUtils.getLogger();
 
  // ─── 아이템 레지스터 ────────────────────────────────────────────────────
  public static final DeferredRegister.Items ITEMS =
          DeferredRegister.createItems(MOD_ID);
 
  // ─── 보석 재료 아이템 ───────────────────────────────────────────────────
  /** 루비 — 순도(purity) DataComponent를 가지는 보석 아이템 */
  public static final Supplier<Item> RUBY = ITEMS.registerItem("ruby",
          props -> new Item(props
                  .stacksTo(64)
                  .rarity(Rarity.RARE)));
 
  public static final Supplier<Item> SAPPHIRE = ITEMS.registerItem("sapphire",
          props -> new Item(props
                  .stacksTo(64)
                  .rarity(Rarity.RARE)));
 
  // ─── 루비 도구 4종 ──────────────────────────────────────────────────────
  /**
   * 루비 곡괭이.
   * MC 26.1.2: PickaxeItem 삭제 → ToolMaterial.applyToolProperties() 사용.
   * MINEABLE_WITH_PICKAXE 태그로 곡괭이 채굴 동작 부여.
   */
  public static final Supplier<Item> RUBY_PICKAXE = ITEMS.registerItem("ruby_pickaxe",
          props -> new Item(RubyTier.INSTANCE.applyToolProperties(
                  props,
                  BlockTags.MINEABLE_WITH_PICKAXE,
                  1.0f,   // 공격력 추가치
                  -2.8f,  // 공격 속도
                  0.0f    // 공격 범위 보너스
          )));
 
  /**
   * 루비 검.
   * MC 26.1.2: SwordItem 삭제 → ToolMaterial.applySwordProperties() 사용.
   */
  public static final Supplier<Item> RUBY_SWORD = ITEMS.registerItem("ruby_sword",
          props -> new Item(RubyTier.INSTANCE.applySwordProperties(
                  props,
                  3.0f,   // 기본 공격력
                  -2.4f   // 공격 속도
          )));
 
  public static final Supplier<Item> RUBY_AXE = ITEMS.registerItem("ruby_axe",
          props -> new AxeItem(RubyTier.INSTANCE, 5.0f, -3.1f, props));
 
  public static final Supplier<Item> RUBY_SHOVEL = ITEMS.registerItem("ruby_shovel",
          props -> new ShovelItem(RubyTier.INSTANCE, 1.5f, -3.0f, props));
 
  // ─── DataComponent 레지스터 ─────────────────────────────────────────────
  public static final DeferredRegister.DataComponents COMPONENTS =
          DeferredRegister.createDataComponents(Registries.DATA_COMPONENT_TYPE, MOD_ID);
 
  /**
   * 보석 순도 (0 ~ 100).
   * 순도가 높을수록 다음 챕터에서 도구 내구도 보너스가 증가합니다.
   */
  public static final Supplier<DataComponentType<Integer>> PURITY =
          COMPONENTS.registerComponentType(
                  "purity",
                  builder -> builder
                          .persistent(Codec.INT)
                          .networkSynchronized(ByteBufCodecs.INT));
 
  public MasterToolsMod(IEventBus modEventBus, ModContainer container) {
    LOGGER.info("Master Tools Mod 로드 완료");
 
    ITEMS.register(modEventBus);
    COMPONENTS.register(modEventBus);
  }
}

cd examplemod-master-projects/tools
./gradlew tasks