Penggunaan Item Dasar

Peringatan

These docs were written for SpongeAPI 7 and are likely out of date. If you feel like you can help update them, please submit a PR!

Barang-barang yang direpresentasikan melalui :javadoc:`kerjatumpukan`. kerjatumpukan adalah aplikasi persediaan barang dengan informasi seperti jumlah kerja pada tumpukan, jenis barang, dan data tambahan seperti daya tahan. Aplikasi :javadoc:`kerja` itu sendiri adalah representasi grafik dari sebuah kerjatumpukan sebagai sebuah entitas. Diketahui bahwa anda akan selalu mendapatkan kopi dan tidak sebenarnya kerjatumpukan dan dengan demikian, anda akan perlu untuk mengatur kembali ke inventarisasi jika diinginkan.

Memeriksa Jenis item

Checking the type of the item is very simple. You just need to call the ItemStack#getType() method.

import org.spongepowered.api.item.ItemType;
import org.spongepowered.api.item.ItemTypes;
import org.spongepowered.api.item.inventory.ItemStack;

public boolean isStick(ItemStack stack) {
    ItemType type = stack.getType();
    return type.equals(ItemTypes.STICK);
}

Melihat bagaimana sederhana itu? Karena tongkat dapat stack, kita juga dapat mengetahui berapa banyak yang hadir.

Getting the number of items in an ItemStack is relatively easy. The ItemStack#getQuantity() method will handle this for us.

Memodifikasi ItemStack Data

Memanipulasi data seperti daya tahan atau pengetahuan tentang item dapat dicapai dengan hanya menggunakan kunci. Anda hanya perlu untuk menentukan kunci yang perlu diubah:

import org.spongepowered.api.data.key.Keys;

public void setUnbreakable(ItemStack stack) {
    stack.offer(Keys.UNBREAKABLE, true);
}

Dalam hal ini, kita ditentukan bahwa :javadoc:`Tombol#TIDAKAKANHARCUR` kunci adalah kunci yang kita ingin perubahan. Kemudian kita tentukan nilainya menjadi benar untuk menyiratkan bahwa kerja tidak akan pernah istirahat. Semua ini tertutup dalam () metode kerjatumpukan untuk kembali berubah kembali ke kerjatumpukan.

Different keys will require different values based on their job. For example, to change the lore of an item, one would need to specify a List of Component rather than a boolean or other value. It is also important to perform checks to see if the key can actually apply to the item. For example, some items might not have durability or may already have lore applied to the item.

import net.kyori.adventure.text.Component;

import java.util.List;

public void setLore(ItemStack stack, List<Component> itemLore) {
    if (stack.get(Keys.ITEM_LORE).isPresent()) {
        stack.offer(Keys.ITEM_LORE, itemLore);
    }
}

Catatan

Almost all API methods that return an ItemStack only return a copy of it, so modifying it does not have any impact on the real stack (e.g. in an inventory). You have to explicitly set it for your changes to persist.

Item Properti

Item tertentu mungkin menyimpan properti tertentu. Misalnya, barang tertentu bisa menambang blok tertentu, seperti beliung berlian ke obsidian. Properti digunakan untuk menentukan apakah item dapat menyebabkan tindakan tanpa benar-benar memeriksa jenis item. Kita bisa mengecek apakah ada barang yang bisa menambang obsidian dengan menggunakan :javadoc:`PanenTanaman` dari item itu.

import org.spongepowered.api.block.BlockTypes;
import org.spongepowered.api.data.property.item.HarvestingProperty;

import java.util.Optional;

public boolean canMineObsidian(ItemStack stack) {
    Optional<HarvestingProperty> optional =
        stack.getProperty(HarvestingProperty.class);

    if (optional.isPresent()) {
        HarvestingProperty property = optional.get();
        return property.getValue().contains(BlockTypes.OBSIDIAN);
    }
    return false;
}

Kode ini akan memeriksa apakah item tersebut memiliki PanenTanaman, seperti beliung beli. Jika ada, maka akan kembali jika barang ini bisa memanen obsidian tanpa perlu mengecek jenis barangnya. Ini berguna jika sebuah mod atau memperbarui Minecraft menambahkan alat baru dengan kemampuan pertambangan obsidian.

Membandingkan ItemStacks

kerjatumpukan kelas berisi rapi metode untuk membandingkan dua kerjatumpukans. Dengan menggunakan :javadoc:`kerjatumpukan#sama(kerjatumpukan)` metode dari yang sudah ada kerjatumpukan, kita dapat melihat jika dua kerjatumpukans adalah 'sama'. Artinya, mereka berbagi sama ukuran tumpukan, :javadoc:`tipepekerjaan`, dan data. Contoh lihat di bawah ini:

public boolean isEqual(ItemStack stack1, ItemStack stack2) {
    return stack1.equalTo(stack2);
}