Pitan Mod Wiki

Pitan作マイクラMODの解説Wiki ≡

目次

• FrontPage
• Video/FabricのMOD開発講座

• MOD解説
  • 自作系
    • Advanced Reborn
    • Bedrock Tools76
    • Cubic Turret
    • Ender Cane
    • Enhanced Quarries
    • Item Alchemy
    • More Harnesses
    • PipePlus
    • Simple Uncrafting Table
    • Space Cube
    • StorageBox Adapter
    • Storage Box for Fabric
    • Universal Wrench

• MCPitanLibドキュメント

↑

検索

AND検索 OR検索  

最新の10件

2026-02-23

• Item Alchemy/EMCコンデンサー
• Item Alchemy/EMC Collector MK-1
• Item Alchemy/EMCコレクター MK-1
• Item Alchemy/EMC Condenser
• Item Alchemy/EMC Condenser MK-2
• Item Alchemy/EMCコンデンサー MK-2
• Item Alchemy/Philosopher's Stone
• Item Alchemy/賢者の石
• Simple Uncrafting Table/Uncrafting Table

2026-02-17

• Item Alchemy/Alchemy Table

↑

ツールボックス

• 新しいページの作成
• バックアップの表示
• リンク元
• 最近更新したページ
• 全ページ
• ヘルプ
• アップロード
• ページ名の変更

↑

カウンター

総計:212
今日:2
昨日:0
現在:21

トップヘルプPukiWiki

How to Add Items with MCPitanLib†

This guide explains the basic steps to add a new item to Minecraft using MCPitanLib.
It references the implementation in ExampleMod.java as an example.

Prerequisites†

• MCPitanLib is already integrated into your project.
• Your mod's main class (e.g., ExampleMod) inherits from CommonModInitializer.

Steps†

1. Prepare MOD ID and Registry†

Define the MOD ID used for identifying your mod and get the MCPitanLib registry.

public class ExampleMod extends CommonModInitializer {
    public static final String MOD_ID = "examplemod"; // Replace with your MOD ID
    public static CompatRegistryV2 registry;

    @Override
    public void init() {
        registry = super.registry; // Get the registry from CommonModInitializer
        // ... other initialization processes ...
    }

    // Helper method to easily create an Identifier using the MOD ID
    public static CompatIdentifier _id(String path) {
        return CompatIdentifier.of(MOD_ID, path);
    }

    @Override
    public String getId() {
        return MOD_ID;
    }

    // ...
}

2. Define Item ID†

Define the ID for the item you want to add using CompatIdentifier.
This will be in the format MOD_ID:item_name.

public class ExampleMod extends CommonModInitializer {
    // ... (code from above) ...

    // Define the Item ID
    public static CompatIdentifier EXAMPLE_ITEM_ID = _id("example_item"); // Becomes "examplemod:example_item"

    // ...
}

3. Prepare Item Instance and Settings†

Create an instance of the item to be added.
With MCPitanLib, you typically use the CompatItem class and CompatibleItemSettings.

• CompatibleItemSettings.of(): Configures basic item settings (stack size, creative tab, etc.).
• CompatItem: The most basic item class, which takes CompatibleItemSettings as an argument.

// Defined within ExampleMod.java, either in the init method or as a static field for item registration

// Variable to hold the registration result of the item (RegistryResult type)
public static RegistryResult<Item> EXAMPLE_ITEM;

// Register the item within the init method
@Override
public void init() {
    // ...
    registry = super.registry;
    // ...

    // Register the item
    EXAMPLE_ITEM = registry.registerItem(EXAMPLE_ITEM_ID, () ->
            new CompatItem(CompatibleItemSettings.of(EXAMPLE_ITEM_ID) // Pass the settings
                    // .maxCount(16) // For example, if you want to set max stack size to 16
                    .addGroup(ItemGroups.INGREDIENTS) // Add to the "Ingredients" creative tab
            )
    );

    // ...
}

Points:

• CompatibleItemSettings.of(CompatIdentifier id): Passing the item ID as an argument generates an appropriate settings instance for the respective versions.
• .addGroup(ItemGroups.INGREDIENTS): Adds the created item to a specific tab in the creative mode inventory (in this case, the "Ingredients" tab). The ItemGroups class defines other tabs as well.
• () -> new CompatItem(...): Passes a lambda expression (Supplier) that provides the item instance. This allows for deferred initialization.

4. (Optional) Create a Custom Item Class†

If you want to create an item with more complex behavior, you can create your own class that inherits from CompatItem.

// Example: An item with special behavior on right-click
public class MyCustomItem extends CompatItem {
    public MyCustomItem(CompatibleItemSettings settings) {
        super(settings);
    }

    @Override
    public public StackActionResult onRightClick(ItemUseEvent e) {
        // Action on right-click
        if (!e.isClient())
            e.player.sendMessage(TextUtil.literal("Custom item was used!"));
        
        return e.success();
    }
}

// Registration in ExampleMod.java
// ...
public static RegistryResult<Item> MY_CUSTOM_ITEM;
public static CompatIdentifier MY_CUSTOM_ITEM_ID = _id("my_custom_item");
// ...
// Inside the init method
MY_CUSTOM_ITEM = registry.registerItem(MY_CUSTOM_ITEM_ID, () ->
        new MyCustomItem(CompatibleItemSettings.of(MY_CUSTOM_ITEM_ID)
                .addGroup(ItemGroups.TOOLS) // Add to the "Tools" tab
        )
);
// ...

Summary†

Using MCPitanLib, you can easily add multi versions compatible items with the steps above.
The key classes and methods are:

• CompatRegistryV2#registerItem(CompatIdentifier id, Supplier<Item> itemSupplier)
• CompatIdentifier#of(String modId, String path)
• CompatItem
• CompatibleItemSettings#of(CompatIdentifier id)

For more detailed settings or custom behaviors, please refer to other APIs in MCPitanLib and other parts of ExampleMod.java (e.g., ExampleGuiItem)

目次

• MCPitanLibドキュメント

検索

AND検索 OR検索  

最新の10件

ツールボックス

カウンター